Transformer

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

Mirth® Connect by NextGen Healthcare User Guide

Filter

A 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. See About Filters for additional information. 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

Destination Connectors

Every channel has at least one destination connector that sends data out to an external system. Destination connectors are configured on the Destinations Tab within the Edit Channel View. In addition to the standard Connector Components, destination connectors include: An Enabled flag that determines whether the destination is currently being used. A channel must have at least one destination enabled at any given time. A Wait for previous destination setting that determines what chain a destination connector belongs to. (For additional information, see Destination Chains. ) A Response Transformer. This is like a regular transformer, except it has its own response inbound data type and response outbound data type, and does the job of modifying the response that an external system returned to a destination connector. It also allows you to decide when to queue / force-error a message. See Response Transformers for additional information. Parent topic: Channel 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

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

Transformer

Recommendations

About Transformers

Filter

About Filters

Destination Connectors

Navigation

Response Transformers

Transformer

About Transformers

Filter

About Filters

Destination Connectors

Navigation

Response Transformers