Windows SharePoint Services 适配器表达式

本主题介绍字符串的格式和含义,这些字符串可指定为适配器的 File NameProperty Source 属性的值Windows SharePoint Services属性的值。 它还介绍了相关的上下文属性,WSS。文件名和WSS。ConfigPropertiesXml。 这些表达式使您很容易基于文本以及从消息或 BizTalk 系统提取的值来定义文件名值,或自定义 Windows SharePoint 服务列值。

表达式可以包含文本和宏。 文本将按键入顺序原样显示在文件名中。 宏必须放在“%”字符之间。 宏的一个示例 %MessageID% 是在运行时,该宏将替换为消息的 GUID。

注意

在将 % 字符用作文本或在 XPATH 中使用该字符时,必须将其转义为 \%。 单个 % 将被视为宏分隔符,而 \% 将在运行时替换为单个 %。 \ 字符必须转义为 \\。

表达式示例

设计时值 运行时值
XYZ XYZ
PurchaseOrder PurchaseOrder
%MessageID% 55B93F27-7455-4066-ABE1-B4EBE6839A1A
PurchaseOrder - %MessageID% PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A
折扣 \%10 折扣 %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 消息 ID,该 ID 是唯一的 GUID。
%SendingOrchestrationID% 作为消息起源的业务流程实例的 BizTalk ID。
%SendingOrchestrationType% 作为消息起源的业务流程的类型名称。
%XPATH=<xpath>% 允许指定一个 XPATH,用于从消息中提取值。 "<xpath>"必须替换为有效的 XPATH 表达式。 注意:命名空间别名必须在"命名空间别名"或"命名空间别名"表达式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 栏类型