Developing OTDs for Application Adapters

SAP Java IDoc Class Library

The SAP Java IDoc Class Library consists of two parts, the SAP Java Base IDoc Class Library and the SAP Java Connector IDoc Class Library.

The packages of the SAP Java IDoc Class Library include the software as well as documentation. The SAP Java Base IDoc Class Library provides an API which helps navigating, reading, filling, and modifying IDocs. This base package is middleware independent. Creating, sending, and receiving IDocs is middleware dependent.

ProcedureTo Download the SAP Java IDoc Class Library

Like the SAP Java Connector, download the required installation files from SAPNet at http://service.sap.com/connectors/.

  1. Navigate to the following directory to access the SAP Java Connector (SAP JCo) tools and services page:


    SAP NetWeaver > SAP NetWeaver in Detail > Application Platform > Connectivity >
     Connectors > SAP Java Connector > Tools & Services > SAP Java IDOC Class Library

    This page contains links to the SAP Java Connector IDoc Class Library 1.0.6, and the SAP Java Base IDoc Class Library 1.0.3.

  2. Uncompress and extract the archives into the same directory as the SAP Java Connector installation path <sapidocjco-install-path>.

  3. Load <sapidocjco-install-path>/docs/idoc/jco/intro.html into your browser and follow the instructions under the link Installation.


    Note –

    The SAP Java Connector file, JCo version 2.1.6 is not backwards compatible with previous versions, such as 2.1.3. Confirm backwards compatibility issues with SAP before attempting to switch between different JCo versions on different machines.



    Note –

    We recommend only using the directory path when setting your library path, not the directory path and file name.



    Note –

    JCo 2.1.6 does not support mixed case, users may need to convert passwords to upper case for all design time and runtime SAP connection configurations.



    Note –

    You need to copy the JCo JAR file to the \compile\lib\ext folder before deploying and running command line codegen. You also need to copy the JCo JAR file to the c:\Sun\ApplicationServer\lib folder before deploying and running via the Sun Java™ System Application Server Enterprise Edition 8.1.



    Note –

    You also need to copy the sapjco.jar, sapidoc.jar, and sapidocjco.jar files to the c:\bea\weblogic91\samples\domains\wl_server\lib folder before deploying and running via the WebLogic Application Server, version 9.1. When using CommandLineCodegen, please place sapjco.jar in <JavaCAPS6>commandlinecodegen\compile\lib\ext.