使用绑定文件更新现有配置

绑定文件中的信息取代了现有配置信息。 如果绑定文件中的项目名称与现有配置中的项目名称匹配,则导入绑定文件时绑定文件中的项目将更新现有配置中的项目。

使用绑定文件工件更新现有工件时,会遵循某些规则。 本主题讨论使用绑定文件中的项目更新现有配置中的项目时所遵循的规则。

本部分假定导入文件时绑定文件中存在有效值,并且不讨论绑定文件包含无效值的任何方案。

使用绑定文件更新配置时,BizTalk Server 遵循的规则

BizTalk Server 在更新绑定文件中与现有工件相匹配的工件时遵循某些规则。 一般情况下,将应用以下规则:

  • 通过 BizTalk Server 用户界面(如 BizTalk Server 管理控制台或 BizTalk 资源管理器)配置项目时公开的文本框和复选框必须设置为特定值或为空。 为绑定文件中的项目提供的值将相应地设置更新项的用户界面值。

  • 通过 BizTalk Server 用户界面配置构件时公开的下拉框必须设置为特定值或设置为“无”。 为绑定文件中的项目提供的值将相应地设置更新项的用户界面值。

  • 通过 BizTalk Server 用户界面配置项目时公开的 Datagrid 视图会使用绑定文件中相应项中的列表进行更新。 与 datagrid 视图关联的列表始终被绑定文件中的列表覆盖,除非 datagrid 视图列表绑定到端口或接收位置。 在这种情况下,绑定文件中的列表与现有的 datagrid 视图列表合并。

  • 绑定文件中的项目由主键值标识。 与项目的主键关联的值永远不能在用户界面中设置为 null,因此绑定文件中的所有项目都必须设置其主键值。 如果与绑定文件中项目的主键关联的值与现有配置项目的主键关联的值匹配,则这些项目被视为相同或匹配。 如果绑定文件项目和现有项目相同,则会使用绑定文件项目更新现有项目,如下表所述。 如果绑定文件中的项目包含唯一的主键值,则在导入绑定文件时,在 BizTalk Server 配置中创建一个新项目。

    下表描述了通过导入绑定文件更新现有配置项目与匹配项目时的预期行为。

工件类型 资产 指定属性的可能出现次数 用户界面字段 从绑定文件导入匹配工件的影响。
相关方 名称 最小出现次数: 1

最大发生次数:1
文本框 主密钥
别名 最小出现次数:0

最大发生次数: *
数据网格 使用绑定文件中的别名列表覆盖别名列表。
发送端口 最小出现次数: 0

最大发生次数: *
数据网格 将此方的现有端口列表与绑定文件中此方端口的列表合并。
证书公用名和指纹 最小出现次数: 0

最大发生次数:1

(每属性)
文本框 使用绑定文件中指定的值覆盖这些值。 如果绑定文件中不存在这些值,则设置为 null。
业务流程 DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
主机 最小出现次数: 0

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。 如果绑定文件中不存在此值,则设置为 null。
入站端口和出站端口 最小出现次数: 0

最大发生次数: *
下拉列表 将逻辑端口绑定到现有物理端口。 物理端口可以存在于以下位置:

- 在组中。
- 在应用程序中。
- 在绑定文件中。

(可选)将端口设置为 “无”。 如果设置为 “无” ,则逻辑端口不会绑定到任何资源。
“跟踪属性”复选框 最小出现次数:1

最大发生次数:1

(每属性)
复选框 使用绑定文件中指定的值覆盖这些值。
发送端口组 名称 最小出现次数:1

最大发生次数:1
文本框 主密钥
发送端口 最小出现次数: 0

最大发生次数: *
数据网格 将此发送端口组的现有端口列表与绑定文件中指定的此发送端口组的端口列表合并。
过滤 器 最小出现次数: 0

最大发生次数: *
数据网格 使用绑定文件中指定的此发送端口组的筛选器列表覆盖此发送端口组的现有筛选器列表。
发送端口 名称 最小出现次数:1

最大发生次数:1
文本框 主密钥
传输 - 类型 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
传输 - 发送处理程序 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
发送管道 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
重试计数、重试间隔和优先级 最小出现次数:1

最大发生次数:1

每个属性
滚动框 使用绑定文件中指定的值覆盖这些值。
按订单交付 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
为失败的消息启用路由 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
“启用服务”窗口 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
服务时段开始时间和服务时段停止时间 最小出现次数:1

最大发生次数:1
滚动框 使用绑定文件中指定的值覆盖这些值。
地图 最小出现次数: 0

最大发生次数: *
数据网格 使用绑定文件中指定的此发送端口的映射列表覆盖此发送端口的现有映射列表。
过滤器 最小出现次数: 0

最大发生次数: *
数据网格 使用绑定文件中指定的此发送端口的筛选器列表覆盖此发送端口的现有筛选器列表。
证书公用名 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
证书指纹 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
跟踪 最小出现次数: 0

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
备份传输类型 最小出现次数: 0

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
备份传输 URI 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。 仅当设置备份传输类型时有效。
备份传输发送处理程序 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。 仅当设置备份传输类型时有效。
备份传输重试计数 最小出现次数:1

最大发生次数:1
滚动框 使用绑定文件中指定的值覆盖此值。 仅当设置备份传输类型时有效。
备份传输重试间隔 最小出现次数:1

最大发生次数:1
滚动框 使用绑定文件中指定的值覆盖此值。 仅当设置备份传输类型时有效。
备份传输启用服务窗口 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。 仅当设置备份传输类型时有效。
备份传输服务时段开始时间和服务时段停止时间 最小出现次数:1

最大发生次数:1
滚动框 使用绑定文件中指定的值覆盖这些值。 仅当设置备份传输类型并且设置了“启用服务”窗口值时,才有效。
接收端口 名称 最小出现次数:1

最大发生次数:1
文本框 主密钥
身份验证设置(单选按钮) 最小出现次数:1

最大发生次数:1
单选按钮 使用绑定文件中指定的值覆盖此值。
启用失败的消息路由 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
接收位置 最小出现次数: 0

最大发生次数: *
数据网格 使用绑定文件中指定的此接收端口的接收位置列表覆盖此接收端口的现有接收位置列表。 如果绑定文件中的所有接收位置已存在于组中,则导入将失败。
地图 最小出现次数: 0

最大发生次数: *
数据网格 使用绑定文件中指定的此接收端口的映射列表覆盖此接收端口的现有映射列表。
跟踪 - 跟踪消息正文和跟踪消息属性 最小出现次数:1

最大发生次数:1

(每个复选框)
复选框 使用绑定文件中指定的值覆盖这些值。
接收位置 名称 最小出现次数:1

最大发生次数:1
文本框 主键
传输类型 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
接收处理程序 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
管道 最小出现次数:1

最大发生次数:1
下拉列表 使用绑定文件中指定的值覆盖此值。
DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
计划开始日期和停止日期复选框和下拉列表框。 最小出现次数:1

最大发生次数:1
复选框和下拉框。 使用绑定文件中指定的值覆盖这些值。 即使未启用复选框值,也会导入日期值。
“启用服务窗口”复选框 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
服务时段开始时间和服务时段停止时间 最小出现次数:1

最大发生次数:1
滚动框 使用绑定文件中指定的值覆盖这些值。 仅当设置了“启用服务”窗口值时有效。
架构 DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
跟踪 - 始终跟踪所有属性 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。
跟踪 - 选择所有邮件属性 最小出现次数:1

最大发生次数:1
复选框 使用绑定文件中指定的值覆盖此值。 如果启用此值,则还会启用可检查的所有消息属性。
跟踪 - 单个属性 最小出现次数: 0

最大发生次数: *
复选框 使用绑定文件中指定的此架构的跟踪属性列表覆盖此架构的现有跟踪属性列表。

如果导入绑定文件,该绑定文件引用了无法用于现有架构的跟踪属性,则会生成错误。
地图 DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
管道 DESCRIPTION 最小出现次数:1

最大发生次数:1
文本框 使用绑定文件中指定的值覆盖此值。
田径赛事 最小出现次数:1

最大发生次数:1

(每个复选框)
复选框 使用绑定文件中指定的值覆盖这些值。
跟踪消息正文 最小出现次数:1

最大发生次数:1

(每个复选框)
复选框 使用绑定文件中指定的值覆盖这些值。
策略 不適用。 策略不可导出到绑定文件。 不適用 不適用 不適用
角色链接 不適用。 角色链接不可导出到绑定文件。 不適用 不適用 不適用

使用绑定文件中匹配的构件更新现有构件时的解除绑定行为

绑定文件工件通常配置为引用其他工件,例如,接收端口通常配置为指向接收位置。 在此方案中,接收端口是父项目,接收位置是子项目。 接收端口 显式 配置为引用接收位置,接收位置随后 隐式 引用接收端口。 如果绑定文件中未完全配置的父项目存在,例如未配置接收位置的接收端口,则在导入绑定文件后,无论它们在现有配置中的状态如何,它们都将不完整配置。 例如,如果现有的接收端口 myRP 已配置接收位置 myRL,而绑定文件中的相同接收端口 myRP 配置接收位置 myRL,那么绑定文件中的条目将优先生效。 对于此示例,在导入绑定文件后,接收端口 myRP 将不会配置接收位置,因此你实际上已将 myRL 从 myRP 取消绑定

此规则仅适用于导入进行显式引用的项目,而不适用于使用隐式引用导入项目时。 因此,如果您导入了一个隐式引用(被 10 个其他项目显式引用)的映射,您不必担心该映射会与这些隐式引用的项目解绑。

另请参阅

自定义绑定文件