25 June 2012 Galileo International 1
Travelport Enhanced Itinerary Application 25 June 2012
version 1.6.5.3
25 June 2012 Galileo International 2
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
25 June 2012 Galileo International 3
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
25 June 2012 Galileo International 4
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
25 June 2012 Galileo International 5
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.
25 June 2012 Galileo International 6
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.
25 June 2012 Galileo International 8
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.
25 June 2012 Galileo International 9
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.
25 June 2012 Galileo International 10
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.
25 June 2012 Galileo International 11
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.
25 June 2012 Galileo International 12
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
25 June 2012 Galileo International 13
<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>
25 June 2012 Galileo International 14
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.
25 June 2012 Galileo International 15
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.
25 June 2012 Galileo International 16
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.
25 June 2012 Galileo International 17
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
25 June 2012 Galileo International 18
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.
25 June 2012 Galileo International 19
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.
25 June 2012 Galileo International 20
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.
25 June 2012 Galileo International 21
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.
25 June 2012 Galileo International 23
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.
25 June 2012 Galileo International 24
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.
25 June 2012 Galileo International 25
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.
25 June 2012 Galileo International 26
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>
25 June 2012 Galileo International 27
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.
25 June 2012 Galileo International 28
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.
25 June 2012 Galileo International 30
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.