B2B Add-On Installation Guide

SAP introduced B2B Integration Cockpit (add-on) to facilitate all EDI communications of an organization with one component. Lets look at how to install B2B add-on in Process Integration (PI) or Process Orchestration (PO). We will look at the steps that should be carried out as part of the Post Installation of B2B Integration Cockpit.

B2B add-on (Integration Cockpit) is compatible with following PI and PO versions 7.1 or higher:

  • Process Integration (PI) with Advanced Adapter Engine (AAE)
  • Process Integration installation with Advance Adapter Engine Extended (AEX)
  • Process Orchestration

Learn about differences between these PI and PO versions here.

This article is a step by step guide on how to execute the post installation steps after BASIS team deploys the B2B add-on cockpit software. Note, these are only the post installation steps PI Integration expert should carryout in order to prepare B2B add-on for design time and runtime execution.

We will discuss how to install B2B Enterprise Service Repository (ESR) content and runtime content below.

  • B2B Toolkit:

This includes Adapter metadata for EDI/B2B related adapters. B2B toolkit contains adapter metadata for AS2, EDI Separator, OFTP, and X400 adapters.

  • B2B Mapping Kit:

This is the repository object which contains B2B mapping templates and User Defined Functions (UDF) delivered through SAP standard content.

  • B2B EDI Runtime Content:

These are the objects and configuration data required for runtime of an EDI scenario. These include Control Key Information (SAP delivered) and EDI messages versions which are used by the converter for transforming EDI to XML and vice versa. Additionally, XSDs which can be used to create EDI service interface objects are also delivered with the runtime content.

 

Prerequisites for B2B Integration Cockpit Post Installation:

Before you install the Mapping Kit, Toolkit and Runtime Content, make sure the BASIS team has already deployed the B2B add-on Cockpit software. Once the BASIS team deploys the B2B Cockpit these Software Components should be available in your PI/PO system.

To verify if you your system contains required components, go to Netweaver Java Application Server home page (http://<host>:<port>) > System Information, then view B2B component detail under Component Info tab.

 

Netweaver-application-server-java-home-b2b-pi-po
Netweaver application server java start page

 

b2b-add-on-components-installed
These B2B Add-on Components should be installed and available

Now that we made sure B2B components are available, we can move forward to post installation steps.

 

Lets look at B2B Cockpit Post Installation Steps.

 

Step 1: Download B2B .ZIP files from SAP Support Center,

Download Software Support Packages & Patches > By Alphabetical Index (A-Z) > PI B2B ADD-ON > PI B2B ADD-ON 1.0 > COMPRISED SOFTWARE COMPONENT VERSIONS

We require below three files for the setup.

  • B2BTOOLKIT1005_0-10011005.ZIP
  • B2BMAPPINGKIT1000_1-10010991.ZIP
  • PIB2BCONTENT00_5-20009370.ZIP
b2b-add-on-zip-files
B2B Add-on set up ZIP files

 

Step 2: Unzip B2B files to your work station.

Files unzip as follows. Mapping Kit and Toolkit zip files contain only one .tpz file each. PIB2BCONTENT00_5-20009370.ZIP file contains Runtime Content, XSDs and com.sap.aii.adapter.archiver.mapping.jar files.

  • B2BTOOLKIT1005_0-10011005.ZIP -> XI7_3_B2B_TOOLKIT_1.0_05_00.tpz
  • B2BMAPPINGKIT1000_1-10010991.ZIP -> XI7_11_B2B_MAPPING_KIT_1.0_00_01.tpz
  • PIB2BCONTENT00_5-20009370.ZIP -> com.sap.aii.adapter.archiver.mapping.jar, Runtime Content and XSDs
B2B-add-on-runtime-content-files
B2B add-on runtime content files
B2B-add-on-runtime-content-files-xsd
B2B add-on runtime content files XSD

 

Step 3: Install B2B Toolkit.

Import file XI7_3_B2B_TOOLKIT_1.0_05_00.tpz to Enterprise Service Repository (ESR).

Import-B2B-toolkit-ESR
Import B2B Toolkit to ESR
toolkit-b2b-add-on-upload-.tpz
Upload Toolkit .tpz file to ESR

 

B2B Toolkit Software Component should be created as below after upload is complete.

B2B-add-on-Toolkit-installed
B2B add-on Toolkit installed
B2B-toolkit-expanded-add-on-edi-pi-po
B2B toolkit expanded

 

Step 4: Install Mapping Kit.

Import file XI7_11_B2B_MAPPING_KIT_1.0_00_01.tpz to Enterprise Service Repository (ESR).

import-mapping-kit-esr-add-on-pi-po
Import Mapping Kit to ESR

 

Software Component B2B Mapping Kit should be created as below after installation.

mapping-kit-installed-b2b-installlation-pi-po
Mapping Kit Installed

Step 5: Install B2B Add-On EDI Runtime Content.

Depending on your organization’s EDI requirement, upload only the appropriate .b2b seed file from Runtime Content. For example, I will be using ANSI X.12, therefore I uploaded the seed file B2B_X12_TABLES-v1.0.b2b.

There are the other seed files available in the runtime content.

  • B2B_EDI_TABLES-00A_10B-v1.0.b2b
  • B2B_EDI_TABLES-93A_99B-v1.0.b2b
  • B2B_ODE_TABLES-v1.0.b2b
  • B2B_PLA_TABLES-v1.0.b2b
  • B2B_TRA_TABLES-v1.0.b2b
  • B2B_VDA_TABLES-v1.0.b2b
  • B2B_X12_TABLES-v1.0.b2b

Go to B2B Integration Cockpit home http://<host>:<port>/b2bic and select EDI Content Manager.

b2b-integration-cockpit-home-edi-content-manager-pi-po
B2B integration cockpit home

Import appropriate .b2b files under respective EDI tab.

import-b2b-runtime-content-cockpit-pi-po
Import b2b runtime content from seed files to cockpit

Verify that EDI content (Control Key association) is successfully imported to the B2B cockpit by accessing Editor > Message Editor

b2b-cockpit-message-editor-installation-pi-po
B2B Integration Cockpit message editor

 

b2b-control-key-association-installation-pi-po
B2B Control Key Association

 

Post Installation Results:

If your Post Installation steps were successful, B2B adapters AS2, OFTP, X400 and EDI Separator should be available in your system. Login to Integration Directory (ID) to verify if the B2B adapters are correctly installed.

b2b-adapters-installed-integration-directory-pip-po-cockpit
B2B adapters should be available in the Integration Directory (ID)

If these B2B adapters are still not available, request BASIS team to register the adapters using JSPM.

If you have any questions about the B2B add-on installation steps we have discussed here, please leave a comment.

9 Comments

Add a Comment

Your email address will not be published. Required fields are marked *