Windows SharePoint Services 适配器属性参考

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

消息属性优先级

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

以下为相应的规则:

  1. 在 PropertiesXML 内部的业务流程中定义的属性

  2. 在业务流程中定义的属性

  3. 在属性名称/或属性源集合内部的发送端口级别上定义的属性

  4. 在发送端口级别上定义的属性

注意事项和已知问题

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

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

属性类型

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