如何:使用 LDAP 查询创建路线以动态将邮件路由到电子邮件地址

目标

本部分演示如何创建一个路线,该路线通过 LDAP(轻型目录访问协议)查询电子邮件地址,然后使用 BizTalk Server SMTP 适配器将电子邮件发送到解析的终结点。

在本指南中,你将完成以下步骤:

  • 创建一个行程路由单,以通过 LDAP 查询动态分发消息。

  • 使用“行程测试客户端”示例应用程序测试行程。

先决条件

本作指南主题中的过程需要完成 开发活动的先决条件

完成本部分的计算机必须配置并运行 Microsoft Active Directory 目录服务(计算机不是域控制器,但必须连接到域)。 此外,必须配置并运行 SMTP 服务器。为了测试此操作指南的效果,您需要一个客户端来检查 ESB 发送的电子邮件。

本部分中的说明假定名为 Global Bank 的组织,其域为 globalbank.com,Active Directory 组织单位名为 Employees,其中包含一个名为 John Evans 的用户,其个人资料中具有有效电子邮件地址(例如 johne@globalbank.com)。 不需要复制这些环境因素:但是,出于在环境中重新创建此实现的目的,请考虑这些因素,并在必要时进行替换。

步骤

创建领域专用的 ESB 行程语言(DSL)模型

  1. 在 Visual Studio 中,打开 C:\HowTos\Patterns\Patterns.sln。

  2. 在解决方案资源管理器中,右键单击 “行程库 ”项目,指向 “添加”,然后单击“ 新建路线”。

  3. 在“添加新项”对话框中,在“名称”框中键入 LdapResolution,然后单击“添加”。

配置行程的属性

  1. 在 Visual Studio 中,单击 LdapResolution.行程的设计界面。 在 LdapResolution 属性窗口中,配置以下属性:

    1. “模型导出程序 ”下拉列表中,单击“ XML 行程导出程序”。

    2. “扩展程序设置” 部分的 “行程 XML 文件 ”属性旁边,单击省略号按钮(...)。

    3. “选择 XML 文件”对话框中,在“文件名”框中键入 C:\HowTos\Itineraries\LdapResolution,然后单击“保存”。

      注释

      此步骤使你可以将行程导出为 XML 到本地文件位置。 通过将行程导出到本地文件位置而不是行程数据库,可以使用 ESB 测试客户端应用程序测试行程。 稍后将完成本作说明主题中的此过程。

定义行程的结构

  1. 从工具箱中,将 On-Ramp 模型元素拖到设计图面。 在 OnRamp1 “属性”窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 ReceiveNAOrder

    2. “扩展程序 ”下拉列表中,单击“ On-Ramp ESB 扩展程序”。

    3. BizTalk 应用程序 下拉列表中,单击 Microsoft.Practices.ESB

    4. 接收端口下拉列表中,单击OnRamp.Itinerary

  2. 从工具箱中,将 “路线服务” 模型元素拖到设计图面,然后将其置于 On-Ramp 模型元素的右侧。 在 “ItineraryService1 属性”窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 RouteMessageEmail

    2. “行程服务扩展程序 ”下拉列表中,单击“ 消息传递扩展程序”。

      注释

      此属性定义进程将在管道(消息传送)中发生。 或者,如果进程将在业务流程中进行,请将 行程服务扩展程序 属性设置为 业务流程扩展程序

    3. “容器”下拉列表中,展开ReceiveNAOrder,然后单击“接收处理程序”

    4. “服务名称 ”下拉列表中,单击 Microsoft.Practices.ESB.Services.Routing

  3. 右键单击 RouteMessageEmail 模型元素的 Resolver 集合,然后单击“添加新冲突解决程序”。 在 Resolver1 “属性”窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 LdapResolver

    2. “解析程序实现 ”下拉列表中,单击 “LDAP 解析程序扩展”。

    3. “传输名称 ”下拉列表中,单击 “SMTP”。

    4. 单击 “传输位置” 属性,然后键入 {mail}

    5. 单击 SearchRoot 属性,然后键入 ou=Employees,dc=globalbank,dc=com

      注释

      如果尚未根据“先决条件”部分中的规范设置环境,请将上述属性中的值替换为适合你的环境的值。

    6. 单击 Filter 属性,然后将值更改为 (&(objectClass=User)(|)givenName=john))

      注释

      键入上述值以替换现有文本。

    7. ThrowErrorIfNotFound 下拉列表中,单击 “True”。

  4. 在“属性”窗口中,单击 “终结点配置” 属性,然后单击省略号按钮(...)。

    1. “终结点配置 ”对话框中,单击 EmailBodyText 属性,然后键入 Order 即可进行处理

    2. 单击 From 属性,然后键入 orders@globalbank.com

    3. 单击 MessagePartsAttachment 属性,然后键入 2

    4. 单击“主题”属性,然后键入“订单 {givenName}”

    5. 使用本地环境的连接信息配置 SMTPAuthentication、SMTPHost、UserName密码 属性。

    6. 单击“ 确定 ”关闭 “终结点配置 ”对话框。

  5. 右键单击 LdapResolver 解析程序,然后单击 “测试解析程序配置”。

  6. 在“输出”窗口中,验证解析的 终结点配置 值中的主题是否为 John 订单,然后验证解析的 传输位置 是否是与 Active Directory 中用户帐户关联的电子邮件地址(例如, johne@globalbank.com) 。

  7. 在工具箱中,单击“ 连接器”。 从 ReceiveNAOrder 模型元素拖动连接到 RouteMessageEmail 模型元素。

  8. 从工具箱中,将 Off-Ramp 模型元素拖到设计图面,然后将其置于 RouteMessageEmail 模型元素的右侧。 在 OffRamp1 “属性”窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 EmailNAOrderDoc

    2. “扩展程序 ”下拉列表中,单击 Off-Ramp ESB 扩展程序

    3. BizTalk 应用程序 下拉列表中,单击 GlobalBank.ESB

    4. “发送端口 ”下拉列表中,单击 DynamicResolutionOneWay

  9. 从工具箱中,将 路线服务 模型元素拖到设计图面,然后将其放在 RouteMessageEmail 模型元素和 EmailNAOrderDoc 模型元素之间。 在 “ItineraryService1 属性”窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 SendPortFilter

    2. “行程服务扩展程序 ”下拉列表中,单击 Off-Ramp 扩展程序

    3. Off-Ramp 下拉列表中,展开 EmailNAOrderDoc,然后单击“ 发送处理程序”。

  10. 在工具箱中,单击“ 连接器”。 将 RouteMessageEmail 模型元素的连接拖到 SendPortFilter 模型元素。

  11. 在工具箱中,单击“ 连接器”。 将连接从 SendPortFilter 模型元素拖到 EmailNAOrderDoc 模型元素。

导出模型以用于路线测试客户端

  1. 在 Visual Studio 中,右键单击 LdapResolution 路线的设计图面,然后单击“ 导出模型”。

    注释

    将在 Visual Studio 中打开行程的 XML 版本。

  2. 保存所有项目工件。

  3. 在 Windows 资源管理器中,浏览到 C:\HowTos\Itineraries and notice the creation of your itinerary XML (LdapResolution.xml)。

测试行程

  1. 使用在 开发活动的先决条件 (C:\HowTos\ESB.Itinerary.Test.exe - 快捷方式)中创建的快捷方式打开行程测试客户端示例应用程序。

  2. 在“路线测试客户端”中,清除“ 使用 WCF 服务 ”复选框,然后单击“ 加载路线”。

  3. “打开路线文件 ”对话框中,浏览到 C:\HowTos\行程。 选择 LdapResolution.xml,然后单击“ 打开 ”加载行程。

  4. 单击“ 确定 ”以清除“ 成功加载路线 ”消息。

  5. 在“行程测试客户端”中,单击 “加载消息 ”框旁边的省略号按钮(...)。

  6. “选择要加载的 XML 文档 ”对话框中,浏览到 C:\HowTos。 选择 NAOrderDoc.xml,然后单击“ 打开 ”以加载测试消息。

  7. 单击“ 提交请求 ”按钮。 测试完成后,单击“ 确定 ”以消除出现的确认。

  8. 打开Microsoft Outlook Express(或所选的邮件客户端),并验证邮件发送到 John Evans 的电子邮件。

其他资源

有关详细信息,请参阅下列相关主题: