The Assign To Iterator Task

Mirth® Connect by NextGen Healthcare User Guide

Creating Iterators From Drag-and-Drop

As explained in the Message Trees Tab section, new rules and steps can be created by right-clicking the node in the message tree, by dragging a node into the filter/transformer table, or by dragging a node from the inbound tree and dropping it onto a node in the outbound tree. In all of these cases, you will be presented with a prompt asking whether you want to create an Iterator automatically. If Yes is chosen, the Iterator Wizard dialog is shown. In this wizard dialog you can select your iteration target (what to iterate on). If you have dragged from inbound to the outbound template, you will also have the option to select which part of the outbound (tmp) expression corresponds to the inbound (msg) target being iterated on. These options correspond directly to the drag-and-drop substitutions shown at the bottom of the dialog. You are essentially telling the wizard "where the i goes" Once you select OK, the Iterator and subsequent rule/step will be created. So far it is only iterating

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

Mirth® Connect by NextGen Healthcare User Guide

Working With Iterators

An Iterator is a special type of step that allows you to loop (iterate) through an array or list of XML nodes. For each array element or XML node (each "iteration"), you can execute multiple filter rules or transformer steps (the "children"). For example, let us say you are mapping inbound HL7 v2.x messages to an outbound HL7 v2.x template, and you want to copy OBR.16 .1 (ordering provider) component to a the PV1.9.1 (consulting doctor) component in the outbound template. Typically you would do this with a Message Builder Transformer Step: This works so far when there is only one OBR segment and one OBR.16 field. But what if you want to handle multiple segments or repeating fields? This is where Iterators come into play. Creating Iterators From Drag-and-Drop The Assign To Iterator Task Remove From Iterators Parent topic: Edit Filter / Transformer Views

Mirth® Connect by NextGen Healthcare User Guide

Rule/Step Table

The table in the top half of the Edit Filter / Transformer Views shows all the rules/steps you currently have configured. If you have Iterators, the elements are organized into a tree-table with the children underneath each Iterator. Column Description Enabled Determines whether the rule/step is currently enabled. When disabled, rules/steps are not executed at all, and act as if they were never there in the first place. For filters, this could change behavior as it follows the AND/OR order of operations. When all rules in a filter are disabled, the filter acts as if no rules exist, and is not executed at all. # This is the sequence number of the rule / step, starting at 0 for the first one. For child elements underneath an Iterator, this will be multiple numbers separated by a dash, to indicate the child index of each depth level. Name This is the name of the rule / step. If the type of rule / step allows user editing, you can double-click the cell to edit the name. For filter rules, y

Mirth® Connect by NextGen Healthcare User Guide

Filter Tasks

The following context-specific tasks are available throughout the Edit Filter View: Task Icon Task Name Description Add New Rule Adds a new filter rule to the table. If an Iterator rule or any rule that is a child of an Iterator is currently selected, the new rule is placed at the end of the children of the most immediate parent Iterator. Otherwise, the new rule is placed at the very end of the list at the bottom of the table. Delete Rule Removes the currently selected rule from the table. If an Iterator rule is deleted, all of its children are also deleted. Assign To Iterator Adds the selected rule to a new or existing Iterator. For additional information, see Working With Iterators. Remove From Iterator Removes the selected rule from its current Iterator. For additional information, see Working With Iterators. Import Filter Imports a filter from an XML file. You can choose to completely replace the current filter or simply append the rules to the current table. For additional informa

Mirth® Connect by NextGen Healthcare User Guide

Transformer Tasks

The following context-specific tasks are available throughout the Edit Transformer View: Task Icon Task Name Description Add New Step Adds a new transformer step to the table. If an Iterator step or any step that is a child of an Iterator is currently selected, the new step is placed at the end of the children of the most immediate parent Iterator. Otherwise, the new step will be placed at the very end of the list at the bottom of the table. Delete Step Removes the currently selected step from the table. If an Iterator step is deleted, all of its children are also deleted. Assign To Iterator Adds the selected step to a new or existing Iterator. For additional information, see Working With Iterators. Remove From Iterator Removes the selected step from its current Iterator. For additional information: Working With Iterators Import Transformer Imports a transformer from an XML file. You can choose to completely replace the current transformer, or simply append the steps to the current tab

The Assign To Iterator Task

Recommendations

Creating Iterators From Drag-and-Drop

Remove From Iterators

Working With Iterators

Rule/Step Table

Filter Tasks

Transformer Tasks

Creating Iterators From Drag-and-Drop

Remove From Iterators

Working With Iterators

Rule/Step Table

Filter Tasks

Transformer Tasks