Sample Configuration for Inbound Processing: EDI to XML

In this section:

This topic provides step-by-step instructions on how to configure a basic inbound message flow for the iWay Integration Solution for EDI X12. The message flow represents the movement and tasks in the conversion of a message from Electronic Data Interchange (EDI) format to XML format and acknowledgement of the message.


Top of page

x
Accessing the iWay Service Manager Administration Console

To access the iWay Service Manager Administration Console, you must first make sure that the iWay Service Manager service is running.

For instructions on starting iWay Service Manager, see the iWay Service Manager User's Guide.



x
Procedure: How to Access the iWay Service Manager Administration Console on Windows
  1. From the Windows desktop, select Start, All Programs, iWay 7.0 Service Manager, and Console,

    or,

    from a browser such as Microsoft Internet Explorer, enter the following URL,

    http://host:port

    where:

    host
    Is the host machine on which iWay Service Manager is installed. The default value is localhost.
    port
    Is the port number on which iWay Service Manager is listening. The default value is 9999.

    The following image shows the URL with the default values.

  2. When prompted, enter your user name and password, and click OK.

    Note: The default user name and password is iway.

    The iWay Service Manager Administration Console opens, as shown in the following image.


Top of page

x
Adding an Ebix to the Registry

The iWay e-Business Information Exchange (Ebix) framework supplies several Ebix files for the iWay Integration Solution for EDI X12.

An Ebix file for EDI-X12 is named X12_transaction_set.ebx, where transaction_set is the transaction set number. For example, the Ebix file for EDI X-12 transaction set 4050 is named X12_4050.ebx.

For details on the supported EDI-X12 transaction sets, see Ebix-Supported Transaction Sets.

This topic describes how to add an Ebix to the Registry on Windows and UNIX.



x
Procedure: How to Add an Ebix to the Registry on Windows
  1. To access the Registry, select the Registry option in the green shaded area below the iWay Service Manager banner, as shown in the following image.

  2. Under Components in the left pane of the Registry, select Ebix.

    The Ebix pane opens, as shown in the following image.

  3. Click Add to add a new Ebix. The New Ebix pane opens.

  4. Browse to the directory in which the Ebix is located and select the name of the file, for example, X12_4050_pipeline.ebx.
  5. Once you have selected the Ebix, click Next.

    You are prompted for the name of the Ebix and an optional description.

  6. Enter a name for the Ebix, for example, EDI_4050, and an optional description, such as EDI 4050 Ebix.

    Note: This step must be repeated for each Ebix X12 message set that is added to the Registry.

  7. Click Finish.

    On the Ebix pane, you will see that the Ebix was successfully added. Later you will associate it with the channel for inbound processing.



x
Procedure: How to Add an Ebix to the Registry on UNIX

Depending on your system configuration, there are two methods that you can use to add an Ebix to the Registry on UNIX.


Top of page

x
Adding Special Register Sets

In iWay Service Manager, a special register is a name-value pair that defines a variable that is carried throughout the system. Once defined, this variable is available to all components of the system. Within the EDI components, a Best Practice is to use special registers to define inputs and outputs. When packages containing channels are migrated between systems, the only changes required to deploy in the new location is to modify these special registers and build the channel. Channels may have many locations and this practice will minimize the effort required to migrate. For a complete list of system special registers that are provided, see the iWay Service Manager Programmer's Guide. For more information on defining a special register of your own, see the iWay Service Manager User's Guide.

The sample inbound channel uses a set of special registers defined as X12. For example:



x
Procedure: How to Add a Special Register Set to Your Channel

To add a special register set to your channel:

  1. In the left console pane of the Registry menu, select Channels.

    The Channels pane opens.

  2. In the row for your channel, click Regs for the channel you want to modify.

    The Assign register pane opens.

  3. Select a register and click Finish.
  4. Click Back to return to the Channels pane.

Top of page

x
Defining an Inlet

An inlet defines how a message enters a channel. It typically contains a:



x
Procedure: How to Add a Listener
  1. From the Registry menu options on the left pane, select Listeners under Components.
  2. On the Listeners pane on the right, click Add to add a new listener.
  3. For the purpose of this example, we will show the configuration with a File listener. For details on supported protocols, see the iWay Service Manager Protocol Guide.

    Select File from the Type drop-down list and click Next.

    The configuration parameters pane opens.

  4. Supply configuration parameters for the new File listener as follows. An asterisk indicates that a parameter is required. For parameters not listed in the following table, accept the default value.

    Parameter

    Value

    Input Path *

    sreg(X12.Input)

    This value is a special register that uses a defined directory in which input messages are received.

    Make sure that you have created this directory; otherwise, errors will occur during deployment.

    Destination *

    sreg(X12.ListenerOutput)

    This value is a special register that uses a defined directory in which output files are stored after transformation.

    Make sure that you have created this directory; otherwise, errors will occur during deployment.

    Removal Destination

    sreg(X12.Archive)

    This value is a special register that uses a defined directory to which input messages are moved if they fail during transformation.

    Make sure that you have created this directory; otherwise, errors will occur during deployment. It is recommended to configure a removal destination when you are constructing a basic channel.

    Suffix In

    *

    Input files with any file extension are allowed.

    Suffix Out

    xml

    The extension for output files is .xml.

  5. Click Next.

    You are prompted for the name of the listener and an optional description.

  6. On the Listeners pane, enter the name of the new listener, EDItoXML_Listener, and an optional description. Then click Finish to add the listener. In a later step, you will associate this listener with the inlet.


x
Procedure: How to Add a Preparser
  1. From the Registry menu options, select Preparsers under Components.
  2. On the Preparsers pane, click Add to add a new preparser. You are prompted for the type of preparser.

  3. Select EDIX12SplitterPreParser (com.ibi.preparsers.EDISplitPP) from the Type drop-down list.

    The EDIX12SplitterPreParser parses an EDI input file with one or more ISAs and multiple transaction sets (STs), and creates multiple XML output files. One XML output file is produced for each transaction set. You can also use the EDIX12SplitterPreParser if there is only one transaction set in an ISA.

    For details on the supported EDI-X12 transaction sets, see Ebix-Supported Transaction Sets.

  4. Click Next.

    The Preparsers configuration parameters pane opens.

    The following table lists and describes the available configuration parameters for the preparser:

    Parameter

    Description

    Template

    Used to locate the template in the Ebix used in the transformation from EDI format to XML format.

    Debug

    If enabled, the transformation components are written to files in the local directory. This parameter is set to False by default.

    Segment Terminator

    The control character that marks the end of a specific variable-length segment.

    To view a list of segment terminator characters, see Separators and Terminators.

    Element Delimiter

    The control character used to separate elements in a segment. It follows the segment identifier and each data element in a segment except the last.

    To view a list of element delimiter characters, see Separators and Terminators.

    Component Element Delimiter

    The control character used to separate sub-elements/components in a composite element.

    To view a list of component element delimiter characters, see Separators and Terminators.

    Escape Character

    The escape character is necessary if any of the EDI document separators is part of the actual value of an attribute.

    Timestamp

    Disabled by default, this option writes a timestamp to the log file. When enabled, the log file will display the start and end time of the file transformation and the input file name that is used. This feature is useful in development or debugging environments when processing batches of files. When the transaction log is not in use (for example, in a production mode) then this information is available in the Activity Log.

    Note: To use this feature, logging must be enabled in the Log Settings section of the iWay Service Manager Administration Console.

    XML Transformer

    Enabled by default, this parameter sets the EDIX12SplitterPreParser to transform the individual documents that are split from the incoming message into XML format.

    Note: Use the standalone EDI batch splitter preparser (com.ibi.preparsers.XDEDIBatchSplitter) if you do not require an XML transformation to be called.

    Insert Group Loop

    Inserts a group loop tag in the XML document. Group loop tags are displayed in activity logs and validation processing reports.

    Note: Ensure that this parameter is set to false. By default, this parameter is set to true.

    Node 'delimiters'

    If set to true, node delimiters are added to the generated XML document. By default, this parameter is set to false.

  5. In the Template field, enter X12_%_^toXML.xch. The preparser obtains the message type and version information from the EDI input document. In the parameter, the character "%" represents the message type, and the character "^" represents the version.

    For example, if the message type of the EDI input document is 810, and the version is 004050, the constructed template name is X12_810_004050toXML.xch.

  6. Click Next.

    You are prompted for a name and optional description for the new preparser.

  7. Enter a name for the new preparser, for example, EDItoXML_SplitterPreparser, and an optional description.
  8. Click Finish to add the preparser. In the next procedure, you will associate this preparser with an inlet.


x
Procedure: How to Define an Inlet

Now that you have added a File listener and splitter preparser to the Registry, you are ready to add and define an inlet. You will associate the previously created listener and preparser with the inlet.

  1. From the Registry menu options, select Inlets under Conduits.
  2. On the Inlet Definitions pane, click Add to add an inlet.
  3. On the New Inlet Definition pane, enter the name of the new inlet and an optional description, as shown in the following table. Then click Finish to add the inlet.

    Parameter

    Value

    Name *

    EDItoXML_Inlet

    Description

    Inlet for EDI to XML

  4. On the Construct Inlet pane, click Add to associate the listener and preparser with the inlet.

    The next pane prompts you for the component type.

  5. Select Listener and click Next.

    The next pane prompts you to select a listener.

  6. Select EDItoXML_Listener, which is the listener you added earlier, and click Finish.

    The listener is associated with the inlet. Now you need to associate the preparser created earlier with the inlet.

  7. On the Construct Inlet pane, click Add.

    The next pane prompts you for the component type.

  8. Select Preparser and click Next.

    On the next pane, you are prompted to select a preparser.

  9. Select EDItoXML_SplitterPreparser, which is the preparser you added earlier, and click Finish.

    You have now successfully completed definition of the inlet.


Top of page

x
Defining a Route

For this sample channel configuration, you will define a route that will invoke the X12 to XML validation process flow. The outcome of the validation process flow will place valid transformed XML data in a defined output folder. Invalid transformed data will be routed to an errors folder. An X12 functional acknowledgement and a validation report will be sent to their designated output folder defined in the sample channel.

This section describes how to create a validation process flow using iIT Designer and bind it to a sample inbound channel as a route.



x
Procedure: How to Create a New Project and Start the Process Flow

To create a new project and start the process flow using iIT Designer:

  1. From the Windows Start menu select Programs, iWay 7.0 Service Manager, tools, and then iWay Integration Tools (iIT) Designer.
  2. Connect to the repository from which you want to work, for example, iWay.
  3. Right-click the integration explorer window, select New, and then click Integration Project from the context menu.
  4. In the Name field, provide a valid integration name, for example, Test, and then click Finish.

  5. Right-click the Flows folder, select New, and then click Process Flow from the context menu, as shown in the following image.

    The New Process Flow Wizard opens, as shown in the following image.

  6. In the Name field, type x12toXML_pflow_AckRpt as the process flow name.

    In the Description field, type a brief description (optional).

  7. Click Finish.

    The new x12toXML_pflow_AckRpt node appears under the Flows folder, and the workspace displays a Start and End object with a relation established in between, as shown in the following image.

    You are ready to build the x12toXML_pflow_AckRpt validation process flow by configuring objects to it and specifying their relationships.



x
Procedure: How to Configure Objects for the Process Flow

To configure objects for the process flow using iIT Designer:

  1. Drag and drop the Service object from the toolbar to the workspace, as shown in the following image.

    The New Service Object dialog box opens.

  2. In the Name field, type X12_Validation_Rpt, and a brief description (optional) in the Description field and click Next.

    The Service Object Type wizard opens.

  3. Select Class Name and enter com.ibi.agents.XDX12ValidationReportAgent and click Next, as shown in the following image.

  4. Click Finish.

    The new Service object (X12_Validation_Rpt) appears in the workspace.

  5. Remove the relation (link) between the Start and End objects.
  6. Establish new relation from the Start object to X12_Validation_Rpt by selecting the Start object, right-clicking on the X12_Validation_Rpt object, and then selecting Create Relation from the context menu, as shown in the following image.

    The Relation Properties wizard opens.

  7. From the Event drop-down list, select OnCompletion and then click Finish.

    This option indicates that there are no conditions that affect the path, and that the path between the two objects will always be followed.

    A line appears between the objects to indicate that a relationship has been established, as shown in the following image.

  8. Drag and drop the File object from the object palette to the workspace.

    The File Type dialog box opens.

  9. In the Name field, type Write_Validation_rpt, and a brief description (optional) in the Description field and click Next.

    The File Type dialog box opens.

  10. From the Type drop-down list, select File Emit Agent and click Next.
  11. For the Target Directory parameter, enter a location where validation report data will be written, for example, sreg(X12.ValidRpt).
  12. For the File Pattern parameter, enter sreg(basename)_rpt.xml.
  13. For the Return parameter, select input from the drop-down list and click Finish, as shown in the following image.

    The new File object (Write_Validation_rpt) appears in the workspace.

  14. Select the X12_Validation_Rpt object, right-click the Write_Validation_rpt object, and select Create Relation from the context menu.

    The Line Configuration dialog box opens.

  15. From the Event drop-down list, select OnSuccess and click OK.

    A line appears between the objects to indicate that a relationship has been established.

  16. Drag and drop the End object from the Object palette to the workspace.

    The End Name and Description dialog box opens.

  17. In the Name field, type End3, and a brief description (optional) in the Description field and click Next.

    The End Name Schema dialog box opens.

  18. From the Terminate parameter, select the check box for Select if this end object is the completion point, as shown in the following image.

  19. Click Finish.
  20. Select the Write_Validation_rpt Dir object, right-click the End3 object, and select Create Relation from the drop-down list.

    The Relation Configuration wizard opens.

  21. From the Event drop-down list, select OnCustom and then select the following check boxes:

  22. Click Finish.

    A line appears between the objects to indicate that a relationship has been established, as shown in the following image.

  23. Select the X12_Validation_Rpt object, right-click the End3 object, and then select Create Relation from the drop-down list.

    The Relation Configuration wizard opens.

  24. From the Event drop-down list, select OnFailure and click Finish.

    A line appears between the objects to indicate that a relationship has been established, as shown in the following image.

  25. Drag and drop the Service object from the Object palette to the workspace.

    The New Service Object dialog box opens.

  26. In the Name field, type X12AckAgent, and a brief description (optional) in the Description field and click Next.

    The Service Type dialog box opens.

  27. Select Class Name and enter com.ibi.agents.XDX12AckAgent and click Next.

    The Properties dialog box opens. The configuration parameters for EDIX12AckAgent are displayed. The following table lists and describes the configuration parameters.

    Parameter

    Description

    Protocol

    Protocol on which to make acknowledgment copies. Select one of the following options from the drop-down list:

    • NONE
    • FILE

    Location

    Location for acknowledgment copies.

    End Tag

    The surrounding XML tag.

    Preemitter

    Determines whether the preemitter should be run on acknowledgment output.

    Error

    Determines whether to send an error.

    ISA Control Number

    Element location of ISA control number. Select one of the following locations from the drop-down list:

    • Input Document
    • _SReg(edi.ICN)

    GS Control Number

    Element location of GS control number. Select one of the following locations from the drop-down list:

    • Input Document
    • _SReg(edi.GCN)

    ST Control Number

    Element location of ST control number. Select one of the following locations from the drop-down list:

    • Input Document
    • _SReg(edi.MCN)

    Stream Acknowledgment

    Determines the level of acknowledgment information to return. Select one of the following acknowledgment levels from the drop-down list:

    • Group. Returns acknowledgment information at the Group level.
    • Interchange. Returns acknowledgment information at the Interchange level.
    • Transaction. Returns acknowledgment information at the Transaction level.

  28. Configure the available parameters according to your requirements.
  29. Click Finish.

    The new Service object (X12AckAgent) appears in the workspace.

  30. Select the Start object, right-click the X12AckAgent object, and select Create Relation from the context menu.

    The Line Configuration dialog box opens.

  31. From the Event drop-down list, select OnCompletion and click OK.

    A line appears between the objects to indicate that a relationship has been established.

  32. Drag and drop the File object from the Object palette to the workspace.

    The New File Object wizard opens.

  33. In the Name field, type Write_Ack, and a brief description (optional) in the Description field and click Next.

    The File Object Type wizard opens.

  34. From the Type drop-down list, select File Emit Agent {com.ibi.agents.XDFileEmitAgent} and then click Next.

    The Object properties wizard opens.

  35. In the Target Directory field, enter a valid physical folder location to write Acknowledgements data, for example, sreg(X12.Ack), as shown in the following image.

  36. In the File Pattern parameter, enter sreg(basename)_*.x12).
  37. For the Return parameter, select input from the drop-down list and click Finish.

    The new File object (Write_Ack) appears in the workspace.

  38. Select the X12AckAgent object, right-click the Write_Ack file object, and select Create Relation from the context menu.
  39. From the Event drop-down list, select OnSuccess and click Finish.

    A line appears between the objects to indicate that a relationship has been established, as shown in the following image.

  40. Drag and drop the End object from the Object palette to the workspace.

    The End Name and Description dialog box opens.

  41. In the Name field, type End_Ack, and a brief description (optional) in the Description field and click Next.

    The End Object Schema wizard opens.

  42. From the Terminate parameter, select the check box for Select if this end object is the completion point.
  43. Click Finish to accept the default values and close the dialog box.

    The new End_Ack object appears in the workspace.

  44. Select the Write_Ack object, right-click the End_Ack object, and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  45. From the Event drop-down list, select OnSuccess and click Finish.

    A line appears between the objects to indicate that a relationship has been established.

  46. Select the X12AckAgent object, right-click the End3 object (which is already linked with the X12_Validation_rpt and Write_Validation_rpt objects), and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  47. From the Event drop-down list, select OnCustom and select the following cases from the case parameter list:
    • OnError
    • OnFailure
  48. Click Finish.
  49. Select the Write_Ack object, right-click the End3 object (which is already linked with the X12_Validation_rpt and Write_Validation_rpt objects), and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  50. From the Event drop-down list, select OnCustom and select the cases from the case parameter list, as shown in the following image:

    A line appears between the objects to indicate that a relationship has been established.

  51. Drag and drop the Decision Switch object from the Objects palette to the workspace.

    The New Decision Switch Object wizard opens.

  52. In the Name field, type a relevant name (for example, Decision_switch), and a brief description (optional) in the Description field and click Next.
  53. Type the following expression in the Expression parameter:
    XPATH(count(//documents/ValidationReport/Report/Success))

    This will check if the validation report is successful or not. If the validation report returns a success node, then the incoming data will go to the Good File write. Otherwise, it will go with the error route to write the error file write.

  54. Click Next.
  55. Add new Switch Cases (1 and 0) by clicking on the Add (+) button shown in the Switch Cases wizard.

    You can delete default empty and null cases from the cases list.

    The following image shows the Switch Cases configuration wizard showing the two cases (1 and 0) in the switch cases list.

  56. Click Finish to complete creating the Switch Cases.

    The new Decision Switch case object appears in the workspace.

  57. Select the Write_Validation_rpt object, right-click the switch case (Decision Switch) object, and select Create Relation from the context menu.
  58. From the Event drop-down list, select OnSuccess and click Finish.

    A line appears between the objects in the workspace to indicate that a relationship has been established.

  59. Drag and drop the Service object from the Object palette into the workspace.
  60. In the Name field, type XDXMLExtract, and a brief description (optional) in the Description field and click Next.

    The Service Object Type wizard opens.

  61. In the Service Object Type dynamic search box, enter the following class name:
    com.ibi.agents.XDXMLExtract
  62. Select the XML Extract agent object and click Next, as shown in the following image.

  63. Provide the XPATH expression (for example, XPATH(//documents/output) to extract the node lists from the XML, and click Finish.

    Note: This is not the xpath function.

  64. Create a copy of XDXMLExtract and name it as XDXMLExtract1 for non-success validation reports (error route).
  65. Select Decision Switch, right-click on XDXMLExtract, and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  66. From the Event drop-down list, select OnCustom.
  67. In the Case of section in the Relation Configuration wizard, select case 1 and then click Finish.

    A line appears between the Decision Switch and XDXMLExtract objects to indicate that a relationship has been established.

  68. Select Decision Switch, right-click on XDXMLExtract1, and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  69. From the Event drop-down list, select OnCustom.
  70. In the Case of section in the Relation Configuration wizard, select the following cases:
    • OnError
    • OnSuccess
    • OnDefault
    • 0 (Zero)

    All cases except case 1 should have been selected.

  71. Click Finish.

    A new relation line appears between the Decision Switch and XDXMLExtract1 objects to indicate that a relationship has been established, as shown in the following image.

  72. Drag and drop the Service object from the Object palette into workspace.
  73. In the Name field, type XDDocUpdate, and a brief description (optional) in the Description field.
  74. Click Next.

    The Service Object Type wizard opens.

  75. In the dynamic search box, enter the class name (for example, com.ibi.agents.XDDocUpdateAgent), select any one of the Doc Update Agent options and then click Next, as shown in the following image.

  76. In the Object properties wizard, select Only Find/Replace from the drop-down list for the Processing Method parameter in the Object properties wizard, as shown in the following image.

  77. For the Search parameter, enter the following string with single quotes:
    '<output>','</output>'
  78. For the Replace parameter, enter the following string with double quotes:
    “‘”

  79. Click Finish to complete creating the Doc Update Agent.

    The XDDocUpdate object appears in the workspace.

  80. Create a copy of the XDDocUpdate agent and name it as XDDocUpdate1 for the non-success validation report (error route).
  81. Select XDXMLExtract, right-click the XDDocUpdate agent, and select Create Relation from the context menu.
  82. From the Event drop-down list, select OnSuccess and click Finish.
  83. Select the XDXMLExtract1 object, right-click on the XDDocUpdate1 object, and select Create Relation from the context menu.
  84. From the Event drop-down list, select OnSuccess and click Finish.

  85. Drag and drop the File object from the object palette to the workspace.

    The New File Object wizard opens.

  86. In the Name field, type Good File, and a brief description (optional) in the Description field, and then click Next.

    The File Object Type wizard opens.

  87. From the Type drop-down list, select File Emit Agent {com.ibi.agents.XDFileEmitAgent} and click Next.

    The Object properties wizard opens.

  88. For the target directory, enter a valid physical folder location to write Acknowledgements data, for example:
    sreg(X12.GoodOutput)

  89. In the File Pattern parameter, enter the following:
    sreg(basename)_*.xml
  90. In the Return parameter, select input from the drop-down list, and then click Finish.

    The new File object (Good File) appears in the workspace.

  91. Select the XDDocUpdate object, right-click the Good File object, select Create Relation from the context menu, and then click Next.
  92. From the Event drop-down list, select OnSuccess and then click Finish.

  93. Drag and drop the File object from the Object palette to the workspace.

    The New File Object wizard opens.

  94. In the Name field, type Bad File, then enter a brief description (optional) in the Description field and click Next.

    The File Object Type wizard opens.

  95. From the Type drop-down list, select File Emit Agent {com.ibi.agents.XDFileEmitAgent} and click Next.

    The Object Properties wizard opens.

  96. In the Target Directory field, enter a valid physical folder location to write Acknowledgements data. For example:
    sreg(Hipaa.BadOutput)
  97. In the File Pattern paremeter, enter the following:
    sreg(basename)_*.xml
  98. In the Return parameter, select input from the drop-down list and then click Finish, as shown in the following image.

    The new File object (Bad File) appears in the workspace.

  99. Select the XDDocUpdate1 object, right-click the Bad File object, and select Create Relation from the context menu.
  100. Click Next.
  101. From the Event drop-down list, select OnSuccess and then click Finish.

  102. Drag and drop the Junction object into workspace from the Objects palette.
  103. In the Name field, enter Junction (by default it will show Junction), and then click Finish.

    The Junction object appears in the workspace.

  104. Create a copy of the Junction object, name it as Junction1, and then click Finish.

    A copy of the Junction object (junction1) appears in the workspace.

  105. Select the Good File object, right-click the Junction object, and select Create Relation from the drop-down list.

    The Relation Configuration wizard opens.

  106. From the Event drop-down list, select OnSuccess and click Finish.

    A relation (line) appears between Good File and the Junction object.

  107. Select the Bad File object, right-click the Junction object, and select Create Relation from the context menu.

    The Relation Configuration wizard opens.

  108. From the Event drop-down list, select OnSuccess and click Finish.

    A line appears between the objects to indicate that a relationship has been established, as shown in the following image.

  109. Select the Good File object, right-click on the Junction1 object, and then select the Create Relation option from the context menu.

    The Relation Configuration wizard opens.

  110. From the Event drop-down list, select OnCustom and then select following cases from the case parameter list:
    • OnError
    • OnFailure
    • Fail_operation
    • Fail_parse
    • notfound

    A relation (line) appears between Good File and the Junction1 objects.

  111. Select the Bad File object, right-click on the Junction1 object, and then select the Create Relation option from the context menu.

    The Relation Configuration wizard opens.

  112. From the Event drop-down list, select OnCustom and then select following cases from the case parameter list:
    • OnError
    • OnFailure
    • Fail_operation
    • Fail_parse
    • notfound

    A relation (line) appears between Bad File and the Junction1 objects, as shown in the following image.

  113. Drag and drop the End object from the Object palette to the workspace.

    The End Name and Description properties wizard opens.

  114. In the Name field, type End, then enter a brief description (optional) in the Description field and click Next.

    The End Object Schema wizard opens.

  115. From the Terminate parameter, select the check box for Select if this end object is the completion point.
  116. Click Finish.

    The new End object appears in the workspace.

  117. Select the Junction object, right-click on the End object, and then select the Create Relation option from the context menu.
  118. From the Event drop-down list, select OnCompletion and then click Finish.

    A new Relation (line) appears between the Junction object and the End object, as shown in the following image.

  119. Drag and drop the End object from the Object palette to the workspace.

    The End Name and Description properties wizard opens.

  120. In the Name field, type End2, then enter a brief description (optional) in the Description field and click Next.

    The End Object Schema wizard opens.

  121. From the Terminate parameter, select the check box for Select if this end object is the completion point.
  122. Click Finish.

    The new End2 object appears in the workspace.

  123. Select the Junction1 object, right-click on the End2 object, and then select the Create Relation option from the context menu.
  124. From the Event drop-down list, select OnCompletion and then click Finish.

    A new Relation (line) appears between the Junction1 object and the End2 object, as shown in the following image.

    The process flow is now complete.

  125. To save the process flow, click the File menu and then select Save from the File menu options.

    Now you need to validate the process flow and publish it to the Registry of the iWay Service Manager Administration Console for use in the route of a channel for outbound processing.

    Validating a process flow ensures that its structure is correct. Publishing a process flow makes it available in the Registry for use in a channel configuration. For instructions on validating and publishing the process flow, see the iWay Integration Tools Designer User's Guide.

  126. Close iIT Designer.

    Your next step is to add a new route to the Registry using the iWay Service Manager Administration Console and associate the process flow with it.



x
Procedure: How to Define a Route and Associate the Process Flow With the Route

To define a route and associate the process flow with It:

  1. From the Registry menu options in the iWay Service Manager Administration Console, click Routes.
  2. On the Route Definitions pane, click Add to add a route.
  3. On the New Route Definition pane, enter a name for the route and an optional description, as shown in the following table.

    Parameter

    Value

    Name *

    EDItoXML_Route

    Description

    This route will invoke the X12 to XML validation process. The outcome of this process will place valid X12 transformed data in your valid inbound folder. Invalid X12 transformed data will be routed to its appropriate folder. A validation report will also be generated and sent to its appropriate folder.

  4. Click Finish.
  5. On the Construct Route pane, click Add.

    You are prompted for the type of component to associate with the route.

  6. Select Process and click Next.
  7. The next pane prompts you to select a process. Select the process flow you created earlier with iIT Designer, x12toXML_pflow_AckRpt, and click Finish.

    The route, with its associated process flow, has been successfully defined.


Top of page

x
Defining the Outlets

An outlet defines how a message leaves a channel. An emitter is a transport protocol that sends a document to its recipient. In the sample configuration, we will use a File emitter. For details on supported protocols, see the iWay Service Manager Protocol Guide.

For the channel in this example, you will add one emitter to the Registry. Then you will define one outlet and associate the emitter with this outlet.

When you associate the outlet with the channel in later steps, you will apply a condition to dynamically direct the flow of the output document based on its content.

In the example, you will add an emitter for the acknowledgement data. In the example, the data for the functional acknowledgement (transaction 997) is in EDI flat file (non-XML) format. When you add the acknowledgement outlet to the channel, you will set the condition _isFLAT(). This condition tests the output data for flat file (non-XML) format. If the data is in flat file (non-XML) format, it is routed to the specified destination.



x
Procedure: How to Add an Emitter for Acknowledgement Output
  1. On the Emitters pane, click Add to add another emitter. The next pane prompts you for the emitter type.
  2. For this example, select File from the drop-down list and click Next.

    The configuration parameters pane opens.

  3. Supply configuration parameters for the second File emitter as follows, then click Next.

    Parameter

    Value

    Destination *

    sreg(X12.Ack)/SREG(basename)*.txt

    This value is the directory where the acknowledgement output is placed. You can use an extension other than .txt, for example, .edi or .data.

    sreg(X12.Ack) is a special register value that uses a defined directory in which output files are stored after transformation.

    Make sure that you have created this directory; otherwise, errors will occur during deployment.

    On output, an asterisk (*) in the destination file name is replaced by a date and time stamp. For details on the special register (SREG) used in the preceding file name, see the iWay Service Manager User's Guide.

    Create Directory

    false

  4. On the Emitters pane, enter the name of the new emitter and an optional description, as shown in the following table. Then click Finish to add the emitter.

    Parameter

    Value

    Name *

    Ack_Out_Emitter

    Description

    Emitter for acknowledgement output for EDI.



x
Procedure: How to Define an Outlet for Acknowledgement Output
  1. From the Registry menu options, select Outlets.
  2. On the Outlet Definitions pane, click Add to add an outlet.
  3. On the New Outlet Definition pane, enter the name of the new outlet and an optional description, as shown in the following table. Then click Finish to add the outlet.

    Parameter

    Value

    Name *

    EDI_Ack_Outlet

    Description

    Acknowledgement outlet for EDI.

  4. On the Construct Outlet pane, click Add to associate the acknowledgement emitter with the acknowledgement outlet. The next pane prompts you for the component type.
  5. Select Emitter and click Next.

    The next pane prompts you to select an emitter.

  6. Select Ack_Out_Emitter, which is the acknowledgement emitter you added earlier, and click Finish.

    Now you have defined the two outlets.


Top of page

x
Defining a Channel

Now that you have defined the inlet, route, and outlets for the channel, you are ready to add the channel to the Registry and associate the conduits with it.



x
Procedure: How to Define a Channel
  1. From the Registry menu options, select Channels under Conduits.
  2. On the Channel Definitions pane, click Add to add a channel.
  3. On the New Channel Definition pane, enter the name of the new channel and an optional description, as shown in the following table. Then click Finish to add the channel.

    Parameter

    Value

    Name *

    EDItoXML_Channel

    Description

    Channel for EDI to XML inbound processing.

  4. On the Construct Channel pane, click Add to associate the inlet, route, and outlets defined previously with the channel.

    You are prompted to associate components with the channel.

  5. Select Inlet and click Next. The next pane prompts you to select an inlet.
  6. Select EDItoXML_Inlet, which is the inlet you defined earlier, and click Finish.

    The inlet is added to the channel. Now you need to associate the route defined earlier with the channel.

  7. On the Construct Channel pane, click Add.

    The next pane prompts you for the component type.

  8. Select Route and click Next.

    On the next pane, you are prompted to select a route.

  9. Select EDItoXML_Route, which is the route created earlier, and click Finish.
  10. On the Construct Channel pane, click the minus sign (-) under Conditions next to the name of the route to set it as the default.

  11. On the Construct Channel pane, click Add to add the outlets.
  12. On the next pane, select Outlet and click Next.
  13. Select the outlet defined earlier, EDI_Ack_Outlet and click Finish.
  14. To set a condition for the EDI_Ack_Outlet, on the Construct Channel pane, click the plus sign (+) under Conditions for the EDI_Ack_Outlet.

    The Set Condition pane opens.

  15. In the Condition input field, enter _isFLAT(), and click Update.

    This condition tests the output data for EDI flat file (non-XML) format. If the data is in EDI flat file (non-XML) format, it is routed to the destination specified when you added the emitter for acknowledgement output.



x
Procedure: How to Add a Special Register Set to the Channel
  1. From the Registry menu options, select Channels.

    The Channel Definitions pane opens.

  2. Click the link in the Regs column for EDItoXML_Channel.
  3. On the next pane, which prompts you to add special register (SREG) sets, click Add to add the SREG set to the channel.
  4. On the next pane, select X12, which is the name of the SREG set you created previously, and click Finish.


x
Procedure: How to Add the Ebix to the Channel
  1. From the Registry menu options, select Channels.

    The Channel Definitions pane opens.

  2. Click the link in the Ebix column for the EDItoXML_Channel.
  3. On the next pane, which prompts you to add Ebix components, click Add to add the Ebix to the channel.
  4. On the next pane, select EDI_4050, which is the name of the Ebix you added previously, and click Finish.

    Now that you have associated all the components with the channel, you are ready to build it.



x
Procedure: How to Build the Channel
  1. From the Registry menu options on the left pane, select Channels under Conduits.
  2. On the Channel Definitions pane, select the channel defined previously, EDItoXML_Channel, and click Build.

    The results of the build are displayed on the right pane.

  3. Review the results of your build and then click Back.

    If an error or errors are displayed in the Message column, take the appropriate action as instructed.



x
Procedure: How to Deploy the Channel

Deployment is the mechanism by which a channel moves from being stored in the Registry to becoming active in iWay Service Manager. For more information on deployment, see the iWay Service Manager User's Guide.

  1. Select the Deployments option in the green shaded area below the iWay Service Manager banner.
  2. On the Channel Management pane, click Deploy.
  3. On the Available Channels pane, select the channel you defined previously, EDItoXML_Channel, and click Deploy.

    The Channel Management pane reopens.

  4. Select EDItoXML_Channel and click Start.

    The red X under Status changes to a green check mark to indicate that the channel has been started. If an error or errors are displayed, take the appropriate action as instructed.



x
Procedure: How to Verify the Channel

To ensure that the channel is working as expected, perform the following steps.

For more information on obtaining EDI X12 sample files for testing purposes, see Extracting SWIFT User Samples.

  1. Place an EDI document as test data in the C:\File_in directory. This is the path in which EDI messages are received, which you specified for the listener associated with the inlet for the channel.
  2. Check for the XML file and the functional acknowledgement in the C:\File_out\EDI directory. This is the destination path you specified for the emitters associated with the outlets for the channel. The listener will detect the presence of the file in the input directory, and the copy service will copy it to the output directory, replacing the asterisk in the file name with a time stamp.

    For example, if you specified the destination file name for the XML emitter as _SREG(basename)_*.xml per the configuration example, an EDI input file named X12856C001_4050.x12 is named _X12856C001_4050_2008-03-03T19_33_26.684Z.xml on output.


Top of page

x
Reusing Your Channel Configuration

Using the Archive Manager feature of iWay Service Manager, you can archive your channel configuration with its associated components and import them into another Registry. They will then be available from that Registry for modification or reuse.

For details on this feature, see the iWay Service Manager User's Guide.


iWay Software