Receive
Starts an MLLP server that collects incoming HL7 messages for the configured duration.
Task version: 1.2.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.Receive
Task Parameters
ListenAddress : String
IP address or hostname to bind to. Leave empty to listen on all interfaces.
Default: -
Example: 127.0.0.1
Port : Int32
TCP port the server listens on.
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
ServerCertPath : String
Path to the server certificate file (PFX or P12 format).
Required only for MTLS mode.
Default: -
Example: C:\certs\client.pfx
🗝ServerCertPassword : String
Password for the server certificate.
Default: -
Example: MyStrongPassword123
ListenDurationSeconds : Int32
How long the listener waits for incoming messages before shutting down. Value in seconds.
Default: 30
Example: 30
BufferSize : Int32
Size of the buffer used when reading data from clients.
Default: 8192
Example: 8192
SendAcknowledgement : Boolean
Whether to send a simple acknowledgement for each message.
Default: True
Example: true
AcknowledgementMessage : String
Payload of the acknowledgement message. Wrapped in MLLP start/end characters automatically.
Default: AA
Example: ACK
IgnoreClientCertificateErrors : Boolean
If enabled, the server will accept client certificates even if they are
self-signed or have validation errors (Mutual TLS only).
Default: False
Example: false
ClientCertificateThumbprints : String[]
Expected client certificate thumbprint(s) for validation.
Only used when IgnoreClientCertificateErrors is false.
Used in MTLS mode for certificate pinning.
Default: -
Example: E5FA62B8B5F3B0B2B3B4B5B6B7B8B9B0B1B2B3B
Encoding : FileEncoding
Encoding used to read incoming HL7 messages.
Possible values:
UTF8: Encoding used to read incoming HL7 messages.Default: Encoding used to read incoming HL7 messages.ASCII: Encoding used to read incoming HL7 messages.Unicode: Encoding used to read incoming HL7 messages.Windows1252: Encoding used to read incoming HL7 messages.Other: Encoding used to read incoming HL7 messages.
Default: 0
Example: FileEncoding.UTF8
EncodingInString : String
Custom encoding name, used when Encoding is set to Other.
Default: -
Example: iso-8859-1
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[]
Messages received while the listener was running.
Example: ACK
Error : Error
Error that occurred during task execution.
Example: object { string Message, Exception AdditionalInfo }
Task Changelog
Changelog for Task Frends.Mllp.Receive.
[1.2.0] - 2026-04-17
Added
Connection.ClientCertificateThumbprintsproperty to specify client certificate thumbprints for authentication in MTLS mode
[1.1.0] - 2026-04-13
Added
Connection.Encodingis now selectable and can be set custom by user
[1.0.0] - 2026-02-06
Added
Initial implementation
Last updated
Was this helpful?