演练：模块 1 - 使用 Windows SharePoint Services 适配器发送和接收消息

项目
07/21/2023

本演练介绍如何配置 Windows SharePoint Services 和 BizTalk Server，以便可以使用 Windows SharePoint Services 适配器和基于内容的路由 (CBR) 来发送和接收消息。基于内容的路由消除了订阅明确绑定到特定端口的消息的必要。同时为那些需要根据信封属性或仅根据接收端口配置属性路由消息的用户提供了更多的灵活性。有关 Windows SharePoint Services 适配器的简介，请参阅什么是 Windows SharePoint Services 适配器？。

必备条件

以下为执行本主题中步骤的前提条件：

必须具有在 Windows Server 2008 SP2 或 Windows Server 2008 R2 上运行BizTalk Server的完整安装的单服务器部署。

有关在多服务器部署中使用 Windows SharePoint Services 适配器的信息，请参阅设置和部署 Windows SharePoint Services 适配器。

配置Windows SharePoint Services

在此过程中，将创建一个包含三个文档库的 SharePoint 顶级网站。 Windows SharePoint Services 适配器使用这些库将消息从源库移动到目标库。此消息还会在文档库中存档。必须执行此过程，以提供 Windows Sharepoint Services 适配器在本演练中所访问的 Windows Sharepoint Services 站点，并设置用户权限使用户能访问此站点。

创建 Windows SharePoint Services 站点

单击 “开始”，指向 “所有程序”，指向 “管理工具”，然后单击“ SharePoint 管理中心”。
在 “虚拟服务器配置”下，单击“ 创建顶级网站”。
在“虚拟服务器列表”下，选择安装了 Windows SharePoint Services 适配器的网站。例如，Default Web Site。
在 “网站地址” 部分的 “URL 名称 ”字段中，键入 WSSAdapterWalkthrough。
在 “网站集所有者” 部分的“ 用户名”字段中， 键入用户名。此用户将是该网站的所有者，不需要在 BizTalk Server 中具有特殊权限。
在 “网站集所有者 ”部分的 “电子邮件” 字段中，键入电子邮件地址。
单击 “确定” 。
在“ 已成功创建顶级网站” 页上，单击刚刚创建的新顶级网站。例如，http://<server_name>/sites/WSSAdapterWalkthrough。
从模板列表中选择 “工作组网站 ”模板，然后单击“ 确定”。这将打开工作组网站主页。

创建“Source”文档库

在团队网站主页的顶部导航栏上，单击“ 创建”。
在 “文档库”下，单击“ 文档库”。
在 “名称和说明” 部分的 “名称”字段中， 键入 Source。
在 “导航 ”部分中，选择“ 是 ”，在“快速启动”栏上显示此窗体库。
在“文档模板”部分的“文档模板”下拉列表中，选择。None
单击“创建”。此时将创建该文档库，并且您将重定向到该空库。

创建“Destination”文档库

在团队网站主页的顶部导航栏上，单击“ 创建”。
在 “文档库”下，单击“ 文档库”。
在 “名称和说明” 部分的 “名称”字段中，键入 Destination。
在 “导航 ”部分中，选择“ 是 ”，在“快速启动”栏上显示此窗体库。
在“文档模板”部分的“文档模板”下拉列表中，选择。None
单击“创建”。此时将创建该文档库，并且您将重定向到该空库。

创建“Archive”文档库

在团队网站主页的顶部导航栏上，单击“ 创建”。
在 “文档库”下，单击“ 文档库”。
在 “名称和 说明”部分的 “名称”字段中，键入 Archive。
在 “导航 ”部分中，选择“ 是 ”，在“快速启动”栏上显示此窗体库。
在“文档模板”部分的“文档模板”下拉列表中，选择。None
单击“创建”。此时将创建该文档库，并且您将重定向到该空库。
WSSAdapterWalkthrough关闭网站。
关闭 SharePoint 管理中心 网站。

配置 Windows 安全性

单击 “开始”，指向 “所有程序”，指向 “管理工具”，然后单击“ 计算机管理”。
在控制台树中，展开“本地用户和组”，然后单击“组”。
右键单击“ SharePoint 已启用的主机” 组，单击“ 添加到组”，然后单击“ 添加”。
在“选择用户、计算机或组”对话框中，在“输入要选择的对象名称”下，键入配置BizTalk Server主机实例运行的帐户的名称，然后单击“确定”。
在控制台树中，展开“ 服务和应用程序”，然后单击“ 服务”。
右键单击“ BizTalk 服务 BizTalk 组： <BizTalk_Host_Name>”，然后单击“ 重启”。

注意

<BizTalk_Host_Name> 是主机的名称。默认情况下，这是 BizTalkServerApplication。

注意

在重新启动服务之前，成员身份将不会生效。
关闭 “计算机管理”。

配置 SharePoint 安全性

打开 Web 浏览器并导航到所创建站点的 URL。例如，http://<server_name>/sites/WSSAdapterWalkthrough。
在工作组网站主页的顶部导航栏上，单击“网站设置”。
在 “管理”下，单击“ 管理用户”。
单击“添加用户”。
在“步骤 1：选择用户”中，键入运行主机实例BizTalk Server帐户的名称。
在“步骤 2：选择网站组”中，选择“读者”和“参与者检查框。
单击“下一步”。
清除“发送以下电子邮件，让这些用户现在已添加到检查”框，然后单击“完成”。
WSSAdapterWalkthrough关闭网站。

创建和配置 BizTalk Server 端口

在此过程中，您将为 Windows SharePoint Services 适配器创建和配置 BizTalk Server 接收端口、接收位置和发送端口。这些端口是 BizTalk Server 的出入点，Windows Sharepoint Services 适配器通过它们来接收和发送文档。

创建接收端口

依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”，然后单击“BizTalk Server管理”。
依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，右键单击“接收端口”，单击“新建”，然后单击“单向接收端口...”
在“接收端口属性”对话框中的“常规”下，键入FromSource“名称”字段。
单击 “确定” 。

创建接收位置

在 BizTalk 管理控制台中，右键单击“ 接收位置” 节点，单击“ 新建”，然后单击“ 单向接收位置”。
在 “选择接收端口 ”对话框中，选择 FromSource，然后单击“ 确定”。
在“接收位置属性”对话框中的“常规”下，键入SourceLocation“名称”字段。
在“传输”部分的“类型”下拉列表中，选择。Windows``SharePoint``Services
单击“配置”以配置Windows SharePoint Services适配器属性。
在“适配器 Web 服务端口”属性中，键入安装了 Windows SharePoint Services 适配器 Web 服务的虚拟服务器的端口号。默认情况下，此端口为端口 80。
在“存档位置”属性中键入 Archive 。
在“轮询间隔”属性中键入 10 。
在 ShareP oint 网站 URL 属性中键入 SharePoint网站的 URL。例如，http://<server_name>/sites/WSSAdapterWalkthrough。
源文档库属性的类型Source。
单击 “确定” 。
在“ 接收位置属性 ”对话框中，选择 BizTalkServerApplication 作为 “接收”处理程序。
在“接收管道”下拉列表中，选择。PassThruReceive
单击 “确定” 。

创建发送端口

在 BizTalk 管理控制台中，右键单击“ 发送端口 ”节点，单击“ 新建”，然后单击“ 静态单向发送端口”。
在“发送端口属性”对话框的“常规”下，键入SendToDestination“名称”字段。
在“ 传输 ”部分中，选择 Windows SharePoint Services 类型。
单击“配置”以配置Windows SharePoint Services适配器属性。
在“适配器 Web 服务端口”属性中，键入安装了 Windows SharePoint Services 适配器 Web 服务的虚拟服务器的端口号。默认情况下，此端口为端口 80。
键入 “Destination目标文件夹” 属性的。
键入 “PurchaseOrder1-%MessageID%.xml文件名” 属性的。
将 Overwrite 属性设置为 Yes。
在 SharePoint 网站 URL 属性中键入 SharePoint 网站的 URL 。例如，http://<server_name>/sites/WSSAdapterWalkthrough。
将 Microsoft Office Integration 属性设置为 No。
单击 “确定” 。
在“发送端口属性”对话框的“发送处理程序”下拉列表中，选择。BizTalkServerApplication
在 “发送管道 ”下拉列表中，选择 PassThruTransmit。
单击“ 筛选器 ”选项卡。
在“属性”字段中选择WSS.InListName。
在“操作员”字段中选择==。
在“值”字段中键入 Source 。
单击 “确定” 。

启用并启动接收位置和接收端口

在以下过程中，您将启用接收位置并启动接收端口。必须完成此过程，以使 Windows Sharepoint Services 适配器能够通过指定的发送端口和接收位置发送和接收消息。

启用接收位置

在 BizTalk 管理控制台中，单击“ 接收位置” 节点。
右键单击， SourceLocation然后单击“ 启用”。

启动发送端口

在 BizTalk 管理控制台中，单击“ 发送端口” 节点。
右键单击， SendToDestination然后单击“ 开始”。
关闭 BizTalk 管理控制台。

通过系统发送消息

在此过程中，您将创建一个 XML 文档并将其上载到 Windows SharePoint Services 网站。 Windows SharePoint Services 适配器将接受该消息并将其存档在存档文档库中，然后将其发送到目标文档库。此过程说明文档是如何通过 Windows Sharepoint Services 适配器，从 Sharepoint 网站流出，通过 BizTalk Server，到达 Sharepoint Services 网站的。

创建工作目录

在计算机上创建名为 WSSAdapterWalkthrough 的目录。例如，C:\WSSAdapterWalkthrough。

创建 XML 文件

单击 “开始”，指向 “所有程序”，指向“ 附件”，然后单击“ 记事本”。

键入下列命令：

<?xml version="1.0"?>  
<PurchaseOrder>  
    <ID>1001</ID>  
    <FirstName>John</FirstName>  
    <LastName>Doe</LastName>  
    <Amount>750</Amount>  
</PurchaseOrder>

将工作目录中的文件另存为 PurchaseOrder1.xml。例如，C:\WSSAdapterWalkthrough\PurchaseOrder1.xml。

上载 XML 文件

打开 Web 浏览器并导航到上一任务中所创建站点的 URL。例如，http://<server_name>/sites/WSSAdapterWalkthrough。
在左侧的 “文档”下，单击“ 源”。
单击“ 上传文档”。
在“ 名称 ”框中，键入或浏览到上面创建的 XML 文件。例如， C:\WSSAdapterWalkthrough\PurchaseOrder1.xml然后单击“ 保存并关闭”。现在您应该可以在列表中看到该文件。
刷新浏览器窗口。该文件 PurchaseOrder1.xml 将不再在此库中列出。

注意

由于轮询间隔设置为 10 秒钟，因此，您可能需要刷新浏览器数次。
在顶部导航栏中，单击“ 文档和列表”。
在 “文档库”下，单击“ 目标”。
在目标文档库中，现在您将看到您的消息已列出。您还将在存档文档库中找到存档副本。

注意

如果目标文档库中未显示该消息，请参阅帮助BizTalk Server中的“Windows SharePoint Services适配器疑难解答”。

总结

在本演练中，您学习了如何配置 Windows SharePoint Services 和 BizTalk Server，以便可以使用 Windows SharePoint Services 适配器和基于内容的路由 (CBR) 来发送和接收消息。

后续步骤

完成本演练后，请执行演练：模块 2 - 将 Office 与 Windows SharePoint Services 适配器集成演练，该演练扩展了你在本演练中完成的工作，并演示如何将 Office 与 Windows SharePoint Services 适配器集成。

另请参阅

Windows SharePoint Services 适配器概述
 Windows SharePoint Services 适配器演练

通过