Filter Tasks

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 information, see Import Filter
	Export Filter	Exports the current filter (all rules) to an XML file.
	Validate Filter	Validates the entire filter and all rules. This includes property validation and script syntax validation.
	Validate Rule	Validates the currently selected rule. This includes property validation and script syntax validation.
	Move Rule Up	Moves the currently selected rule one slot higher in the table. If the rule is inside of an Iterator and is currently the first rule in the Iterator's children, this task will move the rule up and out of the Iterator, similar to the Remove From Iterator task. For additional information, see Working With Iterators.
	Move Rule Down	Moves the currently selected rule one slot lower in the table. If the rule is inside of an Iterator and is currently the last rule in the Iterator's children, this task will move the rule down and out of the Iterator, similar to the Remove From Iterator task. For additional information, see Working With Iterators.

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

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

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

Create a Rule Builder Rule or Mapper Step

When editing a filter, you can create a Rule Builder Filter Rule directly from the message tree. When editing a transformer, you can create a Mapper Transformer Step in the same way. Method 1 Right-click the node you wish to filter on or map, then select either Filter by Value or Map to Variable: A dialog may be shown asking whether you want to add the rule/step as part of an Iterator. For additional information, see Working With Iterators A Rule Builder or Mapper is automatically added to the table with the selected node populated appropriately. Method 2 Drag the node you wish to filter on or map from the tree into the table. The same steps follow as in Method 1. Parent topic: Message Trees Tab

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

Filter Tasks

Recommendations

Transformer Tasks

Rule/Step Table

Iterator Transformer Step

Iterator Filter Rule

Create a Rule Builder Rule or Mapper Step

Working With Iterators

Filter Tasks

Transformer Tasks

Rule/Step Table

Iterator Transformer Step

Iterator Filter Rule

Create a Rule Builder Rule or Mapper Step

Working With Iterators