travelport enhanced itinerary applicationmamba.galileosa.co.za/software/galileo/enhanced... · if a...

25 June 2012 Galileo International 1

Travelport Enhanced Itinerary Application 25 June 2012

version 1.6.5.3


Contents

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

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

Features ....................................................................................................................... 3

Minimum System Requirements ................................................................................... 4

Using Enhanced Itinerary ............................................................................................. 5 Setup ................................................................................................................................................ 5 Displaying a PNR ............................................................................................................................ 8 Selecting visible items..................................................................................................................... 9 Emailing an itinerary...................................................................................................................... 10 Printing an Itinerary. ...................................................................................................................... 11 Saving an Itinerary as a file. ......................................................................................................... 11 Options ........................................................................................................................................... 12 EI from the command line ............................................................................................................. 25 EI from Focalpoint ......................................................................................................................... 27

Troubleshooting ......................................................................................................... 28

Appendix. ...................................................................................................................... 30


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 2.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.

Features EI offers the following features:

1) Ability to display Group pnrs

2) Linkage to Viewtrip (incl. White Label)

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

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

5) View itinerary in html or text formats


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

7) Selectability of one, or more, passengers, segments and eTickets.

8) Full internationalization of application and itinerary. Languages currently supported are Arabic, Catalan, English, French, Spanish, Swiss-German, Portuguese, Brazilian and Polish.

9) Application of Service Fees.

10) Can be run standalone for Worldspan users.

11) Ability to display MCO’s.

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

13) Baggage hyperlinks.

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.4, for Galileo users

6) MS Word 2003


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, see appendix A and C) and a set of options (see appendix B).

Setup

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).

Choosing a host

A user can choose between Galileo and Worldspan by choosing from the Settings Drop down

menu.


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

via xmlpro.

Galileo does not require credentials but you will need to be emulating to successfully complete

the registration process.

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.


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 labeled “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.


Selecting visible items.

EI offers the user the ability to selectively choose which passengers, segments and etickets 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 “all” or “none” items 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

With this example we can see a passenger in the first column but no email address, to add an

email address the user types it in the edit control in the middle – bottom part of the form and

presses the “Add new” button, this will then put the just entered email address into the drop down

list in the middle column. The user can now select that email address by using the drop down

arrow in the second column.

The number of passengers that appear in the “Email Addresses” dialog is determined by the

number selected in the passenger list in “Display Options”.

Further email options will be discussed in the Options section below.


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.


Options

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

This will display the following form.

Currently, this form has 8 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 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>


Visibility

The user can decide which segment types they wish to be visible, also whether they wish to see

eTickets, their coupons and if ticket numbers should be visible in the service information area.

Users can also elect to show fares, mco’s, class codes, the agents sign on, timatic information,

Apis information, the smallicons 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 etickets 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. You 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.


More visibility options

The user can also decide which types of ticket (VOID,RFND, etc. ) they wish to see. Similarly,

Fare rules, can also be show/hidden by ticking which option they wish to hide.

Baggage allowances in the HTML1Col and HTML2Cols can now be detailed, as in the full

description of the passenger fare type, or summary, the currently way the baggage is displayed.


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.


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 whitelabel 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


Email

Further email options are available on this tab.

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.

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.

Finally, 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.


Miscellaneous

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

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.


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.


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.


Settings

The Settings tab allows users to use a master configuration file which holds a list of

configurations based around identifiers in the notepad sections of selected MARs/BARs and

PARs. These configurations are then used to glean information from a pnr to produce a unique

filename which will hold the settings for that corporate customer. So, for example, a user has

created a configuration that looks for a CompanyID in the BAR and EmployeeId in the PAR that

are associated with the pnr. When used in conjunction with the pseudo this will form a unique

name which will identify the settings for that particular corporate customer.

The location of the master configuration file and the settings files can be set by using the

respective Browse buttons.

Available settings will show a drop down of the currently available settings files. When a user

selects one of the items in this drop down list, they then press the Load button to import those

settings into EI and will set up EI as per what is specified in that settings file.

Users can save settings by typing in a name in the “Save current settings as” text box and pressing

the “Save” button. So, extending the example above a user may save a set of settings as E9G--

0087-27654, where E9G is a pseudo, 0087 is a companyID and 27654 is an employeeId.

Finally, whenever a pnr is loaded in EI, EI will check for a matching configuration and will load a

matching set of settings unless the user has ticked the “Ignore Specific configuration for Pnr”

checkbox. If the check box has been ticked then whatever is being currently used in terms of

settings selected will be used to display the itinerary

This concludes coverage of the options available from a GUI point of view; the next section will

cover the command line options available for EI.


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;

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.


Troubleshooting

“Installer cannot complete”/”Installer interrupted” – check that .NET 2.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”.

“KEY NOT VALID…” message when EI runs – update EI to version 1.4

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.


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 applicationmamba.galileosa.co.za/software/galileo/enhanced... · if a...

Documents