Basic Configuration - Exchanging EDI documents with
AS packaging over HTTP
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 Business
Integration Connect; therefore, you only have to create connections
based on those flows. No custom XML is used in this example.
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 (Partner One)
- A File Directory Target (called "FileSystemTarget")
to retrieve documents from the file system (from Partner One's
back-end system) that are to be sent to Partner Two)
Defining the targets
To create a target for the receipt of 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 C:\temp directory. Be sure a C:\temp directory exists on the
file system.
- Click Save.
Defining document flows and interactions
In this example, you are setting up the following exchanges:
- Sending an EDI-X12 document, packaged in AS2, from Partner Two
to Partner One
- Sending an EDI-X12 document, with no packaging, from Partner
Two to Partner One.
- Sending an EDI-X12 document, packaged in AS2, from Partner One
to Partner Two.
- Sending an EDI-X12 document, with no packaging, from Partner
One to Partner Two
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. You need two interactions:
- An interaction in which the source is an EDI-X12 document with
no packaging and the target is an EDI-X12 document with AS2 packaging.
- An interaction in which the source is an EDI-X12 document in
AS2 packaging and the target is an EDI-X12 document with no packaging.
Create the first interaction, in which the source format is an
EDI-X12 document with no packaging and the target format is an EDI-X12
document with AS packaging.
- Click Hub Admin > Hub Configuration > Document Flow Definition.
- Click Manage Interactions and then Create Interaction.
- From the Source column select:
- Package: None
- Protocol: EDI-X12
- Document Flow: All
- From the Target column select:
- Package: AS
- Protocol: EDI-X12
- Document Flow: All
- Set Action to Pass Through.
- Click Save.
Create a second interaction, in which the source format is an
EDI-X12 document in AS packaging, and the target format is EDI-X12
with no packaging:
- Click Create Interaction.
- From the Source column, select:
- Package: AS
- Protocol: EDI-X12
- Document Flow: All
- From the Target column, select:
- Package: None
- Protocol: EDI-X12
- Document Flow: All
- Set Action to 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 Partner One:
- Click Account Admin from the main menu.
The Participant Search page is the default view.
- Click Create.
- For Participant Login Name, type: partnerOne
- For Participant Name, type: Partner One
- For Participant Type, select Community Manager.
- Click New under Business ID.
- Leave Type as DUNS and
enter an Identifier value of 123456789.
- 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 Participant Login Name, type: partnerTwo
- For Participant 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 Partner One and Partner Two to the
hub.
The next steps are to configure gateways for both Partner One
and Partner Two.
Creating the gateways
Before creating a file-directory gateway for Partner One,
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 Partner One to store files received from participants.
In the case of Partner One, who is the Community Manager, the
gateway represents the entrance point into the back-end system.
To create a gateway for Partner One:
- Click Account Admin > Profiles > Community Participant.
- Click Search.
- Select Partner One by clicking the
icon.
- Click Gateways from the horizontal navigation
bar.
- Click Create.
- For Gateway Name, type: FileSystemGateway
- For Transport, select File Directory.
- For Target URI file, type: file://C:\FileSystemGateway
- Click Save.
Next, set this newly created gateway as the default gateway for
Partner One.
- Click List to view all gateways configured
for Partner One.
- Click View Default Gateways.
- From the list, select FileSystemGateway for
the Production Gateway Type.
- Click Save.
Create a gateway for Partner Two
- Click Account Admin > Profiles > Community Participant.
- Click Search, and then select Partner Two by
clicking the magnifying glass icon.
- Click Gateways from the horizontal navigation
bar.
- Click Create.
- For Gateway Name, type: HttpGateway
- For Transport, select HTTP/1.1.
- For Target URI file, type: http://<IP_address>:80/input/AS2,
where <IP_address> represents
Partner Two's computer.
- For User Name, type: partnerOne
- For Password, type: partnerOne
- Click Save.
Note that this example assumes that Parter 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 list, select HttpGateway for
the Production Gateway Type.
- Click Save.
Setting up B2B Capabilities
Next, define the B2B Capabilities for Partner One (the
Community Manager).
- From the main menu, click Account Admin > Profiles > Community Participant.
- Click Search.
- Select Partner One by clicking the magnifying
glass icon.
- Click B2B Capabilities from the horizontal
navigation bar.
- Select Set Source and Set Target for Package: AS, Protocol:
EDI-X12, and Document Flow: ALL by performing the following steps:
- Click the activate icon under Set Source for Package: AS
- Click the activate icon under Set Target for Package: AS
- Click the folder icon next to Package: AS to
expand the folder.
- Click the activate icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the folder icon next to Protocol: EDI-X12 (ALL) to
expand the folder
- Click the activate icon for Document Flow: ALL for
both source and target.
- Set the Source and Target for Package: None, Protocol: EDI-X12,
and Document Flow: ALL by performing the following steps:
- Click the activate icon under Set Source for Package: None
- Click the activate icon under Set Target for Package: None
- Click the folder icon next to Package: None to
expand the folder.
- Click the activate icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the folder icon next to Protocol: EDI-X12 (ALL) to
expand the folder
- Click the activate icon for Document Flow: ALL 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 magnifying glass icon.
- Click B2B Capabilities from the horizontal
navigation bar.
- Select Set Source and Set Target for Package: AS, Protocol:
EDI-X12, and Document Flow: ALL by performing the following steps:
- Click the activate icon under Set Source for Package: AS
- Click the activate icon under Set Target for Package: AS
- Click the folder icon next to Package: AS to
expand the folder.
- Click the activate icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the folder icon next to Protocol: EDI-X12 (ALL) to
expand the folder
- Click the activate icon for Document Flow: ALL for
both source and target.
- Set the Source and Target for Package: None, Protocol: EDI-X12,
and Document Flow: ALL by performing the following steps:
- Click the activate icon under Set Source for Package: None
- Click the activate icon under Set Target for Package: None
- Click the folder icon next to Package: None to
expand the folder.
- Click the activate icon for Protocol: EDI-X12 (ALL) for
both source and target.
- Click the folder icon next to Protocol: EDI-X12 (ALL) to
expand the folder.
- Click the activate icon for Document Flow: ALL for
both source and target.
Defining participant connections
Define the participant connection for EDI documents with
no packaging that come from Partner One to be delivered to Partner
Two.
- Click Account Admin > Participant Connections .
- From the Source list, select Partner One.
- 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: ALL (ALL)
- Target
- Package: AS (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ALL (ALL)
Next, define the connection for EDI documents wrapped in AS2
packaging that come from Partner Two to be delivered to Partner
One 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 Partner One.
- Click Search.
- Click Activate for the connection with
the following detail:
- Source
- Package: AS (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ALL (ALL)
- Target
- Package: None (N/A)
- Protocol: EDI-X12 (ALL)
- Document Flow: ALL (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
screen and clicking the folder 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.
