11.5. 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 Section 11.4, “Export SAP Connection Configuration to a File”.
Procedure
To create a new SAP endpoint, perform the following steps:
- 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).
- 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.NoteThe SAP Netweaver component does not belong to the JBoss Fuse SAP Tool Suite. It is hosted in the Apache Camel project. - 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.
- Open an exported SAP connection configuration file that you exported earlier (see Section 11.4, “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).
- The SAP connection configuration data is encoded as a
bean
element, with theid
value,sap-configuration
. Copy thisbean
element. - Return to the Source view of the Camel editor. Paste the
bean
element as a child of the rootbeans
element in the Camel XML file. - You might not need all of the entries in the SAP connection configuration. Delete any unneeded destination connection and server connection entries (
entry
elements).NoteRemember 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. - 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 relevantentry
element'skey
attribute as thedestinationName
in this URI.