Built-In Code Templates

Mirth® Connect by NextGen Healthcare User Guide

Adding Segments to a Message

Segments are a group of fields that can contain varying types of data. Each segment exists independently and can be used in multiple messages. To add a segment to a message, create a new XML object with a segment code, then add it after the segment it should follow: var seg = new XML("<ZZZ><ZZZ.1><ZZZ.1.1>My Value</ZZZ.1.1></ZZZ.1></ZZZ>");msg['QRF'] += seg;Insert the += operator into a message after a particular segment or at the end of the message. Mirth® Connect has four global functions by which you can create segments for messages: Function Function Description Example Create Segment (individual) Creates an XML object for the segment that has not been inserted into a message. var newSeg = createSegment('ZYX');newSeg ['ZYX']['ZYX.1']['ZYX.1.1'] = "My Value";msg += newSeg; Create Segment (in message) Creates an XML object for the segment at the end of a specified message. createSegment ('ZYX', msg);msg ['ZYX']['ZYX.1']['ZYX.1.1'] = "My Value"; Create Segment (in message, index) Crea

Mirth® Connect by NextGen Healthcare User Guide

Edit Global Scripts

Select a script type from the drop-down menu and edit the script in the text area below. There is also a Reference List to the right for easy drag-and-drop of common helper methods / code templates. The following global script types can be edited: Deploy Script: This script executes once whenever any channel or set of channels deploys. You have access to the global / configuration maps here. Typically this script is used to perform a one-time operation, such as loading a properties file from disk, or instantiate a database connection. Undeploy Script: This script executes once whenever any channel or set of channels is undeployed. You have access to the global / configuration maps here. Typically this script is used to cleanup any data created from the deploy script, such as closing a database connection. Preprocessor Script: This script applies across all channels, and executes once for every message, after the attachment handler has run but before the message reaches the source filte

Mirth® Connect by NextGen Healthcare User Guide

Message Variables

There are a wide variety of different JavaScript contexts throughout Mirth® Connect, and each have various variables automatically available from the local scope. Here are some common examples: message: A string that represents a raw inbound message in native format. msg: An XML object that represents a transformed version of the inbound message. tmp: An XML object that represents an outbound message template; available only if an outbound template is defined. connectorMessage: An instance of the ImmutableConnectorMessage Java class; an internal representation of the message and its attributes. Parent topic: Using JavaScript in Mirth Connect

Mirth® Connect by NextGen Healthcare User Guide

Using Java Classes

You can access any Java class in any JavaScript context: var map = new Packages.java.util.LinkedHashMap(); The "Packages." at the beginning may be omitted for common top-level package domains, like "com", "net", "org", and "java". To avoid having to type out the fully-qualified class name every time, you can import the package: importPackage(org.apache.commons.io);FileUtils.getUserDirectory(); For classes in custom or non-standard libraries, create a resource (see Resources Settings Tab) containing your .jar file. Then include it on the channel in the Library Resources dependencies tab. Parent topic: Using JavaScript in Mirth Connect

Mirth® Connect by NextGen Healthcare User Guide

Using JavaScript in Mirth® Connect

This section shows you how to use JavaScript to perform various messaging operations within Mirth® Connect. About E4X Accessing Message Data with E4X Adding Segments to a Message Segments are a group of fields that can contain varying types of data. Each segment exists independently and can be used in multiple messages. Deleting a Segment Iterating Over Message Segments Iterating Over Repeating Fields Adding a New Repeating Field Message Variables Built-In Code Templates Using Java Classes Regular Expressions Logging with JavaScript Generating a Hash with JavaScript How to generate a hash using Javascript. Parent topic: Mirth Connect and JavaScript

Mirth® Connect by NextGen Healthcare User Guide

Edit Code Templates View

A code template is a function or snippet of code that can be used across multiple channels. A code template library is a group of code templates that is linked to one or more channels. When a library is linked to a channel, all code templates in the library are available to the channel. This view is where code templates and libraries are configured for your Mirth® Connect server. Image of the Code Templates where code templates and libraries are configured for your server. Navigation Code Template Library Table Edit Library Panel Edit Code Template Panel Code Template Tasks Parent topic: Edit Views

Built-In Code Templates

Recommendations

Adding Segments to a Message

Edit Global Scripts

Message Variables

Using Java Classes

Using JavaScript in Mirth® Connect

Edit Code Templates View

Built-In Code Templates

Adding Segments to a Message

Edit Global Scripts

Message Variables

Using Java Classes

Using JavaScript in Mirth® Connect

Edit Code Templates View