About Transformers

Mirth® Connect by NextGen Healthcare User Guide

Transformer

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. For additional information, see About Transformers. All transformers have an inbound data type and an outbound data type used to determine how data is parsed and converted. For additional information on data types, see About Data Types Parent topic: Connector Components

Mirth® Connect by NextGen Healthcare User Guide

About Filters

The filter is the piece of a connector that decides whether a message should proceed to the next step or not. It is configured on the Edit Filter View within either the Source Tab or Destinations Tab within the Edit Channel View. A filter returns true or false. When the filter returns true, the message is said to have been accepted. When the filter returns false, the message is said to have been filtered. If the source connector filters out a message, it will not flow through the source transformer, and will not be processed by any of the destination connectors. If a destination connector filters out a message, it will not flow through the destination transformer, and will not be dispatched outbound by that destination connector. However other destinations may still process the message. A filter is comprised of multiple rules. Each rule is joined together with an operator, which can be AND or OR. For example a filter may look like this: Accept the message if: Rule 1 returns true OR Rul

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

Edit Views

This section is separated into the following topics: Edit Channel View Edit Filter / Transformer Views Edit Global Scripts View Edit Code Templates View Edit Alert View Edit Channel View Edit Filter / Transformer Views You can use the Edit Filter view or the Transformer view to configure filter rules and transformer steps. Edit Global Scripts View The Edit Global Scripts view provides global scripts across all channels. Edit Code Templates View This view is where code templates and libraries are configured for your Mirth® Connect server. Edit Alert View Use the Edit Alert view to configure and modfiy alerts. Parent topic: Mirth Connect Administrator

Mirth® Connect by NextGen Healthcare User Guide

About Data Types

A data type tells a filter / transformer how to parse a certain format. The inbound data type serializes the incoming raw data into its internal representation. Then the filter / transformer executes, possibly modifying this internal representation, or even completely overwriting it with a different internal representation. Finally, the outbound data type takes this transformed data and deserializes it into the proper outbound format (the encoded data) . For example, the HL7 v2.x data type serializes ER7 data from this: into this: In this case, the internal representation is XML, because, for HL7 v2.x, the message object you use or manipulate in a filter / transformer is an E4X XML object. However not all data types use XML for their internal representation. The JSON data type uses JSON as you might expect, and the object you use in a filter / transformer is a regular JavaScript Object. The Raw data type does no serialization or deserialization, so its internal representation is identi

Mirth® Connect by NextGen Healthcare User Guide

The "tmp" Object

This is similar to msg, except that it is the internal representation of the outbound template configured in your transformer settings. It will only be available in the transformer when you have an outbound template configured. The tmp variable is used when you want to convert a message from one format to a completely different format (e.g. HL7 v2.x to JSON). Or, it can be used to selectively include pieces of the incoming message and map them into the outbound message. Parent topic: About Transformers

About Transformers

Recommendations

Transformer

About Filters

Navigation

Edit Views

About Data Types

The "tmp" Object

About Transformers

Transformer

About Filters

Navigation

Edit Views

About Data Types

The "tmp" Object