共用方式為

Windows SharePoint Services 配接器屬性參考

  • 發行項

下列 Windows SharePoint Services 配接器屬性會升級到 BizTalk Server 或用來指定外寄訊息的傳送埠組態選項。 這些屬性可以用來存取與訊息相關的 Windows SharePoint Services 資訊，或提供資訊到來自協調流程內的 Windows SharePoint Services 配接器。

訊息屬性優先順序

對於覆寫在協調流程和傳送埠中定義的訊息屬性，有一套優先順序的規則。

以下是這些規則：

  1. 在 PropertiesXML 內部協調流程中定義的屬性

  2. 在協調流程中定義的屬性

  3. 在屬性名稱/或屬性來源集合內部的傳送埠層級中定義的屬性

  4. 在傳送埠層級定義的屬性

考量與已知問題

下列是 Windows SharePoint Services 配接器屬性的考量：

  • 協調流程中的屬性清單已經根據屬性位置，與由連接埠定義的屬性合併。 若有衝突，協調流程屬性將會覆寫傳送埠屬性。

屬性類型

屬性類型 Description
IN IN 屬性是從 Windows SharePoint Services 取得其值的 BizTalk Server 屬性。 注意： 您不應該從協調流程內修改這些屬性。
配置 CONFIG 屬性是從 BizTalk 協調流程或自訂管線取得其值的屬性。 Windows SharePoint Services 配接器會在決定外寄訊息的目的地時，使用此值。 CONFIG 屬性可以讓您指定在協調流程或自訂管線中的部分屬性值，不然您必須在傳送埠中定義。 開頭不是 IN 或 CONFIG 的屬性皆是 IN 和 CONFIG，URL 屬性除外。
促進 以內容為基礎的路由 (CBR) 可以使用 PROMOTED 屬性。 CBR 無法使用不是標示為 PROMOTED 的屬性。 注意： 雖然所有配接器屬性都會顯示在 CBR 篩選編輯器中，但只有升級的屬性可用於 CBR。
特殊 N/A

注意

所有屬性都存在於 命名空間底下 http://schemas.microsoft.com/BizTalk/2006/WindowsSharePointServices-properties ，而且可以使用 WSS.<WSS_Property_Name> 語法從協調流程或傳送埠篩選器存取。

屬性清單

Windows SharePoint Services 標準資料行 Windows SharePoint Services 屬性名稱與類型 類型 Description 屬性類型
名稱 檔案名稱 xs:string 具有 Windows SharePoint Services 檔案副檔名的檔案名稱。 包括副檔名的檔案名稱，在文件庫中是唯一的。 IN/CONFIG/ PROMOTED
N/A Url xs:string 檔案的 URL。 IN/PROMOTED
N/A TransmittedFileLocation N/A 此屬性是用於商務活動監控 (BAM) 做為整合用途，並且在協調流程中無法使用。 SPECIAL
N/A InArchivedMsgUrl xs:string 封存文件庫中檔案的 URL。 此屬性在接收位置未封存訊息時無法使用。 IN/PROMOTED
類型 InIconUrl xs:string 用來代表文件之 Windows SharePoint Services 圖示的 URL。 IN
標題 InTitle xs:string Windows SharePoint Service 檔案的標題。 這與檔案名稱不同。 標題在文件庫中不須是唯一的。 IN/PROMOTED
修改日期 InLastModified xs:dateTime 上次修改 Windows SharePoint Service 的日期。 IN/PROMOTED
修改者 InLastModifiedBy xs:string 上次修改檔案的使用者名稱。 IN/PROMOTED
識別碼 InItemId xs:int 檔案的 ID。 這是在文件庫內唯一的整數，可用來存取檔案。 IN
編輯 InEditUrl xs:string 可以存取來編輯檔案屬性的 URL。 IN
建立時間 InCreated xs:dateTime 建立 Windows SharePoint Service 檔案的日期。 IN/PROMOTED
建立者 InCreatedBy xs:string 建立檔案的使用者。 IN/PROMOTED
檔案大小 InFileSize xs:int Windows SharePoint Services 檔案的大小。 IN
N/A InListName xs:string 此檔案所在的文件庫名稱。 IN/PROMOTED
N/A InListUrl xs:string 此檔案所在的文件庫或文件庫資料夾名稱。 IN
N/A InPropertiesXml xs:string 包含所有標準和使用者定義 Windows SharePoint Services 資料行的一般 XML 文件。 它可以從協調流程存取任何 Windows SharePoint Services 資料行，包括使用者定義資料行的值。 注意： 它沒有 16 個數據行的限制。 注意： 請參閱本主題下一節的範例 InPropertiesXml 值。 IN
N/A InOfficeIntegration xs:string 根據接收位置的值。 這是 yes 、 no 或 optional 。 IN
N/A ConfigOverwrite xs:string [是] 會以相同名稱覆寫已經存在的檔案。 [否] 會在相同名稱的檔案存在時引發一個錯誤。 [重新命名] 會藉由附加唯一的序列到檔案名稱，將檔案變成一個唯一名稱。 注意： 這類似于實體傳送埠的 [覆寫] 欄位。 注意： 'Orchestration' 不是這個欄位的有效值。 CONFIG
N/A ConfigNamespaceAliases xs:string XPATHs 的別名定義。 CONFIG
N/A ConfigOfficeIntegration xs:string 若應該呼叫 OfficeImporter 則為 [是]。 [否] 則依原狀處理訊息，不作任何變更。 若找到 IP 解決方案，則 [選擇性] 會導致 [是]，不然則為 [否]。 注意： 這類似于實體傳送埠的 [Microsoft Office 整合] 欄位。 注意： 'Orchestration' 不是這個欄位的有效值。 CONFIG
N/A ConfigTemplatesDocLib xs:string 後援文件庫名稱。 這是搜尋的第二個位置。 注意： 這類似于實體傳送埠的 [範本後援文件庫] 欄位。 CONFIG
N/A ConfigTemplatesNamespaceCol xs:string 後援文件庫的命名空間資料行名稱。 注意： 這類似于實體傳送埠的 [範本後援命名空間資料行] 欄位。 CONFIG
N/A ConfigCustomTemplatesDocLib xs:string 主要文件庫名稱。 這是搜尋的第一個位置。 注意： 這類似于實體傳送埠的 [範本文件庫] 欄位。 CONFIG
N/A ConfigCustomTemplatesNamespaceCol xs:string 主要文件庫的命名空間資料行名稱。 注意： 這類似于實體傳送埠的 [範本命名空間資料行] 欄位。 CONFIG
N/A ConfigPropertiesXml xs:string 一般 XML 文件，其中包含所有 Windows SharePoint Services 資料行名稱，以及隨後在 Windows SharePoint Services 中更新的值。 它可以讓協調流程開發人員設定即將在 SharePoint 建立的後續訊息的 SharePoint 資料行值。 注意： 這類似于實體傳送埠的 [資料行 n] 和 [資料行 n 值] 欄位所提供的功能。 注意： 它有 16 個數據行的限制。 注意： 請參閱本主題稍後的範例 ConfigPropertiesXml 值。 CONFIG
N/A ConfigTimeout xs:int Web 服務呼叫的逾時 (以毫秒為單位)。 CONFIG
N/A ConfigAdapterWSPort xs:int 已安裝並設定介面卡的埠或 IIS 網站。 注意： 協調流程中的無效埠組態值會暫停訊息，即使實體傳送埠值覆寫協調流程定義的值也一樣。 CONFIG

範例 InPropertiesXml

以下是 InPropertiesXml 的範例 XML。

<InPropertiesXml>  
     <Property name="InItemId">2</Property>  
     <Property name="Created">12/14/2004 1:30:31 PM</Property>  
     <Property name="Author">3;#John Doe</Property>  
     <Property name="Modified">12/14/2004 1:30:31 PM</Property>  
     <Property name="Editor">3;#John Doe</Property>  
     <Property name="_ModerationStatus">0</Property>  
     <Property name="_ModerationComments" />  
     <Property name="FileRef">/sites/BASSite/SourceLibrary/PO1.xml</Property>  
     <Property name="FileDirRef">2;#sites/BASSite/SourceLibrary</Property>  
     <Property name="InLastModified">2004-12-14 13:30:31</Property>  
     <Property name="InCreated">2004-12-14 13:30:31</Property>  
     <Property name="InFileSize">7338</Property>  
     <Property name="FSObjType">0</Property>  
     <Property name="CheckedOutUserId">2;#3</Property>  
     <Property name="Filename">PO1.xml</Property>  
     <Property name="VirusStatus">2;#7338</Property>  
     <Property name="CheckedOutTitle">2;#John Doe</Property>  
     <Property name="LinkCheckedOutTitle">John Doe</Property>  
     <Property name="InLastModifiedBy">MyDomain\jdoe</Property>  
     <Property name="InCreatedBy">MyDomain\jdoe</Property>  
     <Property name="owshiddenversion">1</Property>  
     <Property name="File_x0020_Type">xml</Property>  
     <Property name="HTML_x0020_File_x0020_Type" />  
     <Property name="_SourceUrl" />  
     <Property name="_SharedFileIndex" />  
     <Property name="LinkFilenameNoMenu">PO1.xml</Property>  
     <Property name="LinkFilename">PO1.xml</Property>  
     <Property name="SelectTitle">2</Property>  
     <Property name="SelectFilename">2</Property>  
     <Property name="Edit">xml</Property>  
     <Property name="InIconUrl">/sites/BASSite/SourceLibrary/PO1.xml</Property>  
     <Property name="Url">http://localhost:80/sites/BASSite/SourceLibrary/PO1.xml</Property>  
     <Property name="EncodedAbsUrl">PO1</Property>  
     <Property name="BaseName">7338</Property>  
     <Property name="FileSizeDisplay" />  
     <Property name="InstanceID">200</Property>  
     <Property name="Order" />  
     <Property name="InTitle" />  
     <Property name="ColumnOne" />  
     <Property name="ColumnTwo" />  
     <Property name="ColumnThree" />  
     <Property name="ColumnFour" />  
     <Property name="InListName">SourceLibrary</Property>  
     <Property name="InListUrl">http://localhost:80/sites/BASSite/SourceLibrary</Property>  
     <Property name="InEditUrl">http://localhost:80/sites/BASSite/SourceLibrary/Forms/EditForm.aspx?ID=2</Property>  
     <Property name="InOfficeIntegration">yes</Property>  
</InPropertiesXml>

範例 ConfigPropertiesXml

以下是 ConfigPropertiesXml 的範例 XML。

<ConfigPropertiesXml>  
     <PropertyName1>PO number</PropertyName1>  
     <PropertySource1>%XPATH=//orchns:PurchaseOrder/orchns:Header/orchns:ID%</PropertySource1>  
     <PropertyName2>Charge To</PropertyName2>  
     <PropertySource2>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:chargeTo%</PropertySource2>  
     <PropertyName3>PO Priority</PropertyName3>  
     <PropertySource3>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:priority%</PropertySource3>  
     <PropertyName4>Order Date</PropertyName4>  
     <PropertySource4>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:dateOrdered%</PropertySource4>  
</ConfigPropertiesXml>

另請參閱

如何設定 Windows SharePoint Services 接收位置
如何設定 Windows SharePoint Services 傳送處理常式
如何設定 Windows SharePoint Services 傳送埠
如何建立傳送埠
Windows SharePoint Services 配接器運算式
支援的 Windows SharePoint Services 資料行類型