Chapter 11. Using the JBoss Fuse SAP Tool Suite
Abstract
The JBoss Fuse SAP Tool Suite makes it possible to integrate your Camel routes with a remote SAP Application Server. A variety of SAP components are provided to support Remote Function Calls (RFC) and the sending and receiving of Intermediate Documents (IDocs). Note that the SAP Tool Suite depends on the JCo and IDoc client libraries from SAP. You must have an SAP Service Marketplace Account, in order to install and use these libraries.
11.1. Installing the JBoss Fuse SAP Tool Suite
Overview
The JBoss Fuse SAP Tool Suite provides a SAP Connections view for configuring SAP connections and a collection of SAP components for integrating your Camel routes with an SAP server. The suite is not installed by default, because it requires third-party Jco and IDoc client libraries, which are licensed separately by SAP.
Platform restrictions for SAP tooling
Because the SAP tool suite depends on the third-party JCo 3.0 and IDoc 3.0 libraries, it can only be installed on the platforms that these libraries support. For more details about the platform restrictions for SAP tooling, see Red Hat JBoss Fuse Supported Configurations.
Prerequisites
Before you can install the JBoss Fuse SAP Tool Suite, you must download the requisites JCo and IDoc libraries from the following location:
Please note the following points:
- You will require an SAP Service Marketplace Account to download the JCo and IDoc client archives.
- Choose the appropriate JCo and IDoc libraries for your operating system.
- Only version 3.0.11 or greater of the JCo library is supported.
- Only version 3.0.10 or greater of the IDoc library is supported.
- For this installation procedure, you can leave the downloaded files in archive format. There is no need to extract the contents.
Procedure
To install the JBoss Fuse SAP Tool Suite into JBoss Developer Studio, perform the following steps:
- In JBoss Developer Studio, select
to open the Import wizard. - In the Select screen of the Import wizard, select
, and click Next. - The Install the JBoss Fuse SAP Tool Suite screen opens, which displays the instructions for downloading the JCo and IDoc libraries from the SAP Service Marketplace. Click Next.
- The Select JCo3 and IDoc3 Archive to Import screen opens. Next to the JCo Archive File field, use the Browse button to select the JCo archive that you downloaded from the SAP Service Marketplace. After selecting the JCo archive, the Archive Version and Archive OS Platform fields are automatically filled in, so that you can check whether the library you are installing has the correct version and OS platform.Next to the IDoc3 Archive File field, use the Browse button to select the IDoc archive that you downloaded from the SAP Service Marketplace.After selecting both archive files, click Finish.
- A new Install wizard (for installing Eclipse plug-ins) opens automatically. This wizard displays the following to plug-ins to be installed:
- JBoss Fuse SAP Tool Suite
- SAP JCo3 and IDoc3 Libraries
Make sure that both of these plug-ins are selected. Click Next.NoteThe SAP JCo3 and IDoc3 Libraries plug-in is dynamically constructed from the selected JCo and IDoc libraries. - The Install Details screen allows you to review the plug-ins to be installed. Click Next.
- The Review Licenses dialog opens. Select the I accept radiobutton option, and then click Finish.
- If you encounter a Security Warning dialog (warning of unsigned content), click OK to ignore the warning and continue installing.
- The Restart Eclipse dialog opens. Click OK to restart Eclipse.
