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

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 the JAR file sapjco3.jar. On Windows, it also requires sapjco3.dll. On UNIX, it also requires libsapjco3.so. SAP JCo JAR files can be found at Connectors under SAP Java Connector. See Importing JDBC drivers for the procedure and required permissions to upload the JAR file to Cloud Pak for Data.

SNC support is enabled by downloading the SAP cryptographic library. Copy the library (libsapcrypto.so) and the command-line tool (sapgenpse) to a local directory.

Create a connection to SAP IDoc

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

  • JAR files
  • Application server
  • System number
  • SAP router
  • SAP username and password (or X.509 certificate)
  • Client number

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

  • Message server
  • Group
  • System number or id

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

  • SNC name (Optional)

  • SNC partner name

  • SNC QOP (Quality of protection):

    • 1: authentication only
    • 2: integrity protection
    • 3: integrity and authentication
    • 8: default
    • 9: maximum

    By default QOP is set to 3.

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 > Data access tools > Connection. See Adding a connection to a project.

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

In a deployment space
Click Add to space > Connection. See Adding connections 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

The SAP IDoc connection cannot be created in a FIPS environment.

Catalogs

  • Platform assets catalog

Parent topic: Supported connections