Extraction

Mirth® Connect by NextGen Healthcare User Guide

Reattachment

Right before a destination connector dispatches a message to the external system, it scans the outbound message for attachment replacement tokens and automatically re-inserts the actual attachment data. You can prevent a destination from reattaching data by disabling the Reattach Attachments option in the Destination Settings. Parent topic: Attachment Handlers

Mirth® Connect by NextGen Healthcare User Guide

Expanded Replacement Tokens

The standard attachment replacement token only includes the attachment ID, and is implicitly assumed to be tied to the current message / channel. However if you disable Reattach Attachments in the Destination Settings, the destination will replace the token not with the actual attachment data, but instead with an expanded token: The expanded token contains the channel ID, message ID, and attachment ID, so that you can uniquely identify an attachment even from a completely different channel or message. Because of this, you can use this replacement token in downstream channels and reattach attachments from earlier, upstream channels. Parent topic: Attachment Handlers

Mirth® Connect by NextGen Healthcare User Guide

Attachment Handler Properties

The following attachment handlers are supported: Entire Message Attachment Handler Properties Regex Attachment Handler Properties DICOM Attachment Handler Properties JavaScript Attachment Handler Properties Custom Attachment Handler Properties Entire Message Attachment Handler Properties Regex Attachment Handler Properties DICOM Attachment Handler Properties JavaScript Attachment Handler Properties Custom Attachment Handler Properties Parent topic: Attachment Handlers

Mirth® Connect by NextGen Healthcare User Guide

Attachment Handlers

An Attachment Handler allows you to extract pieces of any incoming message and store them separately. As a message processes through a channel, multiple copies of it will be held in memory at once (for the raw / transformed / encoded versions of a message, etc.). Attachments are stored only once, so by using them you can greatly reduce your channels' memory footprint. These are configured in the Channel Properties section of the Summary Tab within the Edit Channel View. Note: See Attachment JavaScript Functions for more information. By default the attachment handler is set to None, meaning no attachments will be extracted. To extract attachments choose an attachment handler type from the drop-down menu, and select the Properties button to configure the handler. Note: If Store Attachments next to the Attachment menu is unchecked, then attachments will be extracted from the incoming message data, but not actually stored anywhere. Extraction Reattachment Expanded Replacement Tokens Attach

Mirth® Connect by NextGen Healthcare User Guide

Regex Attachment Handler Properties

This attachment handler extracts data from the incoming message using regular expressions. You can specify multiple expressions, each with their own MIME type. There are also options to replace certain values on the extracted attachment data before storing it in the database, and replace values in the attachment data right before reinserting it into the message for outbound dispatching. Regular Expressions Table String Replacement Tables Parent topic: Attachment Handler Properties

Mirth® Connect by NextGen Healthcare User Guide

Message Attachments

An attachment is a piece of data extracted from the raw incoming message and stored separately. Attachments are not associated with connector messages, but instead with the overall message. The extraction happens at the very beginning of the message lifecycle, even before the preprocessor script runs. When a destination connector dispatches data outbound, any attachments associated with the message will be automatically re-inserted into the outgoing data. In this way, attachment data is only stored once, and multiple copies of it for each connector and for each content type (e.g. Raw / Transformed / Encoded) will not be stored. Using attachments can greatly improve the memory footprint of your channels. More additional information on attachments and how they are extracted, see Attachment Handlers. Parent topic: About Message Data

Extraction

Recommendations

Reattachment

Expanded Replacement Tokens

Attachment Handler Properties

Attachment Handlers

Regex Attachment Handler Properties

Message Attachments

Reattachment

Expanded Replacement Tokens

Attachment Handler Properties

Attachment Handlers

Regex Attachment Handler Properties

Message Attachments