Navitas Expedia Integrator - Installation Guide

The Navitas Expedia Integrator is usually deployed using Microsoft’s Click Once technology which allows Navitas to publish new versions to our central server and have all users automatically updated with the latest features and functionality with minimal overhead.
The following outlines the process required to download and prepare the workstation to run the application.
There are additional instructions provided for customers who utilise a Citrix/Terminal Services type environment.

Pre-Requisites for install

.net Framework
The Navitas Expedia Integrator has been developed against version 3.5sp1 of Microsoft’s .net framework, so this must be available on the workstation before the application will launch. If the workstation does not have this installed it can be downloaded directly from Microsoft’s website.

**PLEASE NOTE: As of Version 3.1.0 (released 12 June 2017) THE SQL COMPACT EDITION 4.0 is NO LONGER a prerequisite, the system now uses a built in SQLite database**
SQL Compact Edition 4.0 sp1
The Navitas Expedia Integrator makes use of a small SQL database that holds the static EAN Location data. In order to access this database the workstation must have the above framework installed. The installer can be downloaded directly from Microsoft’s website (http://www.microsoft.com/en-gb/download/details.aspx?id=30709)

Web Services Access
All Navitas Solutions products communicate with a series of web services to access data tables for the purpose of decoding GDS codes and to provide licence control. If your agency has a proxy installed or a firewall that limits internet communication then please see our FAQ page on the
https://navitas.zendesk.com/hc/en-us/articles/200701759-Navitas-Web-Services-SOA-Infrastructure for information on the web addresses and ports that need to be configured as either “bypass” or “allow” on your network.

Travelport (Galileo / Apollo) Users Only
The application utilises the latest version of the Desktop XML API which often requires the workstation to be upgraded. Navitas Solutions makes a ‘Pre-Requisites’ installer available on our web site to ensure the workstation has the latest files, please follow the additional steps below
Navigate to https://navitas.zendesk.com/hc/en-us/articles/200592779

Installation Guide - Click Once Deployment

On each workstation, open a browser to http://www.navitas.co.uk/products/expedia-integrator
Scroll down to the DOWNLOADS tab and select the Click Once Integrator installation option. You will prompted to Save or Run the solution, if so choose RUN.

NOTE: For Travelport GDS users please ensure you have closed Galileo Desktop / Smartpoint before running the installation

The installer will launch and open the Welcome page, click "Next" to continue.

The installer displays the License Agreement that must be agreed to in order to continue with the install.
Select "I agree to the terms of the license agreement" and click "Next" to continue.

Tick the appropriate box to select if you are an Amadeus, Galileo or Sabre user - select as many boxes as necessary for the specific machine.

The Installer is now ready to perform the installation, click "Next" to continue.

Once complete, the Installation Successful screen is displayed.
Click "Finish" to exit the installer.

NOTE: On some Windows configurations, the Program Compatibility Assistant may display a message to say the program might not have installed correclty - this is in error, simply click "This program installed correctly" to close the installer.

NOTE: The installer automatically adds the required toolbar button for Travelport GDS users. For Amadeus and Sabre users please see the below information on how to configure the toolbar on those GDS environments

If your agency only needs to run the solution from the Start Menu (for example during testing), then after the above instllation has finished, navigate to the c:\navitas directory and double click the 'Expedia GDS Integrator.appref-ms' application file to download and install the application directly.

Installation Guide - Citrix / Terminal Services environments

Using Internet Explorer, navigate to http://www.navitas.co.uk/products/expedia-integrator

Scroll down to the DOWNLOADS tab and select the 'Citrix XCopy' link to download the ZIP file

You must mark the downloaded ZIP file as safe BEFORE extracting the contents, so right click on the ZIP file and select PROPERTIES from the menu.
Select the 'Unblock' check box below the advanced button, and click Apply.

Expand the contents of the ZIP file into the recommended c:\navitas\expediagdsintegrator directory on your server(s).

NOTE: You can choose a different directory if required, but is must be physically on the server where .net 3.5sp1 is installed

Configuring User Access Rights
After copying the files to the server, you must ensure all users have READ/WRITE access to the EANGeographyData.sqlite (or for version prior to 3.1.0, EANLocationData.SDF) file in the directory. This file is a small database containing all the possible search locations available in the EAN system. When users perform a lookup search, temporary files are created within the SDF file to faciliate table queries and therefore users must be able to WRITE to the file as well as READ from the file. If the READ/WRITE doesn't work you may need to provide FULL CONTROL over the file for all users (EVERYONE) instead, this all depends on how controlled your environment is.

If this step has not been performed, the users will be presented with the following error message (or similar)

Configuring the Start Menu
Once copied, configure the Start Menu with a shortcut to the C:\navitas\expediagdsintegrator\ExpediaGDSIntegrator.exe file. If the solution is being tested by a select group of users, then please only make the shortcut available to the individual users. Please see the relevant Appendix to also configure the GDS Toolbar button required to launch the application.

Initiating a ‘First Run’
Due to further limitations with Citrix environments, and as the solution makes use of .net and WPF technologies, the application must be run at least once, by an administrator, on the server. To do this, launch and sign in to the GDS to be used. Double click the c:\navitas\expediagdsintegrator\expediagdsintegrator.exe file so that it is compiled and launches. Once the interface has appeared on screen it can be closed.

Adding a Toolbar Button - Amadeus users

A request needs to be sent through to your Amadeus Account Manager to request a button be added on to the Selling Platform to launch the application. The below text can be sent to your account manager :

For ‘normal’ individual workstations:

<ScriptFolder wcfgIndex="Navitas Scripts">
    <Title>Navitas Scripts</Title>
     <Position>50</Position>
     <ScriptFolderItem wcfgIndex="ExpediaIntegrator">
         <Position>4</Position>
         <Tooltip>Expedia Integrator</Tooltip>
         <IconURL>http://www.navitasonline.co.uk/ClickOnce/Images/ExpediaIntegrator.png</IconURL>
         <IconDisabledURL>http://www.navitasonline.co.uk/ClickOnce/Images/ExpediaIntegratorBW.png</IconDisabledURL>
         <Script wcfgIndex="ExpediaIntegrator" ScriptMustNotifyCompletion="0">
             <ScriptEXE>
                 <Path>rundll32.exe dfshim.dll,ShOpenVerbShortcut</Path>
                 <Params>c:/Navitas/Expedia GDS Integrator.appref-ms </Params>
             </ScriptEXE>
         </Script>
     </ScriptFolderItem>
</ScriptFolder>

For ‘Citrix’ or ‘Terminal Server’ environments:
NOTE: please adjust the URI information in the <Path> section if you chose to deploy the application to a different directory

<ScriptFolder wcfgIndex="Navitas Scripts">
    <Title>Navitas Scripts</Title>
     <Position>50</Position>
     <ScriptFolderItem wcfgIndex="ExpediaIntegrator">
         <Position>4</Position>
         <Tooltip>Expedia Integrator</Tooltip>
         <IconURL>http://www.navitasonline.co.uk/ClickOnce/Images/ExpediaIntegrator.png</IconURL>
         <IconDisabledURL>http://www.navitasonline.co.uk/ClickOnce/Images/ExpediaIntegratorBW.png</IconDisabledURL>
         <Script wcfgIndex="ExpediaIntegrator" ScriptMustNotifyCompletion="0">
             <ScriptEXE>
                 <Path>c:/Navitas/ExpediaGDSIntegrator/ExpediaGDSIntegrator.exe</Path>
             </ScriptEXE>
         </Script>
     </ScriptFolderItem>
</ScriptFolder>

Adding a Toolbar Button - Sabre users

To add a toolbar to Sabre Red for launching the Expedia Integrator, follow the steps below:

Select, Tools -> Agency Applications -> Configure Agency Applications.
On the Options screen, click the 'Add' button.
To configure the Name and Path of the file use the following:
Name:
Expedia Integrator
Path:
(normal worksation) c:\navitas\Expedia GDS Integrator.appref-ms
(citrix / terminal services) c:\navitas\ExpediaGDSIntegrator\ExpediaGDSIntegrator.exe

NOTE: In most cases you won’t be able to use the ‘Browse’ button as this will attempt to point directly to the current version of application and not to the appref-ms file itself. So typing in the path manually is recommended.

Adding a Toolbar Button - Travelport (Galileo/Apollo) users

When using the normal Workstation install, the Travelport toolbar button is automatically created, however for Citrix or Terminal Services environments this needs to be done manually.

NOTE : Before undertaking the steps below, ensure no user is running Galileo Desktop or Smartpoint otherwise the changes made will be overwritten when these applications are next closed.

Navigate to the Application icon using a web browser http://www.navitasonline.co.uk/clickonce/images/btnNavitasEGI.bmp once the icon is displayed, right click and select Save As and save a copy of the file into the c:\fp\swdir\content\toolbar artwork directory on the server.
Copy and paste the following XML snippet into each users Focalpoint toolbar configuration file (the location of this file depends on the agencies individual configuration, but is called focalpoint.config.xml and would normally be stored in the c:\fp\datadir\users\{username} directory).

NOTE : When opening the file, scroll to the end to find the closing </Buttons> XML tag, this text should be pasted in just BEFORE this tag.

<Button>
        <Picture><![CDATA[{{ARTWORKDIR}}\\btnNavitasEGI.bmp]]></Picture>
        <Transparent>Y</Transparent>
        <ActionType>E</ActionType>
        <Action><![CDATA[C:\Navitas\ExpediaGDSIntegrator\ExpediaGDSIntegrator.exe]]></Action>
        <Argument><![CDATA[]]></Argument>
        <ToolTip><![CDATA[Expedia Integrator]]></ToolTip>
</Button>

Save the file and the user can now restart Galileo Desktop and see the new toolbar icon allowing then access to the software.

Previous Lesson: Regular Expressions Table of Contents Next Lesson: Navitas Expedia Integrator - User Guide