Create a New SAP Endpoint

Overview

You can use the Components palette in the Camel editor to add SAP components to a route. But you must also remember to paste the requisite SAP connection configuration data into your Blueprint XML or Spring XML code.

Prerequisites

You must already have created some SAP destination connections and/or server connections, and have exported this configuration to a file of the appropriate type (Blueprint XML or Spring XML). See Export SAP Connection Configuration to a File.

Procedure

To create a new SAP endpoint, perform the following steps:

  1. It is assumed that you already have a Fuse project and a Camel XML file to work with (which could either be in Blueprint XML or Spring XML format).

  2. Open your Camel XML file in the Camel editor. If you have already installed the JBoss Fuse SAP Tool Suite, you should be able to see the SAP components under the Components palette in the Camel editor. The following SAP components are provided by the tool suite:

    • SAP IDoc Destination

    • SAP IDoc List Destination

    • SAP IDoc List Server

    • SAP qRFC Destination

    • SAP Queued IDoc Destination

    • SAP Queued IDoc List Destination

    • SAP sRFC Destination

    • SAP sRFC Server

    • SAP tRFC Destination

    • SAP tRFC Server

    In the Design view of the Camel editor, drag one of these components onto the canvas to create a new SAP endpoint in the current camelContext.

    [Note]Note

    The SAP Netweaver component does not belong to the JBoss Fuse SAP Tool Suite. It is hosted in the Apache Camel project.

  3. Switch to the Source view of the Camel editor, by clicking on the Source tab at the bottom of the canvas. In this view, you can see the XML source of the routes.

  4. Open an exported SAP connection configuration file that you exported earlier (see Export SAP Connection Configuration to a File), making sure that the type of the exported SAP connection configuration file matches the type of your Camel XML file (Blueprint XML or Spring XML).

  5. The SAP connection configuration data is encoded as a bean element, with the id value, sap-configuration. Copy this bean element.

  6. Return to the Source view of the Camel editor. Paste the bean element as a child of the root beans element in the Camel XML file.

  7. You might not need all of the entries in the SAP connection configuration. Delete any unneeded destination connection and server connection entries (entry elements).

    [Note]Note

    Remember that server connections usually also depend on a destination connection (for retrieving meta-data from a remote repository). So, even if you only need a server connection, do not delete all of the destination connection entries.

  8. When specifying an SAP endpoint URI, you must embed either a destination name or a server connection name in the URI format. For example, the sap-srfc-destination component has the following URI format:

    sap-srfc-destination:destinationName:rfcName

    To reference a particular destination, use the value of the relevant entry element's key attribute as the destinationName in this URI.