Message Builder Transformer Step

Item Name	Description
Message Segment	The field/location in the inbound or outbound message to place the value into.
Mapping	The value to place into the given message segment. This may be a field from the message, or any JavaScript expression.
Default Value	If the Mapping is not found or evaluates to an empty string, this value / expression is used instead.
String Replacement	This table allows you to perform replacements on the value before it gets inserted. Regular Expression: A Java-style regular expression to test against the value. This will implicitly set the global regex flag. Replace With: The value to replace any matched regions with.

Mirth® Connect by NextGen Healthcare User Guide

Mapper Transformer Step

This step extracts data from a field in the message (or an expression) and places it into one of the available Variable Maps. Depending on the scope of the map, this variable will be available in subsequent steps, in the destination connector properties, or even in subsequent connectors. Item Name Description Variable The variable name / key to use when inserting into the map. The Add to drop-down menu to the right determines which map to place the variable in. For additional information, see Variable Maps. Mapping The value to place into the map. This may be a field from the message, or any JavaScript expression. Default Value If the Mapping is not found or evaluates to an empty string, this value / expression will be used instead. String Replacement This table allows you to perform replacements on the value before it gets inserted into the map. Regular Expression: A Java-style regular expression to test against the value. This will implicitly set the global regex flag. Replace With:

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

Destination Set Filter Transformer Step

Destination Set Filtering is a powerful feature of the source transformer that allows you to decide in advance which destinations to exclude from message processing. Using each individual destination's filter to control where a message goes is still a valid workflow, but when you have many destinations all with mutually exclusive filters, the performance of the channel can be affected because message data will be stored to the database for each destination connector. Also filtered connector messages can clutter up the message browser, making it harder to find what you are looking for. The advantage to using Destination Set Filtering in this case is that filtered destinations will not have any message data stored, and will not show up in the message browser. This can greatly increase message throughput. Destination Set Filtering can be done manually with JavaScript (look at DestinationSet in the User API) . However this step allows easier access to the feature without having to write an

Mirth® Connect by NextGen Healthcare User Guide

Edit Filter / Transformer Views

This is where filter rules and transformer steps are configured. Although Edit Filter and Edit Transformer are different views, they are very similar and so are combined into this section. Also, the filter and transformer are actually executed together as a single script for each connector. Image of the Transformer view where rules and transformer steps are configured. Navigation Message Templates Tab The Message Templates tab enables you to edit the inbound and outbound message templates for your filter or transformer. Message Trees Tab The Message Trees tab enables you to view a tree representation of your inbound/outbound message templates set in the Message Templates tab. Reference Tab The Reference tab provides helpful variables and templates you can use within your filter rules and transformer steps. Create New Rules/Steps Rule/Step Table Filter Rule Properties Transformer Step Properties Response Transformers Working With Iterators View Generated Script Filter Tasks Transformer

Mirth® Connect by NextGen Healthcare User Guide

Create a Message Builder Step

When editing a transformer, you can create a Message Builder Transformer Step directly from the message tree. Method 1: Right-click the node you want to modify, then select Map to Message. A dialog may be shown asking whether you want to add the step as part of an Iterator. For additional information, see Working With Iterators. A Message Builder is automatically added to the table with the selected node populated appropriately. Method 2 Drag the node you wish to map from the inbound message tree, and drop it into the node you wish to map to in the outbound message tree. The same steps follow as in Method 1. Parent topic: Message Trees Tab

Mirth® Connect by NextGen Healthcare User Guide

About Transformers

A transformer is the piece of a connector that modifies a message, converts a message from one format to another, and extracts pieces of the message for later use. It is configured on the Edit Transformer View within either the Source Tab or Destinations Tab within the Edit Channel View. A transformer has an inbound data type, and an outbound data type. These may be the same (e.g. HL7 v2.x to HL7 v2.x), or they could be different (e.g. HL7 v2.x to JSON). For additional information on data types, see About Data Types. A transformer is also comprised of multiple steps. Each transformer step modifies the message, extracts a piece of the message, or performs some other general task. The "msg" Object The "tmp" Object Response Transformers Transformer Step Types Parent topic: The Fundamentals of Mirth Connect

Message Builder Transformer Step

Recommendations

Mapper Transformer Step

Iterator Transformer Step

Destination Set Filter Transformer Step

Edit Filter / Transformer Views

Create a Message Builder Step

About Transformers