Page Comparison

Task

Process / Helpful Hint

Custom Field Collection

Configure pending queue under Custom PNR

• Under the Service tab click on Travel Agency

Image Removed

Image Added

• Click on Custom PNR

Image Removed

Image Added

• Click on Mapping which you would like to update

Image Removed

Image Added

• Move to the bottom of the mapping and click on Add PNR Line

Image Removed

Image Added

• Under Line No. enter line number which script will reside in your mapping. In this example we are using line 159

• PNR Field Type: select Pre-Trip Approval

• Custom PNR Requirement: Enter Script

• Requirement Type: Select Script

• GDS: Click on GDS your mapping should write to

The below example Is for a Sabre client, script written to line 159 follows the screen shot. You can adjust the output based on the GDS you are writing to

PNR Script:

//Ticketing Field for PTA Pending Approval

function zeroPad(num,count)

{ 

var numZeropad = num + '';

while(numZeropad.length < count) {

numZeropad = "0" + numZeropad; 

}

return numZeropad;

}

if ((UserPnrData.DataType=="new" || UserPnrData.DataType=="purchase_hold")&&(UserPnrData.UserBooking.PreTripApprovalInfo.CurrentApprovalState=="WAITING_FOR_APPROVAL")){with (UserPnrData.UserBooking.AgencyTransactionDate)

{

var day=UserPnrData.UserBooking.AgencyTransactionDate.Day;

day=zeroPad(day,2);

out.print("7TAW" + day + Month + "/HOLD");}}

Approved, Ticketed/Declined and Expired Queues

Programmed under Agency Configurations

• Go to Service tab click on Travel Agency

• Click on Agency Settings

• Click on Setting Name to be configured

Image Removed

Image Added

• Scroll to the bottom of the page and click on Add PTA Configurations

Image Removed

Image Added

• Enter Pseudo-city and Queue for each Approved, Declined and Expired bookings

• Enter the time window for the primary approver to approve or decline the trip, and the time window for the secondary approver. The primary approver window is best set to 4 – 6 hours, with the alternate approver well before the 24-hour void window

  • Tip: The time windows should total less than 24 hours. Declined flights can be automatically canceled within 24 hours of purchase. If the flight is declined within the 24-hour void window, the ticket cost can be fully refunded.

• Click on Save

Image Removed

Image Added

Task

Process / Helpful Hint

Creating Custom Field Collection

• Enter the collection name into the Name field for each collection, such as PTA, pretripapproval or pretripnotification. Use a label which clearly defines the collection.

• Be sure to click the checkbox for Ask for User Input on the Purchase Page. This will display on the Trip Purchase page, allowing travelers to enter additional notes to approver.

Creating Custom Fields

• Click the radio button for Approval required or Notification only

• Decide whether to send the approval email to the manager within the profile, or to a default approver

  • If you would like the manager listed in the traveler’s profile to receive the approval/notification email, click the box next to Send approval email to traveler’s profiled approver

  • Leave unchecked if you would like the approval/notification email to be sent to the default approver email, which you will need to provide in the next section

  • Note: If the setting for "Send approval email to traveler’s profiled approver" is used, the default approver email value is ignored unless the traveler doesn't have a profiled approver (secondary approver field is still applicable)

• Enter the email addresses for the default approver and the secondary approver. If the default approver has not approved or declined the itinerary within the defined period, an email is sent to the secondary approver default email address

• Decide whether or not to automatically cancel declined itineraries

  • Click the box next to action you would like the system to take

    • Note: Offline-generated or offline-changed PNRs and itineraries with expired approvals are not auto-canceled

• Click the Advanced link at the bottom of the Field Type Preference section to enter the JavaScript criteria for this field

Image Removed

Image Added

Use Case JavaScripts

• PNR and Pre-Trip Approvals JavaScript are in many cases interchangeable. For further Information: JavaScript Examples

• Need further help creating a script, please open a Support Case

Example Script

• Flying to specific airport

//Alaska and Hawaii

if((UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="ANC")||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="FAI") ||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCodee=="HOM")||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="JNU") ||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="HNL") ||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="KOA") ||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="LIH") ||

(UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="ITO"))

{out.print("true");}else

{out.print("false");}

Add to Custom Field Set

Once you have completed programming PTA collection, you will then need to add it to the custom field set

• Go back to Custom Field Configurations, and Click on Custom Field Sets

Image Removed

Image Added

• Click on Set which you would like to add PTA

Image Removed

Image Added

• Click on Add Collection to Set

Image Removed

Image Added

• Click check box next to collection you would like to add to the set and click on Add

Image Removed

Image Added

• You can adjust the order in which the fields appear and select Save

Image Removed

Image Added

• Confirm you have Service Rules updated as well 

  • Ensure you have the correct custom field sets assigned to the correct groups

• Commit Changes shown at the top of the screen

• Please be sure to test.

Task

Process / Helpful Hint

Designating  Approver Status Manually

• Click on User tab

• Click on Account Permission

• Click on Travel Approver Permission

• Click  on Save

Image Removed

Image Added

Assigning Manager Manually to Traveler Profile

• Click on User tab

• Click on Personal and Employee Info

• Click on Travel Approver Name

• Select Approver from list

• Click  on Save

Upload Approver

• You can upload a file to establish user-approver relationships. Templates are available under the Profile tab. 

• Before preparing your profile upload, consider, as a profile upload can be damaging if not managed correctly. See Preparing a Profile or Delegate Upload File, and keep in mind the following:

  • Save the upload file template as a new file before adding or changing rows and columns

  • Follow the template instructions to enter information in the new file 

• Follow these general steps when assigning the approver role to any profile:

  • Consulting the User Profile Fields page, locate the Role column (roleSet.role) in the new file for each approver

  • Enter ROLE_TRAVEL_APPROVER in the Role column (roleSet.role) for each user to be designated as a travel approver. Other roles may also appear in this column, such as ROLE_PURCHASE_APPROVER and ROLE_APPROVER (for Expense).

  • Upload this new file to establish the approvers in your site

• Follow these general steps to assign approvers to users:

  • After uploading the file to establish approvers in your site, you can then assign approvers to users

  • Consulting the User Profile Fields page, locate the Travel Approver ID column (userInfo.travelApproverID) in the new file for each user

  • Enter the external ID of the approver for this user, defined previously as ROLE_TRAVEL_APPROVER in the Role column (roleSet.role). For example, if the userInfo.travelApproverID value is 28846, then the user whose external ID is 28846 should already have been uploaded and already have been assigned the role of Travel approver (ROLE_TRAVEL_APPROVER) in the Role column (roleSet.role).

  • Upload this new file to establish the approver-user relationships

• Ensure that all custom fields, corresponding collections, and custom field sets are created first before uploading profiles containing custom fields. If not, the upload will possibly fail.