Office365Mail Adapter
Properties Configuration Settings
The Office365Mail Component adds Outlook 365 send and receive capabilities to your BizTalk Server.
Remarks
The Office365Mail Adapter provides a simple way to send and receive emails from Microsoft Outlook 365.
Authorization
To perform OAuth authorization first open the OAuth Authorization dialog by clicking the ellipses (...) button of the OAuthAuthorization property at design time. This will open a dialog. Within the dialog specify the ClientId, ClientSecret, and CallbackURL values for the registered application.
After specifying the necessary values press the Authorize button to authorize the application. This will launch a browser and prompt the user to grant access. After access is granted the adapter will populate the following values:
All necessary values will be saved in the CacheLocation for use in subsequent requests by the adapter. The adapter will use the cached values and will automatically refresh the token if needed. In this way any user interaction is only required at design time, not at runtime.Office365Mail Receive Adapter
At runtime the adapter will connect to Outlook 365 every PollingInterval and search the emails on the server. All emails that match the Filter will be downloaded and submitted to the BizTalk Message Engine as individual messages.
Office365Mail Send Adapter
The adapter will connect to Outlook 365 whenever it has a message to send. The contents of the message will be sent in the body of the email, with other fields on the email set through the Message* properties.
Please refer to the section on adapter configuration for a description of how to configure receive locations and send ports for this adapter.
Receiver Property List
The following is the full list of the properties of the receiver adapter with short descriptions. Click on the links for further details.
AttachmentDirectory | Specifies the directory to which attachments are saved. |
DeleteMode | Controls if and when the email is deleted after download. |
ErrorThreshold | The maximum number of errors before the component shuts down. |
Filter | A filter to be applied to the inbox when selecting messages. |
Firewall | A set of properties related to firewall access. |
MailFolder | Name of the mailbox selected on the server. |
MaxThreads | The maximum number of threads that the component may consume. |
MessageCc | A comma separated list of addresses for carbon copies. |
MessageDate | The date a message was sent. |
MessageFrom | The email address of the author of the message. |
MessageHeaders | Message headers associated with the current email message. |
MessageId | The id of the current message. |
MessageSender | The email address of the sender. |
MessageSubject | The subject of the mail message. |
MessageTo | A comma separated list of addresses for destinations. |
OAuthAuthorization | OAuth Authorization Information. |
Other | Defines a set of configuration settings to be used by the component. |
PollingInterval | The amount of time, in seconds, between download attempts. |
RequeueEndpoints | Whether to requeue receive endpoints if the polling interval has not been reached. |
RuntimeLicense | Specifies the component runtime license key. |
Select | The parts of a message that should be retrieved. |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
Timeout | A timeout for the component. |
TransportLog | Tells the component where and how to report information about its operations. |
URI | The Uniform Resource Identifier (URI) of the send port or receive location. |
Sender Property List
The following is the full list of the properties of the sender adapter with short descriptions. Click on the links for further details.
Attachments | Specifies which files the component should include as attachments in the outgoing message. |
BCc | A comma separated list of addresses for blind carbon copies (optional). |
Cc | A comma separated list of addresses for carbon copies (optional). |
DeliveryReceipt | Whether or not a delivery receipt should be returned to the sender. |
Firewall | A set of properties related to firewall access. |
From | The email address of the sender. |
MaxThreads | The maximum number of threads that the component may consume. |
MaxTransmissionBatchSize | The maximum number of messages that can be sent in a single batch. |
MessageBody | The body of the message. |
MessageBodyContentType | The body content type for a message. |
OAuthAuthorization | OAuth Authorization Information. |
Other | Defines a set of configuration settings to be used by the component. |
ReadReceipt | Whether or not a receipt should be sent when the email has been read. |
ReplyTo | A mail address to reply to (optional). |
RuntimeLicense | Specifies the component runtime license key. |
SendTo | A comma separated list of addresses for destinations (required). |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
Subject | The subject of the mail message (optional). |
Timeout | A timeout for the component. |
TransmitBatchMode | How the transmitter processes batches. |
TransportLog | Tells the component where and how to report information about its operations. |
URI | The Uniform Resource Identifier (URI) of the send port or receive location. |
Configuration Settings
The following is a list of configuration settings for the adapter with short descriptions. Click on the links for further details.
AddAttachmentsAsMessageParts | Includes attachments as additional parts on the message. |
AttachmentName[index] | Filename for the attached file (at index). |
AttachmentType[index] | Content-type for attached file (at index). |
ContinueOnAttachmentError | Whether or not to continue processing messages if an attachment download fails. |
DuplicateAttachmentAction | Specifies what action to take when a duplicate filename is encountered. |
FolderPageSize | Determines the number of folders that will be returned from the server at a time when searching. |
IncludeAttachments | Determines if additional message parts are added to the outgoing E-Mail as attachments. |
MessageBodyFile | Specifies a file that will be included as the email's body content. |
MessageImportance | Sets the importance of the message. |
MessagePageSize | Determines the number of messages that will be returned from the server at a time when searching. |
MoveTo | Specifies the folder on the server to which messages will be moved. |
UserId | Sets the Id of the mailbox to connect to when accessing a shared mailbox. |
ReuseSSLSession | Determines if the SSL session is reused. |
SSLCipherStrength | The minimum cipher strength used for bulk encryption. |
SSLEnabledCipherSuites | The cipher suite to be used in an SSL negotiation. |
SSLEnabledProtocols | Used to enable/disable the supported security protocols. |
SSLIncludeCertChain | Whether the entire certificate chain is included in the SSLServerAuthentication event. |
SSLSecurityFlags | Flags that control certificate verification. |
TLS12SignatureAlgorithms | Defines the allowed TLS 1.2 signature algorithms when UseInternalSecurityAPI is True. |
TLS12SupportedGroups | The supported groups for ECC. |
TLS13KeyShareGroups | The groups for which to pregenerate key shares. |
TLS13SignatureAlgorithms | The allowed certificate signature algorithms. |
TLS13SupportedGroups | The supported groups for (EC)DHE key exchange. |