共用方式為

何謂 Windows SharePoint Services 配接器？

  • 發行項

Windows SharePoint Services BizTalk Server配接器提供與 Windows SharePoint Services 和 Microsoft Office InfoPath 更緊密的整合。 以下主題說明功能以及 Windows SharePoint Services 配接器運作方式概觀。

Windows SharePoint Services 配接器的功能

以下清單描述 Windows SharePoint Services 配接器的重要功能：

  • 傳送 BizTalk Server XML 及二進位訊息至 SharePoint 文件庫的能力。

  • 與 InfoPath 整合：您可以從Windows SharePoint Services網站開啟時，轉換傳出BizTalk Server XML 訊息，以在 InfoPath 中自動開啟。

  • 進入 Windows SharePoint Services 以便進行訊息的屬性升級。 以有關類似訊息的協調流程個體 ID、訊息 ID，或是從訊息擷取值的 BizTalk Server 中繼資料，最多可更新 16 個 SharePoint 資料行。

  • 檔案名稱定義是以訊息內容和 BizTalk Server 屬性為基礎。

  • 將檔傳送至任意清單 (而非文件庫) 的功能：在此情況下，檔本身不會儲存在Windows SharePoint Services，但屬性升級仍會發生，因此會建立新的清單專案，並從訊息擷取資料行值。

  • 從任何文件庫的任何檢視接收訊息，並將訊息封存至使用指定檔案名稱的指定文件庫之能力。

  • 在BizTalk Server中升級Windows SharePoint Services配接器屬性：Windows SharePoint Services檔案資訊可在BizTalk Server做為訊息內容屬性使用。 訊息內容屬性可從管線、協調流程等取得。可透過 WSS.InPropertiesXml 文件存取自訂 SharePoint 資料行。

  • 動態埠的完整支援：傳送配接器可以在傳送訊息) 時，支援使用者所定義的靜態 URI 系結 () 或協調流程所定義的動態 URI 系結 (。 所有組態資訊可透過訊息內容屬性定義，例如，動態傳送埠以及實體傳送埠的 WSS.Filename 和 WSS.ConfigTimeout。

  • 效能計數器

Windows SharePoint Services 配接器的運作方式

Windows SharePoint Services BizTalk Server配接器包含三個主要元件：

  • Windows SharePoint Services 配接器 Web 服務

  • Windows SharePoint Services 接收配接器

  • Windows SharePoint Services 傳送配接器

    安裝在 Windows SharePoint Services 伺服器的 Web 服務 (BTSharePointAdapterWS.asmx) 提供 Windows SharePoint Services 程式庫和清單的存取。 Web 服務公佈從 SharePoint 程式庫取得、加入、刪除及封存文件的方法。 接收配接器從 Web 服務擷取檔案，而傳送配接器則將檔案公佈至 Web 服務。

    下圖顯示提供這些功能之Windows SharePoint Services BizTalk Server配接器的主要元件。

    顯示提供這些功能之Windows SharePoint Services BizTalk Server配接器主要元件的影像。

從 Windows SharePoint Services 接收文件

接收配接器輪詢 Windows SharePoint Services 文件庫檢視。 它呼叫使用 Windows SharePoint Services 物件模組，Windows SharePoint Services 伺服器上的 Web 方法，瀏覽程文件庫、取出檔案及傳回檔案資料至配接器。 接著配接器提交檔案至 BizTalk Server MessageBox，並從 Windows SharePoint Services 呼叫另一種 Web 方法刪除或封存檔案。 為能篩選 Windows SharePoint Services 程式庫的檔案，配接器會透過 Windows SharePoint Services 檢視輪詢 Windows SharePoint Services 程式庫。

集中式的 (輪詢) 方法提供簡單的管理模型，組態會在此模型的 BizTalk 伺服器上完成。 由於允許訊息批次的事實也能提供更好的效能。

由於 Windows SharePoint Services、Web 服務和 BizTalk Server 之間無法使用平台層級的交易支援，因此使用取出機制可以使失敗情況相關的錯誤降至最低。 在特定情況下 (就是檔案成功地傳入 BizTalk Server MessageBox 資料庫，但是無法從 Windows SharePoint Service 刪除)，雖然檔案已經提交至 BizTalk Server，但是 Windows SharePoint Services 伺服器上的檔案仍會維持取出的狀態。 錯誤會記錄至 BizTalk 伺服器的事件日誌。

傳送文件至 Windows SharePoint Services

配接器透過呼叫 Windows SharePoint Services 伺服器上的 Web 方法，傳送文件至 Windows SharePoint Services。 配接器指定 Windows SharePoint Services 網站 URL、文件庫、或相對於網站的清單 URL，或清單項目及升級屬性，與此檔案產生關聯。

您可以將檔案名稱設為固定的字串或自文件的 XML 資料衍生的名稱。 衍生名稱對於強制標準命名慣例有很大的幫助。 配接器也可將檔案的升級屬性值設為資料行值。 如同檔案名稱，升級屬性可以固定或從文件的 XML 資料衍生。

重要

Windows SharePoint Services 配接器的升級屬性實體與 BizTalk Server 或 Windows SharePoint Services 的升級屬性不同。

在瀏覽 Windows SharePoint Services 表單庫時，可使用 Windows SharePoint Services 升級屬性使 XML 項目可見。 InfoPath 表單發佈至 Windows SharePoint Services 表單庫時，InfoPath 設定表單庫升級重要項目使其自動發生。 此功能只能在使用 InfoPath 表單程式庫時 (以相同 XSD 結構性描述和 InfoPath 解決方案儲存 InfoPath 表單的文件庫)，由 Windows SharePoint Services 提供使用。

含有不同結構性描述的文件儲存在相同文件庫時，Windows SharePoint Services 配接器屬性升級可讓使用者將屬性升級至 Windows SharePoint Services。

BizTalk Server 屬性升級是一種類似的概念，只有做為訊息屬性並可見於協調流程的屬性，而不是可見於 UI 使用者的屬性。 此外，屬性值存回文件後，BizTalk Server 支援屬性降級概念。

在使用含有 InfoPath 表單和表單庫的 Windows SharePoint Services 配接器時 (而非任意 XML 和文件庫)，您不需要透過傳送埠設定升級屬性。 反而，此文件可在協調流程內變更 (直接透過變更訊息變更或是間接透過降級屬性變更)。 此值由 Windows SharePoint Services 自動升級。

Windows SharePoint Services 配接器的安全性考量

Windows SharePoint Services 配接器是由子系統，在 Windows SharePoint Services 網站上執行的 BTSharePointAdapterWS Web 服務，以及在 BizTalk Server 主控件執行個體程序內，BizTalk Server 上執行的配接器執行階段所組成。 配接器執行階段叫用 BTSharePointAdapterWS Web 服務，該服務必須在 Windows SharePoint Services 內有執行特定工作的權限。 因為此元件做為呼叫者執行，所以權限需授與呼叫者。 這表示 BizTalk 主機實例必須在 SharePoint 網站上建立 參與者 ，才能從該網站傳送和接收訊息。 BTSharePointAdapterWS Web 服務只能由 啟用 SharePoint 主機 群組的成員叫用。 若要允許 BizTalk 主機實例執行配接器執行時間，以便與 Web 服務互動，主機實例 Windows 帳戶必須成為 SharePoint 已啟用主機 群組的成員。 系統管理員必須負責新增和移除此群組中的帳戶，以及讓主機實例帳戶成員成為 SharePoint 參與者 角色的成員。

元件 處理序身分識別 權限
BTSharePointAdapterWS Web 服務 呼叫者身份 叫用授與啟用 SharePoint 的主控件群組的權限
配接器執行階段 BizTalk 主控件的身份 N/A
Windows SharePoint Services 物件模型 N/A 啟用 SharePoint 的主機群組必須是SharePoint Services中參與者角色的成員。

BizTalk Server安裝程式會設定 BTSharePointAdapterWS Web 服務的許可權，讓只有屬於SharePoint 已啟用主機群組成員的帳戶才能存取此 Web 服務。 如果您想要讓主機執行Windows SharePoint Services配接器，系統管理員必須將與該主機相關聯的 NT 群組新增至已啟用SharePoint 的主機群組，並將SharePoint 已啟用主機群組新增至Windows SharePoint Services參與者角色。

Windows SharePoint Services 檔案、清單和文件庫權限限制使用 Windows SharePoint Services 安全性。 此訊息是從 Windows SharePoint Services 直接傳送至 BizTalk Server。 配接器執行階段與 Web 服務之間的通訊是在 HTTP 或 HTTPS 上進行。

此配接器假設 BTSharePointAdapterWS Web 服務使用的 HTTP 配置 (HTTP 或 HTTPS) 與 Windows SharePoint Services 網站相同。 這表示 Windows SharePoint Services 網站在安全 IIS 網站建立時，配接器會使用 HTTPS 與 BTSSharePointAdapterWS Web 服務通訊，或者 Windows SharePoint Services 網站是在沒有伺服器憑證的情況下在 IIS 網站建立時，配接器會使用 HTTP 與 BTSharePointAdapterWS Web 服務通訊。

另請參閱

設定和部署 Windows SharePoint Services 配接器
設定 Windows SharePoint Services 配接器
Windows SharePoint Services 配接器逐步解說