Loading...

Recommendations

©2025 NXGN Management, LLC. All Rights Reserved.Legal notices Privacy Policy

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.

Using JavaScript in Mirth® Connect

Mirth® Connect by NextGen Healthcare User Guide

Using the JavaScript Editor

Mirth® Connect has a rich JavaScript editor that includes automatic code completion, code folding, multi-line tabs/comment toggles, auto-indentation, bracket matching, macros, and much more. Using the Context Menu in the JavaScript Editor Remapping Editor Shortcut Keys Using the Auto-Completion Popup in the JavaScript Editor Using the Context Menu in the JavaScript Editor Using the Auto-Completion Popup in the JavaScript Editor Remapping Editor Shortcut Keys Parent topic: Mirth Connect and JavaScript

Mirth® Connect by NextGen Healthcare User Guide

Mirth® Connect Debugger

The Mirth Connect Debugger tool allows you to troubleshoot JavaScript errors throughout the Mirth® Connect application. The Debugger can be used for the following scripts and connectors: Deploy, Undeploy, Preprocessor, and Post Processor scripts Attachment/Batch scripts Source Connectors: Filters/Transformers Database Reader and JavaScript Reader types Destination Connectors: Filters/Transformers. Database Writer and JavaScript Writer types Response transformers Before You Begin If your Java application does not interact directly with a user, use the following steps to change the Headless mode to false. Setting this mode to false means that your Java application: Displays windows or dialog boxes. Accepts keyboard or mouse input. Uses any heavyweight AWT (Abstract Windowing Toolkit) components. To Edit the mcserver.vmoptions file Use the Debugger Debugger Window Debugger Menus Parent topic: Mirth Connect and JavaScript

Mirth® Connect by NextGen Healthcare User Guide

The User API (Javadoc)

The user API (application programming interface) is a collection of Java classes and methods that helps you interact with channels and the message that is being processed. It also provides helper methods for common tasks such as date formatting. Wherever you are editing JavaScript code in Mirth® Connect, you can view the API by selecting the View User API function in the Other panel, which is available on all Mirth® Connect Administrator views. Image of the View User API task on the Other menu. You can also right-click/command+click in the text area of any JavaScript Editor, and on the drop-down menu, select View User API. Image of the process of viewing the user API from the JavaScript Editor. The Javadoc appears in your default web browser, in which you can select classes to view their method signatures and descriptions. Image of the Javadoc. Note: You can also view the API via this link: http://javadocs.mirthcorp.com/connect/3.6.0/user-api/ Parent topic: Mirth Connect and JavaScript

Mirth® Connect by NextGen Healthcare User Guide

Mirth® Connect and JavaScript

JavaScript is a scripting language that can be used in a wide variety of places throughout Mirth® Connect to perform advanced routing and transformation. About JavaScript Using JavaScript in Mirth Connect Using the JavaScript Editor Variable Maps Attachment JavaScript Functions The User API (Javadoc) The user API (application programming interface) is a collection of Java classes and methods that helps you interact with channels and the message that is being processed. Mirth Connect Debugger

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

Logging with JavaScript

Use logger.info() and logger.error() to log information in JavaScript contexts: logger.info("The value of x =" + x); You can view the output of this method in the Mirth® Connect Dashboard's Server Log. The default logging level, ERROR, is the quickest, having the least amount of overhead. INFO and DEBUG levels give more details but have more overhead, so are somewhat slower. You can change the logging level via the Mirth® Connect Server Manager for users who run the latest version of Mirth® Connect on a Mac ( Applications > Mirth Connect > mcmanager) or PC: Note: Mirth Appliance users can change the logging level from the Mirth® Connect Settings page via Applications > Mirth Connect > Manage from the Appliance UI. Parent topic: Using JavaScript in Mirth Connect