Windows SharePoint Services 适配器属性参考

项目
10/14/2023

以下 Windows SharePoint Services 适配器属性已升级到 BizTalk Server 中，或可用来为传出消息指定发送端口配置选项。这些属性可用于访问消息的 Windows SharePoint Services 信息，或用于在业务流程中向 Windows SharePoint Services 适配器提供信息。

消息属性优先级

在替代业务流程和发送端口中定义的消息属性时，存在一个优先级规则。

以下为相应的规则：

在 PropertiesXML 内部的业务流程中定义的属性
在业务流程中定义的属性
在属性名称/或属性源集合内部的发送端口级别上定义的属性
在发送端口级别上定义的属性

注意事项和已知问题

以下为 Windows SharePoint Services 适配器属性的注意事项：

下面所列的业务流程属性将根据属性位置与端口定义的属性进行合并。如果存在冲突，则业务流程属性将覆盖发送端口属性。

属性类型

属性类型	说明
IN	IN 属性是从 Windows SharePoint Services 获取值的 BizTalk Server 属性。注意：不应从业务流程中修改这些属性。
CONFIG	CONFIG 属性是从 BizTalk 业务流程或自定义管道获取值的属性。此值由 Windows SharePoint Services 适配器在确定传出消息的目标时使用。使用 CONFIG 属性，您可以在业务流程或自定义管道中指定一些需要在发送端口上定义的属性的值。除 URL 属性之外，不以 IN 或 CONFIG 开头的属性都是 IN 和 CONFIG 属性。
促进	PROMOTED 属性可由基于内容的路由 (CBR) 使用。 CBR 不能使用没有标记为 PROMOTED 的属性。注意：尽管所有适配器属性都显示在 CBR 筛选器编辑器中，但只有提升的属性可用于 CBR。
特殊	空值

注意

所有属性都位于命名空间下， http://schemas.microsoft.com/BizTalk/2006/WindowsSharePointServices-properties 可以使用语法从业务流程或发送端口筛选器 WSS.<WSS_Property_Name> 访问。

属性列表

Windows SharePoint Services 标准栏	Windows SharePoint Services 属性名称和类型	类型	说明	属性类型
名称	文件名	xs:string	具有 Windows SharePoint Services 文件扩展名的文件名。文件名（包括扩展名）在文档库中是唯一的。	IN/CONFIG/ PROMOTED
不可用	URL	xs:string	文件的 URL。	IN/PROMOTED
N/A	TransmittedFileLocation	不可用	此属性由业务活动监视 (BAM) 用于集成，在业务流程中不可用。	SPECIAL
不可用	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
ID	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
不可用	InListName	xs:string	此文件所在的文档库的名称。	IN/PROMOTED
N/A	InListUrl	xs:string	此文件所在的文档库或文档库文件夹的 URL。	IN
不可用	InPropertiesXml	xs:string	包含所有标准和用户定义的 Windows SharePoint Services 栏的平面 XML 文档。使用该文档可以在业务流程中访问所有 Windows SharePoint Services 栏值，包括用户定义的栏的值。注意：它没有 16 列限制。注意：请参阅本主题下一部分中的示例 InPropertiesXml 值。	IN
N/A	InOfficeIntegration	xs:string	取决于接收位置的值。这是 `yes`、 `no`或 `optional`。	IN
不可用	ConfigOverwrite	xs:string	如果值为“是”，则覆盖具有相同名称的现有文件。如果值为“否”，当存在具有相同名称的文件时将会出现错误。如果值为“重命名”，则通过为文件名附加一个唯一的序列来将文件更改为唯一的名称。注意：这类似于物理发送端口的“覆盖”字段。注意： “Orchestration”不是此字段的有效值。	CONFIG
不可用	ConfigNamespaceAliases	xs:string	XPATH 的别名定义。	CONFIG
不可用	ConfigOfficeIntegration	xs:string	如果应调用 OfficeImporters，则值为“是”。如果值为“否”，则按原样处理消息。如果选择“可选”，则当找到 IP 解决方案时为“是”，否则为“否”。注意：这类似于物理发送端口的“Microsoft Office 集成”字段。注意： “Orchestration”不是此字段的有效值。	CONFIG
不可用	ConfigTemplatesDocLib	xs:string	后备文档库名称。这是辅助搜索位置。注意：这类似于物理发送端口的模板回退文档库字段。	CONFIG
不可用	ConfigTemplatesNamespaceCol	xs:string	后备文档库的命名空间栏名称。注意：这类似于物理发送端口的“模板回退命名空间列”字段。	CONFIG
不可用	ConfigCustomTemplatesDocLib	xs:string	主文档库名称。这是首选搜索位置。注意：这类似于物理发送端口的“模板文档库”字段。	CONFIG
N/A	ConfigCustomTemplatesNamespaceCol	xs:string	主文档库的命名空间栏名称。注意：这类似于物理发送端口的“模板命名空间列”字段。	CONFIG
N/A	ConfigPropertiesXml	xs:string	包含所有要在 Windows SharePoint Services 中更新的 Windows SharePoint Services 栏名称和值的平面 XML 文档。使用该文档，业务流程开发人员可以为要在 SharePoint 中创建的后续消息设置 SharePoint 栏值。注意：这类似于通过物理发送端口的列 n 和列 n 值字段提供的功能。注意：它具有 16 列限制。注意：请参阅本主题后面的示例 ConfigPropertiesXml 值。	CONFIG
不可用	ConfigTimeout	xs:int	Web Services 调用的超时值（毫秒）。	CONFIG
不可用	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 栏类型