Create New Rules/Steps

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

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

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

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

Message Trees Tab

The Message Trees tab is located on the right side of the Edit Filter/Transformer views and enable you to view a tree representation of your inbound/outbound message templates set in the Message Templates tab. Note: The Outbound template tree is only visible for transformers and response transformers. When you edit a connector's filter, you will only see the Inbound template tree. Filter By Node Name/Description Create a Rule Builder Rule or Mapper Step Create a Message Builder Step Drag-and-Drop Field Values Parent topic: Edit Filter / Transformer Views Related concepts Edit Filter / Transformer Views

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

Create New Rules/Steps

Recommendations

Creating Iterators From Drag-and-Drop

Navigation

Iterator Transformer Step

Iterator Filter Rule

Message Trees Tab

Transformer Tasks

Creating Iterators From Drag-and-Drop

Navigation

Iterator Transformer Step

Iterator Filter Rule

Message Trees Tab

Transformer Tasks