Basic
Configuration - Exchanging passthrough EDI documents
In this example, the hub configuration is quite simple--two
targets are defined (one for documents coming into the hub from
a participant and one for documents coming into the hub from the
Community Manager back-end system). The exchanges that are set up
in this example use the document flow definitions provided by WebSphere Partner
Gateway; therefore, you only have to create interactions based on
those flows. No custom XML is used in this example.
This example shows an exchange between a back-end-application
of the Community Manager and a community participant (Partner Two).
Configuring the hub
The first step in setting up the hub is creating the two
targets.
- An HTTP Target (called "HttpTarget") to receive
documents over HTTP (from Partner Two) that are to be sent to the
back-end system of the Community Manager
- A File Directory Target (called "FileSystemTarget")
to retrieve documents from the file system (from the Community Manager's
back-end system) that are to be sent to Partner Two)
Defining the targets
To create a target for the receipt of documents over HTTP:
- Click Hub Admin > Hub Configuration > Targets.
- Click Create Target.
- For Target Name, type: HttpTarget.
- From the Transport list, select HTTP/S.
- For the Gateway type, use the default of Production.
- For the URI, type: /bcgreceiver/submit
- Click Save.
Next, you create a target to poll a directory on the file system.
Creating the target automatically creates a new directory on the
file system.
To create the file-system target:
- Click Hub Admin > Hub Configuration > Targets.
- Click Create Target.
- For Target Name, type: FileSystemTarget.
- From the Transport list, select File Directory.
- For Default Gateway Type, use the default of Production.
- For the Document Root Path, type: \temp\FileSystemTarget
Note: This will create a FileSystemTarget directory within
the temp directory. Be sure a temp directory exists on the file
system.
- Click Save.
Defining document flows and interactions
In this example, you are setting up the exchange of documents
that conform to the EDI-X12 standard. In this example, the documents
are simply being passed through the hub. The EDI interchange is
not being de-enveloped and no transformation occurs. See Appendix B. EDI examples for examples of de-enveloping an interchange, transforming
the transactions, and sending acknowledgments.
In this section, the following exchanges are described:
- Sending an EDI-X12 document, with no packaging, from the Community Manager
to Partner Two
- Sending an EDI-X12 document, packaged in AS2, from Partner Two
to the Community Manager
Because of the packaging and protocols involved, there is no
need to create a new document flow definition. The packages, protocols,
and document flows are ones that are predefined in the system.
However, you do need to define interactions based on these predefined
document flows.
Create the first interaction, in which the source is an ISA-formatted
document that conforms to the EDI-X12 standard and contains no packaging
and the target is an ISA-formatted document that conforms to the
EDI-X12 standard with AS packaging.
- Click Hub Admin > Hub Configuration > Document Flow Definition.
- Click Manage Interactions and then Create Interaction.
- From the Source column, expand:
- Package: None
- Protocol: EDI-X12
- Click Document Flow: ISA
- From the Target column, expand:
- Package: AS
- Protocol: EDI-X12
- Click Document Flow: ISA
- From the Action list, select Pass Through.
- Click Save.
Create a second interaction, in which the source format is an
ISA-formatted document that conforms to the EDI-X12 standard with
AS packaging, and the target format is an ISA-formatted document
that conforms to the EDI-X12 standard and contains no packaging:
- Click Create Interaction.
- From the Source column, expand:
- Package: AS
- Protocol: EDI-X12
- Click Document Flow: ISA
- From the Target column, expand:
- Package: None
- Protocol: EDI-X12
- Click Document Flow: ISA
- From the Action list, select Pass Through.
- Click Save.
Creating participants and participant connections
In this example, one external participant is created,
in addition to the Community Manager. The gateways for the participants
include standard transports, and no configuration points are defined
for the gateways.
Creating the participants
Create two new participants. To define the Community Manager:
- Click Account Admin from the main menu.
The Participant Search page is the default view.
- Click Create.
- For Company Login Name, type: CommMan.
- For Participant Display Name, type: Comm Man.
- For Participant Type, select Community Manager.
- Click New under Business ID.
- Leave Type as DUNS and
enter an Identifier value of 123456789.
Note: Here and throughout this book, all DUNS numbers
are meant to be examples only.
- Click New under Business ID.
- Select Freeform and enter an Identifier
value of 12-3456789
- Click Save.
To define Partner Two:
- Click Account Admin > Profiles > Community Participant.
- Click Create.
- For Company Login Name, type: partnerTwo
- For Participant Display Name, type: Partner Two
- For Participant Type, select Community Participant.
- Click New under Business ID.
- Leave Type as DUNS and
enter 987654321 as the Identifier.
- Click New under Business ID.
- Select Freeform and enter an Identifier
value of 98-7654321
- Click Save.
You have now defined both the Community Manager and Partner Two
to the hub.
The next steps are to configure gateways for both the Community
Manager and Partner Two.
Creating the gateways
Before creating a file-directory gateway for the Community
Manager, you must create the directory structure used by this gateway.
Create a new FileSystemGateway directory on the root drive. This
directory will be used by the Community Manager to store files received
from participants.
In the case of the Community Manager, the gateway represents
the entrance point into the back-end system.
To create a gateway for the Community Manager:
- Click Account Admin > Profiles > Community Participant.
- Click Search.
- Select Comm Man by clicking the View details icon.
- Click Gateways from the horizontal navigation
bar.
- Click Create.
- For Gateway Name, type: FileSystemGateway
- For Transport, select File Directory.
- For Address, type: file://C:\FileSystemGateway
- Click Save.
Next, set this newly created gateway as the default gateway for
the Community Manager.
- Click List to view all gateways configured
for the Community Manager.
- Click View Default Gateways.
- From the Production list, select FileSystemGateway.
- Click Save.
Create a gateway for Partner Two
- Click Account Admin > Profiles > Community Participant.
- Click Search, and then select Partner Two by
clicking the View details icon.
- Click Gateways from the horizontal navigation
bar.
- Click Create.
- For Gateway Name, type: HttpGateway
- For Transport, select HTTP/1.1.
- For Address, type: http://<IP_address>:80/input/AS2,
where <IP_address> represents
Partner Two's computer.
- For User Name, type: Comm Man.
- For Password, type: commMan.
- Click Save.
Note that this example assumes that Partner Two requires a user
name and password for any participant logging in to its system.
Again, you need to define a default gateway for this participant.
- Click List followed by View Default Gateways.
- From the Production list, select HttpGateway.
- Click Save.
Setting up B2B Capabilities
Next, define the B2B Capabilities for the Community Manager.
- From the main menu, click Account Admin > Profiles > Community Participant.
- Click Search.
- Select Comm Man by clicking the View details icon.
- Click B2B Capabilities from the horizontal
navigation bar.
- Set the Source and Target for Package: None, Protocol: EDI-X12,
and Document Flow: ISA by performing the following steps:
- Click the Role is not active icon under Set Source for Package: None
- Click the Role is not active icon under Set Target for Package: None
- Click the Expand icon next to Package: None.
- Click the Role is not active icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the Expand icon next to Protocol: EDI-X12 (ALL).
- Click the Role is not active icon for Document Flow: ISA for
both source and target.
Then, set the B2B Capabilities for Partner Two.
- From the main menu, click Account Admin > Profiles > Community Participant.
- Click Search.
- Select Partner Two by clicking the View details icon.
- Click B2B Capabilities from the horizontal
navigation bar.
- Select Set Source and Set Target for Package: AS, Protocol:
EDI-X12, and Document Flow: ISA by performing the following steps:
- Click the Role is not active icon under Set Source for Package: AS
- Click the Role is not active icon under Set Target for Package: AS
- Click the Expand icon next to Package: AS.
- Click the Role is not active icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the Expand icon next to Protocol: EDI-X12 (ALL).
- Click the Role is not active icon for Document Flow: ISA for
both source and target.
Defining participant connections
Define the participant connection for EDI documents with
no packaging that come from the Community Manager to be delivered
to Partner Two.
- Click Account Admin > Participant Connections.
- From the Source list, select Comm Man.
- From the Target list, select Partner Two.
- Click Search.
- Click Activate for the connection with
the following detail:
- Source
- Package: None (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ISA(ALL)
- Target
- Package: AS (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ISA (ALL)
Next, define the connection for EDI documents wrapped in AS2
packaging that come from Partner Two to be delivered to the Community
Manager with no packaging. This is very similar to the connection
you defined in the previous section, except that you will also configure
AS2 attributes.
- Click Account Admin > Participant Connections.
- From the Source list, select Partner Two
- From the Target list, select Comm Man.
- Click Search.
- Click Activate for the connection with
the following detail:
- Source
- Package: AS (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ISA (ALL)
- Target
- Package: None (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ISA (ALL)
Next, select Attributes next to the Package: AS (N/A) box
for Partner Two.
- Edit the Package: AS (N\A) attributes by scrolling down the
page and clicking the Expand icon next to Package: AS (N/A).
- Enter an AS MDN E-Mail Address (AS1) value. This can be any
valid e-mail address.
- Enter an AS MDN HTTP URL (AS2) value. This should be entered
as follows: http://<IP_address>:57080/bcgreceiver/submit, where <IP_Address> represents the
hub.
- Click Save.
