Exercise Objectives
After completing this exercise, you will be able to:
• Configure the Integrated Configuration object based in a Process Integration Scenario.
Business Example
You want to simulate the distribution of material master data. Material master data is created as an XML document in system A and then sent to SAP NetWeaver Process Integration by HTTP using the HTTP adapter. In SAP PI, the document is mapped to the structure of the inbound interface of target system B. This system expects to receive an XML file, and it is therefore connected using the file adapter. You want to re-create this scenario bypassing the Integration Engine mainly thinking about performance. This configuration should be done using the Integrated Configuration.
Task 1:
Create two Business Components called BC_AAE_##_A and BC_AAE_##_B to represent the sender and receiver
1. Log on to the Integration Directory and navigate to the Business Components node.
2. Create a Business Component called BC_AAE_##_A and define in the outbound interface the reference to SI_Material_outb from the software component SC_BIT400_A in namespace urn:education:com:bit400:A 3. Create an HTTP_AAE Communication Channel for the sender called
HTTP_AAE_Sender_##.
4. Create a Business Component called BC_AAE_##_B and define in the inbound interface the reference to SI_Materials_inb from the software component SC_BIT400_B in namespace urn:education:com:bit400:B 5. Create a File Communication Channel for the receiver called
File_Re-ceiver_AAE_## by applying the template BIT400_File_Receiver_Template.
Continued on next page
For internal use by CSC only For internal use by CSC only
Unit 3: How the Pipeline Works – Example of an Asynchronous Scenario TBIT40
Task 2:
In the Integration Directory, create a configuration scenario called CS_##_AAE, and assign the objects created in the previous task.
Create an Integrated Configuration object. Assign business component BC_AAE_##_A as the sender and BC_AAE_##_B as the receiver. Use the communication channels created in the previous task.
1. In the Integration Directory: navigate to the view for configuration scenarios.
2. Create a configuration scenario called CS_##_AAE and add the objects needed for the configuration: BC_AAE_##_A, BC_AAE_##_B, and the communication channels created in the previous task.
3. Create a New object of type Integrated Configuration for Business Components BC_AAE_##_A and its sender interface.
4. Configure the Integrated Configuration providing communication channel for the sender, receiver business component, operation mapping, and receiver communication channel.
Task 3:
Test the scenario and check the corresponding message in target directory.
1. On the initial screen of the SAP NetWeaver Process Integration (Integration Server), click the link Additional Information. This displays a page containing links for BIT400. Start the HTTP client. This simulates an application that generates an XML document for a material master and sends it to the PI pipeline using the HTTP adapter.
Caution: The sender service, sender interface, and namespace entries are default. If you did not adhere to the naming conventions in the exercises, you will have to correct the entries with the data you maintained.
In any case, change the group number on the screen to ##, choose Material, and send the XML document.
2. Display the file created in your directory.
To do this, you must first release the file directory on the common training computer.
Choose the menu option Start → Programs → XI Server Connector→ XI Server Connector. In the SID field, enter your PI training system SID (for example, RWN), and enter your PI training system server in the Server field
Continued on next page
For internal use by CSC only For internal use by CSC only
TBIT40 Lesson: Integrated Configuration on the Advanced Adapter Engine
(for example, rwntdc00,wdf.sap.corp ). You can find the server name in the message line at the bottom right of the PI system. Then choose OK. The system displays a success message.
Go back to your group directory. To do this, choose Start → Programs → XI Server Connector → XI Serverdrive (X). Open your group## directory. You will find a file that was created as a result of your message.
For internal use by CSC only For internal use by CSC only
Unit 3: How the Pipeline Works – Example of an Asynchronous Scenario TBIT40
Solution 9: Create an Integrated
Configuration for the Advanced Adapter Engine
Task 1:
Create two Business Components called BC_AAE_##_A and BC_AAE_##_B to represent the sender and receiver
1. Log on to the Integration Directory and navigate to the Business Components node.
a) Log on to the Integration Directory.
b) Switch to the Objects tab page. You will find the Business Components under the Communication Components without Party node.
2. Create a Business Component called BC_AAE_##_A and define in the outbound interface the reference to SI_Material_outb from the software component SC_BIT400_A in namespace urn:education:com:bit400:A a) Right click in Business Components and choose new from the context
menu.
b) Give BC_AAE_##_A as the name of the Communication Component, leave the other settings blank and click create.
c) Move to the Sender tab. There is already a line to be edited for an Outbound Interface.
d) Click in the icon of the name column to search for
SI_Material_outbfrom the software component SC_BIT400_A in namespace urn:education:com:bit400:A.
Select it by marking the check box, and click Apply.
e) Save your Business Component with .
3. Create an HTTP_AAE Communication Channel for the sender called HTTP_AAE_Sender_##.
a) Expand your business component BC_AAE_##_A on the browser pane (left-hand). Right click in Communication Channel and choose New.
b) Enter HTTP_AAE_Sender_## in the field Communication Channel, and choose Create.
c) Click of the Adapter type and choose HTTP_AAE.
d) Make sure that Sender is selected and save with .
Continued on next page
For internal use by CSC only For internal use by CSC only
TBIT40 Lesson: Integrated Configuration on the Advanced Adapter Engine
4. Create a Business Component called BC_AAE_##_B and define in the inbound interface the reference to SI_Materials_inb from the software component SC_BIT400_B in namespace urn:education:com:bit400:B a) Right click in Business Components and choose new from the context
menu.
b) Give BC_AAE_##_B as the name of the Communication Component, leave the other settings blank and click create.
c) Stay on the Receiver tab. A line to enter an Inbound Interface is already existing.
d) Click in the icon of the name column to search for
SI_Materials_inbfrom the software component SC_BIT400_B in namespace urn:education:com:bit400:B, select it and click Apply.
e) Save your changes with .
5. Create a File Communication Channel for the receiver called File_Re-ceiver_AAE_## by applying the template BIT400_File_Receiver_Template.
a) In the Business Component BC_AAE_##_B, on the Receiver tab, on the lower section Communication Channels, use the icon Create Object to create a new Communication Channel.
b) Enter File_Receiver_AAE_## as Communication Channel and choose Create.
c) Apply the template BIT400_File_Receiver_Template.
Choose Communication Channel → ApplyTemplate. In the
selection screen, select the BIT400_File_Receiver_Template template (Namespace urn:education.com:BIT400:B, Software Component SC_BIT400_B 1.0).
d) In the Target Directory field, replace “##” placeholder in /usr/sap/trans/tmp/group## with your group number.
e) In the File Name Scheme field, extend “pi_output.XML” with “AAE”
to “pi_output_AAE.XML”.
f) Save your communication channel with .
Continued on next page
For internal use by CSC only For internal use by CSC only
Unit 3: How the Pipeline Works – Example of an Asynchronous Scenario TBIT40
Task 2:
In the Integration Directory, create a configuration scenario called CS_##_AAE, and assign the objects created in the previous task.
Create an Integrated Configuration object. Assign business component BC_AAE_##_A as the sender and BC_AAE_##_B as the receiver. Use the communication channels created in the previous task.
1. In the Integration Directory: navigate to the view for configuration scenarios.
a) Switch to the Objects tab page. You will find the configuration scenarios under the Configuration Scenario node.
2. Create a configuration scenario called CS_##_AAE and add the objects needed for the configuration: BC_AAE_##_A, BC_AAE_##_B, and the communication channels created in the previous task.
a) Move to the Objects tab and right click in the Configuration Scenario Node, choose new.
b) Give the name CS_##_AAE , select No model and choose Create.
c) Move to the objects tab of your new Configuration Scenario and click in to Add new existing new objects.
Hint: The object Configuration scenario in this exercise is used to organize the objects for a specific integration.
d) Add the Business Components BC_AAE_##_A and BC_AAE_##_B and choose Apply and then add the Communication Channels
HTTP_AAE_Sender_## and File_Receiver_AAE_## and choose apply.
Hint: You may as well reference the objects using drag &
drop from the browser pane left-hand to the objects list of the Configuration Scenario.
Continued on next page
For internal use by CSC only For internal use by CSC only
TBIT40 Lesson: Integrated Configuration on the Advanced Adapter Engine
3. Create a New object of type Integrated Configuration for Business Components BC_AAE_##_A and its sender interface.
a) In your Configuration Scenario CS_##_AAE objects tab choose the icon. Select Collaboration Agreement → Integrated Configuration as object type to create.
b) Use the value list to choose BC_AAE_##_A as the sender
Communication Component. Use the value list to choose the Outbound Interface SI_Material_outb from the software component SC_BIT400_A in namespace urn:education:com:bit400:A. Choose Create.
4. Configure the Integrated Configuration providing communication channel for the sender, receiver business component, operation mapping, and receiver communication channel.
a) Maintain Inbound Processing.
In your new Integrated Configuration object, on the Inbound Processing Tab, use the icon to choose your sender Communication Channel HTTP_AAE_Sender_##.
b) Maintain Receiver.
Select the Receiver tab. In the entry field for the Communication Component column, use the value list to select your receiver Communication Component BC_AAE_##_B.
c) Maintain Receiver Interfaces.
Select the Receiver Interfaces tab, where you can select the Operation Mapping OM_MaterialA_MaterialsB from the software component SC_BIT400_MAPPING in namespace urn:education:com:bit400:Mapping using the value list icon.
Hint: The Receiver Interface Name, Namespace, and Software Component Version are taken from the Operation Mapping and listed automatically in the column.
d) Maintain Outbound Processing.
Select Outbound Processing, choose using the icon the receiver Communication Channel File_Receiver_AAE_##.
e) Save using and activate everything using the change list.
Continued on next page
For internal use by CSC only For internal use by CSC only
Unit 3: How the Pipeline Works – Example of an Asynchronous Scenario TBIT40
Task 3:
Test the scenario and check the corresponding message in target directory.
1. On the initial screen of the SAP NetWeaver Process Integration (Integration Server), click the link Additional Information. This displays a page containing links for BIT400. Start the HTTP client. This simulates an application that generates an XML document for a material master and sends it to the PI pipeline using the HTTP adapter.
Caution: The sender service, sender interface, and namespace entries are default. If you did not adhere to the naming conventions in the exercises, you will have to correct the entries with the data you maintained.
In any case, change the group number on the screen to ##, choose Material, and send the XML document.
a) In the Group Number field, change the entry to ## and choose HTTP_AAE. This defines the material number BIT400_## for your document and sets the form to send the message to the HTTP_AAE adapter.
b) Choose Send.
2. Display the file created in your directory.
To do this, you must first release the file directory on the common training computer.
Choose the menu option Start → Programs → XI Server Connector→ XI Server Connector. In the SID field, enter your PI training system SID (for example, RWN), and enter your PI training system server in the Server field (for example, rwntdc00,wdf.sap.corp ). You can find the server name in the message line at the bottom right of the PI system. Then choose OK. The system displays a success message.
Go back to your group directory. To do this, choose Start → Programs → XI Server Connector → XI Serverdrive (X). Open your group## directory. You will find a file that was created as a result of your message.
a) Follow the steps listed in the exercise description.
For internal use by CSC only For internal use by CSC only
TBIT40 Lesson: Integrated Configuration on the Advanced Adapter Engine
Lesson Summary
You should now be able to:
• Describe the tasks and structure of the Advanced Adapter Engine
• Explain the difference between classic and local processing on the Advanced Adapter Engine
• Configure local processing on the Advanced Adapter Engine in the Integration Directory
For internal use by CSC only For internal use by CSC only
Unit 3: How the Pipeline Works – Example of an Asynchronous Scenario TBIT40