Configuring a Channel for Inbound Processing

How to:

The inbound channel creates an XML representation of a HL7 inbound message, and an acknowledgement message. The documents are routed to designated folders based on the success or failure results of the transformation and HL7 rule validation.


Top of page

x
Procedure: How to Create a Channel for Inbound Processing
  1. Start iWay Integration Tools (iIT).
  2. Right-click the Integration Explorer pane, click New, and then select Integration Project from the context menu, as shown in the following image.

    The New Integration Project dialog box opens, as shown in the following image.

  3. Enter a name for the Integration Project (for example, EDIHL7_usr_sample_proj) in the Project name field, and then click Finish.

    A new Integration Project node called EDIHL7_usr_sample_proj is added to the Integration Explorer.

  4. Expand the EDIHL7_usr_sample_proj Integration Project node, right-click the Channels folder, select New, and then click Channel from the context menu, as shown in the following image.

  5. Enter a name for the Channel (for example, EDIHL7_IB_QS_pFlow_Channel), and then click Next, as shown in the following image.

    The Inbound/Outbound Protocols pane appears.

  6. Click the Add button to add a File Listener in the Inbound section, as shown in the following image.

  7. From the Types Filter list, select File and then click Finish, as shown in the following image.

  8. Select the Have an Inlet created for each inbound protocol check box to create an Inlet for the channel, as shown in the following image.

  9. Click the Add button in the Outbound section to define an emitter.

    The Define emitter type pane appears.

  10. In the Types filter list, select Passthrough to define the passthrough emitter, and then click Finish, as shown in the following image.

    Note: Passthrough does not emit data from the listener. Instead, it just passes the control here and does nothing.

  11. Select the Have an outlet created for each outbound protocol check box to create an outlet for the channel, and then click Finish, as shown in the following image.

    The Channel Builder pane appears, as shown in the following image.

  12. Under inlet: inlet.1, click listener: listener.1 (File) and then expand the Main (Missing 2 required fields) configuration parameter on the right pane, as shown in the following image.

  13. Enter a valid Input Path, Destination, and Removal Destination (optional) path, then change the Suffix In Filter parameter from xml to * to receive all types of input files (for example, hl7 and txt), and then set the Suffix Out parameter value to xml, as shown in the following image.

  14. Click the Save icon near the File menu to save your edited listener configuration. You can also press the shortcut key (Ctrl+S) to save your work if you are using a Windows environment.

  15. Import the EDIHL7toXML_pflow_QS_AckAgent_ValidRpt process flow from the local drive or create one in the EDIHL7_usr_sample_proj directory in the Flows folder.
  16. Under the route: route.1(default) node, select process: process.1 and click the process icon on the right panel to reference the process flow into your channel, as shown in the following image.

  17. Select a process flow from the integration project and then click OK.

    Note: Process flows should already be built and available in the iIT integration project. They can be found in the EDIHL7_usr_sample_proj directory inside the Flows folder.

    For more information, see Process Flow Used for Inbound Processing: HL7 to XML.

    Your screen should resemble the following image.

  18. Click the Save icon near the File menu to save your edited listener configuration. You can also press the shortcut key (Ctrl+S) to save your work if you are using a Windows environment.

  19. Right-click inlet: inlet.1, select Add Channel Component, and then click Preparser from the sub context menu, as shown in the following image.

  20. Click the change type link provided in the preparser.1 configuration section, as shown in the following image.

  21. From the Types filter list of the Define preparser type pane, select EDIHL7BatchSplitter and click Finish, as shown in the following image.

  22. Repeat steps 20 and 21 and choose the EDIHL7PreParser preparser type when you are in step 21, as shown in the following image.

  23. Click Finish.

    Your screen should resemble the following image.


Top of page

x
Reference: Process Flow Used for Inbound Processing: HL7 to XML

This section provides an overview of the process flow used for inbound processing: HL7 to XML. This process flow (EDIHL7toXML_pflow_QS_AckAgent_ValidRpt) is already built and available in the iIT integration project. It is located under the EDIHL7_usr_sample_proj node inside the Flows subfolder.

The following image shows the entire inbound process flow, including all of the nodes that are used and their connections.

In this process flow, an HL7 formatted document is read from a validation report file. The XML tags are stripped and the document is written to a directory.

Note: Using a Catch service (com.ibi.agents.XDCatchAgent) in an EDI flow is not supported. The error handling does not work as a result.


Top of page

x
Procedure: How to Update Basic Details for Channel Components
  1. Select the channel component inlet:inlet.1 from the channel and click the update channel component icon on the top right side panel, as shown in the following image.

  2. Rename or update the inlet details (for example, XMLEDIHL7_IB_QS_pFlow_Ebix_Inlet), and click OK, as shown in the following image.

    After renaming or changing the channel components, your iIT Channel Builder should resemble the following image.


iWay Software