Using Resources in Channels/Connectors

Mirth® Connect by NextGen Healthcare User Guide

JMS Listener

This source connector connects to an external JMS provider and reads messages from a queue or topic. It supports both JNDI and specifying a specific connection factory, as well as fine-tuned queries through a configurable selector. Once this connector is started, it will attempt to keep a persistent open connection to the JMS provider. If for any reason the connection is dropped, the connector will automatically reconnect without any intervention needed. The properties view also includes a mechanism to save configuration templates for common provider types, so that creating a new JMS Listener is as quick and easy as possible. Note: Depending on the JMS connection provider you are using, you may need to include some external libraries (JARs) as a Library Resource and include them using the Set Dependencies dialog on the Channel Summary tab. For example, to use connection templates included for ActiveMQ and JBoss, you should download the libraries from their official site in order to use

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

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

Reload Resource

The actual implementation of this task depends on the type of resource. For directory resources the directory will be re-scanned for files, and all channels / connectors using the resource will have their respective classloaders destroyed and recreated with the new list of libraries. When the task is selected, a confirmation message appears. Parent topic: Resources Settings Tab

Mirth® Connect by NextGen Healthcare User Guide

Resources Table Columns

Column Description Name The name of the resource. Double-click this column to edit the name. Note that the [Default Resource] cannot be renamed or removed. Type The type of resource / service. The [Default Resource] type cannot be changed. Global Scripts If selected, any libraries included with the resource will automatically be made available for use in the Global Scripts. Load Parent-First If selected, classes already included in the overall server classpath will not be able to be overwritten. Classes will attempt to be loaded from the parent ClassLoader first. Also, if this resource is included on a channel with other resources that have this option disabled, you will still not be able to overwrite classes in the parent classpath. Parent topic: Resources Settings Tab

Mirth® Connect by NextGen Healthcare User Guide

Directory Resource

The directory resource enables you to easily load Java libraries (or other files) so that they can be used in a channel or connector. Item Name Description A Directory The path to the directory to load files from. If a relative path is used, the path will be relative to the Mirth® Connect installation directory. B Include All Subdirectories Select Yes to traverse directories recursively and search for files in each one. C Description A description for the resource. D Loaded Libraries All files currently loaded and ready for use by channels and connectors. If you have saved the resource but do not see any libraries in this table yet, try using the Refresh task on the left side of the window. Parent topic: Resources Settings Tab

Using Resources in Channels/Connectors

Recommendations

JMS Listener

Channel Properties

Using Java Classes

Reload Resource

Resources Table Columns

Directory Resource

JMS Listener

Channel Properties

Using Java Classes

Reload Resource

Resources Table Columns

Directory Resource