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

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

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

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

Mirth® Connect by NextGen Healthcare User Guide

Edit Data Types

You can edit the properties for the destination transformer's inbound data type. A filter only has access to the inbound data type, while a transformer has access to both inbound and outbound data types. Additionally, when editing the destination transformer the inbound data type may not be changed, since it must remain the same as the source connector's outbound data type. However, you can still edit the properties for the destination transformer's inbound data type. An image of the Message Templates tab editing the inbound data type. When selecting the Properties button, a dialog opens allowing you to edit the various inbound or outbound properties for the data type. This is a subset of the view shown in the Set Data Types Window. For additional information, see About Data Types and Data Types. Parent topic: Message Templates Tab

Mirth® Connect by NextGen Healthcare User Guide

Response Transformers

The response transformer is a special type of transformer only editable for destination connectors on the Destinations Tab. It works the same as a regular transformer, except that the data being transformed is not the message flowing through the channel, but instead the response payload that the destination connector received from the external system (if applicable). For additional information about transformers, see About Transformers. A destination response is comprised not only of the response data, but also the status (e.g. SENT, ERROR), status message, and error message. Response transformers can be used to modify these latter pieces as well. For example if a message gets set to ERROR by the destination connector, in the response transformer you can choose to override that and set the status to SENT instead based on some custom logic. Note: Response transformers will only execute if there is an actual response payload to transform. For example if you are using an HTTP Sender desti

About Transformers

Recommendations

Transformer

Navigation

About Filters

The "tmp" Object

Edit Data Types

Response Transformers

About Transformers

Transformer

Navigation

About Filters

The "tmp" Object

Edit Data Types

Response Transformers