This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

SAP JCo 3 Connector

The Bonita SAP Java Connector 3 allows Bonita to communicate with any SAP system using the SAP JCo 3 toolkit.

Notice

For Enterprise, Performance and Efficiency editions only.

Prerequisite

You must have an SAP license and an SAP server to use the connector.

Overview of the SAP Java Connector (SAP JCo 3) underlying toolkit

  • The SAP JCo3 connector can be used to call a SAP function (BAPI, RFC or ZBAPI).

  • High-performance JNI-based RFC middleware.

  • Supports R/3 3.1H and higher.

  • Supports inbound (Java client calls BAPI or RFM) and outbound (ABAP calls Java server) calls.

  • Supports synchronous, transactional (important for IDocs), and queued RFC.

  • Supports client pooling (good for web servers).

  • Has monitoring capabilities.

Download and install the SAP connector .zip files

To connect to an SAP system from Bonita Studio, and have the correct graphic display, you must install the SAP .dll and .jar files onto your (Windows) machine. You must have an SAP User ID and password to enter the SAP Support Portal to download the files.

Go here (you will need to login first) SAP Service marketplace.

JCo 3: sapjco3-ntamd64-3.0.3

Contents of sapjco-ntamd64-3.0.3.zip

  • Readme.txt: contains instructions

  • sapjco3.jar: must be installed in the /endorsed directory of your Bonita Studio installation and in the webapp libraries directory of the application server.

  • sapjcorfc.dll (sapjcorfc.so): must be installed in the native library search path:

    • Windows: usually the dll file is stored in C:\windows\system32

    • Linux: usually the dll file is stored in /usr/lib

  • javadoc: contains the .html help pages for installation

  • examples: contains some examples

How to use the contents of the .zip file with an application server

  1. Extract the contents of the .zip file into a temporary directory, for example: C:\temp\sapijco3.

  2. Read the installation page provided with the sapjco distribution and follow the instructions.

  3. Put the sapjco3.jar file in the webapp libraries directory of the application server, so that the jar is in the classloader used by the Bonita Engine.

  4. Put the sapjco.dll or .so libraries in the native library search path: C:\windows\system32 for windows, or /usr/lib for Linux.

Studio: How to import the SAP JCo3 library and make a request with an example function using the graphic display

There is below a step by step procedure on Windows. It is assumed that the Studio had been started at least once successfully.

  1. Store the sapjco.dll in the C:\windows\system32 directory

  2. Reboot

  3. Store the sapjco3.jar in the bonita webpapp library directory, deployed in the tomcat embedded with the Studio: e.g. C:\BonitaSubscription-7.6.3\workspace\tomcat\webapps\bonita\WEB-INF\lib

  4. Store the sapjco3.jar in the endorsed directory of your Bonita Studio installation: e.g. C:\BonitaSubscription-7.6.3\endorsed.

  5. Start the Studio

  6. Open a diagram

  7. Select a Service task

  8. Add a SAP JCo 3 connector

  9. Fill in all the connection fields with the correct settings. Note that the SAP JCo 3 connector supports a single destination for all connector instances in Bonita Engine.

  10. Once all the fields are filled, test the connection by clicking on the _test _button.

  11. In the function definition window, only the function name is required.

  12. Click on the arrow at the end of the field to display a dropdown list of functions.

  13. Click on GET_SYSTEM_NAME for example

  14. Click Next

  15. This will display the Input Parameters window

  16. Click Next

  17. This will display the Output Parameters window

  18. The GET_SYSTEM_NAME is displayed to confirm the input is this function. Note: You can create a blank .html file on your c: drive, which will be filled with the output information from the SAP connector

  19. Enter the path to the .html file in the field called "HTML File"

  20. Click Next

  21. This will display an Ouput operations window

  22. Click Finish

Advanced features in Subscription Editions

In the Efficiency, Performance and Enterprise editions, the SAP wizard has advanced features: You do not need to know the names of the functions by heart, as the functions are suggested in a dropdown menu.

  • Filter functions by group: a dropdown list listing all the functions by group

  • Function description: a dropdown list listing all the functions. Auto complete (just type the first letter e.g. G to give a list of Get functions

  • Function name: dropdown list