travelport enhanced itinerary application · the main concept is that a travel agency has a default...

Travelport Enhanced Itinerary

Travelport Enhanced Itinerary Application June 2015

Version 1.8.9

Travelport


Contents

Travelport Enhanced Itinerary Application ....................................................................................... 1

Overview ......................................................................................................................................... 3 Architecture ..................................................................................................................................................................... 3

Features .......................................................................................................................................... 4

Minimum System Requirements ...................................................................................................... 5

Using Enhanced Itinerary ................................................................................................................. 6 Displaying a PNR ........................................................................................................................................................... 9 Selecting visible items. ................................................................................................................................................ 10 Emailing an itinerary. ................................................................................................................................................... 10 Printing an Itinerary. ..................................................................................................................................................... 12 Saving an Itinerary as a file ......................................................................................................................................... 12 Customisations ............................................................................................................................................................. 12 Customisation by Account code ................................................................................................................................. 14 Available templates ...................................................................................................................................................... 15 Options ........................................................................................................................................................................... 16 EI from the command line ........................................................................................................................................... 31 EI from Focalpoint ........................................................................................................................................................ 32

Troubleshooting ............................................................................................................................ 33

Appendix..................................................................................................................................... 34

Travelport


Overview

The Enhanced Itinerary (hereafter referred to as EI) application allows users to produce itineraries for PNRs that are resident on the Galileo, Apollo and Worldspan systems. The itineraries produced can be emailed, printed or copied to 3rd party applications such as MS Word.

Architecture EI is a SDI application that runs on MS Windows. It can be run as a standalone application for those users that only access Worldspan, but Apollo and Galileo users will require Galileo Desktop to be installed. Default email access is via Outlook 2003 and version 4.0 of the .NET framework is required. EI also requires that MS Internet Explorer also be installed as the itinerary is displayed in a web browser window.

Travelport


Features

EI offers the following features:

1) Add link to Viewtrip (incl. White Label)

2) Email/Print/”Save as a file” of itineraries, individually or as a group, in HTML or plain text.

3) Production of .ics files for import into 3rd party applications, e.g. MS Outlook.

4) View itinerary in html or text formats

5) Ability to add corporate logos, and header and footer text

6) Option to select of one, or more, passengers, segments and E-Tickets.

7) Full internationalization of application and itinerary. Languages currently supported are Arabic, Catalan, Czechoslovakian, English, French, Spanish, German, Italian, Swiss-German, Portuguese, Brazilian, Polish, Kazakh, Japanese and Russian.

8) Application of Service Fees.

9) Run standalone for Worldspan users.

10) Ability to display EMDs (Galileo only).

11) Multiple languages on the itinerary (maximum of 3).

12) Baggage hyperlinks.

13) Ability to display Group PNRs

14) display Frequent Flyer numbers according to airlines in the PNR and according to cross accrual references

15) Show Fare Basis in segment details

16) Hide E-Tickets Description

17) Set default : Email subject line: “E-Ticket for (Name date)” 1.8.9

18) **NEW** Display Name Remark in HTML (Flights and Fares Only) and in Plain Text (Simple Itinerary Layout) templates

19) **NEW** Office 2013 compatibility added.

20) **NEW** IT/BT fare and tax display fixed on HTML ETI template

Travelport


Minimum System Requirements

1) MS Windows XP (and latest Service pack)

2) MS Internet Explorer 8.0.

3) MS Outlook 2007

4) .NET 4.0 Framework (and latest service packs)

5) Galileo Desktop 2.5, for Galileo users

6) MS Word 2007

7) Windows Installer 4.5

Travelport


Using Enhanced Itinerary

EI allows a great deal of flexibility in the presentation of itineraries. This flexibility is achieved through the use of different layouts -HTML and plain text, and a set of options.

Starting EI

EI can be started in a variety of ways. For Worldspan only customers then EI is started via the Start button (Start->Travelport->Travelport.EnhancedItinerary). For Galileo Desktop users further methods are available, Galileo Desktop toolbar, GDAudit (Focalpoint command). Smartpoint users can add #EI prompt in the Tools Quick Commands Configuration menu item. The app is installed (Win7): C:\Program Files (x86)\Travelport\Travelport.EnhancedItinerary\Travelport.EnhancedItinerary.exe

Choosing a host

A user can choose between Galileo and Worldspan by selecting from the Settings Drop down menu.

Travelport


If a user selects Worldspan then they will need to have a set of XmlPro credentials to access Worldspan via XmlPro.

Galileo does not require credentials but you will need to be emulating to successfully complete the registration process.

Office not installed

When no Office installed on the PC, user will receive an alert when launching the application. Click OK and

leave it running. The refresh button may be used to update PNR data for confirmation.

Saving and/or sending confirmation in PDF format is not possible when Office is not installed.

Travelport


Menu bar options.

In brief, an itinerary can be copied to the clipboard, emailed, printed, refreshed and passengers, segments and tickets can be selectively displayed from here.

Toolbar mode

EI can be displayed in toolbar mode by selecting the down arrow button on the right hand side of the menu bar.

Travelport


Displaying a PNR

Galileo

EI will capture the PNR that is currently loaded in Galileo desktop. Should a change be made to the PNR then use of the Refresh button will reload the itinerary. Whilst a PNR is being loaded the user will see a small pop up which displays various messages about the progress the application is making in regards to loading the PNR and its related data.

Worldspan

EI can display un-ended (no record locator) as well as ended itineraries. To load an existing PNR type in the record locator in the box in the middle of the menu toolbar and press the “Go!” button next to it. To display an itinerary for an un-ended PNR then two methods are available.

First, the user presses the Go! Button without a record locator in the edit control. This will display the following form.

The user can either, type commands directly into the Data entry edit control as in a Go! Res window, the user presses the “Send to host” button to send the command to Worldspan. The Worldspan host will reply in the first and largest edit control labelled “Host Response”. Or, Paste text from a “Go! Res” window by using the paste button.

The Redisplay button performs a “*R”. The OK button will close the window and EI will display the itinerary.

Travelport


Selecting visible items. EI offers the user the ability to selectively choose which passengers, segments and e-tickets are visible. This is achieved by selecting the Display Options button on the menu bar.

The user can individually select which passengers/segments/tickets they wish to see, or select all or none via a right mouse click or by clicking on the checkbox above each list. The display is automatically refreshed as the user selects/deselects.

Emailing an itinerary. Users can send an itinerary in a variety of ways.

A user can choose what format the email is to take (see first 4 options above), they can also assign email addresses to separate passengers if required by selecting the last option “Select email addresses”. By selecting this option a form will appear like so

Travelport


A list of all the currently available email addresses (as determined by the options selected on the email tab of the Options pop up) will appear in a drop down under the text “All email addresses”. If a user selects one of those addresses and then presses the “Set all email addresses to the selected” button then all passengers listed in the grid in the bottom half of the pop up will be automatically updated to show that address as the selected address for that passenger. New email addresses can be added by typing them into the text box below the text. “Add new email address” and then pressing the “Add” button. The newly added email address will then appear in all the drop downs in the pop up. The number of passengers that appear in the “Email Addresses” pop up is determined by the number selected in the passenger list in “Display Options”. Further email options will be discussed in the Options section below.

Travelport


Printing an Itinerary. Once a user has decided on what they wish to display they can print the itinerary from the Print button. If a user has selected “Individual PNRs in email” then the printing will produce separate itineraries for each passenger in the PNR.

Saving an Itinerary as a file Users can opt to save the itinerary as a file (accessed from the File menu). Available formats are:- For Html layouts - pdf, doc and html. For text layouts - pdf, doc and txt.

Customisations The user can access further options from the Settings menu and selecting “Customisations”.

This will display the following form.

The form, as a whole, allows users to define itinerary types. To create a new itinerary type, the user should click on the “Create New” radio button, select an item from the “Use Template” drop down, or, select an item from the “Clone customization from” dropdown (this drop down holds a list of previously created itinerary types).

Travelport


The user should then add a definitive indicator in the “Save Itinerary Type as” text box to distinguish the newly created itinerary type from either the template of cloned customization previously selected. The user can also, decide whether this new itinerary type is to be a default. This means that in the absence of a specific customization being available then a set of default options is used to display a PNR.

After a user has created a new name for this new itinerary type the “cog” to the left will become enabled and the explicit customisation of this itinerary type can be performed using the Options pop up.

Upon selection of various options the new itinerary type is created when the user presses the OK button in the Options pop up. Should a user wish to change the options in an existing itinerary type then they should click on the “Edit existing” radio button. This will make available the ability to select an existing itinerary type for editing, or, the ability to change the underlying template used by the selected item in the “Itinerary type” drop down. Should the user wish to alter the options for an existing itinerary type then select the itinerary type from the “Itinerary type” drop down and press the “cog” (edit button) and make alterations. Once again when the user presses the Ok button on the options pop up the new settings are saved. Should the user have selected an item from the “Change template” then they can either press the cog to make further adjustments or press the Save button on the main customisation pop up. Should the user wish to remove an itinerary type, after selecting it from the “Itinerary type” drop down, then they just need to click on the trashcan to remove that item. Finally, the user has the ability to decide which Itinerary types should be used as a default. This means that when a booking file is loaded by EI then a default html itinerary type of plain text itinerary type can be used to display it.

Travelport


Customisation by Account code The main concept is that a travel agency has a default template (ie: HTML2) with or without a customized layout and they are sending out confirmation to all customers with that. If they have a corporation which needs a different layout/customization than EI can send out the specific one. EI checks the DI. field and if finds an AC ACCT-999 line than it switches to the specified layout. This can be used with ETI template but will not be shown in the available templates dropdown menu. To achieve this, a new template has to be created using the Setting and Customisations menu. User has to tick “Use Corporate Config” and enter the field identifier / and the constant which EI will look for. Important: only one type of identifier to be used for all booking files, the code after it will alter the template. User can select from the available templates from the “Use template” dropdown menu. The corporate specific template will be finalized by saving the form. For a customer number 999 the following settings will apply. (DOCI-AC ACCT-999)

Should the user want to make changes to the newly created template then they can use the same form by editing the template settings using the cog icon.

Travelport


Available templates

Template Air Hotel Car Surface Other

HTML 1 data column Yes Yes Yes Yes Yes

HTML 2 data columns Yes Yes Yes Yes Yes

HTML flights only Yes

HTML flight selection Yes Yes Yes

HTML conversion Yes Yes Yes

HTML fares and fees Yes

HTML ETI Yes

HTML Itinerary Yes Yes Yes

HTML electronic ticket itinerary Yes

HTML segments only Yes

Plain text 1 data column Yes Yes Yes Yes Yes

Plain text 2 data columns Yes Yes Yes Yes Yes

Plain text conversion Yes Yes Yes

Plain text simple segments only Yes Yes

Plain text flights and fares only Yes

Plain text segments only Yes Yes Yes

Plain text simple itinerary Yes Yes Yes

Travelport


Options Currently, this form has 10 tab pages as shown above and each will dealt with in turn.

Company details

The user can enter their name here so that it is displayed on the itinerary, likewise a company logo, and company name, can be added as well as any company specific text (html for html layouts, text for text layouts) for the header and footer areas of the itinerary. Hyperlinks can be added to these areas as well (separated by a space). Users also have the option to hide/show the display of the text “Consultant’s Name:”. An example of how a header should look in html: <TABLE style='WIDTH: 100%' '> <TR>Company Name</TR> <TR>Company Address Line 1</TR> <TR>Company Address Line 2</TR> <TR>Company Phone<TR> </TABLE>

Note: In html, if you want to have a whitespace character then you must replace it with an so for every whitespace character you substitute it with an , so the above example actually should be <TABLE style='WIDTH: 100%' '>

<TR>Extraordinary Tours</TR>

<TR>The Manor House</TR>

<TR>Tavistock Square</TR>

<TR>London</TR>

<TR>09870 676767<TR>

</TABLE>

Travelport


Visibility

The user can decide which segment types they wish to be visible, also whether they wish to see tickets, their coupons and if ticket numbers should be visible in the service information area. Users can also elect to show fares, output pdfs in landscape format as opposed to portrait, mco’s, class codes, the agents sign on, TIMATIC information, APIS information, the small icons that appear in the html layout in the segment headers, the “Info not found” message that appears when information is not found (e.g. terminal info for air segments). The position of the E-Tickets and segments can be swapped as well if a user requires. Gridlines on the html itinerary layout can be shown/hidden and users can now set their own fonts, font sizes and colours for the html layout as well by accessing the “Select Font(s) and Colours” button. If the user presses the “Select Font(s) and Colours” button then they can alter the appearance of the HTML layout. Further options for the Alt1Plain layout are also available. User can elect to show all segments and all passengers (as well as showing/hiding the company phone number) in the header section of the Alt1 Plain layout. The last 3 items at the bottom of this tab allow various references to be placed in the header or footer sections of a sub set of the available templates.

Travelport


More visibility options

The user can decide which types of ticket (VOID, RFND, etc. ) they wish to see. Similarly, Fare rules, can also be show/hidden. Fare rules can be detailed or in summary form and can optionally be included in emails. Baggage allowances in the HTML1Col and HTML2Cols can now be detailed, as in the full description of the passenger fare type, or summary, the original way the baggage was displayed. Baggage hyperlinks can be added to an itinerary, either after each segment or at the end of the itinerary. Additional baggage information is available in the HTML1Col and HTML2Cols layouts and appears in the ticket section EMDs can also be displayed or hidden with the optional extra of showing or hiding voided EMDs. ADCs can be shown and the fare for the ADC can be shown or hidden as well. For multi-leg segments, the ground, flying and journey time can be shown or hidden. This is only available on the HTML1COL and HTML2COL layouts. Some users may not wish to show the base fare and total fare for ITX fares. These amounts can now be hidden by using the Hide ITX fares check box.

Travelport


**NEW** Display Name Remark in HTML (Flights and Fares Only) and in Plain Text (Simple Itinerary Layout) templates. Full name remark will be included in the itinerary when option is selected.

Setting Fonts and Colours.

The HTML layout can be configured so that the fonts and colours can be defined as to be more in line with a company’s corporate image. The various options are shown below.

Please note that for the ETI and Itinerary itinerary types the font is set by using the “Other areas” section.

Travelport


Viewtrip

The Viewtrip tab allows the user to decide if they want to display a link to www.viewtrip.com (Galileo) and www.mytripandmore .com (Worldspan). They can choose where they wish the link to be displayed (None, Before/After Header/Footer), also a Viewtrip White Label can be added as well. The user can also elect to extract white label information from the current pseudo’s MAR, the PNRs MAR, BAR or PAR as well as specifying the identifier in the related MAR/BAR/PAR’s notepad section

Travelport


Email

Users can choose to use MS Outlook as the default, or they can press the “SMTP” button and enter details for email systems such as Gmail in the form that appears (see SMTP Form below). “On behalf of” type accounts can be entered into the “From” edit control, these appear in any mail that a recipient of an itinerary via email will reply to. It is also possible to add a “cc” address and a “bcc” address. Some users make use of other email systems, i.e. Lotus, and the ability to send html in the body of an email has now been included to allow those systems to be used, EI will still continue to only support Outlook. Email addresses are contained within two areas of a PNR the phone section and the email section, the check boxes provided allow the user to decide from where the email addresses (used in the Select Email Addresses” form (see previous section)). Users can elect to split the PNR into individual emails, one per passenger in the PNR. If this option is selected then the user can also opt to attach a calendar file. There is also the ability to add a “warning” to the email, and, also to embed a similar warning within the calendar file, notifying the recipient that the times for any segment are in the local time zone relevant to departure point of that segment. To remove any possible confusion, a time zone adjustment warning can be included in calendars and/or emails. Users can decide to automatically send emails. When the email button is pressed any email addresses found in the previously specified areas of a PNR will be used as recipients of the itinerary. The subject line of an email can be set to be blank, or can be set as “Schedule Change Advice – Locator” or if both left un-ticked then the default behaviour is retained. Default Subject for email can be set to “E-Ticket for” when EI used mainly for sending out electronic ticket confirmations. The line will be displayed as, E-ticket for (PASSENGER/NAMEMR 11/11/2014).

Travelport


Miscellaneous

This tab contains a selection of options that do not really warrant tabs of their own.

Travelport


Show service fee and Service Fee – if an agency is charging an additional service fee then they can enter it here they can also decide whether it will be visible in the display. It is also possible to use the DU tax as a service fee (this is for the JJ carrier and is a requirement in the Brazilian market) Hide Service Fee – this option allows users to apply a service fee but not to show it in the itinerary. Show Receipts – allows TASF receipts to be added to the itinerary, or they can be added as an attachment Output languages – the first option is the primary language and is used for the application and the itinerary. The second and third options are additional languages outputted on the itinerary. To remove additional languages set all languages to be the same. Include Endorsement (Simple text layout only) – user can display the endorsement or not Use default booking classes only – user can limit cabin descriptions to Economy, Business, and First, etc. Embed in Galileo Desktop – when Galileo desktop is running and this option is selected then EI cannot be moved outside the Galileo Desktop.

Configuring the Service Fee

Open Enhanced Itinerary Click Settings, Options Click the Miscellaneous tab

Check the Show Service Fee box. You can then choose to apply the same, flat fee to all bookings or you can choose “Use service fee from DI line”. In the “DI Format” box, type SF.

Travelport


To add the service fee as a DI remark

DI.FT-SF50.00

The Booking File will look like this, and you MUST have a filed fare for the service fee to show, if you use the DI remark option.

Travelport


Ad-hoc service fee Simple Service Fee / Air Fare may be added to confirmation. There are two types for doing this, Simple and Enhanced method.

Simple Enhanced

HTML flight and fares only HTML Fares and fees

Plain text flights and fares only

Example for Simple SF/AF:

Enhanced Service fee (only for HTML Fares and fees template): EI uses codes for service fees. BG Baggage Charge CC Credit Card HF Hotel Fee PF Airline Payment Fee FD Fare Difference CF Charge Fee TF Transaction Fee XS Excess Baggage

Travelport


Data

The Data tab provides the user with a mechanism to add any missing booking class codes for a particular vendor if it is not available from the host. The user enters the vendor code, the booking class and the cabin description (e.g. economy).When the “Add” button is pressed the new booking class is added to the list held by EI. Lookup data used by EI (such as booking classes) are used to reduce hits on the host, however, every few months this data needs to be updated. By going to this tab the user can cause the lookup data to be refreshed. After an update it is recommended that EI be restarted. If a booking class is missing then a user can add it here. The “Data” area of this tab allows users to automatically update the data files. The user can select from updating daily, weekly, or 4 weekly. They can of course press the “Update data files” button which will perform an update immediately. Users can also elect to additionally search for any updates to merged carriers, the part of the auto update check can take up to 4 minutes to complete.

Travelport


Travelport


Hotel optional fields

EI now offers the user the ability to decide which optional fields of hotel segments they wish to show/hide in the layouts. The user can also decide whether to show or hide hotel segments with a BK or MK status.

Travelport


HTML Itinerary optional fields

With this tab the user can decide which fields to show/hide in the Itinerary layout.

Travelport


HTML Electronic Ticket Itinerary optional fields

With this tab the user can decide which fields to show/hide in the ETI layout.

Travelport


EI from the command line A user can get EI to perform certain things by passing in command line arguments when EI is started. This is most useful if a user is starting EI from a Focalpoint window.

Command line options

The possible options are:- “/?” – displays a list of command line arguments that can be passed to EI “/EA” – auto send emails “/EI” – auto send individual PNRs “/CT” – copies as text to the clipboard “/CH” – copies as HTML to the clipboard “/ET” – open an email with text in the body of the email “/EH” – open an email with HTML in the body of the email “/EM” - open an email with text in the body of the mail and an HTML attachment “/EP” - open an email with plain text in the body of the mail and no attachment “/SP” –select specified passengers, separated by a comma, e.g. /SP:1,2,3-7 “/SS” – select specified segments, separated by a comma, e.g. /SS:1,2,3,4,5 “/EL:xxxx” – sets the language that the itinerary will be displayed in (e.g. /EL:ca-ES) “/GD:xxxxxx” – accesses galileo with a record locator of xxxxxx (e.g. /GD:NF4JT6) “/WS:xxxxxx” – accesses worldspan with a record locator of xxxxxx (e.g. /WS:NF4JT6) “/S” – silent running – no GUI visible “/P” – prints the itinerary So, how would a user make use of this ability. Usually via the gdaudit mechanism. EI can be supplied with an xml file containing JavaScript that can be used by GDAudit to load EI with a variety of the command line options. The following snippet shows EI being activated when the user types in #TKP or #TKPDTDAD, the arguments passed in are "/S /EA /ET" which transcribe to run in silent mode and automatically send individual PNRs. This user had selected “Select emails from the phone section in the Options-> Email tab. So EI would select those email addresses and send the itinerary to the recipients automatically, all in the background. If no email addresses are available then the email will appear with a blank address line for the user to complete. Example gdaudit JavaScript code snippet <RegExp><![CDATA[^(#TKP$|#TKPDTDAD$)]]></RegExp> <Script> <![CDATA[ // global variable to store the Focalpoint entry var sFPCommand_g; function TravelportEnhancedItinerary_Execute (sGalFormat) { var oVP = new ActiveXObject("Viewpoint.ViewpointSrv"); // get the path to Galileo Desktop's SWDIR folder var sSWDIRPath = oVP.GetSWDIRPath(); oVP = null;

Travelport


var sPath = sSWDIRPath + "CustomViewpoint\\LocalScripts\\EnhancedItinerary\\Travelport.EnhancedItinerary.exe";

var oFO = new ActiveXObject("File.FileObj"); // ensure the app files exist before proceeding if (!oFO.Exists(sPath)) { oFO = null; return sFPCommand_g; }

var exec = new ActiveXObject("Exec.ExecObj"); exec.exec(sPath, "/S /EA /ET"); exec = null; return sFPCommand_g; } ]]> </Script>

EI from Focalpoint The application will intercept the TKP command and print off itineraries generated by enhanced itinerary without any additional user input. Process flow is as below and will be transparent to the user. I.e. the user will simply issue the #TKP command and all other processing will occur in background, resulting in the ticket being issued and the itinerary printed.

• To invoke the application the #TKP command will be used rather than TKP. Modifiers can be used as per normal e.g. #TKPFCK etc.

• Application will Intercept the #TKP(+modifiers) command. • The TKP command(+modifiers) will be sent to the host • If the ticket issue is successful the application will automatically re-open the PNR just ticketed • The #EIPRINT command will be automatically submitted • #EIPRINT will perform the following

– Obtain the saved configuration from the installed enhanced itinerary application – Print individual PNR’s per passenger without the need to select “print” multiple times. – Note: the print “ok” button will still need to be selected once. – #EIPrint may also be used independently of #TKP – Both #EIPrint and #TKP are part of the enhanced itinerary install.

Travelport


Troubleshooting

“Installer cannot complete”/”Installer interrupted” – check that .NET 4.0 is installed. Reinstall EI, make sure you remove any old versions of EI via Add/Remove programs in Control panel. Two things to check here are “Enhanced Itinerary” and “Travelport.EnhancedItinerary”. Incorrect booking class being displayed – update the lookup files via Options->Data->Update. Or, un-tick “Use Default booking classes” on the Miscellaneous tab of the Options dialog. If problem persists then contact support. Airport names not being displayed – check the install directory and look in a subdirectory called xml, there should be a file called travelports.xml if not present reinstall EI, and check again. Error popup says it can’t find an xml file, reinstall EI, the look up files are missing. Animated Gifs not animated in Outlook – due to Outlook using MS Word as the rendering engine and MS Word does not allow animated gifs to animate. Cannot send emails via my google account – make sure you have entered the correct details in the SMTP form in Options->Email (and make sure “Use Outlook” is unchecked”). Mail seems to get stuck or hang – Outlook 2007 used for email. A small MS Outlook security dialog appears asking if you want to allow/deny/cancel the email to be sent by EI. This only occurs when there is an email address in the PNR which is being used in the “To” line of the email. To solve this install the latest service pack for Outlook 2007 (SP2). Title background colours missing during printing. My header looks terrible in html - you have to use html for headers and footers when in html layouts during printing some users may see the colours used for the title backgrounds are not being printed. This is fixed by changing your internet settings as shown in the next image. After changing the setting, restart Internet Explorer and Galileo desktop.

Travelport


Appendix. A sample itinerary. This sample itinerary shows a single passenger, segment and ticket have been selected from a group of passengers in a PNR.

A. A plain text email with html attachment

Emails can be sent as plain text (see below) or as HTML (Outlook required) in the body of the email and/or with HTML as an attachment.

travelport enhanced itinerary application · the main concept is that a travel agency has a default...

Documents