Velocity Variable Replacement

Mirth® Connect by NextGen Healthcare User Guide

The Variable Map Lookup Sequence

In many cases when referencing map variables in Mirth® Connect, you do not call out to a specific map, but instead use the generic lookup function: var value = $('variableName'); Or, you might reference a variable using Velocity Variable Replacement: ${variableName} When you do this, Mirth® Connect will automatically look that key up in all available maps. That may only be the configuration/global map (in the case of the global scripts) , or it may be all maps (in the case of a filter / transformer script) . This sequence is followed: Response Map Connector Map Channel Map Source Map Global Channel Map Global Map Configuration Map For example, if you have stored a variable called "dataSource" in both the Connector Map and the Global Channel Map, the one from the Connector Map will be used. If you want the value specifically from the Global Channel Map instead, you can use the map-specific get function shown in the Variable Maps section: var dataSource = globalChannelMap.get('dataSource

Mirth® Connect by NextGen Healthcare User Guide

Channel Properties

Item Name Description A Name The name of the channel. Only alphanumeric (a-z / 0-9) characters, spaces, hyphens, and underscores are allowed. B Enabled Indicates whether the channel is ready to be deployed. All enabled channels will automatically be deployed with the Mirth® Connect by NextGen Healthcare server starts up. If there is an error in your channel configuration, this will automatically be unchecked. C Set Data Types Dialog Configure data types across your entire channel, from the source connector to each of your destination connectors. Allows easy bulk editing of data type properties. For additional information, see Set Data Types. D Clear global channel map on deploy If checked, the global channel map for this channel will be cleared out whenever the channel is redeployed. E Set Dependencies Configures Code Template Libraries, Library Resources, and Deploy/Start Dependencies for this channel. For more information, see Set Dependencies Window. F Initial State Determines what

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

Conditional Statements

Velocity supports if..else statements, with the #if / #elseif / #else directives: There #if($list.size()==1)is#{else}are#end ${list.size()} total value#if($list.size()!=1)s#end The curly brackets ("{}") are only needed if the if/else/end might be confused with template data immediately before or after. Parent topic: Velocity Variable Replacement

Mirth® Connect by NextGen Healthcare User Guide

Basic Syntax

Basic syntax for a Velocity reference is as follows: ${variableName} The brackets may be omitted if the identifier starts with a letter and contains only letters, numbers, hyphens, or underscores: $variableName The variable will be looked up in all available maps, according to The Variable Map Lookup Sequence. The string representation of the value will then replace the Velocity reference. You can also access properties and methods from context variables: ${myArray.length}${myList.size()}${myObject.customMethod('param')} If a property has a corresponding getter method (like getValue()), the engine will automatically find that method when you attempt to access the property. Therefore these may be equivalent: ${myObject.value}${myObject.getValue()} If the context variable doesn't exist, or if the value returned by the reference evaluation is null, no replacement will be done, so the final template will still have your "${varName}" string within. In these cases you can put an exclamation

Mirth® Connect by NextGen Healthcare User Guide

For Loops

Velocity supports iterating through Lists / Collections / Arrays with the #foreach directive: <table>#foreach ($item in $list) <tr> <td>${item.name}</td> <tr>#end</table> Parent topic: Velocity Variable Replacement

Velocity Variable Replacement

Recommendations

The Variable Map Lookup Sequence

Channel Properties

Channel Writer

Conditional Statements

Basic Syntax

For Loops

Velocity Variable Replacement

The Variable Map Lookup Sequence

Channel Properties

Channel Writer

Conditional Statements

Basic Syntax

For Loops