Reattachment

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

Attachment Handlers are used to extract a portion of a message (or the entire message) and store it separately as an attachment. The portion of the message that was extracted is replaced with an attachment replacement token. When you use a destination connector to send a message downstream, Mirth® Connect will automatically take the message and replace any attachment tokens with the actual attachment data (unless you have Reattach Attachments turned off in the Destination Settings) . Throughout the message lifecycle you can retrieve, modify, and add new attachments with built-in helper functions. Built-In Attachment Functions The AttachmentUtil Class The Attachment Object Examples Built-In Attachment Functions The AttachmentUtil Class The Attachment Object Examples Parent topic: Mirth Connect and JavaScript

Mirth® Connect by NextGen Healthcare User Guide

JavaScript Writer

This destination connector executes a custom user-defined JavaScript script. This can be used in a wide variety of ways, such as calling out to external Java libraries or invoking a local OS shell script. You can return custom values that determine what response data to store, and what status to put the destination connector message into. Or simply use the script as a generic job that doesn't necessarily produce responses. For example, you can use tools like ChannelUtil to programmatically start/stop/deploy channels from within the script. Supported property groups: Destination Settings JavaScript Writer Return Values Parent topic: Destination Connectors

Mirth® Connect by NextGen Healthcare User Guide

Extraction

When an attachment handler extracts data from a message, it leaves behind an attachment replacement token like this: This value tells the destination connector where in your message the attachment should be re-inserted right before dispatching to an outbound system. If multiple attachments were extracted for a message, then there will be multiple replacement tokens in the raw data. Parent topic: Attachment Handlers

Mirth® Connect by NextGen Healthcare User Guide

Destination Settings

These are general settings that apply to all destination connectors. They include configuring the destination queue, whether to validate responses, and whether to re-attach attachments on outbound messages. Item Name Description A Queue Messages Never: Disable the destination queue. On Failure: Attempt to send the message first before queuing it. This will allow subsequent destinations and the Postprocessor to use the response from this destination if it successfully sends before queuing. Always: Immediately queue the message. Subsequent destinations and the Postprocessor will always see this destination's response as QUEUED. B Advanced Queue Settings Configure how often to re-attempt queued messages, increase queue threads, and more. C Validate Response Select Yes to validate the response. Responses can only be validated if the response transformer's inbound properties contains a Response Validation section. If validation fails, the message will be marked as queued or errored. For add

Mirth® Connect by NextGen Healthcare User Guide

Document Writer

This destination connector takes an HTML template and converts it into either a PDF or RTF document. Custom embedded stylesheets are supported. That document can then be written out to a file and/or stored as a message attachment. The page size can be specified, and for PDFs you can also encrypt the document with a password. Supported property groups: Destination Settings Item Name Default Value Description A Output File Choose how to output the document. File: Write the contents to a file. Attachment: Write the contents to an attachment. The destination's response message will contain the attachment Id and can be used in subsequent connectors to include the attachment. Both: Write the contents to both a file and an attachment. B Directory The directory (folder) where the generated file should be written. Use the Test Write button to confirm that files can be written to the folder. C File Name The file name to give to the generated file. D Document Type PDF The type of document to be c

Reattachment

Recommendations

Expanded Replacement Tokens

Attachment JavaScript Functions

JavaScript Writer

Extraction

Destination Settings

Document Writer

Reattachment

Expanded Replacement Tokens

Attachment JavaScript Functions

JavaScript Writer

Extraction

Destination Settings

Document Writer