AS4 Connector

Properties   Configuration Settings  

The AS4 Component adds AS4 send and receive capabilities to MuleSoft.

Remarks

The AS4 Connector adds AS4 send and receive capabilities to Mule Project. Using a simple application-like design, the connector allows you to easily incorporate secure EDI (EDI-INT) exchange into your current e-Business process architecture.

Sending AS4 Messages

Outgoing AS4 messages are managed with the Send connector. In order to use the connector, you must specify AS4FromId, AS4ToId, and a URL. Optionally set the SigningCert and RecipientCert to enable signing and encryption. Optionally specify a SignerCert to verify the signature on the response.

Additional properties such as EDIFileName, EDIType, Profile, and more, may also be set.

HTTP/2 is supported on Windows 8.1/Server 2012 R2 or later. If HTTP/2 is used on a version of Windows prior to these versions the connector throws an exception.

Note: HTTP/2 is currently only supported on Windows.

The AS4 Send connector is a Solicit-Response connector and the resulting Mule event will contain the receipt returned by the server if RequireReceipt is True (default).

AS4 Send Example

To get started, add a File Read connector to your flow and configure it to read a target EDI file. Behind the File Read connector, add an AS4 Send module. There is no need to transform the output of the File Read connector before passing it to the AS4 Send module.

All that is left is to configure the connection settings and certificates. The connector will handle sending the AS4 message and receiving a synchronous receipt. The MessageId and ReceiptContent is available in the output attributes.MessageId and attributes.ReceiptContent fields respectively.

Receiving AS4 Messages

The AS4 Receive connector will establish a connection to a server and request messages to download from the specified MPC. If SendReceipt is True (default) the connector will automatically generate a receipt and send it with the next request.

To decrypt the incoming files, set the DecryptionCert property. The SignerCert property specifies the public certificate to use when verifying the signature of received files. Receipts will be signed using the certificate specified by SigningCert.

The connector works by polling the server for files available to download. The polling settings can be found in the "General" tab of the Mule properties page for the connector. During each polling interval the connector will attempt to download all files present in a MPC. Each file will generate a Mule event.

AS4 Receive Example

Add an AS4 Receive source connector to your flow and configure the connection settings and certificates. That is all that is required to get started. The connector will handle connecting to the server and requesting files to download from the specified MPC. One Mule event is generated for each file downloaded.

Behind the AS4 Receive connector you can add a File Write connector to write each file to disk. You will need to dynamically set the Path property on the File Write connector to accomplish this. Click the Mule expression indicator on the Path property and set the value to:

'C:\\temp\\' ++ attributes.ReceivedFileName

The received filename will then be used as the same filename on disk. The content of each file will be present in the payload of the Mule Message. That is all that is required to write an incoming file to disk. Additional properties about the EDI data are also available in the attributes collection.