Creating Iterators From Drag-and-Drop

Mirth® Connect by NextGen Healthcare User Guide

Iterator Filter Rule

This is a special type of rule that allows you to decide whether to filter a message or not by iterating through an array or list of XML nodes. The child rules underneath the Iterator determine the accept/filter behavior of the overall rule. For additional information, see Working With Iterators. Item Name Description Iterate On The element to iterate on. This may be a list of E4X XML nodes, or a Java / JavaScript array. Index Variable The index variable to use for each iteration. Accept Message If Determines how to logically combine each iteration into the overall accept / filter behavior. At Least One: If the logical combination of the child rules returns true for at least one of the iterations, the overall Iterator behavior will be to accept the message. All: If the logical combination of the child rules returns true for all of the iterations, the overall Iterator behavior will be to accept the message. Break Early If this is enabled, the iterator loop will terminate as quickly as p

Mirth® Connect by NextGen Healthcare User Guide

Create New Rules/Steps

As outlined in the Message Trees Tab section, new rules / steps can be generated easily from the inbound/outbound message trees. They can also be created manually. Select the Add New Rule/Step task to the left: A new rule/step is created and added to the table. To change the type of rule/step, double-click the cell in the Type column. To change the name, double-click the cell in the Name column. Some rule/step types have names auto-generated from the properties and so do not allow editing in the table. If you are creating a filter rule, you can change the operator of the rule by selecting the AND or OR button next to the name. Parent topic: Edit Filter / Transformer Views

Mirth® Connect by NextGen Healthcare User Guide

Iterator Transformer Step

This is a special type of step that allows you to perform extract / transform operations while iterating through an array or list of XML nodes. For additional information, see Working With Iterators . Item Name Description Iterate On The element to iterate on. This may be a list of E4X XML nodes, or a Java / JavaScript array. Index Variable The index variable to use for each iteration. Drag-and-Drop Substitutions When drag-and-dropping values into the children underneath this Iterator, the index variable (e.g. "[i]") will be injected after any of these prefixes. For example if your index variable is i and you have msg['PID'] in the Drag-and-Drop Substitutions table, when you drag the value msg['PID']['PID.3']['PID.3.1'].toString() from the Message Trees Tab into a child step, it will automatically be replaced with msg['PID'][i]['PID.3']['PID.3.1'].toString(). Parent topic: Transformer Step Properties

Mirth® Connect by NextGen Healthcare User Guide

The Assign To Iterator Task

This task takes the currently selected rule/step, and either moves it to an existing Iterator, or creates an entirely new Iterator and puts the rule/step within it. When selecting the task, a dialog appears. The Choose Existing Iterator option allows you to take the currently selected rule/step and move it underneath a specific pre-existing Iterator. If your rule/step already belongs to an Iterator, by default this option is selected and the current parent is selected in the drop-down menu. The Create New Iterator option is the same dialog shown before, where you have the option of choosing what to iterate on. Note that in this case, the variable j was automatically chosen, because the wizard detected that the currently selected step is part of a parent Iterator that is already using the i index variable. We can then choose to iterate through each OBR.16 field instead of on each OBR segment:. After selecting OK, the step will now be placed inside a new nested Iterator. You can see from

Mirth® Connect by NextGen Healthcare User Guide

Navigation

Select the Channels link in the Mirth® Connect task pane at the top-left to enter the Channels View: In the Channel Table, select the channel you wish to edit, and select the Edit Channel task to the left: You can also double-click the channel row in the table. Once in the Edit Channel View, select either the Source Tab or Destinations Tab. Select a destination if necessary. Then, select on the Edit Filter, Edit Transformer, or Edit Response tasks to the left. The Edit Response task (for editing the response transformer) is only visible for destination connectors. This section is separated into the following topics: Message Templates Tab Message Trees Tab Reference Tab Create New Rules/Steps Rule/Step Table Filter Rule Properties Transformer Step Properties Response Transformers Working With Iterators View Generated Script Filter Tasks Transformer Tasks Parent topic: Edit Filter / Transformer Views

Mirth® Connect by NextGen Healthcare User Guide

Remove From Iterators

If you decide later that a rule or step should not be part of an Iterator, it is easy to undo those changes. Select the rule or step, then select the Remove From Iterator task. The rule/step is moved one level higher in the tree. So if the rule/step is currently nested under multiple Iterators, select the task multiple times until it is at the depth you want. Parent topic: Working With Iterators

Creating Iterators From Drag-and-Drop

Recommendations

Iterator Filter Rule

Create New Rules/Steps

Iterator Transformer Step

The Assign To Iterator Task

Navigation

Remove From Iterators

Iterator Filter Rule

Create New Rules/Steps

Iterator Transformer Step

The Assign To Iterator Task

Navigation

Remove From Iterators