Global Maps

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

Mappings Tab

The Mappings tab shows all entries stored in variable maps for the selected connector message. View Mappings Mappings Table Columns Parent topic: Message Browser View

Mirth® Connect by NextGen Healthcare User Guide

Dashboard Table

This is the main section of the dashboard. The Dashboard Table shows the current status and statistics for your deployed channels. For general information about working with tables in Mirth® Connect, see Working With Tables. Dashboard Table Columns View Messages for a Channel Show or Hide Channel Groups Change How Tags Display Parent topic: Dashboard View

Mirth® Connect by NextGen Healthcare User Guide

Variable Maps

Throughout the Message Processing Lifecycle, your channels and messages have access to various maps. Depending on the scope, the map may only be available in the current channel/connector, or may be globally available across your entire system. These variable maps allow you to store a piece of information that can be used later (in a downstream channel, connector, or somewhere else). A common use for these variables is to provide easy drag-and-drop for connector properties. The Destination Mappings list will display all available connector/channel map variables for example. They are also used in other ways, such as populating Custom Metadata Columns. The following variable maps exist throughout Mirth® Connect: Name JavaScript Variable Get/Put Shortcut Variable Response Map responseMap $r Connector Map connectorMap $co Channel Map channelMap $c Source Map sourceMap $s Global Channel Map globalChannelMap $gc Global Map globalMap $g Configuration Map configurationMap $cfg The table above

Mirth® Connect by NextGen Healthcare User Guide

Global Maps Table Columns

Column Description Server ID Identifies the ID of the server where the global map variable resides. Channel This will either be the channel name, or "<Global Map>" if the entry refers to the global map rather than a global channel map. Key The string used to uniquely identify the entry within the given map. Value The string representation of the current value residing in the map entry. Note that although the Global Maps table will show the string representation, the actual object resides in memory on the server side. If the object has no string representation you may see an entry like "java.lang.Object@123abc"; instead. For values with long string representations, the value shown in the table will be truncated. To show the entire message for these entries, double-click the value cell: Parent topic: Global Maps

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:

Global Maps

Recommendations

The Variable Map Lookup Sequence

Mappings Tab

Dashboard Table

Variable Maps

Global Maps Table Columns

Mapper Transformer Step

The Variable Map Lookup Sequence

Mappings Tab

Dashboard Table

Variable Maps

Global Maps Table Columns

Mapper Transformer Step