Show TOC

Configuring the IDoc Adapter (Advanced Adapter Engine)Locate this document in the navigation structure

Use

You use this procedure to configure an IDoc adapter (AAE) that transfers information between SAP or non-SAP systems using IDocs (intermediate documents).

Prerequisites

  • You have created an RFC destination with a name XI_IDOC_DEFAULT_DESTINATION, and you have configured it on the adapter engine using the NWA

    Recommendation

    The destination must point to an SAP application system that contains metadata for frequently used IDoc types as the RFC destination.

    More information: Maintaining RFC Destinations

  • You have configured the inboundRA resource adapter and set the following properties using the NWA:

    • MaxReaderThreadCount has a value between 5 and 10 (both inclusive).

    • GatewayServer : The Gateway server that you use for inbound communication in default mode. SAP recommens you to use the gateway server of central PI system.

    • GatewayService : The Gateway service that you use for inbound communication in default mode. SAP recommends you to use the gateway service of central PI system.

      The gateway service should be the service of the gateway used in the property GatewayServer . You must ensure that the sender system sending messages to idoc adapter via a sender channel configured in "Default mode" uses the same GatewayServer and GatewayService .

  • You have configured the JavaIdocAdapter resource adapter and set the following properties using the NWA or using the link Start of the navigation path http:// hostname: port/nwa Next navigation step Configuration Next navigation step Infrastructure Next navigation step Application Resources End of the navigation path, In the Show , select Resource Adapters , in the Resource List table, select JavaIdocAdapter and in the Resource Details table, select Properties .

    • Persistance

      If you want the IDoc information to be persisted in the DB, set the value to true, else set the value to false.

      Note

      • By setting the value to false, monitoring and acknowledgments cannot be monitored.

      • When the value is set to false there is no database operation and hence the IDocs are processed faster.

    • AutoNumberFromDB

      If you want sequential IDoc numbering for the receiver IDoc adapter set the value to true, else set the value to false.

      Note

      • In some cases (DB isolation and locking levels) setting the value to true can result in IDoc number clash, in such cases change the value to false.

      • When the value is set to false there is no extra database operation and hence the IDocs are processed faster.

Note

You can leave all the other properties unchanged.

More information: Configuring Resource Adapters and JCA Connection Factories in NW

Procedure

  1. Configure the sender IDoc adapter (AAE) and the receiver IDoc adapter (AAE) in the Integration Builder.

    More information: Configuring IDoc Adapter (AAE) in the Integration Builder

  2. Configure the sender system to process IDocs.

    More information: Configuring the Sender System to Process IDocs

  3. Configure the receiver system to process IDocs.

    More information: Configuring the Receiver System to Process IDocs

Note

You must activate the configuration scenario and all the entities that are added to it using the activate option in the Integration Builder.

More Information

The characteristics of the IDoc adater (AAE) are discussed in a different topic.

More information: Characteristics of the IDoc Adapter (AAE)