Context

The main purpose of this document is for leveraging the new feature i.e., IDOC_AAE (Java stack IDOC adapter) introduced in SAP PI 7.3 where as ABAP stack IDOC adapter was used till PI 7.11 version.This document will be useful who want to go with single stack from PI 7.3/PI 7.31 (AEX) and connect with SAP ECC using IDOC adapter, even dual stack (ABAP+Java) can use this IDOC_AAE adapter to connect to SAP apart from ABAP stack IDOC adapter.

Audience

SAP PI consultants, who are new to PI 7.3/7.31/AEX, want to leverage the IDOC_AAE adapter (Java stack)

Issues

1)Unable to post idoc into ECC from PI(ABAP Stack).

Error:Authorisation issue in sm58.

Solution:S_IDOCCTRL  and B_ALE_RECV roles added by securities team

2) Error in sm58 on posting idoc from ECC(Using Java AAE)

Error: Bean IDOC_INBOUND_ASYNCHRONOUS not found on host

Solution: Please make sure that the user has sufficient authorizations. You need the S_IDOCDEFT (EDI_TCD = “WE30”; ACTVT = “03”) authorization.

3) Problem in port setting (Not mandatory)

The default Sender port field is not mandatory but sometimes if you face issue then go for the below mentioned solution

Solution:Go to NWA

1. Path:Configurations ->infrastructure->application resources
2. Javaidoc resource adapter ->properties tab

Set the default Sender port field of your PI system

4) Authorisation issues

Error : No RFC authorization for function module IDOCTYPE_READ_COMPLETE.

Solution: You need to give to Service User, the right roles and authorization object to execute RFC function

Contents of the blog

Introduction.

a)Configurations in NWA.

b)Configurations at the Sender System (SAP ECC).

c)Design the Scenario in the Enterprise Service Repository.

d)Configure the Scenario in Integration Directory.

e)Testing the scenario.

Introduction

The purpose of this document is to show all the steps needed to configure an IDoc_AAE to file scenario

This document will help SAP PI consultants to understand the ALE (Application Link Enabling) and NWA settings needed to complete this scenario.

Systems involved in developing the scenario

·         Sender system : SAP ECC (SAPDEV_100) Client No -100

·         PI system : SAP NETWEAVER PI 7.3 (PIDEV_100) ) Client No-100

·         Receiver : Local File Directory (NFS)

Brief Overview of Configurations

a) Configurations in NWA

1)      Settings in Application Resources

2)      Create JCO RFC Provider destination

b) Configurations at the Sender System (SAP ECC)

1)      Create RFC Destination

2)      Create Port

3)      Create Logical System

4)      Create Partner Profile

c) Design the Scenario in the Enterprise Service Repository  

1)      Import the Required IDoc from Sender SAP ECC System

2)      Create Data Type for File structure

3)      Create Message Type for DataType

4)      Create Service Interface

5)      Create Message Mapping doing simple one to one mapping

6)      Create Operation Mapping

d) Configure the Scenario in Integration Directory

1)      Assign Business System for sender ECC

2)      Create Configuration Scenario

3)      Create Receiver Business component

4)      Create Sender Communication Channel

5)      Create Receiver Communication Channel

6)      Create Integrated Configuration

e) Testing the scenario

1)      Trigger the IDoc from ECC

2)      Check the triggered idoc message in PI Adapter engine in RWB

3)      Check whether the Message is received in your file system.

Detailed description of the steps

a) Configurations in NWA

Open NWA page

1) In NWA navigate  to the below path:

     Configuration –> Infrastructure —-> Application Resources

Enter “inboundRA”  in the Resource Name and click on filter icon

Select Resource Adapter, inboundRA

Click on “Properties”

Enter a value for “MaxReaderThreadCount”  between 5 to 10

Enter “true” for Local

XI_IDOC_DEFAULT_PIDEV,PIDEV refers to the PI system ID.

The ProgramID visible here, XI_IDOC_DEFAULT_ PIDEV, must be used when creating the RFC destination of type T on the ECC system

2) Create JCO RFC Provider destination

In NWA navigate  to the below path:

Configuration –>Infrastructure –>JCO RFC Provider

Create JCO RFC Provider destination with name XI_IDOC_DEFAULT_ PIDEV  in NWA where PIDEV refers to the PI System ID.

Enter Gateway host and gateway service of your PI system.

b)Configurations at the Sender System (SAP ECC)

This section describes all the configurations needed in the Sender SAP System (ECC) for sending an IDoc to PI

1. Create RFC Destination

On your SAP ECC system in order to send the IDOCs you need to create an RFC destination of type T (TCP/IP)

Go to Transaction SM59 create a new RFC destination of Type T

1.         1.    Select the radio button Registered Server Program

2.      In the program ID enter the program ID from inboundRA of NWA(explained in the later part of the document)

3.      Enter  the gateway host and gateway service of your PI  server

In PIDEVCLNT100_AAE  and  XI_IDOC_DEFAULT_PIDEV , PIDEV refers to the PI system ID.

Scroll down and fill the following details

Enter Gateway host and gateway service of your PI system.

After you configure that you should be able to check the configuration using the test connection button on the RFC destination.

2. Create Port

Goto Transaction WE21

1.      Click on the Transactional RFC from Ports (left tree panel)

2.      Click on Create Button

3.      Give Port Name(SAP<SID>)here or select generate port name and click on continue. In my example I have given as SAPPIDEV _AAE(PIDEV is PI System Id and _AAE for better understanding)

4.      Give the description of the port and select RFC destination of type T created above. Now click on save.

3. Create Logical System

Goto Transaction BD54

1.      Click on create Button

2.      Give name for your Logical System PIDEVCLNT100( <SID>CLNT<ClintNo.>)where PIDEV  is PI System ID and  100 is client  Number .

3.      Now click on save

4. Create Partner Profile

Create Partner Profile with outbound parameter (WE20) to be send to the PI receiver system

1.      Go to Transaction WE20

2.      Select Partner Type LS

3.      Click on Create Button

4.      Give Logical System Name which we have just created in step 3 as Partner No, Partner Type should be LS , Agent (some valid data) ,Language (EN). Now click on Save

5.      Now create an Outbound Parameter.

• Select the required Message Type.
• Select the Receiver Port (which we have created in step 2 SAPPIDEV _AAE in this example).
• Select Transfer IDoc Immediately option in Output mode for Immediate Testing. Select Basic Type Save.
• Enter all credentials in the post processing permitted agent tab.

   

We can see Message Type is added in the outbound parameter.

c) Design the Scenario in the Enterprise Service Repository  

1) Import the Required IDoc from Sender SAP ECC System

2) Create Data Type for File structure

3) Create Message Type for DataType

4) Create Inbound Service Interface for File

5) Create Message Mapping doing simple one to one mapping

6) Create Operation Mapping

d)Configure the Scenario in Integration Directory

Prerequisites

1)Assign Business System for sender ECC

2)Create Configuration Scenario

3)Create Receiver Business component

4)Create Sender Communication Channel using IDOC_AAE adapter

Select Default(recommmended) in RFC Server Parameters

The Ack Destination can be left blank or the value given as above

5)Create Receiver Communication Channel

6)Create Integrated Configuration

Select appropriate sender and receiver components, channels in different tabs of integrated configuration.

e)Testing the scenario

1)Trigger the Idoc from ECC system.

• Enter the tcode we19 to trigger the idoc
• Search with message type  of idoc(ORDRSP) that you want to trigger, and then select the idoc type (ORDERS05)
•   We will get Idoc with all its segments
• Click on the control segment that is EDIDC in this idoc and fill all the sender and receiver details like Port,Partner No and partner type.
• Then select any other data segment and populate values in the idoc
• We will get a message as IDoc sent to SAP system or external program
• After entering values click on the tab standard outbound processing on the top to trigger the idoc.

2) Check the triggered idoc message in PI Adapter engine

     Navigate to Runtime work bench

     Go to Message Monitoring Link, Select Adapter Engine from the combo box Messages from component and click on display button

    You can see the message here with success status

3) Check whether the Message is received in your file system.

     Since we have selected NFS in our channel, we check it in al11 tcode in PI system.

     Go to the target directory that you specified in your channel. You can find your file being placed there.