case study worksheets - american public transportation

Case Study Worksheets During actual configuration specification development, you would use the CFMS Standard to identify the questions you need to answer before values can be assigned to required elements, objects and messages. For the purposes of this exercise, a sampling of possible questions has been prepared, showing which element/object/message definition they are related to as well as where applicable, the possible values accommodated by the CFMS Standard. Using the information provided in the scenario, as well as reasonable assumptions to fill in missing information, the instructor will guide the class in determining a response to the questions in the table below. NOTE: The Rts (for Regional Transit System) is used as a general engineering practice to help identify the data elements that are defined in Part II of the CFMS Standard (as opposed to Part III, which uses the same element names, but without the prefix).

The steps in the process are as follows: 1. Review the case study scenario to determine which questions from the Question Reference List (Appendix A of the workbook) are

applicable. 2. Answer the questions based upon the information provided in the case study. 3. Use the answers to determine which elements of the standard are applicable to the case study example, and the values of variables.

1

2

Case Study 1

Answer the questions based on the information provided in the case study description. Question Answer

Application Questions 1 In which country is the PICC (card) issued?

2 In which region is the PICC (card) issued?

3 Who is the PICC (card) issuer?

4 On what date will the transit application on the PICC no longer be valid?

Cardholder Questions 5 Is the patron eligible for age-based discounts?

6 Is there a validity period for the discount?

7 What is the cardholder preferred language (for screen displays / messages?

8 Are there different patron groups?

9 Did the patron pay a deposit to obtain this card?

10 Is the cardholder’s personal information recorded (apart from date of birth)?

Agency Questions 11 What agencies are participating in the regional program and/or have

products loaded on this card?

12 Is there a Regional T-Purse?

13 Are there any other regional products (apart from T-purse)?

14 Are there any constraints on how regional products are used?

Agency Product Questions 15 Are there any fare products that are valid only for a specific Agency?

3

Question Answer T-Purse and SV Purse Questions

16 Has an autoload service been established for the T-Purse or for any Agency specific Stored Value purse?

17 If so, what type of autoload service is it?

Pass and Transfer Product Questions For each pass or transfer product on the PICC (card), questions 18 to 23 have to be determined:

18 Is autoload allowed? 19 What type of product is it? 20 Where is the pass valid? 21 Is it a ride-based product? 22 If time limited pass products exist, what is their period of validty? 23 If transfers exist, for how long are they valid?

Account Linked Product Questions Questions 24 to 28 apply to Account Linked products:

24 Is there an Account Linked product?

25 Are there limits on the number of fare payments that can be performed using the Account in a given period of time? What is the duration of that time period?

26 Is there a limit on the total value of fare payments that can be made in a period of time?

27 What nation’s currency is applied to fare payments using the Account?

28 Is the bankcard associated with the Account identified on the card?

Autovalue Product Questions 29 Is there any autovalue (bonus) scheme associated with the card or

transaction?

30 In which physical location did the transaction occur?

31 What other data is available to determine where a transaction occurred?

32 To identify the equipment used to perform the transaction?

33 To identify employees that can service equipment?

4

Solution for Case Study 1

1. The answer to the questions based on the information provided in the case study description. Question Answer

Application Questions 1 In which country is the PICC (card) issued? USA 2 In which region is the PICC (card) issued? Salem-Eugene District 3 Who is the PICC (card) issuer? Salem Eugene Transit Authority (50/50 ST/ET) 4 On what date will the transit application on the PICC no longer be valid? Not stated – assume no limit

Cardholder Questions 5 Is the patron eligible for age-based discounts? Yes – seniors 65+, disabled persons, youth 6 Is there a validity period for the discount? Youth – 3-17 years 7 What is the cardholder preferred language (for screen displays / messages? No 8 Are there different patron groups? Possible groups are Youth, Honored Citizen,

Adult 9 Did the patron pay a deposit to obtain this card? No

10 Is the cardholder’s personal information recorded (apart from date of birth)? No Agency Questions

11 What agencies are participating in the regional program and/or have products loaded on this card?

ST and ET

12 Is there a Regional T-Purse? Yes – used for single rides fares for both agencies

13 Are there any other regional products (apart from T-purse)? No 14 Are there any constraints on how regional products are used? No

Agency Product Questions 15 Are there any fare products that are valid only for a specific Agency? ST has monthly pass, ET has 30 day pass

T-Purse and SV Purse Questions 16 Has an autoload service been established for the T-Purse or for any Agency

specific Stored Value purse? No

17 If so, what type of autoload service is it? -

5


18 Is autoload allowed? ST - No ET - No 19 What type of product is it? Pass Pass 20 Where is the pass valid? ST buses ET buses 21 Is it a ride-based product? No No 22 If time limited pass products exist, what is their period of validty? Monthly 30 day 23 If transfers exist, for how long are they valid? - -


24 Is there an Account Linked product? No 25 Are there limits on the number of fare payments that can be performed using the

Account in a given period of time? What is the duration of that time period? -


-

27 What nation’s currency is applied to fare payments using the Account? - 28 Is the bankcard associated with the Account identified on the card? -

Autovalue Product Questions 29 Is there any autovalue (bonus) scheme associated with the card or transaction? No

30 In which physical location did the transaction occur? Numbered 1000 - 1100 31 What other data is available to determine where a transaction occurred? TBD 32 To identify the equipment used to perform the transaction? TBD 33 To identify employees that can service equipment? TBD From these answers, the relevant data elements, objects and messages can be determined. In some cases, values can’t be directly derived from the answers given above, but have to be created to suit the situation. Areas that are not relevant to this case (e.g. autoload) are not shown.

6

2. Using the answers above, the values for data elements, and the data objects and messages that are applicable, are determined.

Question Object Element Value Message Notes Application Questions 1 In which

country is the PICC (card) issued?

Transit Application Profile Object (TAPO) LocationDataObject

RtsCountryID country-ID

USA = 840

A0101 PICC Initialized A0102 PICC Issued A0103 PICC Registered A0818 Direct a PICC Data Change



RtsRegionID region-ID

This is a new region so a new value is needed.


Transit Application Profile Object (TAPO)

RtsIssuerID

New issuer – assign value 20



RtsTransitExpirationDate

Date in format ddmmyy


RtsTransitValidityPeriod 0 = valid upon issue 1 – 7 = years prior to expiry date when application becomes valid

Cardholder Questions 5 Is the patron

eligible for age-based discounts?

PICC Holder Profile Object (PHPO)

RtsProfileBirthDate Set for Youth when card is issued. For Honored Citizen, set to issue date minus 65 years.



RtsProfileStartDate Set for Youth when card issued.


RtsProfileExpireDate Set for Youth when card issued.

7

Question Object Element Value Message Notes 7 What is the

cardholder preferred language (for screen displays / messages?


RtsProfileLanguage English= 0



RtsProfileCode Set when card issued: Full Fare = 1 Senior = 4 Youth = 5

A0418 PICC Profile Data Changed B0121 Fare Policy Framework – Regional Profile Codes

RegionalProfileCodeDescription

‘Adult’ ‘Youth’ ‘Honored Citizen’

Name of profile used for displaying or printing


PICC Holder Profile Object (PHPO) BatchEncoldingDataObject

RtsDepositPaid DepositAmount

0 0

Used to determine refund if applicable

Agency Questions 11 What

agencies are participating in the regional program and/or have products loaded on this card?

LocationDataObject Agency-ID ST = 50 ET = 51

B0123 Fare Policy Framework –Agency IDs

Assign new agency IDs

Directory Index Object (DIO) RtsAgencyAProductsFileID

File ID = 1

Directory Index Object (DIO) RtsAgencyAProductsQty

3 products = 2

Directory Index Object (DIO) RtsAgencyAID ST = 50

AgencyDescription ‘Salem Transit’ Agency ‘A’ Directory Index Object (DIO) RtsAgencyBProductsFileI

D

File ID = 2

8

Question Object Element Value Message Notes Directory Index Object (DIO) RtsAgencyBProductsQty

3 products = 2

Directory Index Object (DIO) RtsAgencyBID ET = 51

AgencyDescription ‘Eugene Transit’ Agency ‘B’ Regional Product Questions 12 Is there a

Regional T-Purse?

Directory Index Object (DIO) RtsTPurseFileID T-purse = 1 A2770 Regional T-Purse Loaded A2775 Regional T-Purse Unloaded A0401 Use of Regional T-Purse

Note that fares deducted from the T-purse are determined using the fare table resident in the fare payment device.

Directory Index Object (DIO) RtsRegionalProductsQty 1 product = 0 Agency Product Questions 15 Are there

any fare products that are valid only for a specific Agency?

Product Index Object (PIO)

RtsProduct1AgencyID

ST = 50 A2781 Agency Pass Product Loaded A2786 Agency Pass Product Unloaded A0403 Use of Agency Specific Product with or without a step-up fare A0416 Product Blocked A0417 Product Unblocked A0816 Block a Product A0817 Unblock a Product

Each product needs to be defined with an associated agency and product type.

Product Index Object (PIO) RtsProduct1TypeCode Time based Pass = 2

Product Index Object (PIO) RtsProduct2AgencyID

ET = 51


Pass and Transfer Product Questions For each pass or transfer product on the PICC (card), the following have to be determined: 19 What type of

product is it? Pass and Transfer Product Objects (P&TPO)

RtsProductType Monthly pass = 1 (for ST)

A0411 Product Activation (First use of rolling product)

ST Product (defined by the regional participants)

9

Question Object Element Value Message Notes 20 Where is the

pass valid? Pass and Transfer Product Objects (P&TPO)

RtsLocationEncoding All ST Routes = 1 Indicates the location validity of the Pass Product within the Region.

22 If time limited pass products exist, what is their period of validty?

Pass and Transfer Product Objects (P&TPO)

RtsExpDate ddmmyy Date set when pass loaded

19 What type of product is it?


RtsProductType 30 day pass = 2 (for ET)


ET Product (defined by the regional participants)

20 Where is the pass valid?


RtsLocationEncoding All ET Routes = 10 Indicates the location validity of the Pass Product within the Region.



RtsExpDate ddmmyy Date set when pass first used.

Equipment and Employee Questions 30 In which

physical location did the transaction occur?

LocationDataObject

RTSLocationID Location-ID

0 - 100

ID for each CID in the system


VehicleDataObject vehicle-ID zone-ID

0 – 100 (all buses) 0,10 (ST/ET zones)

Define unique IDs for all possibilities in the system

32 Identity of equipment used to perform the

EquipmentDataObject Location-ID CIDID RtsCIDID

0- 100 0 - 100 0 - 100

Unique IDs [within the Region] for Devices

10

Question Object Element Value Message Notes transaction


EmployeeDataObject EmployeeID EmployeeType EmployeePICCID

ID number Name PICC serial number

Optional if ST/ET want to identify employees using equipment

11

Case Study 2

Answer the questions based on the information provided in the case study description. Question Answer

Application Questions 1 In which country is the PICC (card) issued?




Cardholder Questions 5 Is the patron eligible for age-based discounts?


7 What is the cardholder preferred language (for screen displays / messages?



10 Is the cardholder’s personal information recorded (apart from date of birth)?

Agency Questions 11 What agencies are participating in the regional program and/or have

products loaded on this card?

12 Is there a Regional T-Purse?

13 Are there any other regional products (apart from T-purse)?

14 Are there any constraints on how regional products are used?

Agency Product Questions 15 Are there any fare products that are valid only for a specific Agency?

T-Purse and SV Purse Questions

12

Question Answer 16 Has an autoload service been established for the T-Purse or for any

Agency specific Stored Value purse?



18 Is autoload allowed? 19 What type of product is it? 20 Where is the pass valid? 21 Is it a ride-based product? 22 If time limited pass products exist, what is their period of validty? 23 If transfers exist, for how long are they valid?


24 Is there an Account Linked product?

25 Are there limits on the number of fare payments that can be performed using the Account in a given period of time? What is the duration of that time period?


27 What nation’s currency is applied to fare payments using the Account?

28 Is the bankcard associated with the Account identified on the card?

Autovalue Product Questions 29 Is there any autovalue (bonus) scheme associated with the card or

transaction?

30 In which physical location did the transaction occur?


32 To identify the equipment used to perform the transaction?


13

Solution for Case Study 2

1. The answer to the questions based on the information provided in the case study description. Question Answer

Application Questions 1 In which country is the PICC (card) issued? USA 2 In which region is the PICC (card) issued? St Paul/Wilsonville 3 Who is the PICC (card) issuer? St Paul Transit and Wilsonville Transit both

issuers 4 On what date will the transit application on the PICC no longer be valid? Not stated – assume no limit

Cardholder Questions 5 Is the patron eligible for age-based discounts? Yes – seniors 65+, disabled persons, youth 6 Is there a validity period for the discount? Youth – 3-17 years 7 What is the cardholder preferred language (for screen displays / messages? No 8 Are there different patron groups? Possible groups are Youth, Honored Citizen,

Adult 9 Did the patron pay a deposit to obtain this card? No

10 Is the cardholder’s personal information recorded (apart from date of birth)? No Agency Questions

11 What agencies are participating in the regional program and/or have products loaded on this card?

ST, WT

12 Is there a Regional T-Purse? Yes 13 Are there any other regional products (apart from T-purse)? No 14 Are there any constraints on how regional products are used? No

Agency Product Questions 15 Are there any fare products that are valid only for a specific Agency? ST has monthly pass, WT has 30 day pass

T-Purse and SV Purse Questions 16 Has an autoload service been established for the T-Purse or for any Agency

specific Stored Value purse? Yes

17 If so, what type of autoload service is it? Threshold for T-Purse, recurring for ST monthly pass

14


18 Is autoload allowed? ST - Yes ET - No 19 What type of product is it? Pass Pass 20 Where is the pass valid? ST buses ET buses 21 Is it a ride-based product? No No 22 If time limited pass products exist, what is their period of validty? Monthly 30 day 23 If transfers exist, for how long are they valid? 2 hours 1.5 hours


24 Is there an Account Linked product? No 25 Are there limits on the number of fare payments that can be performed using the

Account in a given period of time? What is the duration of that time period? -


-

27 What nation’s currency is applied to fare payments using the Account? - 28 Is the bankcard associated with the Account identified on the card? -

Autovalue Product Questions 29 Is there any autovalue (bonus) scheme associated with the card or transaction? No

30 In which physical location did the transaction occur? Numbered 1000 - 1500 31 What other data is available to determine where a transaction occurred? TBD 32 To identify the equipment used to perform the transaction? TBD 33 To identify employees that can service equipment? TBD

15

2. Using the answers above, the values for data elements, and the data objects and messages that are applicable, are determined.

Question Object Element Value Message Notes Application Questions 1 In which

country is the PICC (card) issued?


RtsCountryID country-ID

USA = 840

A0101 PICC Initialized A0102 PICC Issued A0103 PICC Registered A0818 Direct a PICC Data Change



RtsRegionID region-ID

This is a new region so a new value is needed.



RtsIssuerID

New issuer – assign value 30



RtsTransitExpirationDate

Date in format ddmmyy


RtsTransitValidityPeriod 0 = valid upon issue 1 – 7 = years prior to expiry data when application becomes valid

Cardholder Questions 5 Is the patron

eligible for age-based discounts?


RtsProfileBirthDate Set for Youth when card is issued. For Honored Citizen, set to issue date minus 65 years.



RtsProfileStartDate Set for Youth when card issued.


RtsProfileExpireDate Set for Youth when card issued.

16

Question Object Element Value Message Notes 7 What is the

cardholder preferred language (for screen displays / messages?


RtsProfileLanguage English= 0



RtsProfileCode Set when card issued: Full Fare = 1 Senior = 4 Youth = 5

A0418 PICC Profile Data Changed B0121 Fare Policy Framework – Regional Profile Codes

RegionalProfileCodeDescription

‘Adult’ ‘Youth’ ‘Honored Citizen’

Name of profile used for displaying or printing


PICC Holder Profile Object (PHPO) BatchEncoldingDataObject

RtsDepositPaid DepositAmount

0 0

Used to determine refund if applicable

Agency Questions 11 What

agencies are participating in the regional program and/or have products loaded on this card?

LocationDataObject Agency-ID ST = 70 WT = 71

B0123 Fare Policy Framework –Agency IDs

Assign new agency IDs

Directory Index Object (DIO) RtsAgencyAProductsFileID

File ID = 1

Directory Index Object (DIO) RtsAgencyAProductsQty

3 products = 2

Directory Index Object (DIO) RtsAgencyAID ST = 70

AgencyDescription ‘St Paul Transit’ Agency ‘A’ Directory Index Object (DIO) RtsAgencyBProductsFileI

D

File ID = 2

17

Question Object Element Value Message Notes Directory Index Object (DIO) RtsAgencyBProductsQty

3 products = 2

Directory Index Object (DIO) RtsAgencyBID WT = 71

AgencyDescription ‘Wilsonville Transit’ Agency ‘B’ Regional Product Questions 12 Is there a

Regional T-Purse?

Directory Index Object (DIO) RtsTPurseFileID T-purse = 1 A2770 Regional T-Purse Loaded A2775 Regional T-Purse Unloaded A0401 Use of Regional T-Purse

Note that fares deducted from the T-purse are determined using the fare table resident in the fare payment device.

Directory Index Object (DIO) RtsRegionalProductsQty 1 product = 0 Agency Product Questions 15 Are there

any fare products that are valid only for a specific Agency?

Product Index Object (PIO)

RtsProduct1AgencyID

ST = 70 A2781 Agency Pass Product Loaded A2786 Agency Pass Product Unloaded A0403 Use of Agency Specific Product with or without a step-up fare A0416 Product Blocked A0417 Product Unblocked A0816 Block a Product A0817 Unblock a Product

Each product needs to be defined with an associated agency and product type. Product 1 = monthly pass for ST


Product Index Object (PIO) RtsProduct2AgencyID

WT = 71 Product 1 = 30 day pass for WT


T-Purse and SV Purse Questions 16 Has an

autoload service been established for the T-Purse or for

Stored Value (SV) & T- Purse Product Objects (SV&TPPO)

RtsAutoSubscribe T-purse threshold autoload = 1

A0710 Set up Stored Value or Regional T-Purse Threshold Autoload A0715 Withdraw Stored Value or Regional T-Purse Threshold

18

Question Object Element Value Message Notes any Agency specific Stored Value purse?

Autoload A2713 Regional T-Purse Threshold Autoload Setup Response A2718 Regional T-Purse Remove Threshold Autoload Setup Response A0302 Regional T-Purse Autoloaded (Threshold or Recurring) A0770 Direct a Load of Stored Value A0775 Direct an Unload of Stored Value



RtsRecurringAutoloadType

0 A0750 Set-up Stored Value or Regional T-Purse Fixed Recurring Autoload A0755 Withdraw Stored Value or Regional T-Purse Fixed Recurring Autoload A2753 Regional T-Purse Fixed Recurring Autoload Setup Response A2751 Regional T-Purse Fixed Recurring Autoload Setup and Value Loaded Response A2756 Regional T-Purse Remove Fixed Recurring Autoload Setup and Value Unloaded Response A2758 Regional T-Purse Remove Fixed Recurring Autoload Setup Response


RtsAutoloadThreshold Lookup Tag -1 = 2 A2711 Regional T-Purse Threshold Autoload Setup and Value Loaded Response

Threshold value of $10 contained in file

19

Question Object Element Value Message Notes

A2716 Regional T-Purse Remove Threshold TP & TP & SV Autoload Setup and Value Unloaded Response


RtsSVThresholdLoadAmount

? This is determined by the regional partners


RtsSVRecurringLoadAmount

-


RtsCurrencyCode 0 Uses default from country code

Pass and Transfer Product Questions For each pass or transfer product on the PICC (card), the following have to be determined: 18 Is autoload

allowed? Pass and Transfer Product Objects (P&TPO)

RtsAutoloadSubscribed Subscribed for autoload = 1

A0730 Set-up Regional/Agency Specific Pass Product Setup Autoload A0735 Withdraw Regional/Agency Specific Pass Product Setup Autoload A2732 Agency Pass Product Autoload Setup Response A2737 Agency Pass Product Remove Autoload Setup Response A2730 Agency Pass Product Autoload Setup and Initial Load Response A2735 Agency Pass Product Remove Autoload Setup and Product Unloaded Response A304 Agency Specific Pass Product Autoloaded A0780 Direct a Load of

For ST monthly pass

20

Question Object Element Value Message Notes Regional/Agency Specific Pass Product A0785 Direct an Unload of Regional/Agency Specific Pass Product



RtsProductType Monthly pass = 1 (for ST)


ST Product (defined by the regional participants)



RtsLocationEncoding All ST Routes = 1 Indicates the location validity of the Pass Product within the Region.



RtsExpDate ddmmyy Date set when pass loaded



RtsProductType 30 day pass = 2 (for WT)


WT Product (defined by the regional participants)



RtsLocationEncoding All WT Routes = 10

Indicates the location validity of the Pass Product within the Region.



RtsExpDate ddmmyy Date set when pass first used.

Equipment and Employee Questions 30 In which

physical location did the transaction occur?

LocationDataObject

RTSLocationID Location-ID

0 - 500

ID for each CID in the system

21

Question Object Element Value Message Notes 31 What other

data is available to determine where a transaction occurred?

VehicleDataObject vehicle-ID zone-ID

0 – 150 (all buses) 0,10 (ST/WT zones)

Define unique IDs for all possibilities in the system

32 Identity of equipment used to perform the transaction

EquipmentDataObject Location-ID CIDID RtsCIDID

0- 500 1000 - 1500 1000 - 1500

Unique IDs [within the Region] for Devices


EmployeeDataObject EmployeeID EmployeeType EmployeePICCID

ID number Name PICC serial number

Optional if ST/WT want to identify employees using equipment

case study worksheets - american public transportation

Documents