本主题介绍如何使用 BizTalk 业务流程中的 Windows Sharepoint Services 上下文属性在运行时配置 Windows SharePoint Services 发送端口。 同一机制可用于配置 Windows SharePoint Services 动态和延迟绑定发送端口。 动态发送端口的配置属性在运行时在业务流程中设置。 Windows SharePoint Services 传输属性对话框中公开的适配器属性也可以应用于动态或后期绑定发送端口。 若要使用 Windows Sharepoint Services 适配器上下文属性为动态或后期绑定发送端口设置配置属性,请执行以下步骤:
使用 Windows Sharepoint Services 适配器上下文属性设置发送端口的配置属性
对于动态发送端口,若要创建动态单向发送端口,请按照“ 如何创建发送端口”主题中的步骤作。
在业务流程编排中,使用构造消息形状内的消息分配形状来设置出站消息的配置属性。 有关如何为出站消息设置配置属性的示例,请参阅 演练:模块 3 - 从业务流程访问 SharePoint 属性。 本主题的 “构造新消息 ”部分说明了如何设置出站消息的配置属性。 下表中列出了与 Windows SharePoint Services 传输属性 对话框中可设置的属性相关的适配器上下文属性:
Transport 属性 适配器上下文属性 数据类型 注释 适配器 Web 服务端口 WSS.ConfigAdapterWSPort int (整数) 有效值为 1 到 65535
默认值为 80超时 WSS.ConfigTimeout int (整数) 有效值为 1000 到 2147483647
默认值为 100000
指定值 0 以指示无限超时。目标文件夹 URL 暂无 暂无 对于动态端口,可以通过在业务流程中使用表达式形状来间接设置该端口的 Microsoft.XLANGs.BaseTypes.Address 属性。 对于后期绑定端口,此属性无法在运行时设置,因为它始终由物理发送端口值重写。 文件名 WSS。文件名 字符串 支持使用可在传输属性中使用的所有文件名宏, %Filename%和 %Extension% 宏除外。 命名空间别名 WSS.ConfigNamespaceAliases 字符串 如果运行时为消息设置的命名空间别名与消息路由到的发送端口的命名空间别名集完全匹配,则会合并命名空间并发生路由错误。 若要防止此问题,请确保指定的命名空间别名不相同。 例如,如果在编排中使用以下表达式来设置消息的命名空间别名:
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";
如果此消息路由到指定 命名空间别名 属性的以下值的发送端口:
orchns='http://OrderProcess.PurchaseOrder'
然后,当 BizTalk Server 尝试将消息路由到此发送端口时,将发生错误。 若要解决此问题,可以为发送端口的 命名空间别名 属性指定以下值:
orchns2='http://OrderProcess.PurchaseOrder'
覆盖 WSS.ConfigOverwrite 字符串 有效值为:
- “是”
- “no”
- “重命名”SharePoint 网站 URL WSS.InListUrl 字符串 对于动态端口,可以通过在业务流程中使用表达式形状设置动态端口的 Microsoft.XLANGs.BaseTypes.Address 属性来间接设置。 对于后期绑定端口,无法在运行时设置此属性,因为它始终会被物理发送端口的值覆盖。 Microsoft Office 集成 WSS.ConfigOfficeIntegration 字符串 有效值为:
- “是”
- “no”
- “yesformlibrary”
- “可选”模板文档库 WSS.ConfigTemplatesDocLib 字符串 没有 模板备用文档库 WSS.ConfigCustomTemplatesDocLib 字符串 没有 模板回退命名空间列 WSS。ConfigCustomTemplatesNamespaceCol 字符串 没有 模板命名空间列 WSS。ConfigTemplatesNamespaceCol 字符串 没有 列 n
WSS.ConfigPropertiesXml
列名称在 <PropertyNamex>columnname</ PropertyNamex> 字段中设置。字符串 没有 列 n
值WSS.ConfigPropertiesXml
在 PropertySourcex>columnvalue</PropertySourcex> 字段中设置<列值。字符串 支持使用可在传输属性中使用的所有文件名宏, %Filename%和 %Extension% 宏除外。 注释
为上下文属性提供的值区分大小写。 为具有上下文属性的动态端口设置配置值时,请确保使用正确的大小写,否则当 BizTalk 尝试将文档路由到指定的发送端口时会发生错误。
在业务流程中使用表达式形状设置动态发送端口的 Microsoft.XLANGs.BaseTypes.Address 属性。 此属性用于指定动态发送端口将消息路由到的 URI。 有关如何设置动态发送端口的 Microsoft.XLANGs.BaseTypes.Address 属性的示例,请参阅主题演练:模块 3 - 从业务流程访问 SharePoint 属性的“创建表达式”部分。 有关 Windows Sharepoint Services 适配器上下文属性的详细信息,请参阅 Windows SharePoint Services 适配器属性参考。
还可以在业务流程中动态设置延迟绑定的 Windows SharePoint Services 发送端口的特定属性。 如果这样做,Windows SharePoint Services 端口将配置两次,一次通过 Windows SharePoint Services 上下文属性,一次通过 Windows SharePoint Services 传输属性对话框。 默认情况下,Windows SharePoint Services 传输属性对话框中指定的配置优先于上下文属性中指定的配置属性。 若要使用上下文属性中指定的配置,请执行以下步骤:
若要创建静态单向发送端口,请按照“ 如何创建发送端口”主题中的步骤作。
设置发送端口的属性时,通过输入 Sharepoint 网站 URL 和 目标文件夹 URL 属性的相应值来定义发送端口的 URI。
如果要在业务流程中使用上下文属性 WSS.ConfigOverwrite 所定义的值,请将 Overwrite 属性的值设置为 Orchestration。
如果想在业务流程中使用由上下文属性 WSS.ConfigOfficeIntegration 定义的值,请将 Microsoft Office Integration 属性设置为 Orchestration。
如果要在业务流程中使用上下文属性设置这些值,请为使用整数数据类型的任何发送端口属性输入 -1 值。
如果要在业务流程中使用上下文属性设置这些值,请将任何使用字符串数据类型的发送端口属性留空。 这不适用于 Sharepoint 网站 URL 和 目标文件夹 URL 属性。 必须在 Windows Sharepoint Services 传输属性 对话框中指定这些属性。
在业务流程编排中,使用构造消息形状内的消息分配形状来设置出站消息的配置属性。 有关如何为出站消息设置配置属性的示例,请参阅 演练:模块 3 - 从业务流程访问 SharePoint 属性。 本主题的 “构造新消息 ”部分说明了如何设置出站消息的配置属性。
在运行时,任何配置为 -1 值(适用于使用整数数据类型的属性)、“业务流程”(适用于下拉列表枚举属性)或留空(适用于使用字符串数据类型的属性)的发送端口属性都将根据业务流程中指定的上下文属性进行设置。
如果使用 Windows SharePoint Services 适配器接收带有嵌入附件的 InfoPath 表单,然后将 InfoPath 表单发送到 SharePoint 文档库,请完成以下步骤以保留表单中的任何 InfoPath 处理指令:
为了保留由 BizTalk Server 处理并包含嵌入附件的 InfoPath 表单的处理指令
如果在业务流程中使用映射将数据从一个 InfoPath 表单映射到另一个 InfoPath 表单,请确保已在映射中将 复制处理指令 (PIs) 属性设置为 “是”。 此参数在地图的“网格属性”页的“自定义标头”部分下设置。
如果不在业务流程中使用映射,请使用消息分配形状中的以下表达式更新输出消息:
NewMessage(XMLNORM.ProcessingInstructionOption) = 1; NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"
在上面的表达式中, NewMessage 是要向其添加处理指令的输出消息。