SendMail
SendMail 示例演示如何使用简单邮件传输协议 (SMTP) 适配器在 Microsoft BizTalk Server 业务流程内发送电子邮件。 用于发送电子邮件的动态信息是通过使用属性升级功能从 XML 消息中检索得到的。
本示例使用升级自传入 XML 采购订单 (PO) 消息的属性中的信息来发送电子邮件,其具体的操作步骤如下所示:
BizTalk Server 业务流程检索输入的 XML PO 消息。
BizTalk Server业务流程提升 PONumber 和Email属性,以便将来更易于访问。
BizTalk Server 业务流程使用升级属性的值设置动态发送端口的目标地址和电子邮件的主题。
BizTalk Server 业务流程通过 SMTP 适配器发送构造好的电子邮件。
<示例路径>\AdaptersUsage\SendMail\
下表显示了本示例中的文件及其用途说明:
文件 | 说明 |
---|---|
AssemblyInfo.cs、SendMail.btproj、SendMail.sln | 提供本示例的项目、解决方案和程序集信息文件。 |
Cleanup.bat | 取消部署程序集并将其从全局程序集缓存 (GAC) 中删除;删除发送和接收端口;根据需要删除 Microsoft Internet 信息服务 (IIS) 虚拟目录。 |
PropertySchema.xsd、PurchaseOrder.xsd | 分别为要升级的属性和 XML PO 消息提供架构。 |
ReceiveSend.odx | 提供用于处理传入 XML PO 消息并根据消息中的信息发送电子邮件的 BizTalk Server 业务流程。 |
SendMailInput.xml | 包含具有使用 XML 指定的 PO 的示例输入文件。 |
Setup.bat | 生成并初始化本示例。 注意: 此安装文件使用与 SDK 示例的大多数安装文件不同的机制创建和绑定端口等。 它不需要 companion .xml 文件。 |
在命令窗口中,导航到下面的文件夹:
<示例路径>\AdaptersUsage\SendMail
运行 Setup.bat 文件,该文件将执行以下操作:
为本示例创建以下输入文件夹:
<示例路径>\AdaptersUsage\SendMail\In
为本示例编译 Visual Studio 项目。
启动 BizTalk Server 业务流程。
备注
在尝试运行本示例之前,应确认在生成和初始化过程中 BizTalk 未报告任何错误。
备注
如果选择在不运行 Setup.bat 文件的情况下打开并生成本示例中的项目,则必须首先使用 .NET Framework 强名称实用工具 (sn.exe) 创建一个强名称密钥对。 使用此密钥对对对生成的程序集进行签名。
备注
若要撤消 Setup.bat 所做的更改,请运行 Cleanup.bat 并删除所有前缀为 SendMail_1.0.0.0.0_Microsoft.Samples.BizTalk.SendMail 的接收和发送端口。 第二次运行 Setup.bat 之前,必须运行 Cleanup.bat。
在BizTalk Server管理控制台中,找到前缀为 SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail 的接收端口。 更新此接收端口的接收位置,使其指向文件系统上要用作输入位置的目录。
使用记事本等程序修改文件 SendMailInput.xml,以便Email元素指定要接收此示例生成的电子邮件的合法电子邮件地址。
单击“开始”,指向“程序”,指向“Microsoft BizTalk Server 20xx”,然后单击“BizTalk Server管理”。
在BizTalk Server管理控制台中,展开 BizTalk 组树。
展开左窗格中的 “平台设置” 树。
展开 “适配器 ”文件夹,单击 SMTP 节点,然后双击右窗格中的 SMTP 适配器行。
在 “SMTP - 适配器处理程序属性 ”对话框中,单击“ 属性”。
在“SMTP 传输属性”对话框中的“属性”选项卡上,为 SMTP 服务器名称和“发件人 (电子邮件地址) 属性”提供适当的值,然后单击“确定”。
这些值将用于构造通过此 SMTP 适配器发送的任何电子邮件的发件人电子邮件地址。
备注
如果需要向 SMTP 服务器进行身份验证,必须确保发件人电子邮件地址属于用于身份验证的同一帐户。
(BizTalkServerApplication) 停止并重启 BizTalk 服务,以便业务流程采用这些更改。
将修改的 SendMailInput.xml 文件的副本放到输入文件夹下。
观察电子邮件到达上一过程中指定的电子邮件地址。