myTourplan

Connections Mapping

What are Supplier / Product connections?

To improve the current mapping functionality of linking suppliers and product to external connections, there is now the option to link a single supplier to multiple external connections. A new ‘connections’ feature shifts from using XML configuration inside Tourplan notes to a more structured and user friendly interface.

Including:

  • New Menu Options ‘Connection’ - Access to external connection mapping is provided through new menu items within the Product/Supplier menus. Making it easier for users to manage and configure mappings.

  • New Connection Interface - Common mapping elements are configured through a user interface rather than in straight XML. However, the system still supports viewing and editing full mapping as an XML document when needed.

  • Validation of XML code - Additional XML mapped elements are validated upon saving and an error message will appear, detailing the line number, position and specific formatting issue if the data is invalid.

  • Supplier and Product linkage - A single supplier can be associated with multiple external systems. Products can be linked to any combination of external systems connected to the supplier.

  • Maintaining Existing Setup - Both the new external connection mapping method and the existing note mapping method are supported concurrently.

    The new connection mapping method takes precedence over existing note mappings; if external mapping information is available in the new structure, it is used.

    If not, the system falls back to the information stored in notes. This precedence rule applies to both suppliers and products.

    Additionally:

    • If a connection is defined using the new method for a supplier, then any mapping in notes for the supplier and its product is ignored.

    • If a new connection type is defined against a master supplier, then any child suppliers are deemed to be using the new method and therefore mapping note are ignored for them.

To add a connection your system will need to have:

  1. Endpoint Definitions Defined

  2. External Service Configuration

  3. Connections Setup and Mapping

Endpoint Definitions

Endpoints define how your NX system connects to external suppliers. Each endpoint definition is tailored to your specific system requirements and the agreements you have with your suppliers.

Warning: Your local Tourplan Support Team will insert and manage the configuration of your Endpoint Definitions. Any change to these fields can make your external service connection unusable.

To view configured Endpoint Definitions

Open System Setup > Code Setup > System > Endpoint Definition.

External Service Configuration

External Service Configurations store configuration elements for your connection, general information such as how the rates will display on screen and login.

Warning: Your local Tourplan Support Team will insert and manage the configuration of your External Service Configuration. Any change to these fields can make your external service connection unusable.

To view an External Service

  1. Open System Setup > Code Setup > System > External Service

  2. Select an External Service.

  3. Tourplan will use the Configuration field information to generate XML for the Connection. Changes made to entries in the Configuration tab will update the Additional tab XML Configuration.

  4. Open the Additional tab to view the XML Configuration.

NOTE: Any changes made to the Additional tab, configuration text will update the relevant field information in the Configuration tab.

Connections

Connections store mapped elements to return external rate information. Mapping elements can be inserted at a Supplier level or at a Product level.

Supplier Connections

Involves setting up mapping elements for the External Service information relevant to the supplier.

Creating a Supplier Connection

  1. Open Supplier > Connections.

  2. Insert a Connection.

  3. Select the External Service.

  4. Enter the required mapping information.

  5. Select the Additional tab to view the XML editor.

NOTE: If more complex mapping is required, that can be entered on the Additional Tab.

Product Connections

Involves setting up mapping elements for External Service Options.

  1. To create a Product Connection.

  2. Open Product > Operations > Connections

  3. Select the External Service.

  4. Enter the required mapping information.

  5. Select the Additional tab to view the XML editor.

NOTE: If more complex mapping is required, that can be entered on the Additional Tab.

Additional Resources

For more detailed guidance on mapping options, refer to the article titled ‘Setup and Mapping Using Connections’.

We have the following resources available to learn more:

Endpoint Definition

External Service

Supplier Connections

Product Connections.