使用 Office 365 Outlook Email 适配器发送和接收电子邮件 - BizTalk Server

项目
07/21/2023

Office 365 Outlook Email 适配器允许从 BizTalk Office 365 Outlook Email发送和接收邮件。

使用发送端口发送邮件

在BizTalk Server管理控制台中，右键单击“发送端口”，选择“新建”，然后选择“静态单向发送端口”。

创建发送端口提供了一些指导。
输入“名称”。在“传输”中，将“类型”设置为“Office 365 Outlook Email”，然后选择“配置”。
选择“登录...”，然后登录到Office 365帐户。帐户会自动填充你的电子邮件地址。
允许BizTalk Server审批访问权限：
配置 Office 365 Outlook Email“常规”属性：
- To：输入默认的“到”邮件地址，用“;”分隔 (最大) 256 个字符
- 抄送：输入默认的抄送邮件地址，以“;”分隔 (最大) 256 个字符
- 主题：提及默认邮件主题。 (最多 256 个字符)
- 重要性：选择重要性值。下拉列表包含值 Low、 Normal 和 High ，默认值为 Normal 。
完成后，属性如下所示：
配置 Office 365 Outlook Email 附件属性：

要发送的电子邮件的正文对应于 BizTalk 消息的正文部分。若要向电子邮件添加附件，请执行以下操作：
- 附加 BizTalk 消息部分：如果选中，BizTalk 消息非正文部分将作为附件添加到发送的电子邮件中。
- 文件：指定将一个或多个文件附加到电子邮件以及一个或多个文件的完整路径。主机必须在运行时访问适配器的一个或多个指定路径。默认值：空。
选择某些文件后，附件属性如下所示：
选择“ 确定” 保存更改。

重要详细信息

也可以使用提升的属性更新默认属性：

属性名称升级的属性

To OfficeMail.To

CC OfficeMail.CC

主题 OfficeMail.Subject

重要性 OfficeMail.Importance

附加文件 OfficeMail.AttachedFiles
OfficeMail.AttachedFiles 属性值是不同文件之间以“|”作为分隔符的文件列表。例如：“C:\Attachments\File1.pdf|C:\Attachments\File2.xml”。
BizTalk 邮件正文部分的 ContentType 属性可以设置为“Text”或“Html”，以指示电子邮件正文的类型。默认情况下，它将为“Text”。
附加多部分 BizTalk 消息的各个部分时，部件的 ContentType 属性（如果提供）将用作所创建附件的 MIME 类型。默认情况下，附件的 MIME 类型设置为“application/octet-stream”。
附加文件时，附件的 MIME 类型取决于文件扩展名。默认 MIME 类型为“application/octet-stream”。

属性名称	升级的属性
To	OfficeMail.To
CC	OfficeMail.CC
主题	OfficeMail.Subject
重要性	OfficeMail.Importance
附加文件	OfficeMail.AttachedFiles

测试发送端口

可以使用简单的文件接收端口和位置将邮件发送到Office 365 Outlook Email。

使用文件适配器创建接收端口。在接收位置中，将 Receive 文件夹 设置为 C：\Temp\In\，并将文件掩码设置为 *.xml。
在Office 365 Outlook Email适配器发送端口属性中，将“筛选器”设置为 BTS.ReceivePortName == <Receive Port Name>。

将以下内容粘贴到文本编辑器中，并将文件另存为 Office365Mail.xml。这是你的示例消息。

<ns0:Root xmlns:ns0="http://BizTalk_Server_Project1.Schema1"> 
    <Record> 
        <Name>BizTalk User</Name> 
        <ID>001</ID> 
    </Record> 
</ns0:Root>

启动文件接收位置和 outlook Email 适配器发送端口Office 365。
将Office365Mail.xml 示例邮件复制到接收文件夹中 (C：\Temp\In\) 。发送端口将 XML 文件作为邮件正文发送到Office 365 Outlook Email。在端口配置的“附件”选项卡中指定的文件将附加到电子邮件。

发送处理程序中的其他配置

从 BizTalk Server 2020 累积更新 4 开始可用。

您可以调整Office 365 Outlook Email 适配器在主机实例中的所有发送端口上一次发送的最大电子邮件数。默认情况下，该值设置为 20，可以通过在 Office 365 Outlook Email 适配器的发送处理程序属性中设置最大并发发送属性来更改该值。

在 BizTalk Server 管理控制台中，依次展开“BizTalk Server 管理”、“BizTalk 组”、“平台设置”和“适配器”。
在展开的适配器列表中，单击“Office365 Outlook Email”。
在右窗格中，右键单击要配置的发送处理程序，然后单击“属性”。
设置 最大并发发送 属性。
选择“ 确定” 保存更改。

使用接收端口接收电子邮件

在BizTalk Server管理控制台中，右键单击“接收端口”，选择“新建”，然后选择“单向接收端口”。

创建接收端口提供了一些指导。
输入名称，然后选择“ 接收位置”。
选择“ 新建”，并为接收位置命名。在“传输”中，从“类型”下拉列表中选择“Office 365 Outlook Email”，然后选择“配置”。
选择“登录...”，然后登录到Office 365帐户。帐户会自动填充你的电子邮件地址。
允许BizTalk Server审批访问权限：
配置 终结点常规 属性：
- 文件夹：选择要获取电子邮件的文件夹。默认文件夹为“收件箱”。请注意，文件夹本质上不是递归的。例如，不会检索来自子文件夹的电子邮件。
- 开始时间：输入如何从Office 365接收电子邮件。此值指示Office 365 Outlook 中电子邮件的 receivedTimeStamp。接收的Email比输入的值更新。
- 仅限未读邮件：选中此项以仅读取未读电子邮件。保持未选中状态可阅读所有电子邮件。
- 发布操作：选择要在阅读电子邮件后执行的发布操作。 “无 ”是默认设置，BizTalk 收到电子邮件后不执行任何工作。 标记为已读 意味着 BizTalk 收到电子邮件后，邮箱中的电子邮件将标记为已读。删除意味着，BizTalk 收到电子邮件后，邮箱中的电子邮件将被删除。后操作是尽最大努力执行的。
完成后，属性将如下所示：
从 BizTalk Server 2020 和更新) 开始配置终结点有效负载属性 (可用：
- 传递 MIME：保存电子邮件的 MIME 表示形式。 MIME 内容包括电子邮件正文和所有附件。
- 处理内容：保存电子邮件正文。默认情况下为选中。电子邮件正文的内容类型保存在创建的 BizTalk 邮件的 ContentType 属性中。
- 包含附件：将电子邮件附件保存为 BizTalk 邮件的一部分。默认情况下，它处于未选中状态。每个 BizTalk 消息部件的 ContentType 属性设置为附件的 MIME 类型。 Outlook 项目 (电子邮件、日历事件、联系人) 的附件保存在其 MIME 表示形式中。
完成后，属性将如下所示：
选择“ 确定” 以保存更改。

测试接收设置

可以使用简单的文件发送端口从Office 365 Outlook Email接收邮件。

使用文件适配器创建发送端口。在发送端口属性中，将 “目标”文件夹 设置为 C：\Temp\Out\，并将和 文件名 设置为 %MessageID%.xml。
在“文件发送端口”属性中，将 “筛选器” 设置为 BTS.ReceivePortName == <Receive Port Name>。
启动Office 365 Outlook Email接收位置和文件发送端口。
在目标文件夹中查找 (c：\temp\out) 的邮件。

从接收管道提升的属性

默认情况下，接收管道中的以下属性将升级：

属性名称	升级的属性
重要性	OfficeMail.ReceivedMailImportance
主题	OfficeMail.ReceivedMailSubject
SenderName	OfficeMail.SenderName
SenderAddress	OfficeMail.SenderAddress
HasAttachments	OfficeMail.HasAttachments

后续步骤

查看所有Office 365适配器。