Published on Bonita Documentation (http://documentation.bonitasoft.

com)
SAP JCo3
Product version:
6.3, 6.2, 6.1
Product edition:
Efficiency
Performance
The SAP Java Connector is a toolkit that allows a Java application to communicate with any
SAP system. It combines an easy to use API with unprecedented flexibility and performance.
The package supports both Java to SAP System and SAP System to Java calls.
Prerequisite
You must have an SAP license and an SAP server to use the connector.
JCo 3
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 BPM 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 libraries folder
sapjcorfc.dll: must be installed in the Windows32 folder
javadoc: contains the .html help pages for installation
examples: contains some examples
How to use the contents of the .zip file
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 shared libraries directory of Bonita BPM, so that the jar is in
the classloader used by the Bonita BPM Engine's.
4.
Put the native sapjco.dll or .so libraries in the java library path or the system path.
How to import the SAP JCo3 library and make a request using an example
function using the graphic display
1.
Click Import SAPjco3.jar, and use the browse dialog box to locate and select one of the
.jar file
2.
Click Open to import the .jar file contents
3.
Click OK to reboot the machine and save the configuration.
4.
When the connector window is displayed, the import .jar file button will have
disappeared. This is replaced by disabled button. A .jar file cannot be imported twice.
5.
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 BPM
Engine.
6.
Once all the fields are filled, test the connection by clicking on the testbutton.
7.
In the function definition window, only the function name is required.
8.
Click on the arrow at the end of the field to display a dropdown list of functions.
9.
Click on GET_SYSTEM_NAME for example
10.
Click Next
11.
This will display the Input Parameters window
12.
Click Next
13.
This will display the Ouput Parameters window
14.
The GET_SYSTEM_NAME is displayed to confirm the input is this function.
15.
Note: You can create a blank .html file on your c: drive, which will be filled with the
output information from the SAP connector
16.
Enter the path to the .html file in the field called "HTML File"
17.
Click Next
18.
This will display a Ouput operations window
19.
Click Finish
In the Bonita Subscription Pack, 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
2014 Bonitasoft, Inc. All rights reserved.