Connection
HL7 EDI Connector 4.2 Reference
Configurations
Config
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
String |
Name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
Connection type for this configuration. |
x |
||
Expiration Policy |
ExpirationPolicy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances when appropriate. |
||
Mule application namespace ID (MSH-3-1/MSH-5-1) |
String |
Application namespace ID for Mule in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Mule Application universal ID (MSH-3-2/MSH-5-2) |
String |
Application universal ID for Mule in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Mule Application universal ID Type (MSH-3-3/MSH-5-3) |
String |
Application universal ID type for Mule in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Partner Application Namespace ID (MSH-3-1/MSH-5-1) |
String |
Application namespace ID for the partner in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Partner Application universal ID (MSH-3-2/MSH-5-2) |
String |
Application universal ID for the partner in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Partner Application universal ID Type (MSH-3-3/MSH-5-3) |
String |
Application universal ID type for the partner in the message header (MSH segment). If set, this value affects both receive and send message handling:
|
||
Schema definitions |
Array of String |
List of schema paths for the connector to use. The paths can be filesystem paths or classpaths. |
x |
|
Event and message to message structure map path |
String |
Path to a YAML file that defines the mapping of the event code and message code to the message structure ID:
|
||
HL7 Message character encoding |
Enumeration, one of:
|
Character encoding for HL7 messages. This is the default for receive messages when MSH-18 is not present and for send messages when MSH-18 is not present in the send message data. |
ASCII |
|
Disable numeric prefixes for data keys |
Boolean |
Uses segment and group IDs directly as keys in the data, rather than prefixing the segment and group IDs with position values. |
true |
|
Required processing ID |
Enumeration, one of:
|
Value to match the MSH-11-1 processing ID. If set, only messages with the specified processing ID are accepted for processing. Messages with other processing ID values or with no processing ID specified are rejected with an exception. |
||
Pattern for generic extension segment names |
String |
Java regular pattern for segment names to treat as generic extension segments. If specified, segment names matching this pattern are allowed anywhere in the message and are converted to maps of string values for elements and composites. |
||
Fail when required value missing |
Boolean |
Whether to reject a message if a required value is missing:
In either case, the error is logged and reported in an ERR segment. |
false |
|
Fail when value length outside allowed range |
Boolean |
Whether to reject a message if the receive value length is outside of allowed the range:
In either case, the error is logged and reported in an ERR segment. |
false |
|
Fail when invalid character in value |
Boolean |
Whether to reject a message if the receive value contains an invalid character:
In either case the error is reported in an ERR segment. |
false |
|
Fail when too many repeats of value |
Boolean |
Whether to reject a message if the receive value is repeated too many times:
In either case the error is reported in an ERR segment. |
false |
|
Fail when unknown segment in message |
Boolean |
Whether to reject a message if it contains an unknown segment:
In either case the error is reported in an ERR segment. |
false |
|
Fail when segment out of order in message set |
Boolean |
Whether to reject a message when a segment in a message set is out of order:
In either case the error is reported in an ERR segment. |
false |
|
Fail when unused segment included in message set |
Boolean |
Whether to reject a message when a segment marked as unused is included in a message set:
In either case the error is reported in an ERR segment. |
false |
|
Fail when too many repeats of segment |
Boolean |
Whether to reject a message when a segment occurs too many times in a message set:
In either case, the error is reported in an ERR segment. |
false |
|
HL7 Message segment terminator |
Enumeration, one of:
|
Value for the segment terminator. |
CR |
Connection Type
Operations
Read
<hl7:read>
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Read Content |
Binary |
Input payload. |
|
|
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Reconnection strategy to use. |
Write
<hl7:write>
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Write Content |
Object |
Output payload. |
|
|
Streaming Strategy |
Configures how Mule processes streams. Repeatable streams are the default behavior. |
|||
Target Variable |
String |
The name of a variable that stores the output of the operation. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Reconnection strategy to use. |
Types
Expiration Policy
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
Maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
A time unit that qualifies the Max Idle Time field. |
Forever
Configures a forever reconnection strategy by which the connector operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
Non-Repeatable Stream
Disables the repeatable stream functionality and uses non-repeatable streams to have lower performance overhead, memory use, and cost.
Reconnection
Configures reconnection options.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails deployment when test connection fails |
Boolean |
What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
|
||
Reconnection Strategy |
Reconnection strategy to use. |
Repeatable File Store Stream
Configures the repeatable file store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max In Memory Size |
Number |
Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Max In Memory Size field. |
Repeatable In Memory Stream
Configures the in-memory streaming strategy by which the request fails if the data exceeds the maximum buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by the Buffer Size Increment, with an upper limit of the Max Buffer Size value. |
||
Buffer Size Increment |
Number |
Amount by which the buffer size expands if it exceeds its initial size. Setting a value of |
||
Max Buffer Size |
Number |
Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Max Buffer Size fields. |
Standard
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector operation can make.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Reconnection Attempts |
Number |
How many reconnection attempts the Mule app can make. |