Tutorial: We Love Deep Auto-Completion

This post was originally written for Iguana 5 so it contains version 5 screenshots, and may contain out of date references.

This tutorial shows you how to use auto-completion.

We will show you three ways to find the race field in an HL7 node tree.

  1. Using the field data “EU”.
  2. Using the field name “race”.
  3. Drilling down through the fields.

We chose to place the code we used in a Filter component, but auto-completion works for all code in any component.

Create the Channel [top]

  1. Create a Channel with the the following settings:
    • Source = LLP Listener
    • Destination = LLP Client
    • Channel name = We Love Deep Auto-Completion
  2. Activate the Filter Component: Click the Filter tab and check Use Filter.
  3. Click the Add Channel button to create the channel.
    Ignore the red warning messages, see resolving the commit configuration error.
  4. Open the Translator by clicking the Edit Script link at the bottom of the Filter tab.
  5. Download and import the Auto-Completion_Filter.zip project file.
    This file contains a skeleton project and six sample HL7 messages.
  6. Iguana will load the project and data into the Translator, your screen should look like this:

Tutorial Instructions [top]

Auto-Completion using field data: “EU”

The fastest way to find fields within a node tree is by using the field values from your sample data.

  1. Inspect the data to find the value of the race field.
    Click on the Data parameter (red text) and the ADT message icon:Screen Shot 2014-10-01 at 14.59.46
    Identify the value for the race field in the HL7 message text or in the node tree:
  2. Add a trace() statement:
  3. Type “ms” within the brackets, and click on the Msg variable:
  4. Type “.eu” and click on the race>identifier field:
  5. This is the result:
  6. Time = 20 seconds (15 seconds if you don’t need to lookup the value “eu”)

Auto-Completion using the field name: “race”

Using the field names is also very quick.

  1. Add a trace() statement:
    Screen Shot 2014-10-01 at 15.41.13
  2. Type “ms” within the brackets, and click on the Msg variable:
    Screen Shot 2014-10-01 at 15.43.07
  3. Type “.ra” and click on the race field:
    Screen Shot 2014-10-01 at 15.45.59
  4. Type “.” and click on the Identifier field:
  5. The result is the same as using the the field data “eu”:
  6. Time = 25 seconds

Auto-Completion by drilling down through the fields

Drilling down through the hierarchy is useful when you don’t know the data and field names.

  1. Add a trace() statement:
  2. Type “ms” within the brackets, and click on the Msg variable:
    Screen Shot 2014-10-01 at 15.57.08
  3. Click on the PID segment:
    Screen Shot 2014-10-01 at 15.59.23
  4. Click on the Race field:
    Screen Shot 2014-10-01 at 15.59.44
  5. Click on Repeat 1:
    Screen Shot 2014-10-01 at 16.00.00
  6. Click on Identifier:
    Screen Shot 2014-10-01 at 16.00.13
  7. The result is identical to the other methods:
    Screen Shot 2014-10-01 at 16.00.30
  8. Time = 25 seconds

More Information [top]

Leave A Comment?