Skip to main content

SAP connector

The SAP connector lets you exchange SAP IDoc (Intermediate Document) business documents between Adeptia and your SAP system, both sending documents to SAP and receiving documents from SAP.

What you can do​

Adeptia supports two directions of SAP IDoc exchange:

DirectionWhat it does
Send to SAPYour integration sends IDoc documents outbound to an SAP system
Receive from SAPAdeptia listens for inbound IDoc documents that SAP pushes to it

What you set up​

To connect Adeptia to SAP, you configure two types of objects: an SAP Client and an SAP Server.

SAP client​

The SAP client defines how Adeptia connects outbound to your SAP system. You provide logon credentials (user name or user alias, and password) and choose a connection type:

Connection typeWhat you provide
Direct connectionApplication server host and system number
Load balancing (group) connectionSAP system ID, message server host, message server port, and logon group

Additional settings you can configure on the client include:

  • A SAP router string, for reaching systems behind a SAP Router
  • Logon language and code page settings
  • Connection pool settings: peak connection limit, pool capacity, connection expiration time, expiration check period, and maximum wait time for a connection
  • Trace and CPIC trace levels
  • Secure Network Communications (SNC): SNC library path, your SNC name, the partner SNC name, the quality-of-protection level, and whether to use SNC single sign-on

SAP server​

The SAP server defines how Adeptia listens for inbound IDoc documents that SAP sends to it. You can activate or deactivate the SAP server. When activated, Adeptia begins accepting IDoc documents from SAP; when deactivated, it stops listening.

IDoc tracking​

Every IDoc document exchanged through the connector is tracked. For outbound documents, Adeptia records the transaction identifier, IDoc type, IDoc extension, sender and receiver details, application release, system release, and the current status of each document. Statuses reflect the lifecycle of the exchange, from initial submission through confirmation or failure.

For inbound documents received from SAP, Adeptia similarly tracks each transaction and its status.

IDoc schema​

When building integrations that involve SAP IDocs, Adeptia can retrieve available IDoc types and IDoc extensions from your SAP system using the configured SAP client, given an application release and system release.