Itinerary Driver

This topic explains how to configure an Itinerary Driver. It continues the procedure started in Adding and Configuring Device Drivers.

Notes:

 

After clicking Next on the first Add Device wizard dialog box (see Adding and Configuring Device Drivers), the next Add Device wizard dialog box for Itinerary Driver configuration appears.

Itinerary driver supports printing PDF, saving PDF, and both printing and saving a PDF file.

Select type

  • In the Choose Type drop-down, select whether to print PDF, save PDF, or print and save PDF.

    • Print PDF

    If a print PDF option is selected, in the Available Printers list, select the Windows printer to use for itinerary printing.

    Note: Alternatively, select Use the Default Printer. If selected, print jobs are sent to the default windows printer instead of the Windows printer configured for the device. If not selected, the configured windows printer is used regardless of any default Windows printer. Note that the Use the Default Printer selection does not work for print jobs generated by using the Test Print button on the GPM.NET Status window.

    Save PDF

    If Save PDF is selected, click the Browse button to choose the directory for the saved file. You can also type the full directory path into the PDF Directory field.

    Notes:

    • Folders are created automatically using the following structure:

      Year -> Month -> Type (Listed Below)

    • Supported types:

      • AGENT

      • PAX_RECEIPT

      • TINS

      • REFUND

      • EMD

      • CC

      • DAILY

      • AUDIT

      • EXCHANGED_TICKET

      • OTHER (in case the document does not match any of the above folders)

    • File naming convention: Type _ Ticket Number _ Record Locator _ Last Name _ First Name.

    Detail and customer examples

    GPM.NET Configuration window provides an option to users to configure Itinerary driver and choose an option to either print the documents (default functionality), save as a PDF, or print and save as a PDF.

    When a user choose to:

    • Print PDF, the Itinerary driver will use a configured printer to print the document.

    • Save PDF, the Itinerary driver will save a supported document in a user specified location and a folder structure will be created as Year -> Month -> Type.

      For example, if user is saving Passenger Receipt on 1st September 2022, GPM.NET will create a folder structure as below:

    • Print and Save PDF, the Itinerary driver will first print the document, and, on successful print only, save the PDF.

    Notes:

    • If the operating system does not have the "Microsoft Print to PDF" feature, the save to PDF functionality cannot be used.

    • Installing the new version of GPM.NET will not change the already configured Itinerary driver and it will be configured as a print only option.

    Additional notes:

    • To write PDF files to a drive (network or hard drive), ensure you have enough space on the drive. MIR files can accumulate and take up excessive amounts of space. For assistance, contact Galileo Print Manager.net Technical Support.

    • To write PDF files to a network drive (for example, \\networkdrive\MIR), ensure you have network access. See Configuring Network Printer Permissions or Printing to a Network Printer in a Workgroup Environment.

    • When sending PDF files to a shared network directory or a file server using Galileo Print Manager.net, both the workstation where the directory (folder) is shared and the workstation where the GPM.NET service is running must have the same user account configured as a local administrator. The GPM.NET service must be started by using this same account. For setup instructions, see Configuring Network Printer Permissions. For further assistance, contact a local Windows computer technician and/or Travelport’s Extended Services desk at 800-935-6634.

    • When a computer uses Workgroups instead of Active Directory, PDFs cannot be processed in the following situations:

      • PDFs cannot be sent to Windows DFS Share by using:

        • UNC name

        • Mapped drive

      • PDFs cannot be sent to Windows SMB Share mapped drive.

      • To resolve this issue, make sure that the computer is connected by using Active Directory.

    After selecting Save PDF on the Add Device wizard dialog box (see Adding and Configuring Device Drivers), the next PDF Directory option to select directory to save PDF appears and Available Printers list is disabled/hidden.

    To specify the path to the directory in which you want PDF files saved, click Browse, and then select the directory.

    Note: Alternatively, type the full directory path in PDF Directory.

    Print and Save PDF

    If Print and Save PDF is selected, both the PDF Directory and Available Printers are available. Refer to the Print PDF and Save PDF sections above.

    Itinerary Settings

    Specify relevant information for the itinerary device in the remaining elements within the Add Device wizard dialog box.

    The following table describes these elements, provides some guidance on changing them, and includes their default settings.

    Element Description Default Setting

    Ignore Line Feed Characters check box

    Indicates whether excessive lines of empty data, caused by carriage-return and line-feed characters, should be trimmed off from the end of the print stream that the host sends. Select this check box to prevent the printer from printing blank pages.

    Not selected

    Lines Per Page

    Maximum number of lines to print per page, starting from the position set by the Top Margin setting. If the host does not send a form feed, the printer will start a new page when the full number of lines set by the Lines Per Page setting is reached. Use this setting to adjust the end of page. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Top Margin, Font Size, and Line Spacing settings to achieve desired results.

    66 (lines)

    Top Margin

    Indicates the vertical size (in lines) of the top margin on the form. Printing will occur starting at and below the line specified by this setting. For example, the default value is one line, which causes the printer to start printing at the first line position from the top side of the form. Use this setting to adjust the top margin closer to the top by decreasing the value or further from the top by increasing the value. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page, Font Size, and Line Spacing settings to achieve desired results.

    1 (lines)

    Left Margin

    Indicates the horizontal size (in character columns) of the left margin on the form. Printing will occur starting at and to the right of the character-sized column specified by this setting. For example, the default value is one character, which causes the printer to start printing at the first character-column position from the left side of the form. Use this setting to adjust the left margin to the left by decreasing the value or to the right by increasing the value. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Font Name and Font Size settings to achieve desired results.

    1 (character columns)

    Characters Per Line

    Maximum number of characters to print per line. If the number of characters in lines of text received from the host exceed this amount, the printer will wrap excess text to the next line. Use this setting to adjust line length. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Font Name, Font Size, and Left Margin settings to achieve desired results.

    80 (characters)

    Line Spacing

    Horizontal size (in points) of the space between rows of printed text. This option provides precision control of the spacing between lines. Use this setting to control line position for pre-printed forms. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page and Top Margin settings to achieve desired results.

    3 (points)

    Font Name

    Name of the font to use for printing. Make sure that the font you specify is a monospaced (fixed-width) font. Each character in a monospaced font occupies the same horizontal space as every other character.

    Note: When changing this setting, take into account the Characters Per Line and Left Margin settings to achieve desired results.

    Courier New

    Font Size

    Size (in points) of the font specified in the Font Name setting. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page, Characters Per Line, Left Margin, and Top Margin settings to achieve desired results.

    12 (points)

    1. Once you have chosen your print settings, click Next.

    2. The final Add Device wizard dialog box appears:

    3. Click Finish.

    Overriding Default Print Settings for Itinerary Drivers

    The Itinerary Driver that you configured for Galileo Print Manager.net comes with a set of pre-defined parameters that control the way your itineraries will print by default. The Driver.config file, which is installed during the Galileo Print Manager.net installation process, enables you to manipulate these parameters to override the default settings. In this way, you can adjust the way itineraries are printed until you get the results that you desire.

    Warning: With the current version of Galileo Print Manager.net, be aware that itinerary printing might not produce the same results as you experienced with previous versions of Galileo Print Manager.net or GPM. Because underlying default settings for itinerary print parameters have changed, it is highly recommended that you thoroughly test itinerary printing and make adjustments to the Driver.config file as appropriate.

    The following table describes these parameters, provides some guidance on changing them, and includes their default settings.

    Itinerary Print Parameter Description Default Setting

    IgnoreLineFeeder

    Indicates whether excessive lines of empty data, caused by carriage-return and line-feed characters, should be trimmed off from the end of the print stream that the host sends. To prevent the printer from printing blank pages, set this parameter to True.

    False

    Lines Per Page

    Maximum number of lines to print per page, starting from the position set by the Top Margin setting. If the host does not send a form feed, the printer will start a new page when the full number of lines set by the Lines Per Page setting is reached. Use this setting to adjust the end of page. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Top Margin, Font Size, and Line Spacing settings to achieve desired results.

    66 (lines)

    Characters Per Line

    Maximum number of characters to print per line. If the number of characters in lines of text received from the host exceed this amount, the printer will wrap excess text to the next line. Use this setting to adjust line length. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Font Name, Font Size, and Left Margin settings to achieve desired results.

    80 (characters)

    Left Margin

    Indicates the horizontal size (in character columns) of the left margin on the form. Printing will occur starting at and to the right of the character-sized column specified by this setting. For example, the default value is one character, which causes the printer to start printing at the first character-column position from the left side of the form. Use this setting to adjust the left margin to the left by decreasing the value or to the right by increasing the value. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Font Name and Font Size settings to achieve desired results.

    1 (character columns)

    Top Margin

    Indicates the vertical size (in lines) of the top margin on the form. Printing will occur starting at and below the line specified by this setting. For example, the default value is one line, which causes the printer to start printing at the first line position from the top side of the form. Use this setting to adjust the top margin closer to the top by decreasing the value or further from the top by increasing the value. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page, Font Size, and Line Spacing settings to achieve desired results.

    1 (lines)

    Font Name

    Name of the font to use for printing. Make sure that the font you specify is a monospaced (fixed-width) font. Each character in a monospaced font occupies the same horizontal space as every other character.

    Note: When changing this setting, take into account the Characters Per Line and Left Margin settings to achieve desired results.

    Courier New

    Font Size

    Size (in points) of the font specified in the Font Name setting. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page, Characters Per Line, Left Margin, and Top Margin settings to achieve desired results.

    12 (points)

    Line Spacing

    Horizontal size (in points) of the space between rows of printed text. This option provides precision control of the spacing between lines. Use this setting to control line position for pre-printed forms. Valid values are 1 to 255. Invalid values are ignored.

    Note: When changing this setting, take into account the Lines Per Page and Top Margin settings to achieve desired results.

    3 (points)

    To change the Driver.config file to override default itinerary print settings, perform the following procedure.

    Note: This procedure assumes that you have already added an Itinerary Printer device driver, as described earlier.

    1. Using Windows Explorer, navigate to C:\Program Files (x86)\Galileo Print Manager.NET.

      Note: The typical full path to the folder containing this file is C:\Program Files (x86)\Galileo Print Manager .NET. If you indicated a different Galileo Print Manager.net installation directory during the installation process, navigate to that directory.

    2. Right-click the Driver.config file, and then select to open it with Windows Notepad (or similar text-editing software).

      The following figure shows the XML code in the Driver.config file. The highlighted lines show the parameters associated with an example "Itinerary Printer 1" device driver.

    3. Manually add any or all of the following lines, as desired, to the Driver.config file.

      <add key="Lines Per Page" value="66" />
      <add key="Characters Per Line" value="80" />
      <add key="Left Margin" value="1" />
      <add key="Top Margin" value="1" />
      <add key="Font Name" value="Courier New" />
      <add key="Font Size" value="12" />
      <add key="Line Spacing" value="3" />

      Your Driver.config file should look similar to the following figure. The values for the added parameters are set to the defaults.

    4. Manually change the default values to reflect the print outcomes you desire.

      Note: Review the table above for guidance on changing these settings.

    5. On the File menu, click Save.

      Note: If you are unable to save changes to the Driver.config file, see Unable to Save Manually Edited Configuration Files in the Galileo Print Manager.net Application Folder.

    6. Restart the GPM.NET service to apply the changes.
      1. Right-click the GPM.NET Service Monitor icon () in the Windows notification area (located on the right side of the Windows taskbar).

      2. A menu appears:

      3. Click Restart.

    7. Send an itinerary to test and review the print output.

    8. Make any necessary adjustments to parameter values in the Driver.config file.
      1. Use Windows Notepad (or similar text-editing software) to make changes.
      2. Save the file.
      3. Restart the GPM.NET service.
      4. Send an itinerary to test and review the print output.
      5. Repeat as necessary.