SAP IDoc connection

To access your data in SAP IDoc, create a connection asset for it.

Use the SAP IDoc connection to extract data from incoming IDocs. An IDoc is an intermediate document used to exchange data between SAP and external systems. This connection is available for the DataStage service only.

Supported SAP applications

  • SAP ERP 6.0 EHP6, EHP7 & EHP8
  • S/4 HANA 2020, S/4 HANA 2021, S/4 HANA 2022, S/4 HANA 2023

Prerequisites

Install the packaged Remote Function Module on the SAP Application server and configure the SAP user account with the necessary authorizations to execute the job. Install the SAP server components.

Configure the SAP system to identify your Cloud Pak for Data instance as a target for IDocs. Complete partner profile configuration on the connected SAP system. For more information, see Configuring a logical system in SAP.

The SAP IDoc connection requires these JAR files: sapjco3.jar and sapidoc3.jar, which can be found through SAP Market Place.

See Importing JDBC drivers for the procedure and required permissions to upload the JAR file to Cloud Pak for Data. Important: By default, uploading JDBC driver files is disabled and users cannot view the list of JDBC drivers in the web client. An administrator must enable users to upload or view JDBC drivers.

SNC support is enabled by downloading the SAP cryptographic library. To enable SNC configuration, refer to SNC configuration technote.

Create a connection to SAP IDoc

To create the connection asset, you need the following connection details:

  • JAR file - sapjco3.jar & libsapjco3.so, which can be downloaded through the SAP Market Place
  • Application server - Host name or IP address of the SAP server
  • System number - SAP system number
  • SAP router - Consists of IP address and port number that describes the stations of a connection that is required between two hosts. Syntax: (/H/host/S/service/W/pass)
  • SAP username and password (or X.509 certificate) - Username and password that is connected to the SAP server
  • Client number - SAP client number

To create an asset with a Load Balancing connection type, you need the following connection details:

  • Message server - Hot name of the SAP message server
  • Group - Group name of the SAP applications server
  • System number or ID - Name of the SAP system

To create an asset with an SNC connection type, you need the following connection details:

  • SNC name (Optional) - Specifies Client PSE or Certificate name that is generated on the client side (server tier) with respect to a partner server (SAP server).
  • SNC partner name - Specifies Server PSE or Certificate name that is generated on the SAP Server.
  • SNC QOP - Specifies the quality of protection for SNC connection. By default QOP is set to 3. Following are the possible values of this field:
    • 1: authentication only
    • 2: integrity protection
    • 3: integrity and authentication
    • 8: default
    • 9: maximum

For Credentials, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

Choose the method for creating a connection based on where you are in the platform

In a project
Click Assets > New asset > Prepare data > Connect to a data source. See Adding a connection to a project.

In the Platform assets catalog
Click New connection. See Adding platform connections.

In a deployment space
Click Import assets > Data access > Connection. See Adding data assets to a deployment space.

Next step: Add data assets from the connection

Where you can use this connection

You can use the SAP IDoc connection in the following workspaces and tools:

Projects

Federal Information Processing Standards (FIPS) compliance

This connection can be used on a FIPS-enabled cluster (FIPS tolerant); however, it is not FIPS-compliant.

Migration from the traditional DataStage connector

See Migrating connections.

Catalogs

  • Platform assets catalog

Parent topic: Supported connections