/n software Adapters for BizTalk

Questions / Feedback?

Email Transmitter

Setting the Email 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 Email 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 Email 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.Email 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.Email 2020 Transport Properties dialog box, use the following properties to:


    Attachments Specifies which files the component should include as attachments in the outgoing message.
    Type: xs:string    Default Value: ""
    AuthMode The authentication mode to be used when connecting to the MailServer .
    Type: xs:int    Default Value: 0
    BCc A comma separated list of addresses for blind carbon copies (optional).
    Type: xs:string    Default Value: ""
    Cc A comma separated list of addresses for carbon copies (optional).
    Type: xs:string    Default Value: ""
    ConnectionLifetime Instructs the component whether or not to leave the connection to the server open.
    Type: xs:int    Default Value: 0
    DeliveryReceipt Whether or not a delivery receipt should be returned to the sender.
    Type: bool    Default Value: false
    Firewall A set of properties related to firewall access.
    Type: Firewall    Default Value: null
    From The email address of the sender (required).
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    MaxPersistentConnections The maximum number of simultaneous persistent connections when sending.
    Type: xs:int    Default Value: 1
    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
    MessageHeaders Message headers associated with the current email message.
    Type: xs:string    Default Value: ""
    MessageHTML The HTML text of the message.
    Type: xs:string    Default Value: ""
    MessageText The text of the mail message (optional).
    Type: xs:string    Default Value: ""
    OAuthAuthorization OAuth Authorization Information.
    Type: OAuthAuthorizationParam    Default Value: null
    Other Defines a set of configuration settings to be used by the component.
    Type: xs:string    Default Value: ""
    Password A password for login.
    Type: baf:Password    Default Value: ""
    ReadReceipt Whether or not a receipt should be sent when the email has been read.
    Type: bool    Default Value: false
    ReplyTo A mail address to reply to (optional).
    Type: xs:string    Default Value: ""
    RuntimeLicense Specifies the component runtime license key.
    Type: xs:string    Default Value: ""
    SendTo A comma separated list of addresses for destinations (required).
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    SMTPMessageId The id of the mail message (optional).
    Type: xs:string    Default Value: ""
    SMTPPort The server port for SMTP (default 25).
    Type: xs:int    Default Value: 25
    SMTPServer The name or address of a mail server (mail relay).
    Type: xs:string    Default Value: ""
    NOTE: This property must be specified.
    SSLAcceptServerCert Instructs the component to unconditionally accept the server certificate that matches the supplied certificate.
    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.
    SSLStartMode Determines how the component starts the SSL negotiation.
    Type: xs:int    Default Value: 0
    Subject The subject of the mail message (optional).
    Type: xs:string    Default Value: ""
    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: ""
    User A user id for login.
    Type: xs:string    Default Value: ""

  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]