JavaScript Writer Return Values

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

JavaScript Reader Return Values

If you are using the JavaScript Reader to produce messages for the channel, all you need to do is return those messages from the script. The following return values are accepted: String: Any non-empty string returned will be sent to the channel as a message. RawMessage: This is a special object that contains not only the string message data, but also information about which destinations to dispatch to, and any source map variables you wish to inject. For additional information, see The User API (Javadoc). List: If a Java List is returned, all values in the list will be sent to the channel as discrete messages. The list may contain a mix of Strings, RawMessage objects, or other objects. Empty String / null / undefined: Returning any of these (including just a "return;" statement or no return statement at all) will cause no messages to dispatch to the channel. Any Object: Any other object returned will be converted to a String via the toString() method, and that String representation wil

Mirth® Connect by NextGen Healthcare User Guide

Channel Writer

The Channel Writer is a connector that simply dispatches messages to other internal channels. This can be useful if you split your message workflow into multiple channels, where one sends to another. If no target channel is specified, the connector acts as a "sink" where no message dispatching is done. Note that a channel does not need to use a Channel Reader source for a Channel Writer to be able to send messages to it. The connector also has options to inject source map variables into the downstream message of the target channel. Supported property groups: Destination Settings Item Name Default Value Description A Channel Id <None> The unique ID of the target channel to send messages to. This may be a hard-coded ID, or may be a Velocity Variable Replacement. Use the drop-down menu to the right to quickly select a particular channel. If <None> is selected, the destination will act as a "sink" where messages are not dispatched anywhere. B Message Metadata The map variables entered here

Mirth® Connect by NextGen Healthcare User Guide

Extract Attachments

Use the following method to extract and store attachments from the attachment script: The resulting Attachment object contains the ID you need to inject back into the message. For more information, look at the User API. The return value for the JavaScript attachment script should be the final message string, with any attachments extracted out and replaced with attachment replacement tokens. addAttachment(data, type) Creates and stores an attachment for the current message. Table 1. Parameters Name Type Description data String or Byte array The actual attachment data to insert. Man be either a String or a byte array. If a string is used, it is assumed to be a Base64 encoded representation of the actual attachment data. type String The MIME type of the attachment. For additional information see Attachment Handlers. <Return Value> Attachment The inserted Attachment object. The resulting Attachment object contains the ID you need to inject back into the message. For more information, look

Mirth® Connect by NextGen Healthcare User Guide

Modifying the Response

Modifying the actual response data is done by using the normal features and steps available to a transformer. The internal representation of the response data is msg, while the internal representation of the outbound template (if set) is tmp. When the response transformer finishes processing, it will use the value of tmp (or msg if no outbound template is set) to create the Processed Response content. There are three other pieces of the response that you can modify in the response transformer: responseStatus: This is the status that will be used to update the message after the response message finishes. You may set the status to SENT, QUEUED, or ERROR. If the status is set to QUEUED and queuing is not enabled for the destination connector, it will automatically be changed to ERROR. responseStatusMessage: This is a brief one-line message that displays alongside the status in the message browser. It is typically used to give a reason for the status. responseErrorMessage: This is the full

Mirth® Connect by NextGen Healthcare User Guide

JavaScript HTTP Authentication

Allows you to authenticate users with a custom JavaScript script. With this script you have access to source map variables, and can choose whether to send a challenged or failure response back to the client. The default script simply allows all requests to pass. The Script field will show <Default Script Set> if the default script is currently being used. If you have made any modification to the script, the Script field will show <Custom Script Set>. Select the Script field to edit the JavaScript: This script expects either a boolean ( true to accept the request, false to send back a failure response) or an AuthenticationResult object to be returned (for additional information, see User API) . There are three types of results you can return: AuthenticationResult.Success(): The request will be accepted and processed through the channel. AuthenticationResult.Challenged(authenticateHeader): The request will not be processed through the channel. A 401 response will be sent back to the clie

JavaScript Writer Return Values

Recommendations

JavaScript Writer

JavaScript Reader Return Values

Channel Writer

Extract Attachments

Modifying the Response

JavaScript HTTP Authentication