configuring java idoc adapter (idoc aae) in process integration - … · 2017. 2. 23. ·...

31
Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration Author : Syed Umar Company : SAP Labs India Pvt.Ltd

Upload: others

Post on 24-Aug-2021

16 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) inProcess Integration

Author : Syed UmarCompany : SAP Labs India Pvt.Ltd

Page 2: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

2

TABLE OF CONTENTS

INTRODUCTION ......................................................................................................................................... 3Preparation................................................................................................................................................. 3CONFIGURATION REQUIRED FOR SENDER CHANNEL WITH IDOC_AAE ADAPTER TYPE ................. 41. Default (recommended) option in sender communication channel. ........................................ 4a. Creating Default Destination in NWA of the PI System .................................................................. 4b. Create RFC destination in NWA for Backend System (Optional) ................................................... 7c. Configuring the resource adapter inboundRA. ............................................................................... 7d. Sender Communication Channel with IDoc_AAE Adapter type. ..................................................... 9e. Configuring RFC Destination in Sender R/3 system. ..................................................................... 92. Manual Option in sender communication channel ..................................................................10a. Sender Communication channel with IDoc_AAE Adapter type and Manual Option. ......................10b. Configuring RFC Destination in sender R/3 system. .....................................................................113. From NWA option in sender communication channel .............................................................12a. Create Custom Resource adapter. ...............................................................................................12b. RFC destination in Sender ERP system. ......................................................................................14

CONFIGURATION REQUIRED FOR RECEIVER CHANNEL WITH IDOC_AAE ADAPTER TYPE .............141. Default (Recommended) option in receiver communication channel .....................................14a. RFC destination in NWA ..............................................................................................................14b. Communication channel with IDoc_AAE Adapter type and Default Option. ...................................142. Manual option in receiver communication channel. ................................................................15a. Communication channel with IDoc_AAE Adapter type and Manual Option. ..................................153. From NWA option in receiver communication channel. ..........................................................16a. JCA Connection Factory in NWA. ................................................................................................16b. Communication channel with IDoc_AAE Adapter type and From NWA Option..............................18

TESTING END TO END CONFIGURATIONS WITH IDOC ADAPTERS .....................................................191. Testing IDoc to File scenario with sender adapter in Default (Recommended) Option..........192. Testing IDoc to File scenario with sender adapter in Manual Option......................................203. Testing IDoc to File scenario with sender adapter in From NWA Option................................214. Testing File to IDoc scenario with receiver adapter in Default (Recommend) Option. ...........215. Testing File to IDoc scenario with receiver adapter in Manual Option....................................23METADATA REFRESH AND IDOC MESSAGE MONITOR IN NWA. .........................................................26CHOOSING RFC SERVER PARAMETER OPTION IN IDOC_AAE ADAPTER ..........................................28RELATED CONTENT .................................................................................................................................30

Page 3: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

3

This guide helps to understand the configurations required for IDoc scenarios with IDoc_AAE adaptertype in PI 7.3/ 7.31 involving advanced adapter engine.

Unlike other type of adapters, the Java IDoc adapter has dependencies on configurations in backend SAPsystems and configurations in NWA apart from the configurations which have been maintained incommunication channel with Adapter type IDoc_AAE.

INTRODUCTIONThe new IDoc Adapter IDoc_AAE is part of the advanced adapter engine and is a java implementation whichdoes not use ABAP services.

The configuration for IDoc_AAE adapter is different when compared to the IDoc Adapter (ABAP Stack).

For configurations related IDoc Adapter in PI Dual Stack refer how-to guide How to Configure IDoc Adapters(NW7.0).

However this current document provides the details about the configurations required for using Java IDocAdapter (IDoc_AAE) and other important settings like creation of destinations, configuration of resourceadapter in NWA which are required for IDoc related scenarios.

The three different modes which are available for configuring communication channels with the IDoc_AAEAdapter type are:

1. Default (recommended)2. Manual3. From NWA

Note: The configurations shown here are from swing client and similar options are available if configurationsare done via NWDS. In dual stack installation we can use either IDoc or IDoc_AAE adapters.

The additional configurations in R/3 system related to creation of Partner Profiles (WE20), Ports (WE21) willnot be discussed in detail as part of this guide.

The configuration steps for each mode (Default, Manual and From NWA) in case of Sender and ReceiverIDoc channels are mentioned separately below.

Preparation

The developer should have necessary permissions to log-on to PI system, SOA Monitor and ConfigureDestination and Resource adapters in NWA.

Required Business systems need to be imported in Integration directory of PI from SLD.

Page 4: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

4

CONFIGURATION REQUIRED FOR SENDER CHANNEL WITH IDOC_AAE ADAPTER TYPE

The goal of the sender configuration is to establish a technical connection from the R/3 system to the PIsystem for sending the IDOCs from the former into the latter. The connectivity is established using RFCtechnology. There are different RFC connections that are maintained on PI and the R/3 system.

The PI system receiving the IDOC needs to query the sending R/3 system to understand the structureof the received IDOC. An RFC connection is created for this purpose on the PI system.

The same RFC connection can also be used by the PI system to post IDOC acknowledgementmessages to the R/3 system once the IDOC has been successfully processed or when errors areencountered by PI.

The PI system registers a Program ID with a web application server gateway to receive RFC callsfrom the R/3 system. The gateway chosen is typically that of the PI web application server but canalso be that of the R/3 system.

Finally a RFC destination is created in the R/3 system. This destination allows the IDOC layer in theR/3 to call the program ID that is registered on the RFC gateway either on the PI system or the R/3system. The RFC destination in the R/3 system is referenced in the IDOC port configurations.

1. Default (recommended) option in sender communication channel.

The default setting is recommended as the configuration is simplified by using a central configuration inthe NWA. A single resource adapter is shared between all the sender channels of this option. The detailsare explained in the following sections.

A RFC destination is maintained in the PI system with details of the R/3 system to query the IDOCstructure. This connection is created in the section ‘1.a’ below. The destination maintenance stepenables the IDOC adapter to create a RFC connection internally for metadata query of the IDOCstructure. To support multiple ERP systems the parameter named MultiRepository is used.

The same RFC destination can also be used by the PI system to post IDOC acknowledgementmessages to the R/3 system once the IDOC has been successfully processed or when errors areencountered by PI. However if needed a different destination can be maintained. The creation ofthis destination is outlined in section ‘1.b’.

The registration of the Program ID by the PI system into the RFC gateway is achieved by configuringinboundRA resource adapter in the NWA. This step is outlined in section ‘1.c’

The creation of the RFC destination in the R/3 system is described in section ‘1.e’

a. Creating Default Destination in NWA of the PI System

The destination is used by the sender communication channel to retrieve the metadata for the IDoctypes that are processed on the communication channel. The destination must point to a SAP webapplication server (e.g ERP) that contains the IDOC definition.

Open NWA (http://<host>:<port>/nwa) Configuration Infrastructure Destination.

Page 5: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

5

Click on Create button to create a new Destination.

Enter the Destination Name (XI_IDOC_DEFAULT_DESTINATION) and select destination type asRFC.

Page 6: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

6

Enter ERP system details below.

Enter the log-on Credentials and click finish.

Once completed, the destination will be added in the available list of destinations. Select this newlyadded destination and click on Ping Destination button to check if connection is successful.

Results will be displayed on top of the page.

Page 7: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

7

In case of errors in Ping Destination, check the system and logon details which has beenprovided while creation of destination.

b. Create RFC destination in NWA for Backend System (Optional)

RFC Destinations can be created with the below name for metadata read.

XI_IDOC_DEFAULT_DESTINATION_<SID>.

The above destination can also be used for sending acknowledgements but this needs to beexplicitly defined in the channel. Separate RFC Destinations need to be created for each R/3system.

Separate RFC destination can also be created for sending acknowledgements in this casenaming pattern is not mandatory.

Note: If this is not set the default destination of inboundRA XI_IDOC_DEFAULT_DESTINATION isused for metadata of any idoc messages from the R/3 system.

c. Configuring the resource adapter inboundRA.

This configuration is a one-time activity on the PI system. The step is initially executed during theinstallation process when the CTC template JIDOC is executed. If not configured during the timeof installation, it will have to be configured later.

Open NWA (http ://< host> :< port>/nwa) Configuration Infrastructure Applicationresources.

Select Resource Adapters from show drop down list.

Page 8: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

8

Filter for inboundRA in the list. The resource of the name inboundRA must already exist ifthe CTC template is executed during installation.

Then Click Properties tab and enter the details as shown in screenshot below. (If certainproperty is not shown in the list, it can be added from Add New Property option available).

- Set the value of the Program ID field as XI_IDOC_DEFAULT_<SID> where SID is system ID.Note: This is the same program id which will be used to create RFC destination (TCP/IP) in ERPsystem as described in step ‘e’.Note : Program ID can be arbitrary but must be unique name for the used gateway

- Set MaxReaderThreadCount value between 5 – 10 (Default value is 10)- Destination Name as XI_IDOC_DEFAULT_DESTINATION- Set Local as true.- Set BindingKey as PI_AAE_IDOC- Save changes.

Note : If Local is set to false then default Gateway server and Gateway service of PI systemneed to be provided while configuring inboundRA.

Page 9: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

9

d. Sender Communication Channel with IDoc_AAE Adapter type.

Create a communication channel in Integration Directory (In this guide it is IDoc_AAE_Default) asshown below.

(Note: The required business systems should be already imported into integration directory fromSLD)

- Select Adapter Type as IDoc_AAE- Select Default (Recommended) option in RFC Server Parameters.

Note: Maintaining Ack Destination is not mandatory. Refer SAP Note 1826256 for further details.

e. Configuring RFC Destination in Sender R/3 system.

Create RFC Destination of type T in sender R/3 system (In this guide it is P73_AAE) and in technicalsettings tab select registered server program.

Same details need to be provided for Program ID, Gateway Host and Gateway service in RFCDestination which was added earlier while configuration of inboundRA resource adapter in section‘1.c’ above.

Page 10: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

10

Click on connection test to ensure connection is successful with the details specified in RFCDestination.

2. Manual Option in sender communication channel

In the manual mode, all the configuration parameters are provided in the channel itself. Sendercommunication channel with Manual option can be used for test purpose. In case of Manual optionwe have no control of the gateway.

The parameters to create a RFC connection to retrieve the IDOC structure are already available in thechannel configuration. The same RFC connection can also be used by the PI system to post IDOCacknowledgement messages to the R/3 system once the IDOC has been successfully processed orwhen errors are encountered by PI.

Similarly, the registration of the Program ID by the sender channel into the RFC gateway of the R/3system is implicitly performed. Here a distinct gateway name cannot be specified in the channel.

The creation of the RFC destination in the R/3 system is described in step ‘b’.

a. Sender Communication channel with IDoc_AAE Adapter type and Manual Option.

Create Sender Communication channel (in this guide it is IDoc_AAE_Sender_Manual) in Integrationdirectory

Select Adapter Type IDoc_AAE and select RFC Server Parameters as Manual.

Page 11: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

11

Provide unique Program ID (in our case it is SAP_XI_MANUAL_TEST) as shown in belowscreen shot. This Program ID will be used later while configuring RFC Destination in senderR/3 system.

System details of R/3 system with valid user id and password need to be provided in channel sothat the Program ID is registered in R/3.

b. Configuring RFC Destination in sender R/3 system.

Create RFC of Type T in sender R/3 system (Tcode sm59) and provide the details as shownbelow in Technical settings tab. (In this guide it is P73_AAE_MANUAL)

Program ID name should be the same which has been mentioned in the sendercommunication channel (IDoc_AAE_Sender_Manual).

Maintain Gateway host and Gateway service of R/3 system where Program ID has beenregistered.

Save and Click on Connection Test to ensure RFC Destination is working fine without anyissues.

Page 12: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

12

3. From NWA option in sender communication channel

The mode is very similar to the default mode and offers convenience of a central configuration in theNWA. A resource adapter configuration is created manually and is shared between all the senderchannels sharing the same resource adapter name. The details are explained in the following sections.

Custom Resource adapter is created as in step ‘a’ below. This adapter can be specified in sendercommunication channel to receive IDoc from R/3.

RFC destination need to be created in the R/3 system.

a. Create Custom Resource adapter.

Create a custom resource adapter in NWA

Go to NWA -> Configuration -> Infrastructure -> Application Resources.

Click Button Create New Resource -> Select New Resource Adapter –

Page 13: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

13

Select Template as ‘com.sap.aii.adapter.idoc.raclonetemplateRAR’ & Enter a name for Applicationand click Next

Enter JNDI Name example ERPCLNT800_RA

Press Next Again -> Enter JNDI Name again and press Tab for save button to activate and Press Save.Now a NWA Resource Adapter is created.

Now in the properties tab for newly created resource adapter enter the Program ID(Example :SAP_ERP_NWA) which will be used in RFC Destination in R/3 system, and other details likeserver,client,logon details etc. Do not change the binding key value which is PI_AAE_IDOC.

Create an RFC Destination in R/3 system as done earlier of type ‚‘T‘ and enter the ProgramID(SAP_ERP_NWA) which has been mentioned in properties on Resource Adapter ERPCLNT800_RA

Create a communication channel (In this guide it is IDoc_AAE_NWA) in Integration Directoryas per below screen shot.

- Select Adapter type IDoc_AAE.

- Select RFC Server Parameters as From NWA and provide the Resource Adapter Name asERPCLNT800_RA.

If required separate Java IDoc communication channels can be created for each customer interfacescenario which is using one central NWA configuration .

Page 14: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

14

b. RFC destination in Sender ERP system.

Create RFC destination in Sender R/3 system as done in section 1.e for Default Mode in SenderIDoc Adapter. Enter the Program ID(SAP_ERP_NWA) which has been mentioned in properties ofResource Adapter ERPCLNT800_RA

CONFIGURATION REQUIRED FOR RECEIVER CHANNEL WITH IDOC_AAE ADAPTER TYPE

The objective of the receiver channel configuration is to establish a technical connection from the PIsystem to the R/3 system for sending the IDOCs from the former into the latter. The connectivity isestablished using RFC technology. Single RFC connection needs to be created on PI system. Thefollowing options are available.

The PI system can be configured with a RFC destination to specify the content of the RFC connectionparameters. The PI channel can refer to the RFC destination in the NWA.

The RFC connection parameters can be directly maintained in the PI channel.

A new java connection factory is created and the required parameters of the RFC destination aremaintained in the connection factory. The connection factory is then referenced in the PI channel.

Note: The Java IDOC Receiver Adapter is a bit more strict when checking the syntax of the IDOCXML. For “BEGIN” and “SEGMENT” fields of the IDOC XML and the adapter expects the constantvalue “1” .

1. Default (Recommended) option in receiver communication channel

a. RFC destination in NWA

Create RFC destination in NWA as defined in step 1.b with target R/3 system details in our caseits XI_IDOC_DEFAULT_DESTINATION_ERP (Separate RFC Destinations need to be createdfor each R/3 system if not already done).

b. Communication channel with IDoc_AAE Adapter type and Default Option.

Create Receiver Communication channel (In this guide it is IDoc_Receiver_Default) inIntegration Directory with below details.

Page 15: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

15

Adapter type IDoc_AAE. Select Default (Recommended) option in RFC Client Parameters. Provide the RFC Destination created in NWA for Destination section in RFC Client

Parameters. (In our case it is XI_IDOC_DEFAULT_DESTINATION_ERP).

2. Manual option in receiver communication channel.

a. Communication channel with IDoc_AAE Adapter type and Manual Option.

Create a receiver communication channel (In this guide it is IDoc_Receiver_Manual) inIntegration Directory with IDoc_AAE Adapter type and enter the details as show in screen shotbelow.

Select Manual in RFC Client parameters section. Enter the details for client, user name, pwd, and server name and system number of

receiver R/3 system.

Page 16: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

16

3. From NWA option in receiver communication channel.

a. JCA Connection Factory in NWA.

Create JCA Connection factory in NWA which will be used in channel configuration for NWAMode.

Open NWA (http://<host>:<port>/nwa) Configuration Infrastructure ApplicationResources.

From the drop down list select JCA Resources and filter for outboundRA.

Page 17: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

17

In Related JCA Connection Factories tab select outboundRA_CF and click on Copy and Add NewJCA Connection Factory.

Provide the JNDI Name which will be used later in Communication channel. Separate connectionfactory to be created for each IDoc receiver system.Naming convention can be used as <SID>CLNT<MANDT>_CF where SID is system ID and MANDTis client number.

Page 18: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

18

Click on Configuration Properties Tab and enter the RFC destination name which has been createdpointing to target R/3 system and click on save.

Note: If property is not visible the DestinationName property can be added by clicking Add NewProperty button.

The created JCA Connection Factory will be available in the list and can be used in communicationchannel.

b. Communication channel with IDoc_AAE Adapter type and From NWA Option.

Create a new receiver communication channel in Integration Directory (In this guide it isIDoc_Receiver_NWA). Select IDoc_AAE as adapter type, From NWA option for RFC ClientParameters and enter the created JCA Connection factory details as shown in below screenshot.

Page 19: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

19

TESTING END TO END CONFIGURATIONS WITH IDOC ADAPTERS

For testing the scenario of IDoc to File using IDoc_AAE adapter type, a Receiver file channel has beencreated and integrated configuration using the sender IDoc channel and Receiver file channel has beencreated.

The same integrated configuration has been used for testing by assigning different IDoc communicationchannels which were created earlier as mentioned in document above.

1. Testing IDoc to File scenario with sender adapter in Default (Recommended) Option.

Create File Receiver channel in Integration Directory and Create integrated configuration with senderchannel IDoc_AAE_Default which was created earlier and Receiver File channel.

Assign the RFC Destination which was created earlier for Default mode (P73_AAE) in section 1.e tothe sender port (WE21) in sender R/3 system.

Trigger the IDoc from tcode WE19 from sender ERP system.

Page 20: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

20

Check the communication channel monitoring for the channel IDoc_AAE_Default, the IDoc detailslike IDoc number will be available in processing details section which has been received by PIsystem.

2. Testing IDoc to File scenario with sender adapter in Manual Option.

Assign the RFC destination which was created for Manual mode earlier (P73_AAE_MANUAL)section 2.b to sender port (tcode we21) in sender R/3 System

Assign the sender channel (IDoc_AAE_Sender_Manual) which was created earlier in integratedconfiguration.

Page 21: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

21

Follow the same testing steps to trigger the IDoc from sender R/3 system via WE19 which was donepreviously for Default Mode.

3. Testing IDoc to File scenario with sender adapter in From NWA Option.

Assign the RFC Destination which has been created earlier in section 1.b for the sender port (WE21)in sender R/3 system.

Assign the Sender channel (IDoc_AAE_NWA) created earlier for sender communication channel inintegrated configuration.

Follow the steps for trigger the IDoc via WE19 tcode from sender R/3 system as done before forDefault mode.

4. Testing File to IDoc scenario with receiver adapter in Default (Recommend) Option.

Create a Sender File Channel (File_IDoc_Sender) in Integration Directory, Create integratedconfiguration with sender file channel and IDoc_Receiver_Default (Default Mode which was createdearlier) in Outbound processing tab for receiver channel.

Page 22: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

22

Start the sender communication channel.

Channel monitoring for IDoc_Receiver_Default channel

Page 23: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

23

Check the IDoc status in tcode we05 receiver R/3 System.

Inbound IDoc has been received at target system. However additional data need to be maintained intarget system for successful IDoc processing.

5. Testing File to IDoc scenario with receiver adapter in Manual Option.

Change the Receiver channel in integrated configuration to IDoc_Receiver_Manual which wascreated earlier.

Page 24: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

24

Start the Sender File communication channel.

Communication channel monitoring for IDoc_Receiver_Manual channel.

Page 25: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

25

Check the IDoc status in tcode we05 receiver R/3 System.

Inbound IDoc received at target system

Similarly, we can test for communication channel IDoc_Receiver_NWA which has been configured withFrom NWA Option.

Page 26: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

26

METADATA REFRESH AND IDOC MESSAGE MONITOR IN NWA.

Select http://host:port/nwa --> SOA Monitoring PI IDoc Adapter Monitoring.

Select tab message monitor and enter the filter criteria for Inbound or Outbound IDocs.

If any changes have been done in the IDoc structure, IDoc metadata can be reloaded via MetadataMonitor Tab.

Page 27: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

27

Properties of InboundRA resource Adapter

MaxReaderThreadCount : IDoc works on the SAPJRA and JCo 3 model. SAPJRA applicationinstance allows idoc adapter to receive iDoc messages (sender adapter).The number of Readerthreads or parallel server connections registered to the gateway can be configured in the Resourceadapter.The property is called MaxReaderThreadCount. Set MaxReaderThreadCount value between5 – 10, Default value is 10 and is the highest which is recommended to this property.

Local : To improve performance and tie the Lifecycle of gateway with that of Adapter engine it ispossible to use local gateway. There is local gateway available with Adapter engine installation.Forthis you need to set the 'Local' property to true. However if you do this at SAP Backend side too thesame gateway needs to be chosen. In SM59 transaction you have to enter local gateway detailsmanually. If 'Local' property is chosen, the GatewayServer and GatewayService configured ininboundRA has no significance.Also please remember to set Local property to false if you don't wishto use Local gateway.

multiRepository : The miltiRepository property should not be changed manually as it is populatedby the IDoc_AAE adapter. It specifies a list of RFC destinations from the PI system to several SAPsystems that are used to query for IDoc metadata when parsing the received IDoc documents orIDoc document lists to valid IDoc-XML. The property value consists of pairs<SID>=XI_IDOC_DEFAULT_DESTINATION_<SID> separated by “;” where <SID> is the SID nameof the sender system of a started sender channel.

Binding Key : It is binding key used to activate IDoc message listener and constant value‘PI_AAE_IDOC’ has to be maintained for this property.

Page 28: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

28

CHOOSING RFC SERVER PARAMETER OPTION IN IDOC_AAE ADAPTER

Default (Recommended):

Default mode in sender communication channel can be used to receive IDoc from multiple senders.

Channel configuration is simple compared to manual mode as no authentication parameters aremaintained in the channel.

No requirement of the PI Integration Developer Role for administration of the connection details. Andtherefore ideal configuration for long term operational maintenance of the IDOC connection.

Basis administrator role is required for maintenance of the connection parameters. The PI integrationdeveloper testing phase requires pre configuration activities by BASIS Administrator.

Uses logical destination which allow reuse of connection data. Connection can be shared betweenmultiple R/3 systems . However it may not give good isolation as we have multiple R/3 systems arereusing same set of inbound connections.

Ideally to be used with PI Gateway (in InboundRA resource adapter), this reduces the chances ofGateway related issues and reduces the channel start and stop time.

Could lead to monitoring issues as the request processing is not tied to channel lifecycle (serverconnection may be started even when channel is stopped).

Manual:

Quick and easy configuration by the integration developer is enabled. No NWA Administration role isrequired for configuration and is ideal during adhoc development time testing.

Manual option can be used for test purpose.

Operational maintenance of the connection settings on a long term operational lifecycle of theintegration scenarios requires the PI developer role.

Cannot add trace level or log level since the server connections are per ABAB Backend system.

NWA:

NWA Option can be used if there are numerous senders/receivers to be configured

Simple Configuration. No maintenance of authentication parameters in the channel.

Flexible, can be used for error tracking as separate RAs can be created per incoming servers (tracelevel and server connections can be increased).

Page 29: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

29

Could lead to monitoring issues as the request processing is not tied to channel lifecycle (serverconnection may be started even when channel is stopped).

NWA option can be used for communication with Non-SAP systems using Java IDoc_AAE adaptertype.

Page 30: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration

30

RELATED CONTENT

SAP Help Portal : Configuring IDoc Adapter (AAE) in the Integration Builder

SAP Help Portal : Comparison of IDoc Adapter (IE) and IDoc Adapter (AAE)

Wiki Link : Troubleshooting common errors with IDoc_AAE Adapter configurations

SAP Note references :

Note Details1826256 ACK destination not available1719180 Handling of multiple acknowledgements1729575 Sending IDoc acknowledgements fails because of long text1688780 IDoc AAE Adapter fails to insert empty strings in database1795609 Multiple idoc types in single queued RFC call1790977 Receiver IDoc_AAE adapter fails with NullPointerException1647147 PI CTC: com.sap.aii.adapter.idoc.sapjra.inboundRA startup1641541 Idoc adapter performance tuning

Page 31: Configuring Java IDoc Adapter (IDoc AAE) in Process Integration - … · 2017. 2. 23. · Configuring JavaIDoc Adapter (IDoc_AAE) in Process Integration 8 Filter for inboundRA in

© 2013 SAP AG. All rights reserved.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, SAP HANA, and other SAPproducts and services mentioned herein as well as their respectivelogos are trademarks or registered trademarks of SAP AG in Germanyand other countries.

Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, andother Business Objects products and services mentioned herein aswell as their respective logos are trademarks or registered trademarksof Business Objects Software Ltd. Business Objects is an SAPcompany.

Sybase and Adaptive Server, iAnywhere, Sybase 365, SQLAnywhere, and other Sybase products and services mentioned hereinas well as their respective logos are trademarks or registeredtrademarks of Sybase Inc. Sybase is an SAP company.

Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services areregistered trademarks of Crossgate AG in Germany and othercountries. Crossgate is an SAP company.

All other product and service names mentioned are the trademarks oftheir respective companies. Data contained in this document servesinformational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materialsare provided by SAP AG and its affiliated companies ("SAP Group")for informational purposes only, without representation or warranty ofany kind, and SAP Group shall not be liable for errors or omissionswith respect to the materials. The only warranties for SAP Groupproducts and services are those that are set forth in the expresswarranty statements accompanying such products and services, ifany. Nothing herein should be construed as constituting an additionalwarranty.

www.sap.com