Send
Sends a single HL7 message via MLLP.
Task version: 1.3.0
Required Frends version: 5.7+
Required .NET version: 8.0
Compatible Agents: Crossplatform
Source code: https://github.com/FrendsPlatform/Frends.Mllp/tree/main/Frends.Mllp.Send
Task Parameters
Hl7Message : String
HL7 message to send over MLLP.
Default: MSH|^&|SendingApp|SendingFac|ReceivingApp|ReceivingFac|20250101010101||ADT^A01|MSG00001|P|2.5.1\rEVN|A01|20250101010101\rPID|1||12345^^^Hospital^MR||Doe^John||19800101|MMSH|^\&|SendingApp|SendingFac|ReceivingApp|ReceivingFac|20250101010101||ADT^A01|MSG00001|P|2.5.1\rEVN|A01|20250101010101\rPID|1||12345^^^Hospital^MR||Doe^John||19800101|M
Host : String
Hostname or IP address of the MLLP listener.
Default: 127.0.0.1
Example: 127.0.0.1
Port : Int32
TCP port of the MLLP listener.
Default: 2575
Example: 2575
TlsMode : TlsMode
The TLS encryption mode to use for the connection.
Possible values:
None: The TLS encryption mode to use for the connection.Mtls: The TLS encryption mode to use for the connection.
Default: 0
Example: TlsMode.None
ClientCertPath : String
Path to the client certificate file (PFX or P12 format).
Required only for MTLS mode.
Default: -
Example: C:\certs\client.pfx
🗝ClientCertPassword : String
Password for the client certificate.
Default: -
Example: MyStrongPassword123
ConnectTimeoutSeconds : Int32
Connection timeout in seconds when opening the socket.
Default: 30
Example: 30
ReadTimeoutSeconds : Int32
Read timeout in seconds when waiting for an acknowledgement.
Default: 30
Example: 30
IgnoreServerCertificateErrors : Boolean
If enabled, the task will ignore server-side certificate validation errors.
(e.g., self-signed certificates or hostname mismatches).
Default: False
Example: false
ServerCertificateThumbprints : String[]
Expected server certificate thumbprint(s) for validation.
Only used when IgnoreServerCertificateErrors is false.
Used in MTLS mode for certificate pinning.
Default: -
Example: E5FA62B8B5F3B0B2B3B4B5B6B7B8B9B0B1B2B3B4
Encoding : FileEncoding
Encoding used to encode the HL7 message before sending.
Possible values:
UTF8: Encoding used to encode the HL7 message before sending.Default: Encoding used to encode the HL7 message before sending.ASCII: Encoding used to encode the HL7 message before sending.Unicode: Encoding used to encode the HL7 message before sending.Windows1252: Encoding used to encode the HL7 message before sending.Other: Encoding used to encode the HL7 message before sending.
Default: 0
Example: FileEncoding.UTF8
EncodingInString : String
Custom encoding name, used when Encoding is set to Other.
Default: -
Example: iso-8859-1
ValidateWithNhapi : Boolean
Validate and normalize the HL7 payload using NHapi before sending.
Default: True
Example: true
ExpectAcknowledgement : Boolean
Read the acknowledgement from the listener after sending the message.
Default: True
Example: true
ThrowErrorOnFailure : Boolean
Whether to throw an error on failure.
Default: True
Example: false
ErrorMessageOnFailure : String
Overrides the error message on failure.
Default: -
Example: Custom error message
Task Result
Success : Boolean
Indicates if the task completed successfully.
Example: true
Output : String
Acknowledgement returned by the MLLP listener.
Example: MSH|^~&|...
Error : Error
Error that occurred during task execution.
Example: object { string Message, Exception AdditionalInfo }
Task Changelog
Changelog for Task Frends.Mllp.Send.
[1.3.0] - 2026-04-17
Added
Connection.ServerCertificateThumbprintsto allow pinning the expected server certificate in MTLS mode whenIgnoreServerCertificateErrorsisfalse
[1.2.0] - 2026-04-13
Changed
Connection.Encodingis now selectable and can be set custom by user
[1.1.0] - 2026-03-12
Added
Connection.Encodingparameter to allow configuring the character encoding used when sending HL7 messages (default:UTF-8)
[1.0.0] - 2026-02-05
Added
Initial implementation
Last updated
Was this helpful?