Quick Start to UN/EDIFACT Inbound Processing
The channel described in this section transforms EDIFACT
inbound messages. The channel produces an XML output representation
of the EDIFACT inbound message and routes transformed XML to a designated
folder based on success or failure of EDIFACT validation. It also
generates a CONTRL functional acknowledgment and an XML validation
report. Output files will be routed to the defined directories as
follows: CONTRL acknowledgment (ack), Validation report (rpt), Original
EDIFACT document (archive), and transformed XML document will reside
in either a (good) or (bad) dependent on EDIFACT and routes transformed
XML to a designated folder based on success or failure of EDIFACT validation
rules.
x
The following are required in order to create the EDIFACT
inbound processing channel:
-
A working knowledge
of iWay Service Manager (iSM).
-
The archived channel
.zip file (EDIFACTtoXML_IB_QS_Pflow_Channel.zip).
Note: For
your convenience, the EDIFACTtoXML_IB_QS_Pflow_Channel.zip file
is attached to this PDF.
For PDF-compatibility purposes, the
file extension of the EDIFACTtoXML_IB_QS_Pflow_Channel.zip file
is temporarily renamed to .zap. After saving this file to your file
system, you must rename this extension back to .zip before it can
be imported to iWay Service Manager.
-
The input data
files representing valid and invalid data (edifact_d00a_author_good_sample.edifact
and edifact_d00a_author_bad_sample.edifact).
Note: For
your convenience, the input data files are also attached to this PDF.
-
EDIFACT Ebix (e-Business
Information Exchange).
x
Procedure: How to Download and Save the EDIFACT Ebix
In
order to download and save the EDIFACT Ebix:
-
Enter the
following URL in a web browser:
http://techsupport.informationbuilders.com
-
On the right-hand
side of the webpage, click My Downloads/Shipment.
A logon window is displayed.
-
Login using
your Global ID and password.
Note: If you do not have a Global ID and password,
you must contact iWay Technical support.
-
Once logged
in, download the two Ebix files (EDIFACT_D00A.ebx and EDIFACT_UNCONTRL.ebx).
-
Save the
downloaded files to <iWaySMHOME>\etc\manager\packages,
as shown in the following image.
<iWaySMHOME> is the directory where iWay Service
Manager is installed (for example, C:\Program Files\iWay61).
-
Save the
file EDIFACTtoXML_IB_QS_Pflow_Channel.zip, which is attached to
this manual, into <iWAYSMHOME>\etc\repository\manager\archives,
as shown in the following image.
-
Create EDIFACT
directory files on your local C or D drive (the C drive was used
here as an example), as shown in the following image.
x
Procedure: How to Import Components from a Repository Archive
To
create an inbound processing channel:
-
In the iWay
Service Manager Administration Console, click Tools in
the top pane, and then Archive Manager in
the left pane.
-
Select Import
components from a repository archive and click Next,
as shown in the following image.
-
Select EDIFACTtoXML_IB_QS_Pflow_Channel.zip and
click Next.
-
Select EDIFACTtoXML_IB_QS_Pflow_Channel and
click Next, as shown in the following image.
A
pane telling you whether the import was a success or not appears.
-
If the import
is successful, Click Finish.
x
Procedure: How to Update Inbound Registers
If
your EDIFACT Directory was created on a drive other than C. You
must update the inbound registers. To update the inbound registers:
-
In the iWay
Service Manager Administration Console, click Registry in
the top pane, and then Registers in the left
pane.
-
Click the EDIFACT File
Register, under the name column.
-
In the Value
column, update the drive letter where the Inbound EDIFACT Directory
was created, as seen in the following image.
-
Once the
drive letters are updated, click Finish.
x
Procedure: How to Upload the Ebix to iWay Service Manager
To
upload the Ebix to iWay Service Manager:
-
In the iWay
Service Manager Administration Console, click Registry in
the top pane, and then Ebix in the left pane.
-
Click the Add button.
-
Click Browse and
navigate to the directory in which the two Ebix files downloaded
previously were saved.
-
Select the
file, EDIFACT_D00A.ebx.
-
Click Next.
-
Enter a
unique name to identify this Ebix and click Finish.
-
Repeat this
process for the second downloaded Ebix, Edifact_UNCONTRL.ebx.
Final Ebix entries are shown in the following image.
x
Procedure: How to Add Ebix Components to a Channel
To
add the Ebix components to a channel:
-
In the iWay
Service Manager Administration Console, click Registry in
the top pane, and then Channels in the left
pane.
-
Click the
number on the Ebix column for EDIFACTtoXML_IB_QS_Pflow_Channel.
-
Click the Add button.
-
Check the
two Ebix components, EDIFACT_UNCONTRL_ebixand Edifact_D00A_Ebix.
-
Click the
icon in the move column for the Edifact_D00A_Ebix component.
-
Click Finish.
-
Click the
arrow in the Move column for the Edifact_D00A_Ebix component.
x
Procedure: How to Build, Deploy, and Test Your Channel
To
build, deploy, and test your channel:
-
In the iWay
Service Manager Administration Console, click Registry in
the top pane, and then Channels in the left
pane.
-
Click the
channel, EDIFACTtoXML_IB_QS_Pflow_Channel.
-
Click Build.
-
Click Deployments at
the top of the screen.
-
Click the Deploy button.
-
Select EDIFACTtoXML_IB_QS_Pflow_Channel and
click the Deploy button.
-
Click the
red X under the status column.
This will cause it to turn into a green check mark.
The
channel is ready to accept inbound data.
-
From Windows
Explorer, copy the provided test file, edifact_d00a_author_good_sample.edifact,
as shown in the following image.
-
Paste the
file in the input directory, C:\EDIFACT\inputdir\edifact_xml.
The
output will be copied to the outputdir subdirectories.