SAP NetWeaver Process Integration 7.31
Simple Use Cases for B2B AS2 & EDI Separator Using
Integration Flow Configuration
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
TABLE OF CONTENTS
1
1.1
1.2
1.3
1.4
Preface .............................................................................................................................................. 6
Constraints ....................................................................................................................................... 6
Definition .......................................................................................................................................... 6
Intended Audience........................................................................................................................... 6
Structure ........................................................................................................................................... 6
2
Introduction and Prerequisites ...................................................................................................... 6
2.1
Introduction ...................................................................................................................................... 6
2.1.1
AS2 Adapter ...................................................................................................................................... 8
2.1.2
EDI Separator .................................................................................................................................... 8
2.1.3
EDI-XML Converters.......................................................................................................................... 8
2.1.4
SCN Articles ...................................................................................................................................... 8
2.2
Prerequisites .................................................................................................................................... 9
2.2.1
General Prerequisites ........................................................................................................................ 9
2.2.2
Providing the necessary User and Authorizations ........................................................................... 10
2.2.3
Setting up the Third party Tool Infrastructure (AS2 Connector) ...................................................... 10
2.2.4
Configuring the Certificates for authorization and authentication .................................................... 10
2.2.5
Setting Up the File Directories ......................................................................................................... 10
2.2.6
Adding Software Components to PI B2B ADDON product ............................................................. 11
2.3
Design Objects Used ..................................................................................................................... 12
2.3.1
Interface Objects .............................................................................................................................. 12
2.3.2
Mapping Objects .............................................................................................................................. 12
2.4
Working with NWDS ...................................................................................................................... 12
2.4.1
Setting Connection Parameters ....................................................................................................... 12
2.4.2
Opening Perspectives and Views .................................................................................................... 12
2.4.3
Connecting to the Systems .............................................................................................................. 13
2.4.4
Maintenance tool and B2B Seed File .............................................................................................. 13
2.5
Variant 1a: One Sender and one Receiver using the Advanced Adapter Engine Extended –
Encryption and Signature with synchronous MDN .................................................................................... 14
2.6
Design Objects Used ..................................................................................................................... 14
2.6.1
Summary of Design Objects Used .................................................................................................. 15
2.7
Configuring the Process Integration Scenario ........................................................................... 15
2.8
Calling the Process Integration Designer ................................................................................... 15
2.9
Creating the Integration Flow ....................................................................................................... 15
2.10
Creating Channels ......................................................................................................................... 16
2.11
Saving and Activating the Configuration Objects ...................................................................... 19
2.12
Configuring the trading partner ................................................................................................... 19
2.12.1
Creating the trading partner ............................................................................................................. 19
2.13
Executing the Use Case ................................................................................................................ 19
3
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
Variant 1b : AS2 Adapter with EDI Converter (Plain XML and XML to Plain) .......................... 20
Design Objects Used ..................................................................................................................... 20
Configuring the Process Integration Scenario ........................................................................... 21
Calling the Process Integration Designer ................................................................................... 21
Creating the Integration Flow ....................................................................................................... 21
Creating Channels ......................................................................................................................... 21
Saving and Activating the Configuration Object ........................................................................ 22
Configuring the trading partner ................................................................................................... 22
Executing the Use Case ................................................................................................................ 22
4
Variant 2a: AS2 Adapter – Encryption, Signature and Compression of the message with
Asynchronous MDN ...................................................................................................................................... 23
4.1
Design Objects Used ..................................................................................................................... 23
4.1.1
Summary of Design Objects Used .................................................................................................. 23
4.2
Configuring the Process Integration Scenario ........................................................................... 23
4.3
Calling the Process Integration Designer ................................................................................... 23
2
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
4.4
4.5
4.6
4.1
4.1.1
4.2
Creating the Integration Flow ....................................................................................................... 23
Creating Channels ......................................................................................................................... 24
Saving and Activating the Configuration Object ........................................................................ 25
Configuring the trading partner ................................................................................................... 25
Creating the trading partner on AS2 connector ............................................................................... 25
Executing the Use Case ................................................................................................................ 26
5
Variant 2b: AS2 Adapter – Encryption, Signature and Compression of the message with
Asynchronous MDN and Creation of New XI Message.............................................................................. 27
5.1
Design Objects Used ..................................................................................................................... 27
5.1.1
Summary of Design Objects Used .................................................................................................. 27
5.2
Configuring the Process Integration Scenario ........................................................................... 27
5.3
Calling the Process Integration Designer ................................................................................... 27
5.4
Creating the Integration Flow1 ..................................................................................................... 27
5.5
Creating Channels ......................................................................................................................... 28
5.6
Saving and Activating the Configuration Object ........................................................................ 29
5.7
Configuring the trading partner ................................................................................................... 29
5.7.1
Creating the trading partner on AS2 connector ............................................................................... 29
5.8
Creation of Integration Flow2 ....................................................................................................... 30
5.9
Creating Channels ......................................................................................................................... 30
5.10
Executing the Use Case ................................................................................................................ 31
6
6.1
6.1.1
6.2
6.3
6.4
6.5
6.6
6.7
6.7.1
6.7.2
6.8
Variant 3: AS2 Adapter – Decryption and Signature of the message without MDN Signature
32
Design Objects Used ..................................................................................................................... 32
Summary of Design Objects Used .................................................................................................. 32
Configuring the Process Integration Scenario ........................................................................... 32
Calling the Process Integration Designer ................................................................................... 32
Creating the Integration Flow ....................................................................................................... 32
Creating Channels ......................................................................................................................... 33
Saving and Activating the Configuration Objects ...................................................................... 35
Configuring the trading partner ................................................................................................... 35
Creating the trading partner on AS2 connector ............................................................................... 35
Adding test data to the configured trading partner .......................................................................... 36
Executing the Use Case ................................................................................................................ 36
7
Variant 4a: AS2 Adapter – No Decryption and No Signature of the message with Signed
Async MDN ..................................................................................................................................................... 37
7.1
Design Objects Used ..................................................................................................................... 37
7.1.1
Summary of Design Objects Used .................................................................................................. 37
7.2
Configuring the Process Integration Scenario ........................................................................... 37
7.3
Calling the Process Integration Designer ................................................................................... 38
7.4
Creating the Integration Flow ....................................................................................................... 38
7.5
Creating Channels ......................................................................................................................... 38
7.6
Saving and Activating the Configuration Objects ...................................................................... 41
7.7
Configuring the trading partner ................................................................................................... 41
7.7.1
Creating the trading partner on AS2 connector ............................................................................... 41
7.7.2
Adding test data to the configured trading partner .......................................................................... 42
7.8
Executing the Use Case ................................................................................................................ 42
8
8.1
8.2
8.3
8.4
8.5
8.6
8.7
8.8
Variant 4b: AS2 Adapter – Duplicate message handling Feature in AS2 ................................ 42
Design Objects Used ..................................................................................................................... 43
Configuring the Process Integration Scenario ........................................................................... 43
Calling the Process Integration Designer ................................................................................... 43
Creating the Integration Flow1 ..................................................................................................... 43
Creating Channels ......................................................................................................................... 43
Creating the Integration Flow2 ..................................................................................................... 46
Creating Channels ......................................................................................................................... 46
Execution and Verification............................................................................................................ 48
3
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
9
Variant 5: AS2, EDI Separator (ANSI X12 transaction sets 830, 856, 997) and EDI-XML
Converter ........................................................................................................................................................ 49
9.1
Configuring the Integration Flows ............................................................................................... 50
9.1.1
Calling the Process Integration Designer ........................................................................................ 50
9.1.2
Creating the integration Flows ......................................................................................................... 50
9.1.2.1 Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .............................................. 50
9.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter 51
9.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter 51
9.1.2.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter ............................................... 52
9.1.3
9.1.3.1
Configuring the integration Flows .................................................................................................... 52
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .............................................. 52
9.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter 55
9.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter 56
9.1.3.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter ............................................... 58
9.2
9.2.1
9.2.2
9.3
9.4
Configuring the trading partner ................................................................................................... 61
Creating the trading partner on AS2 connector ............................................................................... 61
Adding test data to the configured trading partner .......................................................................... 62
Saving and Activating the Configuration Objects ...................................................................... 62
Executing the Use Case ................................................................................................................ 62
10
Variant 6: AS2, EDI Separator (ANSI X12 transaction sets 830, 856, 997), EDI-XML Converter
& Conversion Using the Maintenance Tool ................................................................................................ 70
10.1
Configuring the Integration Flows ............................................................................................... 70
10.1.1
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter 70
10.2
Saving and Activating the Configuration Objects ...................................................................... 70
10.3
Executing the Use Case ................................................................................................................ 71
11
11.1
11.1.1
11.1.2
11.1.2.1
Variant 7: AS2, EDI Separator (EDIFACT: DELFOR and DESADV) and EDI-XML Converter . 71
Configuring the Integration Flows ............................................................................................... 73
Calling the Process Integration Designer ........................................................................................ 73
Creating the integration Flows ......................................................................................................... 73
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .......................................... 73
11.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
74
11.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
74
11.1.2.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter ........................................... 74
11.1.3
Configuring the integration Flows .................................................................................................... 75
11.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .......................................... 75
11.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
77
11.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
79
11.1.3.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter ........................................... 81
11.2
11.2.1
11.2.2
11.3
11.4
Configuring the trading partner ................................................................................................... 84
Creating the trading partner on AS2 connector ............................................................................... 84
Adding test data to the configured trading partner .......................................................................... 85
Saving and Activating the Configuration Objects ...................................................................... 85
Executing the Use Case ................................................................................................................ 85
12
12.1
Variant 8: AS2, EDI Separator (Odette: AVIEXP and DELINS) and EDI-XML Converter ......... 92
Configuring the Integration Flows ............................................................................................... 92
4
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
12.1.1
Calling the Process Integration Designer ........................................................................................ 92
12.1.2
Creating the integration Flows ......................................................................................................... 92
12.1.2.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .......................................... 92
12.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
93
12.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
93
12.1.3
Configuring the integration Flows .................................................................................................... 93
12.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. .......................................... 93
12.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
96
12.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
97
12.2
12.2.1
12.2.2
12.3
12.4
Configuring the trading partner ................................................................................................... 99
Creating the trading partner on AS2 connector ............................................................................... 99
Adding test data to the configured trading partner ........................................................................ 100
Saving and Activating the Configuration Objects .................................................................... 100
Executing the Use Case .............................................................................................................. 100
13
13.1
13.1.1
13.1.2
13.1.2.1
Variant 9: AS2, EDI Separator (VDA: 4905 and 4913) and EDI-XML Converter ..................... 101
Configuring the Integration Flows ............................................................................................. 101
Calling the Process Integration Designer ...................................................................................... 101
Creating the integration Flows ....................................................................................................... 101
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. ........................................ 101
13.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
102
13.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
102
13.1.3
Configuring the integration Flows .................................................................................................. 102
13.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator. ........................................ 102
13.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
105
13.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
106
13.2
13.2.1
13.2.2
13.3
13.4
Configuring the trading partner ................................................................................................. 107
Creating the trading partner on AS2 connector ............................................................................. 107
Adding test data to the configured trading partner ........................................................................ 108
Saving and Activating the Configuration Objects .................................................................... 109
Executing the Use Case .............................................................................................................. 109
5
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
1
Preface
1.1 Constraints
The texts, references, and graphics contained in this manual have been compiled with utmost care;
nevertheless, it is impossible to guarantee that they are fully without error. SAP cannot assume any
responsibility for the correctness or completeness of the following documentation; the user alone is
responsible for verifying the information contained therein.
SAP will only assume liability for damage arising from the use of this documentation – irrespective of the
pertinent legal basis – in the case of intentional or active negligence; under no other circumstances will a
warranty be made.
1.2 Definition
This manual describes simple application cases using Integration Flow configuration for B2B and all the
configuration steps that are necessary to execute the application cases on the basis of SAP NetWeaver
7.31.
1.3 Intended Audience
This manual is intended to be used by both technology and application consultants.
1.4 Structure
The structure of this document follows the sequence of steps required to configure and run the use cases.
2
Introduction and Prerequisites
2.1 Introduction
Use cases are based on simple examples that enable you to learn the main features of the B2B AS2 Adapter
Configuration and EDI Separator Configuration for the Advanced Adapter Engine Extended. These
instructions will enable you to understand, configure, and execute simple scenarios (that are based on
fundamental communication patterns), as well as check that the scenarios are executed correctly. The
prerequisite for this document is that you have a general understanding of SAP NetWeaver Process
Integration.
The scope of this test case is to test the following features of the AS2 adapter and EDI-Separator.
AS2 Adapter
 Verification of signature for ensuring non-repudiation
 Signed MDN
 Compression of message payload
 Encryption of message payload for message integrity
 Signing of message for non-repudiation
 Encryption of message payload for message integrity
 Synchronous signed MDN with request and verification of MIC (Message Integrity Check) and signing
 Decryption of message payload for verifying message integrity
 Separating the combined message by the use of EDI Separator adapter
EDI Separator
 ANSI X.12 message with Transaction Set Identifier Codes and Interchange Sender/Receiver Id
specified
 Edifact with message type, version, release number, interchange sender and receiver identification
and code qualifier specified
 Odette with message type, version number, Interchange sender and recipient identification and code
qualifier specified.
 VDA with message type, customer and vendor number specified
 Acknowledgement (positive) message generation for ANSI X.12 message type
The following use case variants for the Advanced Adapter Engine Extended are available at present:
6
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Variant
Description
Variant 1:
One sender and one receiver-with
synchronous MDN
Represents message exchange between one sender and one receiver on
the Advanced Adapter Engine Extended (AEX) with encryption and
signature of the message followed by sending the synchronous MDN.
The message processing is done locally on the Advanced Adapter
Engine Extended.
Variant 2:
One sender and one receiver-with
Asynchronous MDN
Represents message exchange between one sender and one receiver on
the Advanced Adapter Engine Extended (AEX) with encryption, signature
and compression of the message followed by sending the Asynchronous
MDN. The message processing is done locally on the Advanced Adapter
Engine Extended.
Variant 3:
One sender and one receiver- with
unsigned synchronous MDN
Represents message exchange between one sender and one receiver on
the Advanced Adapter Engine Extended (AEX) with decryption and
signature of the message followed by sending unsigned the synchronous
MDN. The message processing is done locally on the Advanced Adapter
Engine Extended.
Variant 4:
One sender and two receivers – with
signed synchronous MDN
Represents message exchange between one sender and one receiver on
the Advanced Adapter Engine Extended (AEX) without decryption and
signature of the message followed by sending the synchronous MDN.
The message processing is done locally on the Advanced Adapter
Engine Extended.
Variant 5:
AS2, EDI Separator (transaction set 830,
856, 997) and EDI-XML Converter (X.12
to XML)
Represents message exchange parting from a trading partner as ASC
X12 message containing two message types (transaction sets), being
converted into XML and split by the EDI separator. Additionally an
acknowledgment message (transaction code 997) is generated and sent
back to the trading partner via AS2 adapter
Variant 6:
AS2, EDI Separator (transaction set 830,
856, 997), EDI-XML Converter (XML to
X.12) & Conversion Using the
Maintenance Tool
Based on the scenario in variant 5 by adding the module converter to one
of the file receivers and using the maintenance tool to convert one of the
received messages to xml and back to X.12.
Variant 7: AS2, EDI Separator
(EDIFACT: DELFOR and DESADV) and
EDI-XML Converter
On this variant, an EDIFACT multi-message containing two message
types (DELFOR and DESADV) is sent by a trading partner. The message
is split by the EDI Separator, converted into XML and sent to a file
receiver.
Variant 8: AS2, EDI Separator (Odette:
AVIEXP and DELINS) and EDI-XML
Converter
On this variant, an Odette multi-message containing two message types
(AVIEXP and DELINS) is sent by a trading partner. The message is split
by the EDI Separator, converted into XML and sent to a file receiver.
Variant 9: AS2, EDI Separator (VDA:
4905 and 4913) and EDI-XML Converter
On this variant, a VDA multi-message containing two message types
(4905 and 4913) is sent by a trading partner. The message is split by the
EDI Separator, converted into XML and sent to a file receiver.
You can aim to learn about the following with the use cases:
 Working with the AS2 protocol and AS2 adapter
 Configuring The EDI Separator adapter and splitting different types of messages
 Using the EDI-XML Convertor module and maintaining control data on the maintenance tool
7
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
 Working with the Process Integration Designer in NWDS: Configuring simple scenarios and
understanding created configuration objects
 Working with the runtime: Executing the use cases and checking the results by using the monitoring
tools
SAP provides the required design objects and files for these learning targets. This document contains a
complete set of instructions that enable you to configure and execute the use cases without any additional
special prerequisites.
SAP NetWeaver Process Integration (Advanced Adapter Engine Extended) must be installed
and configured, and be error free.
2.1.1
AS2 Adapter
The AS2 Adapter enables data transfer using the AS2 protocol.
AS2 (stands for Applicability Statement 2) is a protocol is used to transport data securely and reliably over
the Internet, based on HTTP and S/MIME. The partners are always connected via the tried and tested
HTTP(s) protocol. The AS2 process is a clear choice thanks to its effective firewall administration capability,
signature, encryption, return receipt/acknowledgement (MDN) and rapid response times.
Detailed information on the AS2 protocol can be found in RFC 4130.
2.1.2
EDI Separator
The EDI Separator is a component providing the feature of splitting incoming mass EDI messages into single
messages. It is implemented as a PI Adapter and therefore can be used on sender and receiver adapter
channels that are configured to perform the splitting function. Furthermore, the adapter controls the “content
based receiver determination”. This feature of the adapter offers the possibility to use content-based routing
(message identification) and split mass messages according to interfaces based on message type and
partner.
The SAP NW PI EDI Separator adapter supports 4 EDI formats which are:
 ANSI ASC X12
 EDIFACT
 ODETTE
 VDA
For at least one of the variants described in this document, the format ANSI ASC X12 will be used.
Configuration details will be explained on the corresponding variant.
2.1.3 EDI-XML Converters
EDI-XML converters are set of modules which convert from EDI formats to XML and vice-versa. All formatspecific conversions are called via own modules.
On this simple use case, The ASC X12 message is converted using the module called
“localejbs/X12ConverterModule”. This Java-Bean is able to recognize automatically whether it is an X12 or
an XML message and can process them correspondingly. A maintenance tool is available via web, where
the control data for the conversions can be maintained and conversions can be made. More information on
‎2.4.4
2.1.4 SCN Articles
Additional information can be found on the respective articles published on SAP Community Network:
Link
Title
AS2 Adapter
Learning Series SAP NetWeaver Process Orchestration, business to business add-on 2c
AS2 Adapter
8
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
EDI Separator
Adapter
Learning Series SAP NetWeaver Process Orchestration, business to business add-on 2f EDI
Separator Adapter
All in one guide
for Add-on
Solutions
All in one Guide ADD-On Solutions for SAP NetWeaver Process Orchestration
2.2
Prerequisites
2.2.1 General Prerequisites
To configure and execute the use cases, SAP NetWeaver with usage type Advanced Adapter Engine
Extended must be correctly installed and configured. The following table lists the prerequisites and the
relevant guides:
List of required steps:
Step
Documentation
1.
You have installed SAP
NetWeaver 7.31.
You can find the corresponding guides on SAP Service Marketplace in
the Implementation Documentation Center for SAP NetWeaver 7.3 and
SAP NetWeaver 7.3 including Enhancement Package 1
2.
You have imported the content
for the Enterprise Services
Repository corresponding to the
latest support package/patch.
SAP Note 836200
3.
You have configured SAP
NetWeaver Process Integration.
Configuration of SAP NetWeaver Process Integration
4.
You have configured the System
Landscape Directory (SLD).
Configuring, Working with and Administering System Landscape
Directory
5.
You have installed the
NetWeaver Developer Studio.
You can find the corresponding guides on SAP Service
Marketplace at https://service.sap.com/installnw73  Under
Installation - Standalone Engines and Clients  Installation –
Clients  Inst. and Update - SAP NetWeaver Developer Studio
7.3 EHP1 (SP04).
6.
You have installed the SFTP &
PGP Add-on.
 You can download the B2B add-on from the following location:
http://service.sap.com/swdc -> Browse our Download Catalog - > ->
Installation and Upgrades -> SAP NetWeaver and complementary
products -> PI SFTP PGP ADDON.
7.
You have installed the PI B2B
Add-on.
 You can download the B2B add-on from the following location:
http://service.sap.com/swdc -> Browse our Download Catalog - > ->
Installation and Upgrades -> SAP NetWeaver and complementary
products -> PI B2B ADDON
The simple use cases are located in the Enterprise
Services Repository in the software component SAP
BASIS, software component version SAP BASIS 7.31, in
the namespaces http://sap.com/xi/XI/System/Patterns.
9
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2.2.2 Providing the necessary User and Authorizations
To log on to the AEX system to configure the simple use cases, you have to create a user XIDEMO with the
following roles in the Advanced Adapter Engine Extended:
 SAP_XI_CONFIGURATOR _J2EE
 SAP_XI_MONITOR_J2EE
2.2.3
Setting up the Third party Tool Infrastructure (AS2 Connector)
In this document all the scenarios described are based on the third party tool called AS2 Connector by /n
Software. This third party software has been used just as an example for configuration of trading partners
for the purpose of sending and receiving the AS2 message payloads. You are free to use any third party
software and configure your scenario based on AS2 adapter. The third party software can change in your
case. The scenarios described in this document are based on /n Software AS2 connector, therefore you
need to configure the trading partners which will be used for the communication with the PI system on the
variants described in this document.
Please note that the PIs public Key certificate is used by the AS2 connector in some variants and therefore
should be present on the system hosting the AS2 connector and when configuring a trading partner the path
to the PI public key certificate will be needed. E.g. “<selected-path>/PI_Test-cert.crt”
2.2.4
Configuring the Certificates for authorization and authentication
Some of the AS2 scenarios need encryption, decryption and signing of the payload, for this
2 pairs of keys (public & private key pair) and 2 public key certificates one each for each partner are needed.
The public-private key pair and public key certificates can be generated in NWA.
The scenarios described on this document will use (if any) the public/private key pairs listed on the following
table.
For more information you can read the relevant articles as listed on ‎2.1.4
NW Key Storage View
Entry
Description
AS2_CERTIFICATE
Partner_Test-cert
Partners Public Key Certificate
AS2_CERTIFICATE
PI_Test-cert
Own Public Key Certificate
AS2_KEYSTORE
PI_Test
Own Private Key
2.2.5
Setting Up the File Directories
The variants are based on a simple system landscape that comprises various different file systems (on the
host of the SAP system on which the Advanced Adapter Engine Extended is installed). When the use cases
are executed, files are moved between file directories and/or the third party software. Therefore, to be able to
configure the use cases, the file directories must have been created and described in the System Landscape
Directory. Only then can you access the directories during configuration in the PI Designer.
Perform the steps below to create the required directories on the host of the SAP system on which the
Advanced Adapter Engine Extended is installed.
1. Open the file directory of the SAP system, on which the Advanced Adapter Engine Extended is
installed. For Example using Windows Explorer on Windows Systems.
2. Create a directory in which you can save files temporarily and create the sub directories
Inputfiles and Receiver
A work directory already exists on many computers that can be used for this purpose and under
which you can create the required directories.
3. Create further sub directories in the sub directory Inputfiles. Suggested names: Tradacoms,
ANSI, Odette, Edifact.
10
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
You must have authorization to access this directory to be able to test the process integration
scenario. Bear this in mind when you define the directory, and, if applicable, contact your system
administrator.
4. Copy the files to their respective directory under Inputfiles:





ZB2B_ANSI.xml
ZB2B_Tradacoms.xml
ZB2B_Odette.xml
ZB2B_Edifact.xml
ZB2B_input.txt
These files are provided by SAP in a ZIP file. The ZIP file for 7.31 containing also the EOIO test
files is available in SAP Developer Network (SDN) and can be found using the direct link EHP 1
for SAP NetWeaver Process Integration 7.3 – Test Files for Simple Use Cases.
5. Create one more directory: AS2-EDISEP
6. Under AS2-EDISEP create the following sub-directories: 830, 856, output-edifact, outputodette and output-vda
7. Additionally, the following files will be needed for sending messages from the trading partner:






2.2.6
B2B_ansix12SenderMessage_830_856.txt
B2B_ansix12SenderMessage_830_856_error.txt
B2B_edifactSenderMessage_DELFOR_DESADV.txt
B2B_edifactSenderMessage_DELFOR_DESADV_error.txt
B2B_odetteSenderMessage_AVIEXP3_DELINS3.txt
B2B_vdaSenderMessage_4905_4913.txt
Adding Software Components to PI B2B ADDON product
Perform the following steps to create the required technical and business systems in the System Landscape
Directory (SLD) for the Advanced Adapter Engine Extended:
1. To call the System Landscape Directory for the Advanced Adapter Engine Extended System, open the
Advanced Adapter Engine Extended Start Page using the URL: http(s)://<AEX-Host>:<AEX-Port>/dir.
2. Start the SLD. To do so, on the Advanced Adapter Engine Extended start page, choose System
Landscape Directory.
3. Log on using your user you created.
4. On the initial screen of the SLD, choose Products.
5. Filter for PI B2B ADDON product and check for B2B MAPPING KIT 1.0 software component version is
available in Software Components tab. If not proceed with below associations steps.
6. On the initial screen of the SLD, choose CIM Instances.
7. Filter for B2B MAPPING KIT 1.0 for class Software Component Version.
8. Click on New Association.
9. Filter for *B2B* with Association Type Software Features Software Component and Associated Class as
Product Instance.
10. Select PI B2B ADDON 1.0: JAVA COMPONENTS and click on Associate. A message for successful
association is displayed.
11. Now software component version B2B MAPPING KIT 1.0 will be available in list of Software
Components for PI B2B ADDON product.
Business Components used in the scenarios :
11
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration


















<SID>_<User-ID>_B2B_BC_AS2_V1
<SID>_<User-ID>_B2B_BC_AS2_V2
<SID>_<User-ID>_B2B_BC_AS2_V2b
<SID>_<User-ID>_B2B_BC_AS2_V3
<SID>_<User-ID>_B2B_BC_AS2_V4
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_01
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_02
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_03
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_04
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_01
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_02
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_03
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_01
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_02
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_03
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_01
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_02
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_03
2.3 Design Objects Used
2.3.1 Interface Objects
Interface objects describe the communication mode and the data structure for exchanging messages.
Interface objects comprise service interfaces, message types, and data types, which you can open by means
of forward navigation, starting with the Service Interfaces.
2.3.2 Mapping Objects
If the interfaces at the sender and receiver are different, a mapping is required.
The specific design objects will be listed in the specific variants below
2.4 Working with NWDS
2.4.1 Setting Connection Parameters
If not done yet, open the SAP NetWeaver Developer Studio.
Set the connection data for accessing the Integration Directory under the menu Process Integration →
Change Preferences. The connection details to the Advanced Adapter Engine Extended System have to be
maintained using URL or AEX-Host and AEX-Port, click on “test connection” to verify if the connection is
successful. Click on Apply for saving changes.
On the same menu (Process Integration → Change Preferences), under the following path: Web Services →
Enterprise Services Browser, set the connection details for the ESR System using ESR-Host and ESR-Port.
Once done, click on Apply and exit the menu by clicking on OK.
2.4.2 Opening Perspectives and Views
For creating Integration Flows, the Process Integration Designer perspective is needed.
To call the SAP Process Integration Designer perspective, follow the menu path:
Window → Open Perspective → Other → SAP Process Integration Designer.
Please note that not all views of this perspective (shown as tabs on the left side of the NWDS) will be
opened by default. If missing you can manually open them by using the Show view icon located on the
bottom-left corner of the NWDS. After selecting one view you can change its tab position using drag & drop
with the mouse. You will need at least the following views: PI Explorer, Enterprise Services Browser, PI
Runtime Explorer and Change Lists.
12
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Optionally, you can also call the “Enterprise Services Repository” Perspective:
To call the Enterprise Service Browser in the SAP NetWeaver Developer Studio follow the menu path
Window → Open Perspective → Other → Enterprise Services Repository.
Once done, you can quickly switch between perspectives by selecting the desired one on the top-right corner
of the NWDS.
2.4.3 Connecting to the Systems
Before proceeding to connection ensure that you have set the connection parameters as described
previously.
On the SAP Process Integration Designer perspective connect to the systems using the common logon
option by clicking the connect icon located on the top toolbar (
).
Provide your credentials on the pop-up window. This will connect automatically to both, the AEX and the
ESR systems.
On the connection pop-up window, you can select the check-box “Use common credentials for directory and
repository” if your credentials are the same for both systems.
Alternatively, you can also use the common logon using the Menu Process Integration → Connect
There is also the possibility of connecting to the ESR only. If you would like to connect only to the ESR, use
the connect icon located on the Enterprise Service Browser view.
2.4.4 Maintenance tool and B2B Seed File
SAP PI B2B, specifically the XML converter uses two different types of tables B2B_X12_CTRL_* (contain
rules for creating the nesting structure for the conversion of the messages) and B2B_X12_DEF_* manage
information for generating the XML Definition Schemes (XSD‟s). For the variant described in this document,
we only have to ensure that the tables are populated. This is done using the maintenance tool for EDI
Content Manager available at B2B Integration Cockpit. Follow the next steps:
 Open B2B Integration Cockpit (proceed with user credentials if prompted):
https://host:port/webdynpro/resources/sap.com/b2b~home/B2BHome
 Then click on EDI Content Manager.
 Please check if the data is already available: Go to tab “Ansi X.12” – Tables - B2B_X12_CTRL_IF.
If the table is empty you need to import the B2B seed file. If not, you can skip the next steps.
 Copy the B2B seed file locally
 Import the “B2B seed file”: On the maintenance tool, go to tab “Ansi X.12” – Tables – Import,
browse for your local copy of the B2B seed file and click on „Import“
Since the file is larger than 20 MB, you will get the following warning message:
13
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
After a couple of minutes the import will be complete. Please note that no confirmation will be
displayed. If you want to see the import result, you can have a look at the import log file. The
location for the log file is displayed on the previous warning message.
After the import, the control data is available on the tables:
Repeat the same steps for Plain, VDA, Odette, Tradacoms and EDIFACT.
Variant 1a: One Sender and one Receiver using the Advanced Adapter Engine Extended –
Encryption and Signature with synchronous MDN
This variant enables you to configure and execute the simplest kind of message exchange:
One sender (file directory Inputfiles) sends a message to one receiver. Hereby, the message is
exchanged between sender and receiver adapter by using one Advanced Adapter Engine Extended.
Mapping is executed between the outbound and inbound interface and the message is being converted into
the Tradacoms type in this variant.
2.5
2.6
Design Objects Used
This section explains all the design objects that are used for describing this variant.
The subsequent description of each variant will refer to the detailed step-by-step description in this section;
the relevant design objects will only be listed briefly in each case.
The following describes all the objects that describe the message exchange in this variant in turn. There are
two possibilities to learn more about the design objects, the Enterprise Services Builder and the Enterprise
Service Browser.
To call the Enterprise Service Browser in the SAP NetWeaver Developer Studio first set the connection data
for accessing the Enterprise Services Builder under the menu Window → Preferences. Under Web Services
14
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
→ Enterprise Services Browser the connection details to the ESR System have to be maintained using ESRHost and ESR-Port.
1. To call the Enterprise Services Browser follow the menu path Window → Open Perspective → Other
→ Enterprise Services Repository.
2. Use the Connect Button to connect to the Enterprise Services Builder.
3. In the navigation area, open the software component B2B TOOLKIT software component version
B2B TOOLKIT 1.0, and namespace http://sap.com/xi/XI/AS2
4. Open the node and ensure that the adapter metadata for AS2 is present under the namespace.
5. Again ensure that the software component B2B MAPPING KIT 1.0 is available, as this contains the
mapping objects which will be consumed in the variants described
All the design objects can also be checked directly in the Enterprise Services Builder. To call it call the
Process Integration Tools Page http://<AEX-Host>:<AEX-Port>/dir and from there open the Enterprise
Services Builder.
2.6.1 Summary of Design Objects Used
The design objects used are summarized once more in the following table
Object Type (Name)
Service Interfaces (INVOIC.INVOIC02
SI_INBOUND_EDI_TRADACOMS_INVOIC)
Description
Specifies the communication mode (asynchronous) and references the
message type used.
Message Type (INVFILTO9)
Message Type (INVFILTO9)
Data Type (INVFILTO9)
Describes the data structure of the message
2.7 Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the Process Integration Designer. You perform the following configuration steps in the SAP Process
Integration Designer for the Advanced Adapter Engine Extended.
2.8 Calling the Process Integration Designer
Open the SAP NetWeaver Developer Studio, connect and open the Process Integration Designer view as
described in ‎2.4
2.9
Creating the Integration Flow
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant1_IntFlowScenario_<User-ID>.
3. Choose Next.
4. To assign Business component to sender, right click on the sender -> New Business component ->
name as <SID>_<User-ID>_B2B_BC_AS2_V1-> Click Finish.
5. As Interface select INVOIC.INVOIC02.
6. In Tab Receiver Systems as Receiver component select the Business component <SID>_<UserID>_B2B_BC_AS2_V1 using the input help for the Receiver Name.
7. As Receiver Interface select SI_INBOUND_EDI_TRADACOMS_INVOIC.
8. Choose Finish.
15
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
9. The integration Flow will be displayed in a graphical overview.
10. On the line representing the message flow to receiver <SID>_<User-ID>_B2B_BC_AS2_V1 in the
context menu select Add Mapping.
11. Select the mapping object in the graphical view. The properties tab will open.
12. Using the Browse functionality select the operation mapping OM_INVOIC02_TO_INVOICTO9.
2.10 Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Apply Channel
Template. The Choose Channel Template screen will open.
2. Select the template B2B_AS2_FileSender of software component version B2BTOOLKIT 1.0 and
press OK. Change to the channel view.
3. In tab Adapter Specific under File Access Parameter in the Source Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the sender communication
channel, enter the whole path for the file directory Inputfiles.
Example: \\host\<selected_path>\AS2\Inputfiles\Tradacoms.
4. As File Name Tradacoms.xml should be set automatically.
5. In the graphical editor, right-click on channel for the receiver component. The channel view will open
and then name the channel, as in this case named it as B2B_AS2_ReceiverAS2_Variant1.
6. In adapter type field browse and select AS2 adapter.
7. Go to Adapter-Specific tab and under General tab fill the details as given below in the table
Header Field
Field Name
Value
Recipient
Recipient URL
<Enter The URL path of the partner
(initiator) where the incoming AS2 messages
shall be received>
e.g. http://host:port/Receiver.aspx
Basic Authentication
Message
Checked

Username
<User ID for login the system where
message will be received>

Password
<Password for login the system where
message will be received>
Use your credentials
Filename
MessageID left
MessageID right
<Enter the file name>
File_var1.txt
.*
.*
<Enter the AS2 identifier >
Own AS2Name
AS2 name which is transmitted in
the AS2 message as AS2-FromParameter
e.g. AS2_<SID>_<User-ID>_var01
16
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
<Enter the AS2 Name of the Recipient >
Recipient AS2 Name
AS2 name which is transmitted in
the AS2 as AS2-To-Parameter
e.g. testas2
Own email- address
<Enter the email address >
The email address which is
transmitted in the AS2 message as
sender.
e.g. <user-id>@sap.com
Message subject
<Enter the subject of the message>
The message subject which is
transmitted in the AS2 message as
sender.
e.g. AS2_Scenario_sign_enc
Content-Type
<Enter the type of the content>
Content type with which the message is
marked.
application/edi-x12
Charset conversion
Checked
Charset

Source encoding
UTF-8

Destination encoding
UTF-8
8. Navigate to the tab Signature and Encryption and fill the details as given below in the table:
Header Field
Field Name
Value
Signature
Sign message
Check the sign message
View to own public key certificate
<Enter storage name of public key
certificate >
The NWA key-storage view in the
sending partner (SAP PI -initiator),
which contains the self (own) public key
certificate
e.g. AS2_CERTIFICATE / PI_Test-cert
for both (view and alias)
Alias of own public key certificate
<Enter the name of the public key>
The alias (or name) under which the self
(own) public key certificate is stored
See above
View to own private key
<Enter the key storage name of private
key>
The NWA key-storage view in the
sending partner (SAP PI - initiator),
17
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
which contains the self (own) private key
e.g. AS2_KEYSTORE / PI_Test for
both (view and alias)
Alias of own private key
Encryption
<Enter the name of the private key>
The alias (or name) under which the self
(own) private key is stored see above
Encrypt message
Check the encrypt message box
Checked
Algorithm
<Select the encryption algorithm >
The encryption algorithm to be used
(default is AES 128. The other available
values are AES 192, AES 256, 3DES and
RC2
3DES
View to recipient‟s public key
certificate
<Enter the storage name of the public key>
The NWA key-storage view in the
sending partner (SAP PI- initiator),
which contains the receiving partner‟s
(responder) public key certificate
AS2_CERTIFICATE / Partner_Test-cert
<Enter the storage name of the public key>
View to recipient‟s public key
certificate
The alias (or name) under which the
receiving partner‟s (responder) public
key certificate is stored
AS2_CERTIFICATE / Partner_Test-cert
9. Now go to MDN tab and give the details as below:
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Select Synchronous
Verify MIC
Request Signing
Verify Signature
Checked
Checked
Checked
View to signer‟s public key
certificate
<Enter the key storage name>
MDN
The NWA key-storage view in the sending partner
(SAP PI- initiator), which contains the receiving
partner‟s (responder) public key certificate
AS2_CERTIFICATE / Partner_Test-cert
18
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Alias of signer‟s public key
certificate
<Enter the key name>
The alias (or name) under which the receiving
partner‟s (responder) public key certificate is stored
AS2_CERTIFICATE / Partner_Test-cert
1. Go to Module Tab and Add Converter module Tradacoms converter
“localejbs/GenericConverterModule”. For adding the converter module bean click on the
Add button. Move the GenericConverterModule module bean to the first position by clicking on
the Move Up button which is present at the right hand side. The final screen should look like as
given below:
2.11 Saving and Activating the Configuration Objects
In the following steps, you save the integration flow with all its objects and activate it for the runtime.
1. Save the Integration Flow by pressing the save button (
).
2. Use the Activate entry in the context menu of the integration flow
AS2_Variant1_IntFlowScenario_<User-ID> to activate the configuration.
3. Use the Deploy entry in the context menu of the integration flow
AS2_Variant1_IntFlowScenario_<User-ID> to deploy it in the runtime.
2.12 Configuring the trading partner
2.12.1 Creating the trading partner
2.13 Executing the Use Case
You perform the following steps to check that the use case is executed without errors.
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for receiving the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
1. On the host of the Advanced Adapter Engine Extended, open the file directory Tradacoms.
2. Rename the file ZB2B_Tradcoms.xml as B2B_Tradcoms.xml.
3. The File adapter is designed in a way that a file with exactly this name is recognized and moved
from the source directory to the AS2 Recipient every 60 seconds. If the configuration was executed
without errors, the file will be moved from the source directory within 60 seconds after it is renamed.
4. Open the third party software (In this case /n software) http://host:port/Default.aspx
5. Go to Incoming Tab select the trading partner “SAPPI_<SID>_<User-ID>_01”. The tab content
shows the successfully received messages.
6. Also the “Logs” tab shows the logs of the incoming messages (successful transmissions and errors if
any) and the MDN requested by the sender will be available in the “Logs”.
OR
19
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. As the third party software will be installed in a server. You can also go to the file structure of the
server where the third party is installed and can also check the Incoming file on the basis of the
party.
8. Open the received file and compare with the original file ZB2B_Tradcoms.xml and verify the content
of the received file. Received File can be found on: \\host\as2data\AS2_<SID>_<UserID>_var01\Incoming
The file must have been changed to tradacoms format when this variant is executed.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as follows:
Channel Monitoring:
1. Start the Monitoring by choosing Configuration and Monitoring Home on the Advanced Adapter
Engine Extended start page.
2. Choose Adapter Engine → Communication Channel Monitor
3. Use appropriate filter criteria to restrict the number of channels displayed. On the very right hand
side select Advanced to get all possible filter criteria displayed. To select your channels, put in the
channel ID (you can find it in the channel editor screen) into the communication channel field, press
Go and select your sender channel from the list.
4. Check that the channel is running without error.
5. In the Processing Details section you can find the processing logs and the links to the processed
messages. The link can be followed to get the message details.
6. In the processing log you can see the encryption and signing of the message has been done as you
have chosen these features in the scenario.
Message Monitoring:
1. Start the Monitoring by choosing Configuration and Monitoring Home on the Advanced Adapter
Engine Extended start page.
2. Choose Adapter Engine → Message Monitor.
3. Select Database.
4. Use appropriate filter criteria to restrict the number of XML messages displayed (for example, the
processing period). On the very right hand side select Advanced to get all possible filter criteria
displayed and open the Message Header Data section. To select using your Integration Flow name
put in the Integration Flow name into the field Integration Flow.
5. Choose Go.
6. The system displays the selected messages in a table. You want to locate the messages that were
sent during execution.
7. Select the message to be displayed by selecting the appropriate radio button and then choose Open
Message.
8. The tab Payloads displays the message contents for the various versions of the message during
processing.
Note: This scenario described in this variant contains encryption and signing of message. You can also try
with different combination like without signing and with encryption or with signing and with encryption option
and test the scenario.
3
Variant 1b : AS2 Adapter with EDI Converter (Plain XML and XML to Plain)
This variant enables you to configure and execute: One sender (file directory Inputfiles) sends a message to
one receiver. Hereby, the message is exchanged between sender and receiver adapter by using one
Advanced Adapter Engine Extended and the EDI Converter has been used in the scenario which will convert
the message into Plain Message.
3.1 Design Objects Used
To call the ESR proceed as outlined in variant 1.
20
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
3.2 Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
3.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
3.4
Creating the Integration Flow
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant1b_Integration_FlowScenario.
3. Choose Next.
4. As Sender Business componet select the Business component
<SID>_<UserID>_B2B_BC_AS2_V1 you imported from SLD using the Browse… button.
5. As Interface select XiPatternInterface1.
6. In Tab Receiver Systems as Receiver componet select the Business component
<SID>_<UserID>_B2B_BC_AS2_V1 using the input help for the Receiver Name.
7. As Receiver Interface select XiPatternInterface1.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
3.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Apply Channel
Template. The Choose Channel Template screen will open.
2. Select the template XiPatternChannel_FileSender of software component version SAP BASIS
7.31 and press OK. Change to the channel view.
3. In tab Adapter Specific under File Access Parameter in the Source Directory field, enter the path in
the file directory that you defined previously (see 2.2.6). In the case of the sender communication
channel, enter the whole path for the file directory Inputfiles.
Example: ../../../../SYS/global/Connectivity_Test/B2B/AS2/Inputfiles.
4. As File Name AS2_Converter.txt should be set.
5. Go to the Module tab and Add Odette converter “localejbs/PlainConverterModule”.
For adding the converter module bean, click on the Add button. Move the converter module bean to
the first step by clicking on the Move Up button which is present at the right hand side. The final
screen should look like as given below:
21
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. In the graphical editor, right-click on channel for the receiver component. The channel view will open
and then name the channel, as in this case named it as B2B_AS2_ReceiverAS2_Var1.
7. In adapter type field browse and select AS2 adapter.
8. Go to Adapter-Specific tab and under General tab fill the details as given in the variant1 table.
Uncheck the characterset conversion check box.
9. Navigate to the tab Signature and Encryption and fill the details as given in the variant1 table.
10. Now go to MDN tab and give the details as given in variant1.
Note: An MDN (Message Delivery Notification) is a functional acknowledgement of receipt generated by the
receiving party to positively or negatively acknowledge the success/failure/error in receipt of the original AS2
message.
11. Now go to Module tab and similarly add converter module “localejbs/PlainConverterModule” as given
below
3.6
Saving and Activating the Configuration Object
Proceed as described in variant1.
3.7 Configuring the trading partner
You can reuse the trading partner that was created and configured in variant 1.
3.8
Executing the Use Case
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for receiving the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
You perform the following steps to check that the use case is executed without errors.
1. On the host of the Advanced Adapter Engine Extended, open the file directory Inputfiles.
2. Rename the file ZAS2_Converter.txt as AS2_Converter.txt
The File adapter is designed in a way that a file with exactly this name is recognized and moved
from the source directory to the AS2 Recipient every 60 seconds. If the configuration was executed
without errors, the file will be moved from the source directory within 60 seconds after it is renamed.
3. Open the third party software (In this case /n software) http://host:port/Default.aspx
4. Go to Incoming Tab select the trading partner “SAPPI_<SID>_<User-ID>_01” (created in variant 1).
The tab content shows the successfully received messages.
5. Also the “Logs” tab shows the logs of the incoming messages (successful transmissions and errors if
any) and the MDN requested by the sender will be available in the “Logs”.
OR
6. As the third party software will be installed in a server. You can also go to the file structure of the
server where the third party is installed and can also check the Incoming file on the basis of the
party.(Please refer the section 2.2.6 for checking the file).
22
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. Open the received file and compare with the original file ZAS2_Converter.txt and verify the
content of the received message should be same and the format of the received message will be
Plain . The size of the file should be compressed (size of the format should be lesser than the
original file) when this variant is executed.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel
and message monitoring. To do this, proceed as given in variant1.
4
Variant 2a: AS2 Adapter – Encryption, Signature and Compression of the
message with Asynchronous MDN
This variant enables you to configure and execute: One sender (file directory Inputfiles) sends a message to
one receiver. Hereby, the message is exchanged between sender and receiver adapter by using one
Advanced Adapter Engine Extended and the mapping used in the scenario will convert the message into the
ANSI type.
4.1 Design Objects Used
To call the ESR proceed as outlined in variant 1.
4.1.1 Summary of Design Objects Used
The design objects used are summarized once more in the following table.
Object Type (Name)
Service Interfaces (INVOIC.INVOIC02
SI_INBOUND_EDI_ANSIX12_INVOICE)
Description
Specifies the communication mode (asynchronous) and references the
message type used.
Message Type (ASC810_004010)
Describes the message sent at runtime and references the data type
used.
Data Type (ASC810_004010)
Describes the data structure of the message
4.2 Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
4.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
4.4
Creating the Integration Flow
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant2_IntFlowScenario_<User-ID>
3. Choose Next.
4. To assign Business component to sender right click on the sender -> New Business component ->
name as <SID>_<User-ID>_B2B_BC_AS2_V2-> Click Finish.
23
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
5. As Interface select INVOIC.INVOIC02.
6. In Tab Receiver Systems as Receiver component select the Business component <SID>_<UserID>_B2B_BC_AS2_V2 using the input help for the Receiver Name.
7. As Receiver Interface select SI_INBOUND_EDI_ANSIX12_INVOICE.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
10. On the line representing the message flow to receiver <SID>_<User-ID>_B2B_BC_AS2_V2 in the
context menu select Add Mapping.
11. Select the mapping object in the graphical view. The properties tab will open.
12. Using the Browse functionality select the operation mapping OM_INVOIC02_TO_ASC810_4010.
4.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Apply Channel
Template. The Choose Channel Template screen will open.
2. Select the template XiPatternChannel_FileSender of software component version SAP BASIS
7.31 and press OK. Change to the channel view.
3. In tab Adapter Specific under File Access Parameter in the Source Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the sender communication
channel, enter the whole path for the file directory Inputfiles\ANSI.
Example: \\host\<selected_path>\AS2\Inputfiles\ANSI
4. As File Name ANSI.XML should be set .
5. In the graphical editor, right-click on channel for the receiver component. The channel view will open
and then name the channel, as in this case named it as B2B_AS2_ReceiverAS2_Variant2.
6. In adapter type field browse and select AS2 adapter.
7. Go to Adapter-Specific tab and under General tab fill the details as given in the variant1 table.
Uncheck the characterset conversion check box.
AS2_<SID>_<User-ID>_var02 as Own AS2Name
8. Navigate to the tab Signature and Encryption and fill the details as given in the variant1 table
and check the Compress message check box.
9. Now go to MDN tab and give the details as below:
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Select Asynchronous
MDN target-URL
<Enter the URL where the MDN will be received>
MDN
http:/<host>:port/AS2/mdn
Request signing
Check the request signing
Checked
Algorithm
SHA1
View to signer‟s public key
<Enter the key storage name>
24
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
certificate
Alias of signer‟s public key
certificate
<Enter the key name>
Create new XI message for
received MDN
None
Note: An MDN (Message Delivery Notification) is a functional acknowledgement of receipt generated by the
receiving party to positively or negatively acknowledge the success/failure/error in receipt of the original AS2
message.
4.6
Saving and Activating the Configuration Object
Proceed as described in variant1.
4.1
Configuring the trading partner
4.1.1
Creating the trading partner on AS2 connector
Proceed as Variant 1
1. On “Organization Name”, type: SAPPI_<SID>_<User-ID>_02
2. On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_var02
3. On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_V2
4. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Unchecked
Unchecked
Incoming Message
Security
Require Signature
Require encryption
Checked
checked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
5. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
Checked
Security
Signed / Unsigned
Signed
Delivery
Synchronous / Asynchronous
Asynchronous
25
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
7. Click on “Save Changes”
4.2
Executing the Use Case
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for receiving the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
You perform the following steps to check that the use case is executed without errors.
1. On the host of the Advanced Adapter Engine Extended, open the file directory Inputfiles.
2. Rename the file ZB2B_ANSI.xml as B2B_ANSI.xml.
The File adapter is designed in a way that a file with exactly this name is recognized and moved
from the source directory to the AS2 Recipient every 60 seconds. If the configuration was executed
without errors, the file will be moved from the source directory within 60 seconds after it is renamed.
3. Open the third part software http://host:port/Default.aspx?a=Incoming go to Incoming Tab select the
trading partner “SAPPI_<SID>_<User-ID>_02”. The tab content shows the successfully received
messages.
Received File can be found on: \\host\as2data\ AS2_<SID>_<User-ID>_var02\Incoming
4. Also the “Logs” tab shows the logs of the incoming messages (successful transmissions and errors if
any) and the MDN requested by the sender will be available in the “Logs”.
5. Check in the “Received Transmissions” if a file was received and an MDN was generated.
OR
6. As the third party software will be installed in a server. You can also go to the file structure of the
server where the third party is installed and can also check the Incoming file on the basis of the
party.
7. Open the received file and compare with the original file ZB2B_ANSI.xml and verify the content of
the received file and size of the file as the file must be changed to ANSI format and the size of the
format should be lesser than the original file when this variant is executed.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel
and message monitoring. To do this, proceed as given in variant1.
26
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
5
Variant 2b: AS2 Adapter – Encryption, Signature and Compression of the
message with Asynchronous MDN and Creation of New XI Message.
The feature tested here for AS2 adapter is, creation of new XI message specifically for MDN tracking .


Integration Flow 1: Sender: File Adapter, Receiver: AS2 Adapter.
The message is sent from the file adapter and AS2 adapter receives the message.
Integration Flow 2: Sender: AS2 Adapter , Receiver: File adapter
The MDN will be received at the AS2 sender, new XI message will be generated in the
communication channel monitoring and then the MDN will be sent to the file adapter (receiver).
5.1 Design Objects Used
To call the ESR proceed as outlined in variant 1.
5.1.1 Summary of Design Objects Used
The design objects used are summarized once more in the following table.
Object Type (Name)
Service Interfaces (INVOIC.INVOIC02
SI_INBOUND_EDI_ANSIX12_INVOICE)
Description
Specifies the communication mode (asynchronous) and references the
message type used.
Message Type (ASC810_004010)
Describes the message sent at runtime and references the data type
used.
Data Type (ASC810_004010)
Describes the data structure of the message
5.2 Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
5.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
5.4
Creating the Integration Flow1
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant2b_IntFlowScenario_<User-ID>
3. Choose Next.
4. To assign Business Component to sender, right click on the sender -> New Business component ->
name as <SID>_<User-ID>_B2B_BC_AS2_V2b-> Click Finish.
5. As Interface select INVOIC.INVOIC02.
27
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. In Tab Receiver Systems as Receiver component select the Business component <SID>_<UserID>_B2B_BC_AS2_V2 using the input help for the Receiver Name.
7. As Receiver Interface select SI_INBOUND_EDI_ANSIX12_INVOICE.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
10. On the line representing the message flow to receiver <SID>_<User-ID>_B2B_BC_AS2_V2b in
the context menu select Add Mapping.
11. Select the mapping object in the graphical view. The properties tab will open.
12. Using the Browse functionality select the operation mapping OM_INVOIC02_TO_ASC810_4010.
5.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Apply Channel
Template. The Choose Channel Template screen will open.
2. Select the template XiPatternChannel_FileSender of software component version SAP BASIS
7.31 and press OK. Change to the channel view.
3. In tab Adapter Specific under File Access Parameter in the Source Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the sender communication
channel, enter the whole path for the file directory Inputfiles\ANSI.
Example: \\host\<selected_path>\AS2\Inputfiles\ANSI
4. As File Name ANSI.XML should be set .
5. In the graphical editor, right-click on channel for the receiver component. The channel view will open
and then name the channel, as in this case named it as B2B_AS2_ReceiverAS2_Variant2.
6. In adapter type field browse and select AS2 adapter.
7. Go to Adapter-Specific tab and under General tab fill the details as given in the variant1 table.
Uncheck the characterset conversion check box.
AS2_<SID>_<User-ID>_var02 as Own AS2Name
8. Navigate to the tab Signature and Encryption and fill the details as given in the variant1 table
and check the Compress message check box.
9. Now go to MDN tab and give the details as below:
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Select Asynchronous
MDN target-URL
<Enter the URL where the MDN will be received>
MDN
http:/<host>:port/AS2/mdn
Request signing
Check the request signing
Checked
Algorithm
SHA1
View to signer‟s public key
certificate
<Enter the key storage name>
28
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Referenced MDN
Channel
5.6
Alias of signer‟s public key
certificate
<Enter the key name>
Create new XI message for
received MDN
Both positive and negative MDN
Channel Name
AS2 Sender channel name (from Integration Flow2)
Communication Component
AS2 Sender Communication Component (from
Integration Flow2)
Saving and Activating the Configuration Object
Proceed as described in variant1.
5.7
5.7.1
Configuring the trading partner
Creating the trading partner on AS2 connector
Proceed as Variant 1
1. On “Organization Name”, type: SAPPI_<SID>_<User-ID>_02b
2. On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_var02b
3. On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_V2b
4. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Unchecked
Unchecked
Incoming Message
Security
Require Signature
Require encryption
Checked
checked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
5. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
Checked
Security
Signed / Unsigned
Signed
Delivery
Synchronous / Asynchronous
Asynchronous
29
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
7. Click on “Save Changes”.
5.8
Creation of Integration Flow2
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow ( ).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant2b_IntFlowScenario_<User-ID>_MDN.
3. Choose Next.
4. To assign Business component to sender right click on the sender -> New Business Component,
name as <SID>_<User-ID>_B2B_BC_AS2_V2b_MDN-> Click Finish.
5. As Interface select XiPatternInterface2.
6. In Tab Receiver Systems as Receiver component select the Business
component<SID>_<UserID>_B2B_BC_AS2_V2b_MDN using the input help for the Receiver Name.
7. As Receiver Interface XiPatternInterface2 .
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
5.9
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Configure channel.
The channel view screen will open. Name the sender channel as B2B_AS2Sender_MDN.
2. In adapter type field browse and select AS2 adapter.
3. Select Transport protocol as AS2MDN.
4. In the graphical editor, right-click on channel for the receiver component. Select Apply Channel
Template. The Choose Channel Template screen will open.
5. Select the template XiPatternChannel_FileReceiver of software component version SAP
BASIS 7.31 and press OK. Change to the channel view.
6. In tab Adapter Specific under File Access Parameter in the Target Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the receiver communication
channel, enter the whole path for the file directory AS2.
Example: \\host\<selected-path>\AS2\Receiver.
7. As File Name mdn.txt should be set.
30
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
5.10 Executing the Use Case
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for receiving the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
You perform the following steps to check the use case is executed without errors.
1. On the host of the Advanced Adapter Engine Extended, open the file directory Inputfiles.
2. Rename the file ZB2B_ANSI.xml as B2B_ANSI.xml.
The File adapter is designed in a way that a file with exactly this name is recognized and moved
from the source directory to the AS2 Recipient every 60 seconds. If the configuration was executed
without errors, the file will be moved from the source directory within 60 seconds after it is renamed.
3. Open the third part software http://host:port/Default.aspx?a=Incoming go to Incoming Tab select the
trading partner “SAPPI_<SID>_<User-ID>_02b”. The tab content shows the successfully received
messages.
Received File can be found on: \\host\as2data\ AS2_<SID>_<User-ID>_var02b\Incoming
4. Also the “Logs” tab shows the logs of the incoming messages (successful transmissions and errors if
any) and the MDN requested by the sender will be available in the “Logs”.
5. Check in the “Received Transmissions” if a file was received and an MDN was generated.
OR
6. As the third party software will be installed in a server. You can also go to the file structure of the
server where the third party is installed and can also check the Incoming file on the basis of the
party.
7. Open the received file and compare with the original file ZB2B_ANSI.xml and verify the content of
the received file and size of the file as the file must be changed to ANSI format and the size of the
format should be lesser than the original file when this variant is executed.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel
and message monitoring. To do this, proceed as given in variant1.
In the channel monitoring you can see the message ID for the Integration Flow2 communication
channels is newly created and it‟s different from the message ID generated for the Integration Flow1
communication channels.
You can open the newly created XI message ID(for the Integration flow2 channels) and check the
content of the payload. The payload will have MDN details. For doing so:
1.
2.
3.
4.
Click on the newly created XI message ID.
Click on Open Message.
Go to payload Tab.
Check for the MDN content.
Also check the mdn.txt file at the receiver location given in the configuration. MDN should be received at
the receiver location.
31
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6
Variant 3: AS2 Adapter – Decryption and Signature of the message without MDN
Signature
This variant enables you to configure one sender (AS2) sends a message to one receiver (File). Hereby, the
message is exchanged between sender and receiver adapter by using one Advanced Adapter Engine
Extended. The mapping used in the scenario will change the message format to Edifact type.
6.1
Design Objects Used
To call the ESR proceed as in variant1
6.1.1
Summary of Design Objects Used
The design objects used are summarized once more in the following table.
Design Objects Used
Object Type (Name)
Description
Service Interfaces
Specifies the communication mode (asynchronous) and references the
message type used.
(ORDERS.ORDERS05
SI_INBOUND_EDI_EDIFACT_ORDERS)
Message Type (ORDERS96A)
Describes the message sent at runtime and references the data type
used.
Data Type (ORDERS96A)
Describes the data structure of the message
6.2
Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
6.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
6.4
Creating the Integration Flow
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant3_IntFlowScenario_<User-ID>
3. Choose Next.
4. To assign Business component to sender right click on the sender -> New Business component ->
name as <SID>_<User-ID>_B2B_BC_AS2_V3-> Click Finish.
5. As Interface select ORDERS.ORDERS05.
6. In Tab Receiver Systems as Receiver component select the Business component <SID>_<UserID>_B2B_BC_AS2_V3 using the input help for the Receiver Name.
32
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. As Receiver Interface select SI_INBOUND_EDI_EDIFACT_ORDERS.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
10. On the line representing the message flow to receiver <SID>_<User-ID>_B2B_BC_AS2_V3 in the
context menu select Add Mapping.
11. Select the mapping object in the graphical view. The properties tab will open.
12. Using the Browse functionality select the operation mapping OM_INVOIC02_TO_INVOICTO9.The
integration Flow will be displayed in a graphical overview OM_ORDERS05_TO_ORDERS96A.
6.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Configure
channel. The channel view screen will open. Name the sender channel as
B2B_AS2_SenderAS2_Variant3.
2. In adapter type field browse and select AS2 adapter.
3. Go to Adapter-Specific tab and under General tab fill the details as given in the table below.
HEADER FIELD
FIELD NAME
VALUE
Server
Expected URL-Path
<Enter The URL path of the partner
(initiator) where the incoming AS2 messages
shall be received>
AS2DispatcherServlet_<User-ID>_V3
Message
Expected Message ID left
Expected Message ID right
Specifies the left part of the incoming AS2
MessageID.
“.*” (type without quotes)
Specifies the right part of the incoming AS2
MessageID.
”.*”
<Enter the AS2 identifier >
Expected sender‟s AS2Name
AS2 name which is transmitted in the AS2
message as AS2-From-Parameter
e.g. testas2
<Enter the AS2 Identifier>
Expected own AS2 name
The email address which is transmitted in the
AS2 message as sender.
AS2_<SID>_<User-ID>_var03
Expected subject
<Enter the subject of the message>
The message subject which is transmitted in
the AS2 message as sender.
.*
33
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Charset conversion
Checked
Charset
Message configuration

Source encoding

Destination encoding
set dynamic parameter
QoS
UTF-8
UTF-8
Checked
Exactly once
4. Navigate to the tab Signature and Encryption and fill the details as given in the table below:
HEADER FIELD
FIELD NAME
VALUE
Signature
Verify Signature
Checked
View to sender‟s public key
certificate
<Enter storage name of public key certificate >
The NWA key-storage view in the sending
partner (SAP PI -initiator), which contains the
self (own) public key certificate
AS2_CERTIFICATE / Partner_Test-cert
Alias of sender‟s public key
certificate
<Enter the name of the public key>
The alias (or name) under which the self
(own) public key certificate is stored
AS2_CERTIFICATE / Partner_Test-cert
Decryption
Decrypt message
View to own private key
Alias of own private
Check the decrypt message box
significance same as receiver
configuration
AS2_KEYSTORE / PI_Test
channel
significance same as receiver channel
configuration
AS2_KEYSTORE / PI_Test
5. Now go to MDN tab and give the details as below:
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Uncheck the sign MDN
MDN
Override URL for MDN
Unchecked
34
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Basic HTTP Authentication
Proxy server
Unchecked
Unchecked
Note: An MDN (Message Delivery Notification) is a functional acknowledgement of receipt generated by the
receiving party to positively or negatively acknowledge the success/failure/error in receipt of the original AS2
message.
6. In the graphical editor, right-click on channel for the receiver component. Select Apply Channel
Template. The Choose Channel Template screen will open.
7. Select the template B2B_AS2_FileReceiver of software component version B2BTOOLKIT
1.0 and press OK. Change to the channel view.
8. In tab Adapter Specific under File Access Parameter in the Target Directory field, enter the path
in the file directory that you defined previously (see 2.2.3). In the case of the receiver
communication channel, enter the whole path for the file directory Receiver.
\\host\<selected-path>\AS2\Receiver
9. As File Name output.txt should be set automatically.
6.6
Saving and Activating the Configuration Objects
Proceed as described in variant1.
6.7
Configuring the trading partner
6.7.1
Creating the trading partner on AS2 connector
Proceed as Variant 1
1. On “Organization Name”, type: SAPPI_<SID>_<User-ID>_03
2. On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_var03
3. On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http:// host:port/AS2/AS2DispatcherServlet_<User-ID>_V3
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
4. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Checked
Checked
Incoming Message
Security
Require Signature
Require encryption
Unchecked
Unchecked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
Unchecked
35
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
encryption algorithms…
5. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
Checked
Security
Signed / Unsigned
Unsigned
Delivery
Synchronous / Asynchronous
Synchronous
6. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
7. Click on “Save Changes”.
6.7.2
Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1. Go to the corresponding folder of the trading partner you just created.
\\host\as2data\ AS2_<SID>_<User-ID>_var03\Outgoing
2. Copy the file “B2B_Edifact.xml” into the “Outgoing” folder.
6.8
Executing the Use Case
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for sending the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
1. Start the sender and receiver channels before sending the message.
2. Go to http://<host>:<port>/Default.aspx and navigate to the Outcoming tab.
3. Select the trading partner “SAPPI_<SID>_<User-ID>_03”. The tab content shows the messages
present at the trading partner location.
4. Click on the send button.(Input file you can get from the directory Inputfiles)
5. On the host of the Advanced Adapter Engine Extended, open the file directory AS2.
6. Example: \\host\<selected-path>\AS2\Receiver
7. Verify the contents of the file –“output.txt” at the file target directory.
36
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Go to file structure of the server where the third party is installed
http://host:port/Default.aspx?a=Outgoing and select the trading partner “SAPPI_<SID>_03. The tab
content shows the successfully sent messages in the “Sent Files” tab. Also the “Logs” tab shows the
logs of the outgoing messages (successful transmissions and errors if any) and the MDN.
9. Open the received file and compare with the file sent. The received message should be in Edifact
format and the content of the file should be same.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1
In the processing log you can see the decryption and signing of the message has been done as you
have chosen these features in the scenario.
Note: This scenario described in this variant contains decryption and signing of message. You can also try
with different combination like without signing and with decryption or with signing and with decryption option
and test the scenario.
7
Variant 4a: AS2 Adapter – No Decryption and No Signature of the message with
Signed Async MDN
This variant enables you to configure one sender (AS2) sends a message to one receiver(File). Hereby, the
message is exchanged between sender and receiver adapter by using one Advanced Adapter Engine
Extended. The mapping used in the scenario will change the message format to Odette type.
7.1
Design Objects Used
To call the ESR proceed as in variant1
7.1.1
Summary of Design Objects Used
The design objects used are summarized once more in the following table.
Design Objects Used
Object Type (Name)
Description
Service Interfaces (INVOIC.INVOIC02
Specifies the communication mode (asynchronous) and references the
message type used.
SI_INBOUND_EDI_ODETTE_INVOIC)
Message Type (INVOIC3)
Describes the message sent at runtime and references the data type
used.
Data Type (INVOIC3)
Describes the data structure of the message
7.2
Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
37
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
7.4
Creating the Integration Flow
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow ( ).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_Variant4_IntFlowScenario_<UserID>
3. Choose Next.
4. To assign Business component to sender right click on the sender -> New Business component->
name as <SID>_<User-ID>_B2B_BC_AS2_V4-> Click Finish
5. As Interface select INVOIC.INVOIC02.
6. In Tab Receiver Systems as Receiver Component select the Business Component
<SID>_<UserID>_B2B_BC_AS2_V4 using the input help for the Receiver Name.
7. As Receiver Interface SI_INBOUND_EDI_ODETTE_INVOIC.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
10. On the line representing the message flow to receiver <SID>_<UserID>_B2B_BC_AS2_V4 in the
context menu select Add Mapping.
11. Select the mapping object in the graphical view. The properties tab will open.
12. Using the Browse functionality select the operation mapping OM_INVOIC02_TO_INVOIC3 .
The integration Flow will be displayed in a graphical overview OM_INVOIC02_TO_INVOIC3.
7.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Configure channel.
The channel view screen will open. Name the sender channel as
B2B_AS2_SenderAS2_Variant4.
2. In adapter type field browse and select AS2 adapter.
3. Go to Adapter-Specific tab and under General tab fill the details as given in the table below.
HEADER FIELD
FIELD NAME
VALUE
Server
Expected URL-Path
<Enter The URL path of the partner
(initiator) where the incoming AS2
messages shall be received>
AS2DispatcherServlet_<User-ID>_V4
Message
Expected Message ID left
Specifies the left part of the incoming AS2
MessageID. Recommended : ”.*”
Expected Message ID right
Specifies the right part of the incoming AS2
Message ID.
Recommended : ”.*”
Expected sender‟s AS2Name
<Enter the AS2 identifier >
testas2
38
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
<Enter the AS2 Identifier>
Expected own AS2 name
The email address which is transmitted in
the AS2 message as sender.
AS2_<SID>_<User-ID>_Var04
Expected subject
<Enter the subject of the message>
The message subject which is transmitted
in the AS2 message as sender.
.*
Charset conversion
Checked
Charset
Message configuration

Source encoding

Destination encoding
<Enter the type of incoming message
encoding> UTF-8
<Enter the type of outgoing message
encoding > UTF-8
set dynamic parameter
Checked
QoS
Exactly once
4. Navigate to the tab Signature and Encryption and fill the details as given in the table below:
HEADER FIELD
FIELD NAME
VALUE
Signature
Verify Signature
Unchecked
Decryption
Decrypt message
Uncheck the decrypt message box
5. Now go to MDN tab and give the details as below:
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Check the sign MDN
View to own public key certificate
<Enter storage name of public key certificate >
MDN
The NWA key-storage view in the sending
partner (SAP PI –initiator), which contains the
self (own) public key certificate
AS2_CERTIFICATE / PI_Test-cert
Alias of own public key certificate
<Enter the name of the public key>
The alias (or name) under which the self (own)
public key certificate is stored
AS2_CERTIFICATE / PI_Test-cert
View to own private key
significance
same
as
receiver
channel
39
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
configuration
AS2_KEYSTORE / PI_Test
Alias of own private
significance same as receiver channel
configuration
AS2_KEYSTORE / PI_Test
Send options
Immediate
Override URL for MDN
Checked
Async MDN URL
http://host:port/AsyncMDN.aspx
Basic HTTP Authentication
Checked
Username
<User ID for login the system where message will
be received>
Password
<Password for login the system where message will
be received>
Use your credentials
Proxy server
Unchecked
6. In the graphical editor, right-click on channel for the receiver component. Select Apply Channel
Template. The Choose Channel Template screen will open.
7. Select the template XiPatternChannel_FileReceiver of software component version
B2BTOOLKIT 1.0 and press OK. Change to the channel view.
8. In tab Adapter Specific under File Access Parameter in the Target Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the receiver communication
channel, enter the whole path for the file directory AS2.
Example: \\host\<selected-path>\AS2\Receiver.
9. As File Name output.txt should be set.
10. Go to the Module tab and Add Odette converter “localejbs/OdetteConverterModule”.
For adding the converter module bean, click on the Add button. Move the converter module bean to
the first step by clicking on the Move Up button which is present at the right hand side. The final
screen should look like as given below:
40
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7.6
Saving and Activating the Configuration Objects
Proceed as described in variant1.
7.7
Configuring the trading partner
7.7.1
Creating the trading partner on AS2 connector
Proceed as Variant 1
1. On “Organization Name”, type: SAPPI_<SID>_<User-ID>_04
2. On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_Var04
3. On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_V4
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
4. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Unchecked
Unchecked
Incoming Message
Security
Require Signature
Require encryption
Unchecked
Unchecked
Compression
Compress Outgoing Data
checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
5. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
checked
Security
Signed / Unsigned
signed
Delivery
Synchronous / Asynchronous
Asynchronous
6. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Can be left empty
41
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Server Authentication
7. Click on “Save Changes”
7.7.2
Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1
2
Go to the corresponding folder of the trading partner you just created.
e.g. \\host\as2data\AS2_<SID>_<User-ID>_Var04\Outgoing
Copy the file “B2B_Odette.xml” into the “Outgoing” folder.
7.8
Executing the Use Case
Here the whole execution is described on the basis of third party /n software . In this variant the third party
has been used for sending the message . Third party can vary in your case . For the configuration of third
party in /n software please refer the section ‎2.2.3.
1. Start the sender and receiver channels before sending the message from third party software.
2. Go to http://host:port/Default.aspx and navigate to the Outcoming tab.
3. Select the trading partner “SAPPI_<SID>_<User-ID>_04”. The tab content shows the messages
present at the trading partner location.
4. Click on the send button.(Input file you can get from the directory Inputfiles)
5. On the host of the Advanced Adapter Engine Extended, open the file directory Receiver.
6. Example: \\host\<selected-path>\AS2\Receiver.
7. Verify the contents of the file –“output.txt” at the file target directory.
8. Go to file structure of the server where the third party is installed
http://host:port/Default.aspx?a=Outgoing and select the trading partner “SAPPI_<SID>_<UserID>_04”. The tab content shows the successfully sent messages in the “Sent Files” tab. Also the
“Logs” tab shows the logs of the outgoing messages (successful transmissions and errors if any) and
the MDN.
9. In the “Logs” tab open the “Request” link for the recently executed message. The Receipt-deliveryoption should be the same URL as given in the configuration (Async MDN URL).
10. Open the received file and compare with the file sent. The received message should be in Odette
format and the content of the file should be same.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1.
In the processing log you can see there will not be any kind of decryption and signing of the message as you
have not chosen these features in the scenario.
8
Variant 4b: AS2 Adapter – Duplicate message handling Feature in AS2
The feature tested here for AS2 adapter is the duplicate message handling feature in the sender channel.
The variant involves the feature to avoid/control the processing of duplicate messages using AS2 Sender
Channel. It also provides flexible threshold configuration and channel stops (if threshold exceeds) options.
The message flow will start from the file adapter.

Integration Flow 1: Sender: File Adapter, Receiver: AS2 Adapter.
42
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration

The message is sent from the file adapter and AS2 adapter receives the message and sends it to a
receiver communication channel .
Integration Flow 2: Sender: AS2 Adapter , Receiver: File adapter
The message received at the AS2 sender will be sent again to the file adapter (receiver).
8.1 Design Objects Used
To call the ESR proceed as outlined in variant 1.
8.2 Configuring the Process Integration Scenario
In configuration, you use the design objects in the process integration scenario for the actual system
landscape. You have already described the system landscape in the SLD. The communication components
you defined earlier enable you to address the involved business systems as senders/receivers of messages
from the in the Process Integration Designer.
You perform the following configuration steps in the SAP Process Integration Designer for the Advanced
Adapter Engine Extended.
8.3
Calling the Process Integration Designer
Follow the procedure mentioned in variant1.
8.4
Creating the Integration Flow1
Perform the following steps to create a new integration flow.
1. In the Process Integration Designer choose New → Integration Flow (
).
2. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name
and ID of the Integration Flow as AS2_DuplicateCheck1_Integration_FlowScenario.
3. Choose Next.
4. As Sender Business component select the Business component
<SID>_<UserID>_B2B_BC_AS2_V4 you imported from SLD using the Browse… button.
5. As Interface select XiPatternInterface1.
6. In Tab Receiver Systems as Receiver Component select the Business Component.
<SID>_<UserID>_B2B_BC_AS2_V4 using the input help for the Receiver Name.
7. As Receiver Interface select XiPatternInterface1.
8. Choose Finish.
9. The integration Flow will be displayed in a graphical overview.
8.5
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
1. In the graphical editor, right-click on channel for the sender component. Select Apply Channel
Template. The Channel Template screen will open.
2. Select the template XiPatternChannel_FileSender of software component version SAP BASIS
7.31 and press OK. Change to the channel view.
3. In tab Adapter Specific under File Access Parameter in the Source Directory field, enter the path in
the file directory that you defined previously (see 2.2.6). In the case of the sender communication
channel, enter the whole path for the file directory Inputfiles.
Example: ../../../../SYS/global/Connectivity_Test/B2B/AS2/Inputfiles.
4. As File Name input.txt should be set.
5. In the graphical editor, right-click on channel for the receiver component. The channel view will open
and then name the channel, as in this case named it as B2B_DuplicateCheck_AS2_Rec
6. In adapter type field browse and select AS2 adapter.
7. Go to Adapter-Specific tab and under General tab fill the details as given below in the table
43
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Header
Field
Field Name
Value
Recipient
Recipient URL
https://<host:port>/AS2/AS2DispatcherServlet/DuplicateCheck/
Basic Authentication
Checked
Message

Username
<User ID for login the system where message will be
received>

Password
<Password for login the system where message will be
received>
Use your credentials
Filename
MessageID left
MessageID right
<Enter the file name>
Duplicate
12345
54321
<Enter the AS2 identifier >
Own AS2Name
e.g. duplicateSender
<Enter the AS2 Name of the Recipient >
Recipient AS2 Name
AS2 name which is transmitted in the AS2 as AS2To-Parameter
e.g. duplicateReceiver
Own email- address
<Enter the email address >
The email address which is transmitted in the AS2
message as sender.
e.g. [email protected]
Message subject
<Enter the subject of the message>
The message subject which is transmitted in the AS2
message as sender.
e.g. duplicateTest
Content-Type
<Enter the type of the content>
Content type with which the message is marked.
e.g application/edi-x12
8. Navigate to the tab Signature and Encryption and fill the details as given in the table below:
44
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
HEADER FIELD
FIELD NAME
VALUE
Signature
Verify Signature
Checked
Algorithm
SHA 224 (Algorithm used to sign
the message)
View to own public key certificate
<Enter storage name of public
key certificate >
The NWA key-storage view in
the sending partner (SAP PI initiator), which contains the
self (own) public key certificate
e.g. AS2_CERTIFICATE /
PI_Test-cert for both (view and
alias)
Alias of own public key certificate
<Enter the name of the public key>
The alias (or name) under
which the self (own) public key
certificate is stored
See above
View to own private key
<Enter the key storage name of
private key>
The NWA key-storage view in
the sending partner (SAP PI initiator), which contains the
self (own) private key
e.g. AS2_KEYSTORE / PI_Test
for both (view and alias)
Alias of own private key
<Enter the name of the private
key>
The alias (or name) under which
the self (own) private key is stored
see above
Decryption
Decrypt message
Uncheck the decrypt message box
9. Navigate to the tab MDN Tab and fill the details as given in the table below
45
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
HEADER FIELD
FIELD NAME
VALUE
Message Delivery Notification
Select Synchronous
Verify MIC
Checked
Request Signing
Checked
Algorithm
SHA 224
Verify Signature
Checked
View to signer‟s public key
certificate
<Enter the key storage name>
MDN
The NWA key-storage view in the sending partner
(SAP PI- initiator), which contains the receiving
partner‟s (responder) public key certificate
AS2_CERTIFICATE / Partner_Test-cert
Alias of signer‟s public key
certificate
<Enter the key name>
The alias (or name) under which the receiving
partner‟s (responder) public key certificate is stored
AS2_CERTIFICATE / Partner_Test-cert
8.6
Creating the Integration Flow2
Perform the following steps to create a new integration flow.
10. In the Process Integration Designer choose New → Integration Flow ( ).
11. In category Enterprise Integration Patterns select the Point-to-Point Pattern and set the name and ID
of the Integration Flow as AS2_DuplicateCheck2_Integration_FlowScenario.
12. Choose Next.
13. As Sender Business component select the Business component
<SID>_<UserID>_B2B_BC_AS2_V4 you imported from SLD using the Browse… button.
14. As Interface select XiPatternInterface2.
15. In Tab Receiver Systems as Receiver component select the Business
component<SID>_<UserID>_B2B_BC_AS2_V4 using the input help for the Receiver Name.
16. As Receiver Interface XiPatternInterface2 .
17. Choose Finish.
18. The integration Flow will be displayed in a graphical overview.
8.7
Creating Channels
You perform the following steps to configure the connection of the process integration scenario. You activate
the relevant sender-receiver relation (between the sender and receiver component) and assign both the
sender and receiver a (sender or receiver) communication channel.
46
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. In the graphical editor, right-click on channel for the sender component. Select Configure channel.
The channel view screen will open. Name the sender channel as
B2B_DuplicateCheck2_AS2Sender.
9. In adapter type field browse and select AS2 adapter.
10. Go to Adapter-Specific tab and under General tab fill the details as given in the table below.
HEADER FIELD
FIELD NAME
VALUE
Server
Expected URL-Path
AS2DispatcherServlet/DuplicateCheck/
Message
Expected Message ID left
12345
Expected Message ID right
54321
Expected sender‟s AS2Name
<Enter the AS2 identifier >
duplicateSender
<Enter the AS2 Identifier>
Expected own AS2 name
duplicateReceiver
Expected subject
<Enter the subject of the message>
duplicateTest
UnChecked
Charset
Charset conversion
Duplicate Handling
Enable Duplicate Handling
Checked
Duplicate Message Threshold
1
Disable channel if threshold
exceeded
Checked
Time period for Duplicate
check
1
Time period for duplicate
Check
Day
set dynamic parameter
Checked
QoS
Exactly once
Message configuration
11. Navigate to the tab Signature and Encryption and fill the details as given in the table below:
47
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
HEADER FIELD
FIELD NAME
VALUE
Signature
Verify Signature
Unchecked
Decryption
Decrypt message
Uncheck the decrypt message box
12. Navigate to the tab MDN and fill the details as given below:
HEADER FIELD
VALUE
Signature
Unchecked
Override URL for MDN
Unchecked
Basic HTTP
Authentication
Proxyserver
Unchecked
Unchecked
13. In the graphical editor, right-click on channel for the receiver component. Select Apply Channel
Template. The Choose Channel Template screen will open.
14. Select the template XiPatternChannel_FileReceiver of software component version SAP
BASIS 7.31 and press OK. Change to the channel view.
15. In tab Adapter Specific under File Access Parameter in the Target Directory field, enter the path in
the file directory that you defined previously (see 2.2.3). In the case of the receiver communication
channel, enter the whole path for the file directory AS2.
Example: \\host\<selected-path>\AS2\Receiver.
16. As File Name output.txt should be set.
8.8
Execution and Verification
1. Start all the four channels consumed in the above created integration flows.
2. As in AS2 sender channel you have enabled duplicate handling with threshold level 1. Only one
message will be processed and flowing sucessfully in all four different channels. When the
second message comes, the AS2 sender channel should throw an error and AS2 sender channel
should go to stop status as you have also checked the box Disable channel if threshold exceeds.
3. For running the scenario again, start the AS2 sender channel manually in the channel monitoring
and execute the scenario.
4. In the configuration we have set Time period for duplicate check as 1 Hour. The duplicacy of the
message should be checked for 1 hour and after that the duplicacy will not be identified and
channels will allow processing the duplicate message as well.
5. In the channel monitoring you should be able to see the message and MDN is signed by the
algorithm SHA 224.
48
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
9
Variant 5: AS2, EDI Separator (ANSI X12 transaction sets 830, 856, 997) and EDIXML Converter
On this variant, the AS2 adapter is used in combination with the EDI Separator (adapter) and the EDI_XML
Converter (module).
The message flow starts as an ASC X12 message containing two message types (transaction sets):
 Material Planning Schedule – 830
 Shipment Notice – 856
The EDI separator splits the message into each transaction set, which are converted into XML by the
X12Converter Module at each of the EDI Separator sender channels and sent to a receiver file adapter,
respectively.
Additionally an acknowledgment message (transaction code 997) is generated by the EDI Separator after
splitting, validating (optional) and dispatching the individual messages and sent back to the trading partner
(AS2 connector) via AS2 adapter. The 997 message generation by the EDI Separator channel can be tested
using the various configurable parameters available and the validation feature provided by the
X12ConverterModule of the EDI-XML Converter Module.
The configurable options for 997 message generation are:






Acknowledgment required or not
997 message in the transaction mode-"All”(global at parent message level) or transaction mode
“Individual”(local per message)
Positive Acknowledgment not required option for “All” transaction mode
Negative Acknowledgment not required option for “All” transaction mode
Partially accepted (P) acknowledgement code for “Individual” transaction mode
Execution modes:
 997 message for receipt and dispatch of messages only
 997 message for receipt and validation of individual messages
Note:
 Executing in Transaction Mode “All” means that even if a single message in the bulk parent message
fails (due to errors in configuration, dispatch, validation, etc), the entire transaction will be rolled back
with all the individual messages rejected (R).
 Executing in Transaction mode “Individual” means that, if one or more messages in the bulk parent
message fails (due to errors in configuration, dispatch, validation, etc), only those failed messages
will be rejected (R) while the successful messages will be accepted (A).
The General structure of the 997 Acknowledgment message is
ISA (Interchange Control header)
GS (Group segment header)
ST (Transaction set header)
AK1 -> Functional Group Response Header
AK2-> Transaction Set Response Header
AK3 -> Data Segment Note
AK4 -> Data Element Note
AK5 -> Transaction Set Response Trailer
AK9 -> Functional Group Response Trailer
SE (Transaction set trailer)
49
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
GE (Group trailer)
IEA (Interchange control trailer)
Four Integration Flows are configured in this variant:




9.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
The message is sent with AS2 protocol from a partner to the PI. A sender Communication Channel
with AS2 adapter receives the message and sends it to a receiver communication channel with
Adapter type EDI Separator.
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Transaction Set Identifier code: 830
The transaction set 830 is converted into XML on the sender side and sent to the file adapter
(receiver).
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Transaction Set Identifier code: 856
The transaction set 856 is converted into XML on the sender side and sent to the file adapter
(receiver).
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Transaction Set Identifier Code: 997 and sent back to the third party software (AS2 connector).
Configuring the Integration Flows
9.1.1 Calling the Process Integration Designer
If not done yet, open the SAP NetWeaver Developer Studio, connect to the systems and open the SAP
Process Integration Designer perspective as described on the Prerequisites section.
9.1.2 Creating the integration Flows
9.1.2.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
1. On the PI Explorer View, select “New Integration Flow” form the context menu (right click) or from
the toolbar menu (top-left) as shown in the screenshot below
50
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. On the Name field type “AS2_EDISep_R1_<User-ID>”, select “Point-to-Point Channel” and click on
“Next”
3. To Assign the business component to sender, right click on the sender -> Click on the New Business
component and give the name as Business Component <SID>_<UserID>_B2B_BC_AS2_EDISEP_V5_01 -> Click Finish.
4. Click on the Browse button for the field Interface and select the service interface
“XiPatternInterface1”, software component SAP BASIS 7.31
5. Select the “Receiver Systems” tab
6. Click on the field located on the column “Communication Components”, a browse button will appear
on the right side of the field, click on it and select the Business Component <SID>_<UserID>_B2B_BC_AS2_EDISEP_V5_01
7. Following the same procedure, select the service interface “XiPatternInterface1”, software
component SAP BASIS 7.31 on the field located under column “Interface”
8. Click on button “Finish”
9.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow1, create the second Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_S1_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_02
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_02
9.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow 1, create the third Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_S2_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_03
51
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_03
9.1.2.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Following the same steps for Integration Flow 1, create the fourth Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_S3_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_04
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V5_04
9.1.3
9.1.3.1
Configuring the integration Flows
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
In the following steps, you configure the first Integration Flow using AS2 adapter as sender and EDI
separator as receiver.
Configuring the AS2 adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_R1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel (please see screenshot below)
3. As adapter type, select AS2 (Software Component B2B Toolkit 1.0)
4. On the field Channel Name type: AS2_sender
5. Select tab “Adapter-Specific”. Under sub-tab “General” provide the following configuration values:
Category
Field Name
Value
52
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Server
Expected URL-Path
AS2DispatcherServlet_<User-ID>_R1
Message
Expected Message ID left
<Specifies the left part of the incoming AS2
MessageID>
This is a regular expression. For more
information on regular expressions you can refer
to the following link: Regular expression
Patterns>
Type without the quotes:
”.*”
Expected Message ID right
<Specifies the right part of the incoming AS2
Message ID>
”.*“
<aka Organization name on AS2 connector>
Expected sender‟s AS2Name
testas2
Expected own AS2 name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var05_Outbound_PO_SE
Expected subject
“.*”
Charset
Charset conversion

Source encoding

Destination encoding
Checked
ISO-8859-1
UTF-8
Message
configuration
Set dynamic parameter
Quality of Service
Checked
Exactly Once (asynchronous)
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
53
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Signature
Field Name
Value
Verify Signature
Checked
View to sender‟s public key
certificate
<The NWA key-storage view containing the
sending partner‟s public key certificate and alias
(or name) under which the sending partner‟s
public key certificate is stored.>
Use the browse button to select both, View and
Alias, and click OK
Alias of sender‟s public key
certificate
Select Keystore: AS2_CERTIFICATE /
Keystore Entry: Partner_Test-cert for both (view
and alias)
Decryption
Decrypt
Checked
View to own private key
Alias of own private key
<, the NWA key-storage view containing self (own)
private key and alias (or name) under which the selfprivate key is stored >
Use the browse button to select both, View and
Alias, and click OK
Select AS2_KEYSTORE / PI_Test for both (view and
alias)
7. Select sub-tab “MDN” and provide the following configuration values:
Category
Message
Disposition
Notification
Field Name
Sign MDN
Value
Unchecked
Configuring the EDI Separator on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “configure
channel”
2. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0)
3. On the field Channel Name type: EDISep_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Formatting
Indent messages
Checked
Adapter
Status
Adapter Status
Active
54
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
5. Under tab “ANSI X12”, enter the following configuration values
Category
Field Name
997
Acknowledgements
Value
Acknowledgement Required
Required (by Default ”Not Required”)
Transaction Mode
All
Negative Acknowledgement
not Required
Unchecked
Positive Acknowledgement
not Required
Unchecked
Execution Mode
Receipt Only
6. Save the integration Flow
9.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_S1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “ANSI X.12”
4. On the field Channel Name type: EDISep_send1
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Value
Version /Release/Industry
Identifier Code
All versions
Transaction Set Identifier
Code
830
Interchange Sender ID:
<The value in the ISA segment of the incoming
message in the sender ID field (ISA06) identifying the
sender (Partner 1)>
87654321
Interchange Receiver ID:
<The value in the ISA segment of the outgoing
message in the receiver ID field (ISA08)identifying the
receiver (Partner 2)>
12345678
55
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Encoding
Charset encoding
UTF-8
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
6. Select tab “Modules”
7. Add the Converter module to convert from X12 to XML, to do this, please click on “Add” on the first
table (Processing sequence) and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
Localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec1
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\830
Create Target Directory:
Checked
File Name Scheme
Output-830.xml
6. Save the integration Flow
9.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDISeparator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_S2_<User-ID>”
56
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “ANSI X.12”
4. On the field Channel Name type: EDISep_send2
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Value
Version /Release/Industry
Identifier Code
Select :
« 003060 Draft Standards Approved for
Publication by ASC X12 Procedures »
Transaction Set Identifier
Code
856
Interchange Sender ID:
<The value in the ISA segment of the incoming
message in the sender ID field (ISA06) identifying the
sender (Partner 1)>
87654321
Interchange Receiver ID:
<The value in the ISA segment of the outgoing
message in the receiver ID field (ISA08)identifying the
receiver (Partner 2)>
12345678
Encoding
Charset encoding
UTF-8
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
Localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
57
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec2
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\856
Create Target Directory:
Checked
File Name Scheme
Output-856.xml
6. Save the integration Flow
9.1.3.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Configuring the EDISeparator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_S3_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select “Configure
Channel”
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “ANSI X.12”
4. On the field Channel Name type: EDISep_send3
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Value
Version /Release/Industry
Identifier Code
All versions
Transaction Set Identifier
Code
997
Interchange Sender ID:
<The value in the ISA segment of the incoming
message in the sender ID field (ISA06) identifying the
sender (Partner 1)>
12345678
58
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Interchange Receiver ID:
<The value in the ISA segment of the outgoing
message in the receiver ID field (ISA08)identifying the
receiver (Partner 2)>
87654321
Encoding
Charset encoding
UTF-8
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
6. No conversion module is configured
Configuring the AS2 Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Configure
Channel”
2. As adapter type, select AS2 (Software Component B2B Toolkit 1.0), for transport protocol, select
“Hypertext Transfer Protocol” and for Message protocol, select “AS2”
3. On the field Channel Name type: as2_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values:
Category
Recipient
Field Name
Recipient URL
Value
<Enter The URL path of the partner (initiator)
where the AS2 messages shall be received>
http://host:port/Receiver.aspx
Basic HTTP Authentication
Checked
Username
Password
<User ID for login the system where message will be
received>
<Password for login the system where message
will be received>
Message
Proxyserver
Unchecked
Filename
AS2-EDISEP-997.txt
Message ID left
Type the following regular expression for both:
Message ID right
.*
Use compatible MessageId
Unchecked
Own AS2 Name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var05_Outbound_PO_SE
59
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Recipient‟s AS2Name
<aka Organization name on AS2 connector>
testas2
Own email-address
< Specifies the email address which is
transmitted in the AS2 message as sender >
<User-ID>@mailhost.com
Message subject
< Specifies the subject included in the
message>
AS2-EDISEP-997
Content type
application/edi-x12
Charset
Charset conversion

Source encoding

Destination encoding
Checked
UTF-8
ISO-8859-1
Dynamic
configuration
Respect parameter
Checked
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
5. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Field Name
Value
Compression
Compress message
Unchecked
Signature
Sign message
Checked
View to own public key
certificate
Alias of own public key
certificate
< The NWA key-storage view in the sending
partner, which contains the self (own) public key
certificate and the alias (or name) under which
the self (own) public key certificate is stored.
Use browse button to select it>
Select: AS2_CERTIFICATE / PI_Test-cert for
both (view and alias)
View to own private key
Alias of own private key
< The NWA key-storage view in the sending partner,
which contains the self (own) private key >
Select AS2_KEYSTORE / PI_Test for both
(view and alias)
60
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Encrypt
Encrypt message
Checked
Algorithm
3DES
View to recipients public key
Alias of recipients certificate
AS2_CERTIFICATE / Partner_Test-cert
6. Select sub-tab “MDN” and provide the following configuration values:
Category
MDN
Field Name
Value
MessageDeliveryNotification
Synchronous
Verify MIC
Request signing
Verify signature
checked
checked
checked
View to signer‟s public key
certificate
<The NWA key-storage view in the sending partner
(SAP PI- initiator), which contains the receiving
partner‟s (responder) public key certificate and the
alias (or name) under which the receiving partner‟s
(responder) public key certificate is stored >
Alias of signer‟s public key
certificate
AS2_CERTIFICATE / Partner_Test-cert
7. Save the integration Flow
9.2
Configuring the trading partner
9.2.1
Creating the trading partner on AS2 connector
1.
2.
3.
4.
5.
6.
7.
Open the URL of the AS2 connector http://host:port/Default.aspx
Navigate to the tab “Trading Partner”
Click on “Add New”
On “Select partner type” select “AS2”
On “Organization Name”, type: SAPPI_<SID>_<User-ID>_05
On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_Var05_Outbound_PO_SE
On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_R1
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
8. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
checked
checked
Incoming Message
Security
Require Signature
Require encryption
checked
checked
Compression
Compress Outgoing Data
checked
Connection timeout (sec)
600
Restrict the use of signing and
Unchecked
61
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
encryption algorithms…
9. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
checked
Security
Signed / Unsigned
Unsigned
Delivery
Synchronous / Asynchronous
Synchronous
10. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
11. Click on “Save Changes”
9.2.2
Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1. Go to the corresponding folder of the trading partner you just created.
\\host\as2data\AS2_<SID>_<User-ID>_Var05_Outbound_PO_SE\Outgoing
2. Copy the file “B2B_ansix12SenderMessage_830_856.txt” into the “Outgoing” folder and create two
or more copies of it.
3. Also, Copy the file “B2B_ansix12SenderMessage_830_856_error.txt” with validation errors in the
856 transaction set into the “Outgoing” folder and create two or more copies of it.
9.3
Saving and Activating the Configuration Objects
Proceed as described in variant1.
9.4
Executing the Use Case
In this variant the third party AS2 Connector from /n software has been used for sending the message. Third
party can vary in your case. For the configuration of this third party software please refer the section ‎2.2.3.
1. Check that all sender and receiver channels are started before sending the message from third party
software.
2. Go to AS2 Connector (AS2 connector http://host:port/Default.aspx )and navigate to the “Outcoming”
tab.
62
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
3. Select the trading partner‟s organization name (SAPPI_<SID>_<User-ID>_05). The table “Outgoing
files” shows the available test files present at the trading partner location. If there isn‟t any, place the
test files.
4. Click on the send button for the test file “B2B_ansix12SenderMessage_830_856.txt”.
5. After some seconds the message “transmission successful” should be displayed.
6. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
7. On the AS2 connector, go to the “Incoming” tab
8. Select the trading partner identifier (e.g. “SAPPI_<SID>_06”).
9. A table with all incoming files for this identifier is displayed. There should be a recent message called
“AS2-EDISEP-997” which is the MDN (acknowledgement)
10. Click on “View” to see the file contents. The file contains an ANSI X.12 acknowledgment.
63
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Verification for the 997 Acknowledgement generated:
1. Open the ANSI X12 997 file “AS2-EDISEP-997”.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
The Functional Group Header Segment (GS) is used to start the envelope for the Functional
Acknowledgment Transaction Sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201.
The AK2 segments appear in the same order as the transaction sets in the functional group that has
been received and is acknowledged. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “A” as the transaction set and the
functional group has been accepted.
Note:
The ANSI X.12 message used for testing has the code 00360, If a different code is used on the filter
parameter “Version/Release/Industry Identifier Code” (on Adapter-Specific tab of the Sender
Communication Channel using the EDISeparator) the filtering will not be successful and no
message will be processed.
Now repeat the steps 1-10 of the Execution section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt” and verify the 997 generated as follows:
Verification for the 997 Acknowledgement generated:
1. Open the ANSI X12 997 file “AS2-EDISEP-997”.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID
(ISA06 and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction
sets.
The Functional Group Header Segment (GS) is used to start the envelope for the Functional
Acknowledgment Transaction Sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set
at AK201.
The AK2 segments appear in the same order as the transaction sets in the functional group that
has been received and is acknowledged. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “A” as the transaction sets and
the functional groups has been accepted.
On the Receiver EDI Separator, the generation of acknowledgement was configured according to
section 9.1.3.1.
Additionally you have various configuration options to test the feature of the generation of 997
Acknowledgement:
64
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Case
Acknowled
gement
Required
Transaction
Mode
Negative
Acknowled
gement
not
Required
Positive
Acknowled
gement not
Required
Exclude
Partially
Accepted
Acknowled
gement
code
Execution
Mode
Exclude
AK3 and
AK4
1
Not
Required
NA
NA
NA
NA
NA
NA
2
Required
All
Checked
Unchecked
NA
Receipt Only
NA
3
Required
All
Unchecked
Checked
NA
Receipt Only
NA
4
Required
All
Checked
Checked
NA
Receipt Only
NA
5
Required
All
Unchecked
Checked
NA
Receipt &
Validation
Unchecked
6
Required
All
Unchecked
Checked
NA
Receipt &
Validation
Checked
7
Required
All
Checked
Checked
NA
Receipt &
Validation
Checked
8
Required
Individual
NA
NA
Unchecked
Receipt only
NA
9
Required
Individual
NA
NA
Checked
Receipt only
NA
10
Required
Individual
NA
NA
Unchecked
Receipt &
Validation
Unchecked
11
Required
Individual
NA
NA
Checked
Receipt &
Validation
Checked
 Case 1:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
Verification of the 997 Acknowledgement generated:
1. No 997 Acknowledgement should be generated.
 Case 2:
Execution:
1. In the Integration flow “AS2_EDISep_S1_<User-ID>” change the configurable parameter value for
eg, for the Sender Interchange ID to 765432.
2. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
65
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
3. There should be no messages generated for 830 or 856 transaction sets as the entire transaction is
rolled back due to error in configuration.
Verification of the 997 Acknowledgement generated:
1. No 997 Acknowledgement should be generated.
 Case 3:
Execution:
1. Revert the changes done to the Integration flow “AS2_EDISep_S1_<User-ID>” in Case 2.
2. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
3. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
Verification of the 997 Acknowledgement generated:
1. No 997 Acknowledgement should be generated.
 Case 4:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
Verification of the 997 Acknowledgement generated:
1. No 997 Acknowledgement should be generated.
 Case 5:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. There should be no messages generated for 830 or 856 transaction sets as the entire transaction is
rolled back due to validation error in the 856 transaction set.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “R” as the transaction sets and the
functional groups has been Rejected due to validation error in the transaction set 856.
6. The AK3 and AK4 segments should be displayed for the 856 transaction set reporting errors in the
data segment and data element and indicating the location of the error. In this case for the
66
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
transaction set 856 AK3 identifies “BSN” as the segment with error code “8”, AK4 identifies the
numerical count of the data element in error “2”.
 Case 6:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. There should be no messages generated for 830 or 856 transaction sets as the entire transaction is
rolled back due to validation error in the 856 transaction set.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “R” as the transaction sets and the
functional groups has been Rejected due to validation error in the transaction set 856.
6. There should not be any AK3 and AK4 segments.
 Case 7:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. There should be no messages generated for 830 or 856 transaction sets as the entire transaction is
rolled back due to validation error in the 856 transaction set.
3. The EDI Separator Receiver channel EDISep_rec in the Integration flow “AS2_EDISep_R1_<UserID>” should be in error state indicating that the messages are not dispatched due to validation errors
in transaction set 856.
Verification of the 997 Acknowledgement generated:
1. No 997 Acknowledgement should be generated.
 Case 8:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
67
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “A” as the transaction sets and the
functional groups have been Accepted.
 Case 9:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for each transaction set 830 and 856, respectively.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for both 830 and 856 should indicate “A” as the transaction sets and the
functional groups have been Accepted.
 Case 10:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for transaction set 830 but no file for transaction set 856 indicating it has not been dispatched.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for transaction set 830 should indicate “A” as the transaction set and the
functional group have been Accepted.
68
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. For the transaction set 856, the AK5 segment should indicate “R” as the transaction set has been
Rejected and the AK9 segment should indicate “P” (Partially accepted) as there is at least one
transaction set in the functional group which is rejected.
7. The AK3 and AK4 segments should be displayed for the 856 transaction set reporting errors in the
data segment and data element and indicating the location of the error. In this case for the
transaction set 856 AK3 identifies “BSN” as the segment with error code “8”, AK4 identifies the
numerical count of the data element in error “2”.
 Case 11:
Execution:
1. Execute the steps 1-5 of section 9.4 with the test file
“B2B_ansix12SenderMessage_830_856_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directories 830 and 856 (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for transaction set 830 but no file for transaction set 856 indicating it has not been dispatched.
Verification of the 997 Acknowledgement generated:
1. 997 Acknowledgement should be generated.
2. Check the ISA segment to identify the Sender Interchange ID and Receiver Interchange ID (ISA06
and ISA08) to be the same as 87654321 and 12345678 respectively.
3. There should be two functional group GS segment loops one for each 830 and 856 transaction sets.
4. The AK2 segment should identify the transaction set code (830 and 856) for each transaction set at
AK201. In this case the AK2 segment for 830 appears first.
5. The AK5 and AK9 segment for transaction set 830 should indicate “A” as the transaction set and the
functional group have been Accepted.
6. For the transaction set 856, the AK5 and AK9 segment should indicate “R” as the transaction sets
and the functional group have been Rejected.
7. There should be no AK3 and AK4 segments.
.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1
With a Negative 997 Acknowledgement, the user is able to edit the message (transaction set) with error and
Resend the message.
You can also monitor the relation between the EDI parent message and child messages (of type 830 and
856) after their split.
1. To do so, in Message Monitoring, search for the child message (of type 830 and 856) by selecting
the appropriate radio button and then go to Message log tab.
2. The tab Message log and Message Details for the child messages (of type 830 and 856) displays the
correlation between the child messages and the parent message.
3. In the Message Details tab check for the Reference ID label which refers to the Message ID of the
Parent EDI message.
69
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
4. Also check for the message “Message was split from an Ansi X. 12 message with ID <Message ID of
the parent EDI message>” in the Message log.
10 Variant 6: AS2, EDI Separator (ANSI X12 transaction sets 830, 856, 997), EDI-XML
Converter & Conversion Using the Maintenance Tool
On this variant we modify the scenario in variant 5 by adding the module converter to one of the file receivers
and afterwards we use the maintenance tool to convert one of the received messages to xml and back to
X.12.
One of the Integration Flows from variant 5 will be modified:

Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Transaction Set Identifier code: 856. The transaction set 856 is converted into XML on the sender
side and sent to the file adapter. The receiver file adapter uses the converter module once again and
the message is converted back to ANSI X.12 and saved on the output folder.
10.1 Configuring the Integration Flows
10.1.1 Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File
adapter
Configuring the File Adapter on the receiver communication channel
1. Open the Integration Flow “AS2_EDISep_S2_<User-ID>”
2. In the graphical editor, right click on the channel for the receiver component and select “Configure
Channel”
3. Select tab “Modules”
4. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
Localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
5. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
6. Save the integration Flow. The rest of the configuration remains intact.
10.2 Saving and Activating the Configuration Objects
Proceed as described in variant1.
70
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
10.3 Executing the Use Case
1. Proceed as in variant 5.
2. On the host of the Advanced Adapter Engine Extended, open the file directory 856 (e.g.
\\host\<selected-path>\AS2-EDISEP\856 ). There should be the transaction set 856 in ANSI X.12
form. Please keep this file since we will use it for conversion on the EDI Content Manager
maintenance tool
3. Open the EDI Content Manager Maintenance tool via URL for B2B Integration Cockpit:
https://host:port/webdynpro/resources/sap.com/b2b~home/B2BHome -> EDI Content Manager.
4. Go to the Ansi X.12 tab and select “Ansi X.12-XML Converter” → “Ansi X.12 to XML”
5. On the text input box “Convert Ansi.X12 to XML”, insert the content of the file received on step 2,
overwriting the text “Insert Ansi X.12” Alternatively you can perform a file import using the Browse
button, selecting the file and clicking on “import”
6. Click on “Convert”
7. The conversion is performed and a confirmation message is shown (e.g. Converted in 400
milliseconds), the converted message is displayed (in XML).
8. Copy the converted message to the clipboard
9. On the same Ansi X.12 tab, select “Ansi X.12-XML Converter” → “XML to Ansi X.12”
10. Paste the XML message from your clipboard on the text input box and proceed with the conversion
to Ansi X.12
11. Compare the converted message to the original one on the 856 folder, they should be similar.
You can also monitor the relation between the EDI parent message and child messages (of type 830 and
856) after their split.
1. To do so, in Message Monitoring, search for the child message (of type 830 and 856) by selecting
the appropriate radio button and then go to Message log tab.
2. The tab Message log and Message Details for the child messages (of type 830 and 856) displays the
correlation between the child messages and the parent message.
3. In the Message Details tab check for the Reference ID label which refers to the Message ID of the
Parent EDI message.
4. Also check for the message “Message was split from an Ansi X. 12 message with ID <Message ID of
the parent EDI message>” in the Message log.
11 Variant 7: AS2, EDI Separator (EDIFACT: DELFOR and DESADV) and EDI-XML
Converter
On this variant, an EDIFACT multi-message containing two message types (DELFOR and DESADV) is sent
by a trading partner. The message is split by the EDI Separator, converted into XML and sent to a file
receiver.
Additionally an acknowledgment message (Message Type CONTRL) is generated by the EDI Separator
(after splitting, validating (optional) and dispatching the individual messages) and sent back to the trading
partner (AS2 connector) via AS2 adapter. The CONTRL message generation by the EDI Separator receiver
channel can be tested using the various configurable parameters available.
The configurable options for CONTRL message generation are:
 Acknowledgment required or not
 EDIFACT CONTRL Message Version and Release
 CONTRL message in the transaction mode-"All”(global at parent message level) or transaction
mode “Individual”(local per message)
 Positive Acknowledgment not required option for “All” transaction mode
 Negative Acknowledgment not required option for “All” transaction mode
 Execution modes:
71
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration


CONTRL Acknowledgement for receipt and dispatch of messages only
CONTRL Acknowledgement for receipt and validation of individual messages
Note:
Executing in Transaction Mode “All” means that even if a single message in the bulk parent
message fails (due to errors in configuration, dispatch, validation, etc), the entire transaction
will be rolled back with all the individual messages rejected (4).
Executing in Transaction mode “Individual” means that, if one or more messages in the bulk
parent message fails (due to errors in configuration, dispatch, validation, etc), only those failed
messages will be rejected (4) while the successful messages will be accepted/acknowledged
(7). In case all the messages in a group fail, the UCI and UCF segment will be
accepted/acknowledged (7).
The General structure of the CONTRL Acknowledgment message is
UNA (Service String Advice)
UNB (Interchange Header)
UNG (Functional Group Header)
UNH -> Message Header
UCI -> Interchange Response
UCF -> Functional Group Response
UCM -> Message Response
UCS -> Segment Error Indication
UCD -> Data Element Error Indication
UNT -> Message Trailer
UNE (Functional Group Trailer)
UNZ (Interchange trailer)
Four Integration Flows are configured in this variant:
 Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
The message is sent with AS2 protocol from a partner to the PI. A sender Communication Channel
with AS2 adapter receives the message and sends it to a receiver communication channel with
Adapter type EDI Separator.
 Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: DESADV, Message Version Number: D, Message Release Number: 96A
 Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: DELFOR, Message Version Number: D, Message Release Number: 96A
 Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Message Type: CONTRL, Message Version Number: D, Message Release Number: 3
72
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
11.1 Configuring the Integration Flows
11.1.1 Calling the Process Integration Designer
If not done yet, open the SAP NetWeaver Developer Studio, connect to the systems and open the SAP
Process Integration Designer perspective as described on the Prerequisites section.
11.1.2 Creating the integration Flows
11.1.2.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
1. On the PI Explorer View, select “New Integration Flow” form the context menu (right click) or from
the toolbar menu (top-left) as shown in the screenshot below
2. On the Name field type “AS2_EDISep_var7_R1_<User-ID>”, select “Point-to-Point Channel” and
click on “Next”
3. To Assign the business component to sender, right click on the sender-> click on New Business
component select the Business Component name as <SID>_<UserID>_B2B_BC_AS2_EDISEP_V7_01 -> Click Finish.
4. Click on the Browse button for the field Interface and select the service interface
“XiPatternInterface1”, software component SAP BASIS 7.31
5. Select the “Receiver Systems” tab
6. Click on the field located on the column “Communication Components”, a browse button will appear
on the right side of the field, click on it and select the Business Component <SID>_<UserID>_B2B_BC_AS2_EDISEP_V7_01
73
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. Following the same procedure, select the service interface “XiPatternInterface1”, software
component SAP BASIS 7.31 on the field located under column “Interface”
8. Click on button “Finish”
11.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow1, create the second Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var7_S1_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_02
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_02
11.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow 1, create the third Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var7_S2_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_03
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_03
11.1.2.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Following the same steps for Integration Flow 1, create the third Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var7_S3_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_04
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
74
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V7_04
11.1.3 Configuring the integration Flows
11.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
In the following steps, you configure the first Integration Flow using AS2 adapter as sender and EDI
separator as receiver.
Configuring the AS2 adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var7_R1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel (please see screenshot below)
3. As adapter type, select AS2 (Software Component B2B Toolkit 1.0)
4. On the field Channel Name type: AS2_sender
5. Select tab “Adapter-Specific”. Under sub-tab “General” provide the following configuration values:
Category
Field Name
Value
Server
Expected URL-Path
AS2DispatcherServlet_<User-ID>_var7
Message
Expected Message ID left
<Specifies the left part of the incoming AS2
MessageID. This is a regular expression. For
more information on regular expressions you
can refer to the following link: Regular
expression Patterns>
”.*”
Expected Message ID right
<Specifies the right part of the incoming AS2
Message ID>
”.*“
<aka Organization name on AS2 connector>
Expected sender‟s AS2Name
75
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
testas2
Expected own AS2 name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var07_Outbound_PO_SE
Expected subject
“.*”
Charset
Charset conversion

Source encoding

Destination encoding
Checked
ISO-8859-1
UTF-8
Message
configuration
Set dynamic parameter
Quality of Service
Checked
Exactly Once (asynchronous)
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
6. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Signature
Field Name
Value
Verify Signature
Checked
View to sender‟s public key
certificate
<The NWA key-storage view containing the
sending partner‟s public key certificate and alias
(or name) under which the sending partner‟s
public key certificate is stored.>
Use the browse button to select both, View and
Alias, and click OK
Alias of sender‟s public key
certificate
Select Keystore: AS2_CERTIFICATE /
Keystore Entry: Partner_Test-cert for both (view
and alias)
Decryption
Decrypt
Checked
View to own private key
Alias of own private key
<, the NWA key-storage view containing self (own)
private key and alias (or name) under which the selfprivate key is stored >
Use the browse button to select both, View and
Alias, and click OK
Select AS2_KEYSTORE / PI_Test for both (view and
alias)
7.
76
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Select sub-tab “MDN” and provide the following configuration values:
Category
Message
Disposition
Notification
Field Name
Sign MDN
Value
Unchecked
Configuring the EDI Separator on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “configure
channel”
2. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0)
3. On the field Channel Name type: EDISep_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Formatting
Indent messages
Checked
Adapter
Status
Adapter Status
Active
5. Under tab “EDIFACT”, enter the following configuration values
Category
Syntax and Service
report message
(CONTRL)
Field Name
Value
Acknowledgement Required
Required (by Default ”Not Required”)
EDIFACT CONTRL Message
Version and Release
Version D, Release 3
Transaction Mode
All
Negative Acknowledgement
not Required
Unchecked
Positive Acknowledgement
not Required
Unchecked
Execution Mode
Receipt Only
UNA Segment Required
Unchecked
6. Save the integration Flow
11.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
77
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
1. Open the Integration Flow “AS2_EDISep_var7_S1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “EDIFACT”
4. On the field Channel Name type: EDISep_send1
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Message Type
Select „DESADV’
Message Version Number
Select „D‟
Message Release Number:
Select „96A’
Interchange Sender
Identification
1234567
Interchange Sender
Identification Code Qualifier
Select „ZZZ‟
Interchange Recipient
Identification
7654321
Interchange Recipient
Identification Code Qualifier
Select „ZZZ‟
Encoding
Character encoding
Select „ISO-8859-15‟
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
Filter
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
78
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
9. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
10. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
11. In the graphical editor, right click on the channel and select “configure channel”
12. On the field Channel Name type: File_rec1
13. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\outputedifact
Create Target Directory:
Checked
File Name Scheme
Output-DESADV.xml
14. Save the integration Flow
11.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var7_S2_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “EDIFACT”
4. On the field Channel Name type: EDISep_send2
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Value
Message Type
Select „DELFOR’
Message Version Number
Select „D‟
Message Release Number
Select „96A‟
Interchange Sender
Identification
1234567
79
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Interchange Sender
Identification Code Qualifier
Select „ZZZ’
Interchange Recipient
Identification
7654321
Interchange Recipient
Identification Code Qualifier
Select „ZZZ’
Encoding
Character encoding
Select „ISO-8859-15’
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec2
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\outputedifact
Create Target Directory:
Checked
File Name Scheme
Output-DELFOR.xml
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
80
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
9. Save the integration Flow
11.1.3.4
Integration Flow 4: Sender: EDI Separator, Receiver: AS2 adapter
Configuring the EDISeparator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_S3_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select “Configure
Channel”
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “Edifact”
4. On the field Channel Name type: EDISep_send3
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Value
Message Type
Select 'CONTRL‟
Message Version Number
Select „D‟
Message Release number
Select „3‟
7654321
Interchange Sender ID:
Interchange Sender
Identification Code Qualifier
Select „ZZZ’
Interchange Receiver ID:
1234567
Interchange Reciever
Identification Code Qualifier
Select „ZZZ’
Encoding
Charset encoding
Select „ISO-8859-15’
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
6. No conversion module is configured
81
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Configuring the AS2 Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Configure
Channel”
2. As adapter type, select AS2 (Software Component B2B Toolkit 1.0), for transport protocol, select
“Hypertext Transfer Protocol” and for Message protocol, select “AS2”
3. On the field Channel Name type: as2_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values:
Category
Recipient
Field Name
Recipient URL
Value
<Enter The URL path of the partner (initiator)
where the AS2 messages shall be received>
http://host:port/Receiver.aspx
Basic HTTP Authentication
Checked
Username
Password
<User ID for login the system where message will be
received>
<Password for login the system where message
will be received>
Message
Proxyserver
Unchecked
Filename
Edifact_CONTRL_Ack.txt
Message ID left
Type the following regular expression for both:
Message ID right
.*
Use compatible MessageId
Unchecked
Own AS2 Name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var07_Outbound_PO_SE
Recipient‟s AS2Name
<aka Organization name on AS2 connector>
testas2
Own email-address
< Specifies the email address which is
transmitted in the AS2 message as sender >
<User-ID>@mailhost.com
Message subject
< Specifies the subject included in the
message>
Edifact-CONTRL-Ack
Content type
application/edi-x12
82
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Charset
Charset conversion

Source encoding

Destination encoding
Checked
UTF-8
ISO-8859-1
Dynamic
configuration
Respect parameter
Checked
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
5. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Field Name
Value
Compression
Compress message
Unchecked
Signature
Sign message
Checked
View to own public key
certificate
Alias of own public key
certificate
< The NWA key-storage view in the sending
partner, which contains the self (own) public key
certificate and the alias (or name) under which
the self (own) public key certificate is stored.
Use browse button to select it>
Select: AS2_CERTIFICATE / PI_Test-cert for
both (view and alias)
View to own private key
Alias of own private key
< The NWA key-storage view in the sending partner,
which contains the self (own) private key >
Select AS2_KEYSTORE / PI_Test for both
(view and alias)
Encrypt
Encrypt message
Checked
Algorithm
3DES
View to recipients public key
Alias of recipients certificate
AS2_CERTIFICATE / Partner_Test-cert
83
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
6. Select sub-tab “MDN” and provide the following configuration values:
Category
MDN
Field Name
Value
MessageDeliveryNotification
Synchronous
Verify MIC
Request signing
Verify signature
checked
checked
checked
View to signer‟s public key
certificate
<The NWA key-storage view in the sending partner
(SAP PI- initiator), which contains the receiving
partner‟s (responder) public key certificate and the
alias (or name) under which the receiving partner‟s
(responder) public key certificate is stored >
Alias of signer‟s public key
certificate
AS2_CERTIFICATE / Partner_Test-cert
7. Save the integration Flow
11.2 Configuring the trading partner
11.2.1 Creating the trading partner on AS2 connector
1.
2.
3.
4.
5.
6.
7.
Open the URL of the AS2 connector http://host:port/Default.aspx
Navigate to the tab “Trading Partner”
Click on “Add New”
On “Select partner type” select “AS2”
On “Organization Name”, type: SAPPI_<SID>_<User-ID>_07
On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_Var07_Outbound_PO_SE
On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_var7
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
8. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Checked
Checked
Incoming Message
Security
Require Signature
Require encryption
Checked
Checked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
9. On “MDN Receipts” select the following options:
Category
Security
Field Name
Value
Request MDN Receipt
Unchecked
Signed / Unsigned
Unsigned
84
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Delivery
Synchronous / Asynchronous
Synchronous
10. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate –
Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate –
Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
11. Click on “Save Changes”
11.2.2 Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1. Go to the corresponding folder of the trading partner you just created.
\\host\as2data\AS2_<SID>_<User-ID>_Var07_Outbound_PO_SE\Outgoing
2. Copy the file “B2B_edifactSenderMessage_DELFOR_DESADV.txt” into the “Outgoing” folder and
create two or more copies of it.
3. Also, Copy the file “B2B_edifactSenderMessage_ DELFOR_DESADV_error.txt” with validation
errors in the DESADV Message Type into the “Outgoing” folder and create two or more copies of it.
11.3 Saving and Activating the Configuration Objects
Proceed as described in variant1.
11.4 Executing the Use Case
In this variant the third party AS2 Connector from /n software has been used for sending the message. Third
party can vary in your case. For the configuration of this third party software please refer the section ‎2.2.3.
1. Check that all sender and receiver channels are started before sending the message from third party
software.
2. Go to AS2 Connector (AS2 connector http://host:port/Default.aspx )and navigate to the “Outcoming”
tab.
3. Select the trading partner‟s organization name (SAPPI_<SID>_<User-ID>_07). The table “Outgoing
files” shows the available test files present at the trading partner location. If there isn‟t any, proceed
as described in ‎11.2.2
4. Click on the send button for the input file “B2B_edifactSenderMessage_DELFOR_DESADV.txt”.
5. After some seconds the message “transmission successful” should be displayed.
6. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ). There should be an XML version of the input file
for each message type DELFOR and DESADV, respectively.
Verification for the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
85
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
3. Check the Message Header UNH. A service segment starting and uniquely identifying a message.
Check for the Message Reference number at UNH010 which is also referenced in UNB, UNT, UNZ.
And for the Message Identifier at UNH020 for the Message type, Message Version number,
Message Release number and Controlling agency (in this case CONTRL, D, 3, UN respectively).
4. The UCI segment is the Interchange Response indicating the acknowledgment of the Interchange at
UCI040 to be “7”.
5. The UCF and UCM segment for both DESADV and DELFOR should indicate “7” as the Group
segment and the Message segment has been accepted.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
Now repeat the steps 1-10 of the Execution section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV_error.txt” and verify the CONTRL message generated as follows:
On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ). There should be an XML version of the input file for
each message type DELFOR and DESADV.
Verification for the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
3. Check the Message Header UNH. A service segment starting and uniquely identifying a message.
Check for the Message Reference number at UNH010 which is also referenced in UNB, UNT, UNZ.
And for the Message Identifier at UNH020 for the Message type, Message Version number,
Message Release number and Controlling agency (in this case CONTRL, D, 3, UN respectively).
4. The UCI segment is the Interchange Response indicating the acknowledgment of the Interchange at
UCI040 to be “7”.
5. The UCF and UCM segment for both DESADV and DELFOR should indicate “7” as the Group
segment and the Message segment has been accepted.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
86
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
On the Receiver EDI Separator, the generation of acknowledgement was configured according to section
10.1.3.1
Additionally you have various configuration options to test the feature of the generation of CONTRL
Acknowledgement:
Case
Acknowled
gement
Required
EDIFACT
CONTRL
Message
Version and
Release
Negative
Acknowled
gement not
Required
Positive
Acknowledg
ement not
Required
1
Not
Required
Version D,
Release 3
NA
NA
NA
NA
NA
2
Required
Version D,
Release 3
All
Unchecked
Checked
Receipt Only
Checked
3
Required
Version D,
Release 3
All
Checked
Unchecked
Receipt Only
Unchecked
4
Required
Version D,
Release 3
All
Checked
Checked
Receipt Only
Unchecked
5
Required
Version D,
Release 3
All
Unchecked
Checked
Receipt &
Validation
Unchecked
6
Required
Version D,
Release 3
All
Unchecked
Checked
Receipt &
Validation
Checked
7
Required
Version D,
Release 3
All
Checked
Checked
Receipt &
Validation
Unchecked
8
Required
Version D,
Release 3
Individual
NA
NA
Receipt only
Unchecked
9
Required
Version D,
Release 3
Individual
NA
NA
Receipt &
Validation
Checked
Transaction
Mode
Execution
Mode
UNA
segment
required
 Case 1:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ). There should be an XML version of the input file
for each message type DELFOR and DESADV, respectively.
Verification of the CONTRL Acknowledgement generated:
1. No CONTRL Acknowledgement should be generated.
 Case 2:
Execution:
1. In the Integration flow “AS2_EDISep_var7_S1_<User-ID>” change the configurable parameter value
for eg, for the Sender Interchange ID to 765432.
3. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV.txt”
87
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. There should be no messages generated for DESADV or DELFOR Message types as the entire
transaction is rolled back due to error in configuration.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check for the UNA segment. The specifications in the UNA segment define the characters used as
separators and indicators for the interchange.
3. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
4. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
5. The UCI segment is the Interchange Response indicating the Interchange is rejected at UCI040 to
be “4”.
6. The UCF and UCM segment for both DESADV and DELFOR should indicate “4” as the Group
segment and the Message segment has been rejected. The UCM segment should also indicate the
error code “17” (No Agreement) and “18” (Unspecified error) respectively at UCM0030.
7. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
 Case 3:
Execution:
1. Revert the changes done to the Integration flow “AS2_EDISep_S1_<User-ID>” in Case 2.
4. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV.txt”
5. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ) respectively. There should be an XML version of
the input file for message type DELFOR and DESADV.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
3. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
4. The UCI segment is the Interchange Response indicating the acknowledgment of the Interchange at
UCI040 to be “7”.
5. The UCF and UCM segment for both DESADV and DELFOR should indicate “7” as the Group
segment and the Message segment has been accepted.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
88
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
 Case 4:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ) respectively. There should be an XML version of
the input file for message type DELFOR and DESADV.
Verification of the CONTRL Acknowledgement generated:
1. No CONTRL Acknowledgement should be generated.
 Case 5:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV_error.txt”
2. There should be no messages generated for DESADV or DELFOR Message types as the entire
transaction is rolled back due to validation error in DESADV Message type.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
3. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
4. The UCI segment is the Interchange Response indicating the Interchange is rejected at UCI040 to
be “4”.
5. The UCF and UCM segment for both DESADV and DELFOR should indicate “4” as the Group
segment and the Message segment has been rejected. The UCS segment for DESADV should
indicate the error code “13” (Missing mandatory segment) at UCS020 and the UCM segment should
indicate “18” (Unspecified error) for DELFOR at UCM0030.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
 Case 6:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV_error.txt”
2. There should be no messages generated for DESADV or DELFOR Message types as the entire
transaction is rolled back due to validation error in DESADV Message type.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check for the UNA segment. The specifications in the UNA segment define the characters used as
separators and indicators for the interchange.
89
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
3. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
4. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
5. The UCI segment is the Interchange Response indicating the Interchange is rejected at UCI040 to
be “4”.
7. The UCF and UCM segment for both DESADV and DELFOR should indicate “4” as the Group
segment and the Message segment has been rejected. The UCS segment for DESADV should
indicate the error code “13” (Missing mandatory segment) at UCS020 and the UCM segment should
indicate “18” (Unspecified error) for DELFOR at UCM0030.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
 Case 7:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV_error.txt”
2. There should be no messages generated for DESADV or DELFOR Message types as the entire
transaction is rolled back due to validation error in DESADV Message type.
3. The EDI Separator Receiver channel EDISep_rec in the Integration flow
“AS2_EDISep_var7_R1_<User-ID>” should be in error state indicating that the messages are not
dispatched due to validation errors in Message type DESADV.
Verification of the CONTRL Acknowledgement generated:
1. No CONTRL Acknowledgement should be generated.
 Case 8:
Execution:
6. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV.txt”
3. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\856 ) respectively. There should be an XML version of the input
file for message type DELFOR but not for DESADV.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
3. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
4. The UCI segment is the Interchange Response indicating the acknowledgment of the Interchange at
UCI040 to be “7”.
90
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
5. The UCF and UCM segment for both DESADV and DELFOR should indicate “7” as the Group
segment and the Message segment has been accepted.
6. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
 Case 9:
Execution:
1. Execute the steps 1-5 of section 10.4 with the test file “B2B_edifactSenderMessage_
DELFOR_DESADV_error.txt”
2. On the host of the Advanced Adapter Engine Extended, open the file directory output-edifact (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-edifact ) respectively. There should be an XML version of
the input file for each message type DELFOR but not for DESADV due to validation error in
DESADV Message type.
Verification of the CONTRL Acknowledgement generated:
1. Open the CONTRL Ack file “Edifact_CONTRL_Ack.txt”.
2. Check for the UNA segment. The specifications in the UNA segment define the characters used as
separators and indicators for the interchange.
3. Check the UNB segment to identify the Interchange Sender ID and Interchange Receiver ID
(UNB020 and UNB030) to be the same as 7654321 and 1234567 respectively.
4. Check the Message Header UNH for the Message Reference number at UNH010 which is also
referenced in UNB, UNT, UNZ and for the Message Identifier at UNH020 (in this case CONTRL, D,
3, UN respectively).
5. The UCI segment is the Interchange Response indicating the acknowledgment of the Interchange at
UCI040 to be “7”.
6. The UCF and UCM segment for both DESADV and DELFOR should indicate “4” and “7” as the
Group segment and the Message segment has been rejected for DESADV and accepted for
DELFOR. The UCS segment for DESADV should indicate error code “13” (Missing mandatory
segment) at UCS020.
7. The UNT and UNZ segment should indicate the count of the number of segments and the number of
Functional groups in the message at UNT010 and UNZ010.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1
You can also monitor the relation between the EDI parent message and child messages (of type DELFOR
and DESADV) after their split.
1. To do so, in Message Monitoring, search for the child message (of type DELFOR and DESADV) by
selecting the appropriate radio button and then go to Message log tab.
2. The tab Message log and Message Details for the child messages (of type DELFOR and DESADV)
displays the correlation between the child messages and the parent message.
3. In the Message Details tab check for the Reference ID label which refers to the Message ID of the
Parent EDI message.
91
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
4. Also check for the message “Message was split from an EDIFACT message with ID <Message ID of
the parent EDI message>” in the Message log.
12 Variant 8: AS2, EDI Separator (Odette: AVIEXP and DELINS) and EDI-XML Converter
On this variant, an Odette multi-message containing two message types (AVIEXP and DELINS) is sent by a
trading partner. The message is split by the EDI Separator, converted into XML and sent to a file receiver.
Three Integration Flows are configured in this variant:



Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
The message is sent with AS2 protocol from a partner to the PI. A sender Communication Channel
with AS2 adapter receives the message and sends it to a receiver communication channel with
Adapter type EDI Separator.
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: AVIEXP, Message Version Number: 3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: DELINS, Message Version Number: 3
12.1 Configuring the Integration Flows
12.1.1 Calling the Process Integration Designer
If not done yet, open the SAP NetWeaver Developer Studio, connect to the systems and open the SAP
Process Integration Designer perspective as described on the Prerequisites section.
12.1.2 Creating the integration Flows
12.1.2.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
1. On the PI Explorer View, select “New Integration Flow” form the context menu (right click) or from
the toolbar menu (top-left) as shown in the screenshot below
2. On the Name field type “AS2_EDISep_var8_R1_<User-ID>”, select “Point-to-Point Channel” and
click on “Next”
3. To assign the Communication Component to sender, right click on the sender -> Click on New
Business component -> select the Business Component name as <SID>_<UserID>_B2B_BC_AS2_EDISEP_V8_01 -> Click Finish.
4. Click on the Browse button for the field Interface and select the service interface
“XiPatternInterface1”, software component SAP BASIS 7.31
5. Select the “Receiver Systems” tab
6. Click on the field located on the column “Communication Components”, a browse button will appear
on the right side of the field, click on it and select the Business Component <SID>_<UserID>_B2B_BC_AS2_EDISEP_V8_01
92
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. Following the same procedure, select the service interface “XiPatternInterface1”, software
component SAP BASIS 7.31 on the field located under column “Interface”
8. Click on button “Finish”
12.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow1, create the second Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var8_S1_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_02
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_02
12.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow 1, create the third Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var8_S2_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_03
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V8_03
12.1.3 Configuring the integration Flows
12.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
In the following steps, you configure the first Integration Flow using AS2 adapter as sender and EDI
separator as receiver.
Configuring the AS2 adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var8_R1_<User-ID>”
93
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. In the graphical editor, right click on the channel for the sender component and select configure
channel (please see screenshot below)
3. As adapter type, select AS2 (Software Component B2B Toolkit 1.0)
4. On the field Channel Name type: AS2_sender
5. Select tab “Adapter-Specific”. Under sub-tab “General” provide the following configuration values:
Category
Field Name
Value
Server
Expected URL-Path
AS2DispatcherServlet_<User-ID>_var8
Message
Expected Message ID left
<Specifies the left part of the incoming AS2
MessageID>
”.*”
Expected Message ID right
<Specifies the right part of the incoming AS2
Message ID>
”.*“
<aka Organization name on AS2 connector>
Expected sender‟s AS2Name
testas2
Expected own AS2 name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var08_Outbound_PO_SE
Expected subject
“.*”
Charset
Charset conversion

Source encoding

Destination encoding
Checked
ISO-8859-1
UTF-8
Message
Set dynamic parameter
Checked
94
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
configuration
Quality of Service
Exactly Once (asynchronous)
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
6. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Signature
Field Name
Value
Verify Signature
Checked
View to sender‟s public key
certificate
<The NWA key-storage view containing the
sending partner‟s public key certificate and alias
(or name) under which the sending partner‟s
public key certificate is stored.>
Use the browse button to select both, View and
Alias, and click OK
Alias of sender‟s public key
certificate
Select Keystore: AS2_CERTIFICATE /
Keystore Entry: Partner_Test-cert for both (view
and alias)
Decryption
Decrypt
Checked
View to own private key
Alias of own private key
<, the NWA key-storage view containing self (own)
private key and alias (or name) under which the selfprivate key is stored >
Use the browse button to select both, View and
Alias, and click OK
Select AS2_KEYSTORE / PI_Test for both (view and
alias)
7. Select sub-tab “MDN” and provide the following configuration values:
Category
Message
Disposition
Notification
Field Name
Sign MDN
Value
Unchecked
Configuring the EDI Separator on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “configure
channel”
2. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0)
3. On the field Channel Name type: EDISep_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
95
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Category
Field Name
Value
Formatting
Indent messages
Unchecked
Adapter
Status
Adapter Status
Active
5. Save the integration Flow
12.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var8_S1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “Odette”
4. On the field Channel Name type: EDISep_send1
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Message Type
Select „AVIEXP‟
Message Version Number
Select „3‟
Interchange Sender
Identification
SENDERXYZ
Interchange Sender
Identification Code Qualifier
Select „ZZZ‟
Interchange Recipient
Identification
PARTNERZYX
Interchange Recipient
Identification Code Qualifier
Select „ZZZ‟
Encoding
Character encoding
Select „US-ASCII‟
QoS
Quality of Service
Select „Exactly Once (asynchronous)‟
Adapter
Status
Adapter Status
Active
Filter
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
96
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec1
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\outputodette
Create Target Directory:
Checked
File Name Scheme
Output-AVIEXP.xml
6. Save the integration Flow
12.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var8_S2_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “Odette”
4. On the field Channel Name type: EDISep_send2
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Filter
Field Name
Message Type
Value
Select „DELINS‟
97
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Message Version Number
Select „3‟
Interchange Sender
Identification
SENDERXYZ
Interchange Sender
Identification Code Qualifier
Select „ZZZ‟
Interchange Recipient
Identification
PARTNERZYX
Interchange Recipient
Identification Code Qualifier
Select „ZZZ‟
Encoding
Character encoding
Select „US-ASCII‟
QoS
Quality of Service
Exactly Once (asynchronous)
Adapter
Status
Adapter Status
Active
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec2
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
98
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
e.g. \\host\<selected-path>\AS2-EDISEP\outputodette
Create Target Directory:
Checked
File Name Scheme
Output-DELINS.xml
6. Save the integration Flow
12.2 Configuring the trading partner
12.2.1 Creating the trading partner on AS2 connector
1.
2.
3.
4.
5.
6.
7.
Open the URL of the AS2 connector http://host:port/Default.aspx
Navigate to the tab “Trading Partner”
Click on “Add New”
On “Select partner type” select “AS2”
On “Organization Name”, type: SAPPI_<SID>_<User-ID>_08
On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_Var08_Outbound_PO_SE
On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_var8
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
8. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Checked
Checked
Incoming Message
Security
Require Signature
Require encryption
Checked
Checked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
9. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
Unchecked
Security
Signed / Unsigned
Unsigned
Delivery
Synchronous / Asynchronous
Synchronous
99
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
10. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
11. Click on “Save Changes”
12.2.2 Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1. Go to the corresponding folder of the trading partner you just created.
\\host\as2data\AS2_<SID>_<User-ID>_Var08_Outbound_PO_SE\Outgoing
2. Copy the file “B2B_odetteSenderMessage_AVIEXP3_DELINS3.txt” into the “Outgoing” folder and
create two or more copies of it.
12.3 Saving and Activating the Configuration Objects
Proceed as described in variant1.
12.4 Executing the Use Case
In this variant the third party AS2 Connector from /n software has been used for sending the message. Third
party can vary in your case. For the configuration of this third party software please refer the section ‎2.2.3.
1. Check that all sender and receiver channels are started before sending the message from third party
software.
2. Go to AS2 Connector (AS2 connector http://host:port/Default.aspx )and navigate to the “Outcoming”
tab.
3. Select the trading partner‟s organization name (SAPPI_<SID>_<User-ID>_08). The table “Outgoing
files” shows the available test files present at the trading partner location. If there isn‟t any, proceed
as described in ‎12.2.2
4. Click on the send button.
5. After some seconds the message “transmission successful” should be displayed.
6. On the host of the Advanced Adapter Engine Extended, open the file directory output-odette (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-odette ). There should be an XML version of the input file
for each message type AVIEXP and DELINS, respectively.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1
You can also monitor the relation between the EDI parent message and child messages (of type AVIEXP
and DELINS) after their split.
1. To do so, in Message Monitoring, search for the child message (of type AVIEXP and DELINS) by
selecting the appropriate radio button and then go to Message log tab.
100
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. The tab Message log and Message Details for the child messages (of type AVIEXP and DELINS)
displays the correlation between the child messages and the parent message.
3. In the Message Details tab check for the Reference ID label which refers to the Message ID of the
Parent EDI message.
4. Also check for the message “Message was split from an Odette message with ID <Message ID of
the parent EDI message>” in the Message log.
13 Variant 9: AS2, EDI Separator (VDA: 4905 and 4913) and EDI-XML Converter
On this variant, a VDA multi-message containing two message types (4905 and 4913) is sent by a trading
partner. The message is split by the EDI Separator, converted into XML and sent to a file receiver.
Three Integration Flows are configured in this variant:



Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
The message is sent with AS2 protocol from a partner to the PI. A sender Communication Channel
with AS2 adapter receives the message and sends it to a receiver communication channel with
Adapter type EDI Separator.
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: 4905
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Message Type: 4913
13.1 Configuring the Integration Flows
13.1.1 Calling the Process Integration Designer
If not done yet, open the SAP NetWeaver Developer Studio, connect to the systems and open the SAP
Process Integration Designer perspective as described on the Prerequisites section.
13.1.2 Creating the integration Flows
13.1.2.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
1. On the PI Explorer View, select “New Integration Flow” form the context menu (right click) or from
the toolbar menu (top-left) as shown in the screenshot below
2. On the Name field type “AS2_EDISep_var9_R1_<User-ID>”, select “Point-to-Point Channel” and
click on “Next”
3. To assign the Communication Component to sender, right click on the sender -> give the Business
Component name as <SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_01 -> Click finish.
4. Click on the Browse button for the field Interface and select the service interface
“XiPatternInterface1”, software component SAP BASIS 7.31
5. Select the “Receiver Systems” tab
6. Click on the field located on the column “Communication Components”, a browse button will appear
on the right side of the field, click on it and select the Business Component <SID>_<UserID>_B2B_BC_AS2_EDISEP_V9_01
101
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. Following the same procedure, select the service interface “XiPatternInterface1”, software
component SAP BASIS 7.31 on the field located under column “Interface”
8. Click on button “Finish”
13.1.2.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow1, create the second Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var9_S1_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_02
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_02
13.1.2.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Following the same steps for Integration Flow 1, create the third Integration Flow with the following data:
Integration Flow Name
AS2_EDISep_var9_S2_<User-ID>
Sender Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_03
Sender Service Interface
“XiPatternInterface1”, software component SAP BASIS 7.31
Receiver Communication Component
<SID>_<User-ID>_B2B_BC_AS2_EDISEP_V9_03
13.1.3 Configuring the integration Flows
13.1.3.1
Integration Flow 1: Sender: AS2 Adapter, Receiver: EDI Separator.
In the following steps, you configure the first Integration Flow using AS2 adapter as sender and EDI
separator as receiver.
Configuring the AS2 adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var9_R1_<User-ID>”
102
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
2. In the graphical editor, right click on the channel for the sender component and select configure
channel (please see screenshot below)
3. As adapter type, select AS2 (Software Component B2B Toolkit 1.0)
4. On the field Channel Name type: AS2_sender
5. Select tab “Adapter-Specific”. Under sub-tab “General” provide the following configuration values:
Category
Field Name
Value
Server
Expected URL-Path
AS2DispatcherServlet_<User-ID>_var9
Message
Expected Message ID left
<Specifies the left part of the incoming AS2
MessageID>
”.*”
Expected Message ID right
<Specifies the right part of the incoming AS2
Message ID>
”.*“
<aka Organization name on AS2 connector>
Expected sender‟s AS2Name
testas2
Expected own AS2 name
<AS2 Identifier>
AS2_<SID>_<User-ID>_Var09_Outbound_PO_SE
Expected subject
“.*”
Charset
Charset conversion

Source encoding

Destination encoding
Checked
ISO-8859-1
UTF-8
Message
Set dynamic parameter
Checked
103
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
configuration
Quality of Service
Exactly Once (asynchronous)
Archiving
Archive Messages
Unchecked
Adapter
Status
Adapter Status
Active
6. Select sub-tab “Signature and Encryption” and provide the following configuration values:
Category
Signature
Field Name
Value
Verify Signature
Checked
View to sender‟s public key
certificate
<The NWA key-storage view containing the
sending partner‟s public key certificate and alias
(or name) under which the sending partner‟s
public key certificate is stored.>
Use the browse button to select both, View and
Alias, and click OK
Alias of sender‟s public key
certificate
Select Keystore: AS2_CERTIFICATE /
Keystore Entry: Partner_Test-cert for both (view
and alias)
Decryption
Decrypt
Checked
View to own private key
Alias of own private key
<, the NWA key-storage view containing self (own)
private key and alias (or name) under which the selfprivate key is stored >
Use the browse button to select both, View and
Alias, and click OK
Select AS2_KEYSTORE / PI_Test for both (view and
alias)
7. Select sub-tab “MDN” and provide the following configuration values:
Category
Message
Disposition
Notification
Field Name
Sign MDN
Value
Unchecked
Configuring the EDI Separator on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “configure
channel”
2. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0)
3. On the field Channel Name type: EDISep_rec
4. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
104
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Category
Field Name
Value
Formatting
Indent messages
Unchecked
Adapter
Status
Adapter Status
Active
5. Save the integration Flow
13.1.3.2
Integration Flow 2: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var9_S1_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDI Separator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “VDA”
4. On the field Channel Name type: EDISep_send1
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Message Type
Select „4913‟
Customer Number
12345678
Vendor Number
87654321
Encoding
Character encoding
Select „UTF-8‟
QoS
Quality of Service
Select „EO‟
Adapter
Status
Adapter Status
Active
Filter
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values:
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
105
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec1
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\output-vda
Create Target Directory:
Checked
File Name Scheme
Output-4913.xml
6. Save the integration Flow
13.1.3.3
Integration Flow 3: Sender: EDI Separator & EDI-XML Converter module, Receiver: File adapter
Configuring the EDI Separator adapter on the sender communication channel
1. Open the Integration Flow “AS2_EDISep_var9_S2_<User-ID>”
2. In the graphical editor, right click on the channel for the sender component and select configure
channel
3. As adapter type, select EDISeparator (Software Component B2B Toolkit 1.0), for transport protocol,
select “PI” and for Message protocol, select “VDA”
4. On the field Channel Name type: EDISep_send2
5. Select tab “Adapter-Specific”. Under tab “General” provide the following configuration values
Category
Field Name
Value
Message Type
Select „4905‟
Customer Number
12345678
Vendor Number
87654321
Encoding
Character encoding
Select „UTF-8’
QoS
Quality of Service
Exactly Once (asynchronous)
Filter
106
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
Adapter
Status
Adapter Status
Active
6. Select tab “Modules”
7. Add the Converter module, to do this, please click on “Add” on the first table (Processing sequence)
and type the following values (please note that the module name is case sensitive):
Category
Processing
sequence
Parameter name
Value
Module Name
localejbs/GenericConverterModule
Type
Local Enterprise Bean
Module Key
1
8. Move to the position number 1 the module you just added by selecting the row and using the “Move
Up” button
Configuring the File Adapter on the receiver communication channel
1. In the graphical editor, right click on the channel for the receiver component and select “Apply
Channel Template”
2. Select “XiPatternChannel_FileReceiver”, software component “SAP BASIS 7.31” and click “OK”
3. In the graphical editor, right click on the channel and select “configure channel”
4. On the field Channel Name type: File_rec2
5. Go to the tab “Adapter-Specific” and adjust the following values:
Category
File Access
Parameters
Parameter name
Target Directory:
Value
<the path to the output folder on the server>
e.g. \\host\<selected-path>\AS2-EDISEP\output-vda
Create Target Directory:
Checked
File Name Scheme
Output-4905.xml
6. Save the integration Flow
13.2 Configuring the trading partner
13.2.1 Creating the trading partner on AS2 connector
1.
2.
3.
4.
5.
6.
Open the URL of the AS2 connector http://host:port/Default.aspx
Navigate to the tab “Trading Partner”
Click on “Add New”
On “Select partner type” select “AS2”
On “Organization Name”, type: SAPPI_<SID>_<User-ID>_09
On “AS2 Identifier”, type: AS2_<SID>_<User-ID>_Var09_Outbound_PO_SE
107
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
7. On “Partner URL”, type: http://<host>:<port>/AS2/<ExpectedURLPath>
http://host:port/AS2/AS2DispatcherServlet_<User-ID>_var9
The last part is the parameter you configured on the AS2 Sender Communication Channel (Expected
URL-Path)
8. On “Connection Info” select the following options:
Category
Field Name
Value
Outgoing Message
Security
Sign Outgoing Data
Encrypt Outgoing Data
Checked
Checked
Incoming Message
Security
Require Signature
Require encryption
Checked
Checked
Compression
Compress Outgoing Data
Checked
Connection timeout (sec)
600
Restrict the use of signing and
encryption algorithms…
Unchecked
9. On “MDN Receipts” select the following options:
Category
Field Name
Value
Request MDN Receipt
unchecked
Security
Signed / Unsigned
Unsigned
Delivery
Synchronous / Asynchronous
Synchronous
10. On “Trading Partner Certificates” provide the following data:
Category
Field Name
Value
Trading Partner Certificate Encryption
<selected-path>\PI_Test-cert.crt
Security
Trading Partner Certificate Signature
<selected-path>\PI_Test-cert.crt
Delivery
Trading Partner Certificate - SSL
Server Authentication
Can be left empty
11. Click on “Save Changes”
13.2.2 Adding test data to the configured trading partner
On the system hosting the AS2 connector, a new folder with the name of the AS2 Identifier has been
automatically created. Under that folder, the folder “Outgoing” was created, where the test files have to be
present in order to be sent.
1. Go to the corresponding folder of the trading partner you just created.
\\host\as2data\AS2_<SID>_<User-ID>_Var09_Outbound_PO_SE\Outgoing
2. Copy the file “B2B_vdaSenderMessage_4905_4913.txt” into the “Outgoing” folder and create two or
more copies of it.
108
Simple Use Cases for B2B AS2 & EDI Separator using Integration Flow Configuration
13.3 Saving and Activating the Configuration Objects
Proceed as described in variant1.
13.4 Executing the Use Case
In this variant the third party AS2 Connector from /n software has been used for sending the message. Third
party can vary in your case. For the configuration of this third party software please refer the section ‎2.2.3.
1. Check that all sender and receiver channels are started before sending the message from third party
software.
2. Go to AS2 Connector (AS2 connector http://host:port/Default.aspx )and navigate to the “Outcoming”
tab.
3. Select the trading partner‟s organization name (SAPPI_<SID>_<User-ID>_09). The table “Outgoing
files” shows the available test files present at the trading partner location. If there isn‟t any, proceed
as described in ‎13.2.2
4. Click on the send button.
5. After some seconds the message “transmission successful” should be displayed.
6. On the host of the Advanced Adapter Engine Extended, open the file directory output-vda (e.g.
\\host\<Selected-path>\AS2-EDISEP\output-vda ). There should be an XML version of the input file for
each message type 4913 and 4905, respectively.
Furthermore, you can check the processing of the message in monitoring. You can do this in channel and
message monitoring. To do this, proceed as given in variant1
You can also monitor the relation between the EDI parent message and child messages (of type 4913 and
4905) after their split.
1. To do so, in Message Monitoring, search for the child message (of type 4913 and 4905) by selecting
the appropriate radio button and then go to Message log tab.
2. The tab Message log and Message Details for the child messages (of type 4913 and 4905) displays
the correlation between the child messages and the parent message.
3. In the Message Details tab check for the Reference ID label which refers to the Message ID of the
Parent EDI message.
4. Also check for the message “Message was split from a VDA message with ID <Message ID of the
parent EDI message>” in the Message log.
109
www.sap.com
© 2013 SAP AG. All rights reserved.
SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP
products and services mentioned herein as well as their respective
logos are trademarks or registered trademarks of SAP AG in Germany
and other countries.
Business Objects and the Business Objects logo, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and
other Business Objects products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks
of Business Objects Software Ltd. Business Objects is an SAP
company.
Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL
Anywhere, and other Sybase products and services mentioned herein
as well as their respective logos are trademarks or registered
trademarks of Sybase Inc. Sybase is an SAP company.
Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services are
registered trademarks of Crossgate AG in Germany and other
countries. Crossgate is an SAP company.
All other product and service names mentioned are the trademarks of
their respective companies. Data contained in this document serves
informational purposes only. National product specifications may vary.
These materials are subject to change without notice. These materials
are provided by SAP AG and its affiliated companies ("SAP Group")
for informational purposes only, without representation or warranty of
any kind, and SAP Group shall not be liable for errors or omissions
with respect to the materials. The only warranties for SAP Group
products and services are those that are set forth in the express
warranty statements accompanying such products and services, if
any. Nothing herein should be construed as constituting an additional
warranty.