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

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

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

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

Mirth® Connect by NextGen Healthcare User Guide

Edit Channel View

The Edit Channel view is where channels are configured. General settings and other properties not specific to a connector are configured on the Summary Tab. Connector-specific settings are configured on the Source and Destinations tabs. Channel-level scripts not specific to connectors are configured on the Scripts Tab. Navigation Summary Tab The Summary tab is where general settings not specifically tied to connectors are configured. Source Tab The Source tab is where the source connector is configured. This includes the source connector properties, and the source filter / transformer scripts. Destinations Tab You can configure destination connectors on the Destinations tab. Scripts Tab You can configure channel-level scripts using the Scripts tab. Edit Channel Tasks Parent topic: Edit Views

Transformer

Recommendations

About Transformers

Filter

Navigation

Destination Connectors

Response Transformers

Edit Channel View

Transformer

About Transformers

Filter

Navigation

Destination Connectors

Response Transformers

Edit Channel View