适配器设计时配置
适配器包含一个运行时组件和一个设计时组件。 运行时组件对于用户是不可见的。 它以透明方式负责BizTalk Server消息的传输、接收和处理。
适配器的设计时组件可通过管理用户界面看到。 它负责显示可用属性、接受管理输入以及验证输入以配置适配器。 设计时组件允许对适配器的属性进行适当配置以使运行时功能能够正确交换消息,这一点是非常重要的。
本部分仅讨论适配器的设计时组件。 因此,我们将主要关注如何显示和设置适配器的配置。 有两种方法来配置适配器:
属性浏览器。 发送或接收端口的适配器属性,或者发送或接收处理程序,通过使用BizTalk Server管理控制台通过其“属性”菜单进行配置。 在这些项目的配置过程中,可以选择适配器(传输)并使用属性浏览器来配置其属性。 适用的属性通过一个带有集名称的架构来显示。 例如,对于一个发送(传输)处理程序,属性将位于 TransmitHandler.xsd 文件中;对于一个接收位置,属性将位于 ReceiveLocation.xsd 文件中。 适配器实现 IAdapterConfig 接口,以查找并加载相应的架构,以在属性浏览器中公开特定属性。 IAdapterConfigValidation 接口用于验证这些条目,并在保存配置数据之前对值进行任何最终修改。
添加适配器元数据向导。 对于应用程序和数据库适配器,可能需要在 Visual Studio 的 BizTalk 项目中导入描述适配器所需的消息类型和端口类型的支持架构。 或者,有时需要使用适配器提供的服务。 使用“添加适配器元数据向导”可以查看适配器支持的服务并将相关消息类型和端口类型导入到您的项目中。 此过程称为“元数据收集”。作为适配器开发人员,你将创建一个描述这些服务的 XML 文件,并在设计时通过 IStaticAdapterConfig 或 IDynamicAdapterConfig 接口将其公开给向导,结果如下:
静态适配器。 向导提供一个标准默认分层树结构,用于显示适配器的服务。 静态适配器定义为使用向导提供的标准树用户界面 (UI) 的适配器。 使用 IStaticAdapterConfig.GetServiceOrganization 和 GetServiceDescription 方法允许将所选服务添加到 BizTalk 项目。 这是适配器开发人员的最简单的配置选择,但其不利的一面是对显示格式要求严格。
动态适配器。 如果向导提供的基本服务选择 UI 不够灵活,无法满足您的 UI 需要,则可以创建可由向导动态显示的自定义 UI。 使用 IDynamicAdapterConfig.DisplayUI 方法显示自定义 UI,以允许选择要添加到 BizTalk 项目的服务。
本部分提供了以静态或动态方式处理设计时配置的两套方案的指南。
Microsoft BizTalk Server 软件开发工具包 (SDK) 包含一个示例文件适配器,可用于创建和自定义自己的适配器设计时配置解决方案。 每个设计时配置主题中都提供了有关该示例文件适配器的注释和参考,以帮助您修改自己的自定义适配器配置要求。 为更好地理解这些指南,您可能需要安装、生成和运行 SDK 中提供的示例文件适配器。 有关详细信息,请参阅文件适配器 (BizTalk Server 示例) 。