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

Database Writer

This destination connector connects to an external database and performs an INSERT/UPDATE statement (or any other statement, like calling a stored procedure). This can be done using a SQL statement, or by using JavaScript mode to execute the statement manually. The database connection will automatically be kept open across multiple dispatches. Supported property groups: Destination Settings Item Name Default Value Description A Driver Specifies the type of database driver to use to connect to the database. The following values are supported by default: Sun JDBC-ODBC Bridge MySQL Oracle PostgreSQL SQL Server / Sybase SQLite Additional drivers can be added by editing the dbdrivers.xml File. B URL The JDBC URL to connect to the database with. This is not used when "Use JavaScript" is checked. However, it is used when the Generate Connection / Insert feature is used to generate code. Use the Insert URL Template button to populate the URL field with a starting template. C Username The usern

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

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

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

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

JavaScript Writer Return Values

Recommendations

JavaScript Writer

Database Writer

JavaScript Reader Return Values

Destination Set Filter Transformer Step

Modifying the Response

Channel Writer

JavaScript Writer Return Values

JavaScript Writer

Database Writer

JavaScript Reader Return Values

Destination Set Filter Transformer Step

Modifying the Response

Channel Writer