Policies

Policies are one tab in Service Infractions.

Enhancements and corrections to Policies typically concern system administrators. System administrators may need to let system users know of any functionality changes.

Version Type Description ID

6.5

ENH Now, for policies that use a Threshold Calculation Type of Percentage, the total number of trips is calculated by dividing the total number of violations by the total violation trips and scheduled/arrived/performed trips. The violation trips have schedule statuses defined by the policy criteria. PASS-12494

6.5

ENH Policies now support the Flagged Periods Violation Calculation Type.

Flagged Periods policies require a Fixed Duration Threshold Time Period, a Lookback Horizon (the amount of time in which to check for flagged periods), and an Infraction Threshold (the number of infractions that must occur within the defined Time Period Unit for it to be flagged [and, therefore, count towards the total number of flagged periods]).

No case promotion option is available for Flagged Periods policies. Cases will always be promoted within the same stage (not to the highest applicable stage).

PASS-12744

6.5

ENH The Policies tab has been updated and there is more flexibility when defining policies.
The following options are now typically available when creating policies:
  • Threshold Time Period (Fixed Duration or Rolling Window)
  • Time Period Unit (Month, Quarter, or Year)
  • Threshold Calculation Type (Count or Percentage)
  • Violation Calculation Type (Infractions, Suspensions, or Flag Periods)
  • Case Promotion (Same Stage or Highest Stage).
PASS-12777

6.5

ENH Behavioral policies can now be created. PASS-12866

6.5

ENH New MergeField options are available for use in template letters:
FlaggedPeriodCount
For the flagged period case type, this is the number of periods during the policy's defined lookback horizon that the client surpasses the policy's infraction or percentage threshold.

The FlaggedPeriodCount is used to determine the violation level. For example, 1, 2, 3.

OrdinalFlaggedPeriodCount
Ordinal of the flagged period count.

For example, 1st, 2nd, 3rd, 4th.

RecentFlaggedPeriod
Month of the most recent flagged period, not including the current one. For example, March, 2017.
Letters
This is a new table Alt Text Title option, used to advise clients about letters that have previously been sent to them. This only applies to letters for Flagged Period policies.
LetterDate
For flagged period cases: dates (month/year) of the letters that have been delivered during the time horizon.

For example, February, 2017.

Stage
Stage to which the delivered flagged period letters belonged.

For example, Warning, Violation, Appeal.

CaseId
Identification number of the case(s) associated with the delivered letters.
PASS-12870

6.5

ENH New MergeFields were added:
SuspendedForWords
Suspension value written in words.

For example, two days.

SuspendedForDaysWord
Suspension days value written in words.

For example, two(2).

CurrentFlaggedPeriod
Flagged period to which the current infractions belong (determined using the first infraction date located for the letter).

For example, March, 2017.

PASS-12901

6.5

ENH Now, when a Behavioral policy is created, the only available Threshold Time Period is the Rolling Window time period.

For Behavioral policies, Rolling Window is defined in months.

To define how many months prior to the current date the behavioral policy should check, type a number in the Rolling Window Duration field.

PASS-12980

6.5

ENH Now, when an existing policy is edited, the end date can be extended if the current end date occurs some time in the future. PASS-13077

6.5

ENH On the Policies tab, Hide and Unhide options are now available.

These allow system administrators to hide inactive policies from users.

To mark a policy as hidden, on the Policies tab, select the policy card of the policy to be hidden (the policy must not be in an Active state) and click Hide.

To unhide a policy, click Unhide. Note that to see hidden policies (in order to unhide them), the following context property must be selected: PassEligibility > CasesScreen > Show hidden policies. After adjusting the context property, restart the Service Shell.

PASS-13087

6.5

ENH On the Policies tab, the Stages and Phases pane is now presented vertically, and the Information and Infraction criteria panes are shown on the right-hand side of the page. PASS-13136

6.5

ENH Policy criteria requirements were updated to include the following:

General:

  • Printed Letter Template must be uploaded for all stages.
  • Valid Cancellation Code must be specified for all suspension levels (phases).
Rolling Window:
  • Rolling Window Duration must be equal to or greater than 1.
In order to change any setting, the policy needs to be deactivated.
Only the following settings can change for a policy after it has been activated (and then deactivated):
  • End Date: End date can only be extended.
  • Name and Description
  • Infraction Criteria
  • Maximum investigation time period must be greater than 0 for stages
  • Maximum time period to compose message for stages
  • Printed Letter Template for stages
  • Grace Period for Violation Alert Stage
  • Grace Period Prior to Suspension for Appeal Stage
  • Cancellation Code for Suspension Levels

Note that other settings will only be editable for policies with a Not Yet Activated Status

PASS-13177

6.5

ENH Policy duplicates can now be created.

This allows you to make new policies containing minor variations on existing policies.

For example, you can create individual policies for infraction criteria while retaining Violation Alert and Appeals definitions.

Note that the clone of a policy will be created in the Not Yet Activated state, allowing changes that would not be possible in the original policy (even if it is deactivated).

To create a policy copy, on the Policies tab, select a policy card. Click Clone. Give the new policy a unique name and edit as needed. When ready, Activate the policy.

PASS-13256

6.5

ENH For Behavioral policy Types, a new Infraction Criteria type has been added: Behavior Types. PASS-13280

6.5

ENH Now, the Lookback Horizon value cannot be 0.

The default Lookback Horizon value is 1.

PASS-13383

6.5

CORR MergeField client address information now pulls from the mailing address.

If no mailing address is defined, then client home (CH) address information is used. If no CH address is defined, information from the first saved client address is used.

PASS-13438

6.5

ENH Provider security is now applicable to policies that explicitly apply to one or more providers. Policies that do not specify a provider are accessible by all users. PASS-13779

6.5

ENH ShortFare policies allow transit agencies to based service infractions on monetary shortfalls.

To use ShortFare policies, in the Trapeze4 Workstation, under Tools > System Properties, on the Profile tab, Faring > Enable Prepaid Faring Deductions must be set to No.

Short fares are calculated based on the difference between the FareCollected and FareToCollect amounts.

PASS-13798

6.5

ENH ShortFare policies now feature the following:
  • Count is the only valid Threshold Calculation Type
  • Point-based is not a valid option for ShortFare policies
  • Booking Purpose is not a valid Infraction Criteria
  • Schedule Status Infraction Criteria automatically include Scheduled, Arrive, and Performed statuses
  • In the Infractions widget, To collect (FareToCollect), Collected (FareCollected), and Shortage amounts are visible
  • The total Confirmed Fare Shortage is visible in the Infractions widget title bar
PASS-13854

6.5

ENH Policies now support a multi-level appeal processes. PASS-14087

6.5

ENH The default Grace Period for appeals is now two weeks.

The grace period can also be set to 0 or defined in hours.

PASS-14186

6.5

ENH Now, when a policy is cloned, the policy copy's policy Type cannot be changed. PASS-14218

6.5

ENH Policies that have a Threshold Time Period of Fixed Duration and a Violation Calculation Type of Infractions now support a Threshold Value (either # or %) for each stage. For example, Warning Alert 1 and Violation Alert. PASS-14242

6.5

ENH Missing Scheduled Trips policies now support the points-based option for policies using the Percentage Threshold Calculation Type. PASS-14256

6.5

ENH Now, for Behavioral policies, trip information is available in the Infractions widget via the Show trip information button. PASS-14373

6.5

ENH New MergeFields are available to be used with ShortFare policy letters:
  • FareShortage, FareToCollect, and FareCollected can be used in infractions tables.
  • TotalFareShortage can be used in the letter body.
PASS-14390

6.5

ENH Now, for Missing Scheduled Trips policies, when the vehicle arrival time is inside the window and the dwell time is >=5 minutes, the dwell time (Arr(Dwell)) in the Infractions widget is shown in green. PASS-14413

6.5

ENH Multi-period cases in the Suspended - Closed phase are checked for their highest suspension level (which is visible on the Infractions widget title bar as Last Suspension Level).

When they meet the defined criteria, they are then moved to the next suspension level (or the same level if they are in the Suspended - Subsequent Violations phase).

PASS-14445

6.5

ENH The Add a Policy dialog box now has the following option for multi-period case policies:
  • a check box to indicate the policy is a Multi-period case policy
When checked:
  • the Case life span field appears (this defines the number of months the case must remain in the same phase (for example, Warning Alert 1 - Closed) before a case is Archived)
  • Threshold Time Period is set to Fixed Duration
  • Violation Calculation Type is set to Infractions
  • Time Period Unit is set to Month
  • Threshold Calculation Type can be set to either Count or Percentage
  • the policy can be defined as a Point based policy
  • Case Promotion can be made to the Same Stage or Highest Stage
  • a Description can be added

If a multi-period case reaches the violation alert level, the Previous Suspension Level is visible on the Infractions title bar.

PASS-14467

6.5

ENH Now, if the Threshold Calculation Type is Percentage, a Min Number of Infractions option is available for warning alert and violation alert stages.

If the policy is points-based, then Min Infraction Points is used instead.

PASS-14474

6.5

ENH Suspension phases in multi-period policies allow definitions for Threshold Value and Min Number of Infractions (valid values are 1-99). PASS-14568

6.5

ENH Multi-period case policies now allow the warning alert and suspension Threshold Value (#) to be any number.

For example, Warning Alert 1 can have a Threshold Value (#) of 2 and Warning Alert 2 can have a Threshold Value (#) of 1.

PASS-14570

6.5

ENH The Warning Alert levels of single-period case and multi-period case policies with a Threshold Calculation Type of Percentage can now have a Threshold Value (%) of 0. PASS-14864

6.5

ENH The Lookback Horizon option is now available for policies with a Threshold Time Period of Fixed Duration and a Violation Calculation Type of Suspensions. PASS-15076

6.5

ENH When clients are suspended, suspensions can be defined as 0 days (overriding the default policy suspension period). PASS-15542

6.5

ENH Now, in rolling window policies, when the last sanction is older than the rolling window duration, cases can only be promoted to the first sanction level. PASS-15613

6.5

ENH New MergeField options are available for Short Fare policies:
  • AccountBalance (per infraction)
  • FareDeducted (per infraction)
  • FareShortage (per infraction)
  • OverdraftLimit
  • TotalFareShortage
  • CurrentAccountBalance
PASS-16160

6.5

ENH Now, when a transit agency is using EZ-Wallet, Service Infractions can be set up to look for deductions from the purse that total a greater amount than the defined overdraft limit.

Trapeze recommends that the same overdraft limits be defined in the Trapeze4 Workstation (under Tools > System Properties, on the Profile tab, under Faring > Default Over Draft Limit), which is used by EZ-Wallet as the default overdraft limit when a client overdraft limit of 0 is defined (as shown in Task > Clients, on the Detail tab, in the Fare frame, in the Overdraft Limit field; in EZ-Wallet, the overdraft limit is defined on the Purse tab, in the Actions & Settings frame, in the Over Draft field), and in Context Properties (under PASS > PassInfoServer > Faring > DefaultOverdraftLimit).

To use ShortFare policies based on purse balances (instead of the difference between FareToCollect and FareCollected), the following context property should be selected: PASS > PassInfoServer > Faring > EnablePrepaidFaringDeductions.

This context property must not be altered after ShortFare policies are set up; or existing ShortFare policies should be deleted and new ShortFare policies should be created after it is altered.

Additional fields for purse-based ShortFare policies have been added to the Infractions widget on the Cases tab in Service Infractions:
Confirmed Fare Shortage
Total fare shortage for all confirmed infractions.
Overdraft Limit
Client overdraft limit (as shown in the Trapeze4 Workstation, under Task > Clients, on the Detail tab, in the Fare frame, in the Overdraft Limit field).

If the client overdraft is $0.00, the amount defined in the DefaultOverdraftLimit context property is used for calculations in Service Infractions. This amount is not shown in the Overdraft Limit field in the Infractions widget.

Current Account Balance
Current EZ-Wallet purse balance.

For each infraction, the Account Balance (EZ-Wallet purse balance after the trip was performed), Fare Deducted (amount deducted from the EZ-Wallet purse for the trip), and Shortage (difference between the funds applied to the FareAmount (for example, the client's purse balance, FareCollected amount, and overdraft limit [client overdraft limit or amount defined in the DefaultOverDraftLimit context property]) and the FareAmount) are shown.

To prevent infraction errors, use the PassEligibility > Policies > ShortFare > InfractionSyncDelay context property to define the number of days to wait before importing ShortFare infractions into Service Infractions. If FareCollected amounts for a trip (in Schedule Editor) are altered after the defined number of days, incorrect information may be passed to or visible in Service Infractions.

Relates to PASS-15194.

PASS-16123
6.5 ENH For Short Fare policies, you can now mail-merge trip fare collection amounts into letters.
6.5.1 ENH

You can now set indefinite suspensions in the Policies screen. You can also set and change the indefinite suspension duration in the Modify Suspension dialog box.

PASS-16743
6.5.3 CORR Fixed an issue, where Violation Threshold field was missing from a Percentage based policy if the Violation-Calc-Type = Infraction. PASS2-3876
6.5.3 CORR Fixed an issue, where editing parameters in an infraction-populated policy showed an error if one of the infractions has parameter with 0 Id (undefined parameter). PASS2-3860
6.5.3 ENH In multi-period policies, you can now investigate infractions from a current time period. PASS2-2989
6.5.3 ENH For flagged-periods policies, you can now assign cases in the Initial phase and confirm/forgive infractions when the violation calculation type is set to "Flagged-Periods". PASS2-2988
6.5.3 CORR Fixed an issue, where a behavioral policy allowed the selection of a behavior type for an infraction that was not authorized under the policy. PASS2-2620
6.5.3 ENH Made improvements for percentage-based policy setups so that when Violation Calculation Type field is set to infractions, there was no threshold information shown at the Violation level. Threshold criteria should be set on suspension phases (like multi-period policies). PASS2-1660
6.5.4 CORR Fixed an issue, where you could not add a parameter in a policy (single or multi-period). PASS2-5803
6.5.4 CORR Fixed display issue for policies with longer names. Policies - Status (Active / Deactivated / Not Active yet) and the full name of the policy (when selecting from the Policy drop-down menu) was not fully displayed. PASS2-4498

6.5.6

CORR Fixed an issue where Behavioral Type policy did not accept floating point (0.5) value. PASS2-12616

6.5.6

ENH In flag period policies, cases that are created in Initial phase will not be promoted to sanction levels if the same client has another active case. The case will be transitioned as soon as the old case is closed. PASS2-10871
6.5.6 ENH The <behaviorabbr> and <behaviordesc> tags were added to support merge of data fields for Behavior policy types. PASS2-9285

6.5.6

CORR Fixed an issue where in policies that have specific infraction criteria, when an invalid infraction became valid again, trying to refresh the data on the revalidated infractions caused a NullReferenceException to be thrown. PASS2-9153
6.5.6 ENH An Only Subscription Trips checkbox was added to policy settings (both on the dialog box and the widget) to specify that "only subscription trips" will be processed to generate missed trip infractions. This checkbox is only be available when policy type is set to Missed Trips, but hidden when policy type is set to Behavioral or Short-Fare. PASS2-12435
6.5.7 CORR Fixed an issue where Subscription Trip Only policy calculation totals were incorrect. SI-778