Modifying the Response

Mirth® Connect by NextGen Healthcare User Guide

JavaScript Writer Return Values

When you return from your script, you can choose to set a custom Response that will be stored for the destination. The following return values are accepted: String: Any string returned will be stored as the Response content for the destination, with a status of SENT. Status: An instance of the Status enum (for additional information, see The User API (Javadoc)) will cause no response content to be stored, but the connector message status will be updated to SENT, QUEUED, or ERROR depending on the status returned. Note that the status can only be set to QUEUED if queuing is enabled in the Destination Settings. Response: A Response object contains a status, status message, error message, and the actual response content. If this object is returned, all of these things will be stored in the Response content, and the connector message status will be updated accordingly. For additional information, see The User API (Javadoc). Empty String / null / undefined: Returning any of these (including

Mirth® Connect by NextGen Healthcare User Guide

Destination Set Filter Transformer Step

Destination Set Filtering is a powerful feature of the source transformer that allows you to decide in advance which destinations to exclude from message processing. Using each individual destination's filter to control where a message goes is still a valid workflow, but when you have many destinations all with mutually exclusive filters, the performance of the channel can be affected because message data will be stored to the database for each destination connector. Also filtered connector messages can clutter up the message browser, making it harder to find what you are looking for. The advantage to using Destination Set Filtering in this case is that filtered destinations will not have any message data stored, and will not show up in the message browser. This can greatly increase message throughput. Destination Set Filtering can be done manually with JavaScript (look at DestinationSet in the User API) . However this step allows easier access to the feature without having to write an

Mirth® Connect by NextGen Healthcare User Guide

Common Scenarios

Re-queue a message if the HL7 ACK has an AE code if (msg['MSA']['MSA.1']['MSA.1.1'].toString() == 'AE') { responseStatus = QUEUED; responseStatusMessage = 'Application Error NACK received.'; responseErrorMessage = msg['MSA']['MSA.3']['MSA.3.1'].toString(); Force a queuing message to error if the number of send attempts exceeds some threshold if (responseStatus == QUEUED && connectorMessage.getSendAttempts() >= 5) { responseStatus = ERROR; responseStatusMessage = 'Maximum send attempts exceeded.';} Route the response data to a downstream channel if (responseStatus == SENT) { router.routeMessageByChannelId('channel ID here', response.getMessage());} Parent topic: 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

SMTP Sender

This destination connector sends an e-mail to a specified address (or list of addresses), through a given SMTP relay/host. Both implicit and explicit (STARTTLS) encryption modes are supported. The body can be either text or HTML. Custom headers and attachments can be added to the request as well. Supported property groups: Destination Settings Item Name Default Value Description A SMTP Host The domain name or IP address of the SMTP server to use to send the e-mail messages. Note that sending e-mail to an SMTP server that is not expecting it may result in the IP of the machine running Mirth® Connect being added to the server's "denylist". After filling out the necessary information below, use the Send Test Email button to send a sample e-mail to the To address, to verify that everything is working as intended. B SMTP Port 25 The port number of the SMTP server to send the e-mail messages to. Generally, the default port of 25 is used. C Override Local Binding No Select Yes to override the

Mirth® Connect by NextGen Healthcare User Guide

Response Transformers

The Response Transformer is a special type of transformer specific to destination connectors. 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, see Response 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 destination and it fails to connect to the remote se

Modifying the Response

Recommendations

JavaScript Writer Return Values

Destination Set Filter Transformer Step

Common Scenarios

Response Transformers

SMTP Sender

Response Transformers

JavaScript Writer Return Values

Destination Set Filter Transformer Step

Common Scenarios

Response Transformers

SMTP Sender

Response Transformers