Response Transformers

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

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 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

Channel Map

This map is isolated to the current message as it processes through a channel. If you store a connector map variable in the source connector, you will have access to that value in all subsequent destinations. However when the current message finishes and the next one begins, that next message will not have access to the value you stored for the previous message. The channel map is useful for anything that needs to be shared among multiple destinations, or the source connector and all destinations. For example, you might have one HTTP Sender destination that makes a request to a remote service, and then in the Response Transformer you store a particular response HTTP header in the channel map. As long as the next destination connector is in the same chain, it will have access to that channel map variable, and can do something else with it, like include it on a subsequent HTTP request. Get channel map value: var value = channelMap.get('key'); var value = $c('key'); Put channel map value:

Mirth® Connect by NextGen Healthcare User Guide

Raw Data Type

This data type allows a channel / connector to process any custom data not handled by any of the other data types. When using it, the msg / tmp variable accessible in the filter/transformer will be a String rather than an E4X XML object which some other data types use. This data type also has the special property that when used as the Response Inbound data type for a destination, the response transformer will always be executed, even if no actual response data was received. No serialization properties are needed since there is no conversion done. Batch Properties Name Default Value Description Split Batch By JavaScript Select the method for splitting the batch message. This option has no effect unless Process Batch is enabled in the Source Settings. The following options are available: JavaScript: Use JavaScript to split messages. For additional information, see JavaScript Batch Script JavaScript Enter JavaScript that splits the batch, and returns the next message. This script has acce

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

Response Transformers

Recommendations

Response Transformers

Navigation

About Data Types

Channel Map

Raw Data Type

About Transformers

Response Transformers

Response Transformers

Navigation

About Data Types

Channel Map

Raw Data Type

About Transformers