/n software Adapters for BizTalk

Questions / Feedback?

AS2 Transmitter

Setting the AS2 Adapter Configuration Properties for a Dynamic Send Port

A dynamic send port does not provide any transport configuration options in BizTalk Explorer because it is expected that these properties will be provided with the context properties associated with the message. These properties can be set in a custom pipeline or in an orchestration. To set message configuration properties in an orchestration you can do the following:

  • Add a Construct Message shape to your orchestration.
  • Configure the Construct Message shape to construct a new message. (for example Message_2)
  • Add a Message Assignment shape to the Construct Message shape.
  • Add code to the Message Assignment shape to initialize the message that you constructed and to set the appropriate configuration properties for the message.

Configuring the AS2 Send Port with the BizTalk Server Administration Console

To configure the send port by using the BizTalk Server Administration console, use the following procedure:

To configure variables for a AS2 send port:

  1. In the BizTalk Server Administration console, create a new send port or double-click an existing send port to modify it. For more information, see How to Create a Send Port. Configure all of the send port options and specify nsoftware.AS2 2020 for the Type option in the Transport section of the General tab.
  2. On the General tab, in the Transport section, click the Configure button next to Type.
  3. In the nsoftware.AS2 2020 Transport Properties dialog box, use the following properties to:


    AS2From The identity of the sending system.
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    AS2MessageId The Id of the message.
    Type: xs:string    Default Value: "@%MessageId%"
    AS2Subject The subject of the message.
    Type: xs:string    Default Value: ""
    AS2To The identity of the receiving system.
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    AS2Version The version of AS2 being used.
    Type: xs:string    Default Value: "1.1"
    CompressionFormat The compression format (if any) to use.
    Type: xs:int    Default Value: 0
    EDIFileName The name to be used in the Content-Disposition MIME header of the outbound request.
    Type: xs:string    Default Value: "rfc1767.edi"
    EDIType The MIME type of the data.
    Type: xs:string    Default Value: "application/edi-x12"
    EncryptionAlgorithm The algorithm, if any, used to encrypt the EDI data.
    Type: xs:string    Default Value: "3DES"
    Etag The etag of the file.
    Type: xs:string    Default Value: ""
    Firewall A set of properties related to firewall access.
    Type: Firewall    Default Value: null
    From The email address of the HTTP agent (optional).
    Type: xs:string    Default Value: ""
    HTTPPassword A password if authentication is to be used.
    Type: baf:Password    Default Value: ""
    HTTPProxy A set of properties related to proxy access.
    Type: Proxy    Default Value: null
    HTTPUser A user name if authentication is to be used.
    Type: xs:string    Default Value: ""
    LogDirectory The path to a directory for logging.
    Type: xs:string    Default Value: ""
    LogFile The log file written.
    Type: xs:string    Default Value: ""
    MaxThreads The maximum number of threads that the component may consume.
    Type: xs:int    Default Value: 20
    MaxTransmissionBatchSize The maximum number of messages that can be sent in a single batch.
    Type: xs:int    Default Value: 1
    MDN The MDN generated by the component.
    Type: xs:string    Default Value: ""
    MDNMICValue The Message Integrity Check(s) (one-way hash) of the EDI message.
    Type: xs:string    Default Value: ""
    MDNOptions Used to indicate the options requested for the MDN receipt.
    Type: xs:string    Default Value: "signed-receipt-protocol=optional, pkcs7-signature; signed-receipt-micalg=optional, sha-256, sha1"
    MDNTo Used to indicate that a message disposition notification is requested.
    Type: xs:string    Default Value: ""
    Other Defines a set of configuration settings to be used by the component.
    Type: xs:string    Default Value: ""
    ReceiptHeaders The AS2 headers that are returned with the receipt.
    Type: xs:string    Default Value: ""
    ReceiptMessage The textual message that is included in the receipt.
    Type: xs:string    Default Value: ""
    ReceiptSignerCert The certificate of the receipt signer.
    Type: Certificate    Default Value: null
    RecipientCert The certificate of the recipient.
    Type: Certificate    Default Value: null
    RestartDirectory The directory to log cached files when using AS2 restart functionality.
    Type: xs:string    Default Value: ""
    RolloverSigningCert An additional certificate used to sign the outgoing AS2 request when transitioning certificates.
    Type: Certificate    Default Value: null
    NOTE: The digital id must have a private key associated with it.
    RuntimeLicense Specifies the component runtime license key.
    Type: xs:string    Default Value: ""
    SigningCert The certificate used to sign the outgoing AS2 request.
    Type: Certificate    Default Value: null
    NOTE: The digital id must have a private key associated with it.
    SSLAcceptServerCert For sending HTTPS requests, a server certificate to unconditionally accept.
    Type: Certificate    Default Value: null
    SSLCert The certificate to use for client authentication during the SSL handshake.
    Type: Certificate    Default Value: null
    NOTE: The digital id must have a private key associated with it.
    Timeout A timeout for the component.
    Type: xs:int    Default Value: 60
    TransmitBatchMode How the transmitter processes batches.
    Type: xs:int    Default Value: 0
    TransportLog Tells the component where and how to report information about its operations.
    Type: Log    Default Value: null
    URI The Uniform Resource Identifier (URI) of the send port or receive location.
    Type: xs:string    Default Value: ""
    URL The URL to post to.
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    UserAgent Information about the user agent.
    Type: xs:string    Default Value: "IP*Works! AS2 Transmitter - www.nsoftware.com"

  4. Click OK and OK again to save settings.

Copyright (c) 2022 /n software inc. - All rights reserved.
/n software Adapters for BizTalk - Version 20.0 [Build 8319]