Choose a Source Connector

Mirth® Connect by NextGen Healthcare User Guide

HTTP Listener

This source connector acts as an HTTP server, listening for requests from one or more remote clients. The messages sent to the channel can be the raw payload, or an XML document allowing multipart payloads to be parsed in a consistent and easy-to-use way. The HTTP payload can be either Base64 encoded or converted using a charset, depending on the Content-Type. Responses that go back to each client can be fully configured, including custom response headers. Finally, static resources or directories can be automatically hosted, to allow the connector to act as a simple web server that serves specific content. Additional options are available with the SSL Manager extension. Supported property groups: Listener Settings Source Settings HTTP Authentication Settings Item Name Default Value Description A Base Context Path The context path for the HTTP Listener URL. Note: If this is specified, any requests made at this base context path must have a trailing slash in the request URI. B Receive Ti

Mirth® Connect by NextGen Healthcare User Guide

Web Service Listener

This source connector publishes a SOAP endpoint via JAX-WS. By default it uses a simple service with one operation that takes in a message string and sends back a response string. The SOAP XML envelope is automatically handled, so that the actual data the channel receives is the content within the operation argument node. You also have the option to provide your own custom service, with custom operations. Supported property groups: Listener Settings Source Settings HTTP Authentication Settings Item Name Default Value Description A Web Service Default service If Custom is selected, provide the fully-qualified class name of the Endpoint service you wish to publish. B Service Class Name com.mirth.connect.connectors.ws.DefaultAcceptMessage The fully-qualified class name of the Endpoint service to publish. C Service Name Mirth The name of the service, used to populate the URL context path. D Binding Default The selected binding version defines the structure of the generated envelope. Select

Mirth® Connect by NextGen Healthcare User Guide

Source Connector Properties

This section refers to the actual connector-specific settings. The sections are labeled according to the connector types, for example, "HTTP Listener", "JavaScript Reader". For additional information on connectors in general, refer About Channels and Connectors. Here is a list of source connectors supported by Mirth® Connect Source Connectors Channel Reader DICOM Listener Database Reader File Reader HTTP Listener JMS Listener JavaScript Reader TCP Listener Web Service Listener Additional source connectors are made available as extensions: Email Reader Serial Connector FHIR Connector Interoperability Connector Suite Parent topic: Source Tab

Mirth® Connect by NextGen Healthcare User Guide

Listener Settings

These properties are shown when the connector is a TCP socket-based listener (server), and allow you to specify the local network interface and port to listen on. Supported connectors include the DICOM Listener, HTTP Listener, TCP Listener, and Web Service Listener. Item Name Description A Local Address If All interfaces is selected, the connector will listen on all interfaces, using address 0.0.0.0. If Specific interface is selected, the connector will listen on the specific network interface address given in the accompanying field. B Local Port The TCP port on which to listen for connections. Parent topic: Source Tab

Mirth® Connect by NextGen Healthcare User Guide

Polling Settings

These settings are for connectors that do not listen passively for messages, but instead actively poll according to a specific schedule. This may be once every few seconds, at a specific time of day, or something more complex. Supported connectors include the Database Reader, File Reader, and JavaScript Reader. Item Name Description A Schedule Type Determines how the polling schedule is set. This could be on a specific interval, a time of day, or a custom expression. B Next poll at Given the current polling settings, shows the next date and time that the source connector will poll for new messages (assuming it is deployed). This value is updated once when you navigate to the Source tab, or when you update the schedule settings. It does not continue to update automatically. C Poll Once on Start Select Yes to immediately poll once when the channel is started. All subsequent polling will follow the specified scheduling settings. D Schedule Settings These are settings specific to the sched

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

Choose a Source Connector

Recommendations

HTTP Listener

Web Service Listener

Source Connector Properties

Listener Settings

Polling Settings

JMS Listener

HTTP Listener

Web Service Listener

Source Connector Properties

Listener Settings

Polling Settings

JMS Listener