动态设计时适配器配置

静态设计时适配器配置以及“添加适配器元数据”向导中的标准默认 UI 有时不够灵活,不足以显示适配器的服务,以供 BizTalk 项目导入。 此时可以选用动态设计时配置,在其中为向导提供自定义 UI,以显示和选择您的适配器服务。 BizTalk 适配器框架提供了一组 API,可供您导入适配器所需的架构以及显示自定义 UI。

本部分介绍如何实现您的自定义适配器的动态设计时配置功能。 您决定做出的更改将基于要与适配器通信的应用程序的需要,以及该适配器需要实现的逻辑。 如果可用,BizTalk Server提供指向"帮助"部分的链接,这些部分更详细地介绍了这些步骤或提供其他背景信息。 此外,本部分还指出了示例文件适配器文档中提供相关示例的位置。

有关动态开发过程的准则

下面的列表提供了有助于在适配器中构建动态设计时功能的建议。 在开发过程中,可能不需要执行所有这些步骤,也不需要以严格的顺序执行这些步骤。

  1. 创建适配器配置需求以及您需要设置的配置参数的列表。 如果要对所有接收位置和发送端口全局性地使用这些参数,请在处理程序架构配置文件中指定这些参数。 如果参数特定于端口或位置,请在发送端口和接收位置配置文件中指定这些参数。

  2. 修改各适配器属性页,说明所有新的配置参数。 有关此步骤的信息,请参阅 适配器配置架构

  3. 为“添加适配器元数据”向导创建自定义用户界面 (UI),以便选择要添加到项目中的架构。 在此列出的所有建议中,动态适配器与静态适配器只在这一条建议上有所不同。 有关此步骤的信息,请参阅 动态适配器 DisplayUI 方法和 Microsoft.BizTalk.Adapter.Framework.IDynamicAdapterConfig.DisplayUI 类

  4. 修改示例代码,将架构作为 Web Services 描述语言 (WSDL) 文件返回。 有关此步骤详细信息,请参阅 静态适配器 IStaticAdapterConfig 接口

  5. 修改现有的 WSDL 文件,或者创建新的 WSDL 文件。 有关此步骤的信息,请参阅 适配器 WSDL 文件

  6. 修改示例代码,以返回适配器所需的但未包含在 WSDL 文件中的附加 XSD 文件。 有关此步骤详细信息,请参阅 适配器 GetSchema 方法

  7. 修改适配器注册表项并运行适配器注册表文件。 有关此步骤的信息,请参阅 适配器注册文件

  8. 将静态适配器安装到 BizTalk Server。 有关此步骤的信息,请参阅将适配器安装到 BizTalk Server

  9. 测试对适配器属性页所做的更改。 重新生成适配器,以测试在“添加适配器元数据”向导中出现的 UI。 有关此步骤的信息,请参阅生成和测试适配器Project

本节内容