Destination Set Filter Transformer Step

Item Name	Description
Behavior	Identifies which destinations will be removed (not processed) from the destination set. Available options are: the following: The identified destination(s) are filtered if the conditions indicated are true. all except the following: All destinations except those selected are filtered if the conditions indicated are true. This includes new destinations added after this step was created. all: All destinations are filtered if the conditions indicated are true. This includes new destinations added after this step was created.
Destinations	Select the destinations to exclude or not exclude, depending on the behavior above. If the destination is renamed later, these selections will still be correct since the metadata ID is used.
Field	The message field or expression to test.
Condition	Determines how to test the Field set above. The following conditions are supported: Exists: Returns true if the length of the field is greater than 0. Not Exist: Returns true if the length of the field is 0. Equals: If the Values table is empty, returns true if the field is equal to an empty string. If the Values table is not empty, returns true if the field matches any of the values in the Values table below. Not Equal: If the Values table is empty, returns true if the field is not equal to an empty string. If the Values table is not empty, returns true if the field matches none of the values in the Values table below. Contains: Returns true if the field contains any of the values in the Values table below. Not Contain: Returns true if the field contains none of the values in the Values table below.
Values	A table of expressions that may be used in conjunction with the Condition to test the given field and decide whether or not to filter the selected destinations.

Mirth® Connect by NextGen Healthcare User Guide

Mapper Transformer Step

This step extracts data from a field in the message (or an expression) and places it into one of the available Variable Maps. Depending on the scope of the map, this variable will be available in subsequent steps, in the destination connector properties, or even in subsequent connectors. Item Name Description Variable The variable name / key to use when inserting into the map. The Add to drop-down menu to the right determines which map to place the variable in. For additional information, see Variable Maps. Mapping The value to place into the map. This may be a field from the message, or any JavaScript expression. Default Value If the Mapping is not found or evaluates to an empty string, this value / expression will be used instead. String Replacement This table allows you to perform replacements on the value before it gets inserted into the map. Regular Expression: A Java-style regular expression to test against the value. This will implicitly set the global regex flag. Replace With:

Mirth® Connect by NextGen Healthcare User Guide

Use the "Destination Set Filter" feature in your source transformer when you need to route messages to only one (or a subset) of destinations in your channel.

This feature has been available in the JavaScript user API since version 3.1.0: if (sourceMap.get("contextPath") == "/path1") { destinationSet.removeAllExcept([1]);} A less efficient pattern used prior to version 3.1.0 was to filter the message on all destinations except the desired destination. This approach consumes more disk space as the message is copied to each destination before the filtering takes place. The Destination Set Filter will ensure that the message is only processed and stored by the desired destination. Since version 3.5.0, it can also be leveraged without writing any code: Parent topic: Channel Performance

Mirth® Connect by NextGen Healthcare User Guide

Rule Builder Filter Rule

This rule allows you to build simple accept logic for a specific message field or expression. Item Name Description Behavior This is always set to Accept, meaning that if the logical expression below evaluates to true, the message will be accepted. Field The message field or expression to test. Condition Determines how to test the Field set above. The following conditions are supported: Exists: Returns true if the length of the field is greater than 0. Not Exist: Returns true if the length of the field is 0. Equals: If the Values table is empty, returns true if the field is equal to an empty string. If the Values table is not empty, returns true if the field matches any of the values in the Values table below. Not Equal: If the Values table is empty, returns true if the field is not equal to an empty string. If the Values table is not empty, returns true if the field matches none of the values in the Values table below. Contains: Returns true if the field contains any of the values in

Mirth® Connect by NextGen Healthcare User Guide

Metadata Table Columns

Column Description Id The unique ID that identifies the message within the current channel. Note that a single message can have multiple connector messages for each connector (source / destinations) in the channel. Each connector message row is organized by this column in the table. Connector The name of the connector. (e.g. "Source", "Destination 1") Status The current status of the connector message. Valid values include: Source connector statuses: Received: If the source queue is enabled, this means the message has been committed to the database and added to the source queue, but has not yet been processed. If the source queue is disabled, this means the message has not yet finished processing through the source connector. Filtered: The message has been rejected by the source filter, and will not flow any further through the channel. Transformed: The message has passed the source filter/transformer, and the source encoded data has been dispatched to any destinations. Error: An error

Mirth® Connect by NextGen Healthcare User Guide

Destination Table

This table shows you all currently configured destinations for your channel. You can see at a glance the type of each destination, whether it is enabled, what chain it belongs to, and more. Column Description Status Indicates whether the destination is enabled or disabled. Only enabled destinations process messages. A channel must have at least one destination enabled. Destination Double-click this cell to edit the name of the destination. Note that while a destination may be renamed, its metadata ID will remain the same. Id The metadata ID that uniquely identifies this destination within the current channel. Connector Type The type of destination connector. To change this, select the destination from the table and choose a new type from the drop-down menu directly below the table. Chain The chain this destination connector belongs to. The first destination in the table is automatically placed into chain #1. To start a new chain, select a subsequent destination from the table, and unch

Mirth® Connect by NextGen Healthcare User Guide

Destination Tasks

In addition to the general Edit Channel Tasks, several context-specific tasks are unique to the Destinations Tab: Task Icon Task Name Description New Destination Creates a new destination and adds it to the table above. Delete Destination Deletes the currently selected destination and removes it from the table above. Note that a channel must have at least one enabled destination. Clone Destination Copies the currently selected destination and adds it to the table above. Enable Destination Marks this destination as ready to process messages at deploy time. Disable Destination Marks this destination as not ready to process messages at deploy time. Note that a channel must have at least one enabled destination. Move Destination Up Moves the currently selected destination one row higher in the table above. Move Destination Down Moves the currently selected destination one row lower in the table above. Edit Response Enters the Edit Transformer View for the currently selected destination's r

Destination Set Filter Transformer Step

Recommendations

Mapper Transformer Step

Use the "Destination Set Filter" feature in your source transformer when you need to route messages to only one (or a subset) of destinations in your channel.

Rule Builder Filter Rule

Metadata Table Columns

Destination Table

Destination Tasks

Destination Set Filter Transformer Step

Mapper Transformer Step

Use the "Destination Set Filter" feature in your source transformer when you need to route messages to only one (or a subset) of destinations in your channel.

Rule Builder Filter Rule

Metadata Table Columns

Destination Table

Destination Tasks