JavaScript Reader

Mirth® Connect by NextGen Healthcare User Guide

Channel Reader

The Channel Reader is a connector that does nothing but wait for other channels / processes to send it messages. This can be useful if you split your message workflow into multiple channels, where one sends to another. Note that you do not need to use a Channel Reader source for the channel to be able to receive messages from other internal channels / processes. Channels using other source connector types can still receive messages from a Channel Writer or from a "router.routeMessage" call. Supported property groups: Source Settings Source Map Variables Parent topic: Source 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

File Reader

This source connector reads files from a local or remote directory on a specified interval/time schedule. Several protocols are supported, including regular local file mode, FTP, SFTP, SMB, WebDAV, and Amazon S3. Files may be read in and converted to Base64, or converted to a message string using a specific character set encoding. After reading in files, the connector has options to either delete the original files, rename them, or move them to a separate directory. Additional options (like FTPS) are available with the SSL Manager extension. Supported property groups: Polling Settings Source Settings Item Name Default Value Description A Method file The basic method used to access files to be read in. Options include File (local filesystem or NFS / mapped share), FTP, SFTP, SMB, WebDAV, or Amazon S3. Once all necessary connection/directory information has been filled in before, use the Test Read button to attempt to actually connect and test the ability to read from the directory. B Ad

Mirth® Connect by NextGen Healthcare User Guide

Alert Error Categories

Any: Select this option to trigger on all error categories. Source Connector: An error that originated from the source connector during deploy/start, receiving a message, or sending a response. Destination Connector: An error that originated from a destination connector during deploy/start, dispatching a message, or receiving a response. Serializer: An error that originated from the source or destination filter/transformer script, specifically when serializing the message to the internal representation (e.g. XML), or deserializing the message to the outbound data type format. Filter: An error that originated from a source or destination filter rule. Transformer: An error that originated from a source or destination transformer step. User Defined Transformer: An error that originated from a user-defined call to AlertSender (alerts.sendAlert) from any script. For additional information, see The User API (Javadoc). Response Validation: An error that originated from a destination connector

Mirth® Connect by NextGen Healthcare User Guide

Batch Processing

Batch Processing allows a channel to receive a single message, but split it into multiple messages that each get processed through the channel. When using this along with a source connector that supports streaming (File Reader, TCP Listener in MLLP mode), batch processing has the added benefit of not having to read the entire file into memory all at once, but instead only one message at a time. For example with the File Reader and batch processing you can read in files that are gigabytes in size, without causing any memory issues for your Mirth Connect server. Data types that support batch processing will have a Batch Properties section in the source inbound data type properties. To enable batch processing, set Process Batch to Yes in the Source Settings. To change how an incoming message is split into multiple messages, look at the Batch Properties section of the source inbound data type you are using. For example, the Delimited Text Data Type has options to split by record delimiter,

Mirth® Connect by NextGen Healthcare User Guide

Database Reader

This Database Reader connects to an external database, performs a query, and reads selected rows into messages that get dispatched to the channel. This can be done using a SQL statement, or by using JavaScript mode to perform the query manually. The database connection will automatically be kept open across multiple polling windows, unless otherwise specified. This connector also supports a Post-Process section where an update statement can be performed after each row is read in, for example to set a processed flag in the source table. The values selected from the query will be automatically converted into an XML document where each column will be a separate node. That XML document is what actually gets dispatched to the channel as a message. Supported property groups: Polling Settings Source 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 M

JavaScript Reader

Recommendations

Channel Reader

JavaScript Reader Return Values

File Reader

Alert Error Categories

Batch Processing

Database Reader

JavaScript Reader

Channel Reader

JavaScript Reader Return Values

File Reader

Alert Error Categories

Batch Processing

Database Reader