Windows Sharepoint Services 配接器運算式
本主題描述字串的格式和意義，這些字串可以指定為 Windows SharePoint Services 配接器之 [檔名][屬性來源] 屬性的值。 它也描述相關的內容屬性 WSS。檔名 和 WSS。ConfigPropertiesXml。 這些運算式可讓您根據常值與從訊息或 BizTalk 系統擷取的值，輕鬆地定義檔案名稱值或是自訂的 Windows SharePoint Service 資料行值。
運算式可以包含常值與巨集。 常值將依照您的輸入出現在檔案名稱中。 巨集必須放置在 '%' 字元之間。 宏的範例是 %MessageID% ，在運行時間會取代為訊息的 GUID。
注意
當 % 字元做為常值或是用於 XPATH 中時，它必須以此 \% 符號逸出。 單一 % 將會視為巨集分隔符號，其中 \% 將在執行階段由單一 % 取代。 \ 字元必須由此 \\ 符號逸出。
運算式範例
| 設計階段值 | 執行階段值 |
|---|---|
| XYZ | XYZ |
| PurchaseOrder | PurchaseOrder |
| %MessageID% | 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| PurchaseOrder - %MessageID% | PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| Discount \%10 | Discount %10 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – 10001 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:PartnerName%-%XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – Contoso-10001 |
支援的巨集
| 設計階段值 | 執行階段值 |
|---|---|
| %MessageID% | BizTalk 訊息識別碼是唯一的 GUID。 |
| %SendingOrchestrationID% | 產生訊息的協調流程執行個體之 BizTalk 識別碼。 |
| %SendingOrchestrationType% | 產生訊息的協調流程類型名稱。 |
| %XPATH=<xpath>% | 允許指定要用來擷取訊息值的 XPATH。 “<xpath>” 必須取代為有效的 XPATH 運算式。 注意： 命名空間別名必須在 『Namespace Aliases』 或 WSS 中的運算式外部定義。ConfigNamespaceAliases 欄位。 |
| %Filename% | 取代成從訊息內容屬性 WSS.Filename 擷取的檔案名稱值。 從 SharePoint 接收的訊息會將 WSS.Filename 內容屬性設定為 SharePoint 檔案的名稱。 傳回的值是使用 Path.GetFilenameWithoutExtension 來預先處理。 注意： 此宏無法用於協調流程) (WSS.Config* 內容屬性。 |
| %Extension% | 取代成從訊息內容屬性 WSS.Filename 擷取的副檔名值。 從 SharePoint 接收的訊息會將 WSS.Filename 內容屬性設定為 SharePoint 檔案的名稱。 傳回值會使用 Path.GetExtension 進行前置處理。 傳回的值不會包含 "."。 注意： 此宏無法用於協調流程) (WSS.Config* 內容屬性。 |
屬性升級支援的任何有效運算式都是有效的設計階段檔案名稱。 此設計階段檔案名稱將在執行階段擴充成 Windows SharePoint Services 檔案名稱。 此 Windows SharePoint Services 檔案名稱有一些其他的限制，如下所述：
有效的 Windows 檔名可以包含任何 Unicode 字元，但下列專案除外： / \ ： * ？ <> |# { } % & ~ 或製表元和多個句點。
檔案名稱不能超過 256 個字元，而且整個 URL 必須少於或等於 256 個字元。
若擴充的 Windows SharePoint Services 檔案名稱包含無效的字元，或是若擴充的檔案名稱或 URL 太長，則會在應用程式事件日誌中記錄錯誤，並且擱置訊息。 錯誤和訊息狀態也會顯示在使用訊息事件和服務執行個體追蹤的 [群組中樞] 頁面中。
另請參閱
如何設定 Windows SharePoint Services 接收位置
如何設定 Windows SharePoint Services 傳送處理常式
如何設定 Windows SharePoint Services 傳送埠
Windows SharePoint Services 配接器屬性參考
支援的 Windows SharePoint Services 資料行類型