逐步解說：模組 1 - 使用 Windows SharePoint Services 配接器傳送和接收訊息

發行項
10/14/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

在此程序中，您會建立 1 個包含 3 個文件庫的 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 。
在 [ 流覽] 區段中，選取 [ 是 ] 以在 [快速啟動] 列上顯示此表單庫。
在 [ 檔範本 ] 區段中的 [ 檔範本 ] 下拉式清單中，選取 None 。
按一下 [建立]。會建立文件庫，然後將您重新導向至空白文件庫。

建立目的地文件庫

在 [小組網站首頁] 頁面上，按一下頂端導覽列上的 [ 建立]。
在 [文件庫]底下，按一下 [文件庫]。
在 [ 名稱與描述 ] 區段中的 [ 名稱] 欄位中，輸入 Destination 。
在 [ 流覽] 區段中，選取 [ 是 ] 以在 [快速啟動] 列上顯示此表單庫。
在 [ 檔範本 ] 區段中的 [ 檔範本 ] 下拉式清單中，選取 None 。
按一下 [建立]。會建立文件庫，然後將您重新導向至空白文件庫。

建立封存文件庫

在 [小組網站首頁] 頁面上，按一下頂端導覽列上的 [ 建立]。
在 [文件庫]底下，按一下 [文件庫]。
在 [ 名稱與描述] 區段中的 [ 名稱] 欄位中，輸入 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 接收埠、接收位置以及傳送埠。這些連接埠是 Windows Sharepoint Services 配接器接收和傳送文件的 BizTalk Server 進出點。

建立接收埠

按一下[開始]、[所有程式]、[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 。
輸入 10Polling Interval 屬性。
在 SharePoint 網站 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輸入Filename屬性。
將 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 檔案

開啟網頁瀏覽器，然後移至您在上一個工作建立的網站之 URL。例如： http://<server_name>/sites/WSSAdapterWalkthrough 。
在左側的 [ 檔] 底下，按一下 [ 來源]。
按一下 [上傳檔]。
在 [ 名稱] 方塊中，輸入或流覽至您在上面建立的 XML 檔案。例如， C:\WSSAdapterWalkthrough\PurchaseOrder1.xml ，然後按一下 [ 儲存] 和 [關閉]。您現在應該可以在清單中看到檔案。
重新整理瀏覽器視窗。檔案 PurchaseOrder1.xml 將不再列在此程式庫中。

注意

您可能需要重新整理瀏覽器幾次，因為輪詢間隔設定為 10 秒。
在頂端導覽列上，按一下 [檔與清單]。
在 [文件庫]底下，按一下 [ 目的地]。
在 [目的地] 文件庫中，您現在會看見已列出您的訊息。您也可以在 [封存] 文件庫中找到封存的複本。

注意

If the message does not appear in the Destination Document Library, refer to "Troubleshooting the Windows SharePoint Services Adapter" in BizTalk Server Help.

摘要

在此逐步解說中，您已看到如何設定 Windows SharePoint Services 配接器和 BizTalk Server，供您使用 Windows SharePoint Services 配接器和以內容為基礎的路由來傳送和接收訊息。

後續步驟

現在，您已完成本逐步解說，請執行逐步解說：模組 2 - 整合 Office 與 Windows SharePoint Services 配接器逐步解說，這會擴充您完成此逐步解說的工作，並示範如何整合 Office 與Windows SharePoint Services配接器。

另請參閱

何謂 Windows SharePoint Services 配接器？
Windows SharePoint Services 配接器逐步解說

共用方式為