为主机应用程序配置 BizTalk 适配器

使用 BizTalk Adapter for Host Application Configuration 对话框可以定义和管理与远程 IBM CICS、IMS 或 iSeries 系统的连接。 单击 “连接字符串 ”属性值字段时会启动它。 可以使用 BizTalk Adapter for Host Application Configuration 对话框添加 TI .NET 程序集。 可以使用它作为映射的一部分，导入、导出和删除映射、编辑连接字符串，以及查看 TI .NET 程序集的属性。

“ 主机应用程序配置 ”对话框组件包括工具栏、菜单、数据网格和结果窗格。 本主题包含以下部分，这些部分介绍了可执行的各种任务。

工具栏和菜单命令

映射DataGrid窗口

创建和管理映射

连接字符串设置和映射

从以前版本的 Host Integration Server 升级

工具栏和菜单命令

可以通过工具栏和上下文敏感菜单访问创建和管理连接字符串的命令。 可以右键单击数据网格中的任意位置以显示上下文相关的菜单。 例如，右键单击连接字符串时，可以查看、编辑、删除、导入和导出映射。 可以双击连接字符串以在编辑模式下显示。 DELETE 键将删除当前选定的项，F1 键将打开联机帮助。

以下列表描述了可以执行的动作：

• 通过全局程序集缓存（GAC）或使用本地文件路径，添加 TI .NET 程序集到映射中。 这些列用由程序集反映的默认值填充。 如果未输入所需的值，则默认连接字符串将不可用。

• 删除 所选映射。 将显示一个对话框以确认删除。

• 选择映射后，编辑映射的连接字符串部分。 启动 “连接字符串 ”对话框以编辑连接字符串。

• 将映射导出到 XML 允许备份映射。 稍后可以使用导入映射功能还原它们。 使用导入/导出功能可在终结点之间共享映射。

• 导入映射或 RE 允许您导入由 主机应用程序配置的 BizTalk 适配器 对话框导出的 XML。 还可以在选择映射时导入 TI 管理器导出的 RE 定义。

• 查看 TI .NET 程序集的属性 将显示程序集属性。 XML 标记显示此程序集支持的输入/输出文档的名称。 方法名称是标记名称的一部分，但在查找映射时不使用该方法。 所有属性都是只读的。

映射数据网格窗口

“映射 DataGrid”对话框包含以下项：

• 状态 （完整或不完整）。 如果连接字符串缺少连接信息，则会显示红色圆圈指示的警告，并带有白色感叹号。 添加缺失信息后，警告将消失。

• 用作映射一部分的 TI 程序集的 ClassName 和接口名称。

• 程序集 名称。 如果程序集是从 GAC 加载的，则为其强名称；或者如果是本地程序集，则为完整路径。 此字段在添加程序集时自动填充，并且是只读的。

• 远程环境 定义连接字符串。 这表示从 BizTalk 主机应用程序适配器接收请求的远程系统的特征。 连接字符串由远程环境类型、编程模型、远程主机标识、网络传输和其他与远程主机通信时使用的设置组成。

• 远程终结点 远程 IBM 主机的 DNS 名称或 IP 地址。

• 结果窗格 显示当前所选映射的连接字符串的值。

创建和管理映射

本部分介绍可执行的任务。

添加程序集以创建连接字符串

在工具栏上，单击文件夹图标，然后选择 “从 GAC 添加程序集 ”或 “添加本地程序集”。 从 GAC 添加程序集 将启动一个对话框，其中列出了可以选择的 GAC 中的所有程序集。 如果选择 “添加本地程序集”，则可以浏览本地安装的程序集。

还可以使用 “添加 GAC”添加 程序集或从菜单中 添加本地程序集选项来添加程序集 。

删除连接字符串

选择要删除的一个或多个映射。 单击工具栏上的 [X] 图标以删除所选映射。 将显示一个对话框，以便确认删除。

还可以使用菜单中的 “删除映射 ”选项删除映射。

编辑连接字符串

• 连接字符串用于冻结 RE 实例。 指定程序集时，会用默认值填充它。 双击所选映射，选择“ 编辑”，或选择 “编辑连接字符串 ”菜单以启动“ 连接字符串 ”对话框。 这样，就可以编辑指定 RE 的连接字符串。 如果未输入所需的值，将显示错误标志。

• RE 对象验证所需的最小属性值。 如果未设置所需的属性值，则会标记连接字符串单元格。 本主题的 “连接字符串设置和映射” 部分列出了所需的属性。 RE 验证在范围内受到限制，不适当的值可能会导致 TI 运行时错误。

• 该对话框在网格中显示可编辑和不可编辑的属性。 底部的只读文本框显示基于属性网格中输入的值创建的连接字符串。 属性是根据 RE 对象定义的公共方法收集的，其值由对象本身定义。 提供了某些类型转换器和属性编辑器，以帮助编辑属性值。

• 远程环境 显示连接到主机所需的属性。 这些值由属性网格中的星号 × 指示。 如果缺少一个或多个属性，则会在数据网格上显示带有白色感叹号的红色圆圈。 此警告通知你在运行时可以使用替代来提供缺少的属性。

• 安全设置由预定义的安全枚举控制，这些枚举可以通过使用 OR 运算符组合成新的安全设置。

  Off 标志是客户端、包和用户的独占标志。 勾选任意其他三个中的一个时，关闭将被清除。 选中 “关闭 ”后，将清除所有其他三个选项。

  SSOApplication 编辑器从上一版本移植，并进行了细微的更改。 可以直接在属性网格中指定关联应用程序，或使用编辑器选取已创建的应用程序。

连接字符串设置和映射

下表显示了定义主机环境和编程模型的受支持属性。 星号指示所需的属性。

默认值由 RE 对象本身设置，并执行有限的验证。

SNA 用户数据

*必填字段。

SNA 链接

*必填字段。

HTTP 用户数据

*必填字段。

HTTP 链接

*必填字段。

IMS LU6.2

*必填字段。

IMS Connect

*必填字段。

TRM 用户数据/链接

*必填字段。

ELM 用户数据/链接

*必填字段。

分布式程序调用

*必填字段。

系统 Z 套接字用户数据/链接

*必填字段。

System I 套接字用户数据

*必填字段。

导入映射

若要导入 BizTalk 适配器为宿主应用程序配置所导出的映射，请单击 “导入映射或 REs” 图标。 选择“导入映射”，或从“文件”菜单中选择“导入映射”。 然后，您可以浏览查找由 BizTalk 适配器用于主机应用程序配置 对话框导出的 XML 文件。 选择要导入的文件。 导入过程不会覆盖现有映射。

导入 RE 定义

使用此方式导入 TI 管理器导出的 RE 定义。 选择映射后，单击导入映射或REs图标。 选择“导入 REs”或从“文件”菜单中选择“导入 REs”。 然后，可以浏览 TI 管理器导出的 XML。 将显示一个对话框，其中列出了可以选择的 RE 定义。 仅显示与所选映射具有相同程序模型的 RE 定义。

导出映射

若要将映射导出到 XML 文件，请单击“导出到 XML 图标”的映射，或从“文件”菜单中选择“导出映射”。 然后，可以浏览到可以保存文件的位置。 可以使用 导入映射 功能导入此文件。

程序集属性

可以查看程序集的相关属性，以及此程序集支持的输入/输出文档的 XML 标记名称。 方法名称是标记名称的一部分，但在查找映射时不使用此方法。 所有属性都是只读的。 选择映射，然后单击程序集属性图标，或从菜单中选择 显示程序集属性 。

从以前版本的 Host Integration Server 升级

本部分介绍如何迁移现有 BAHA 应用程序以使用连接字符串：

• 如果在 BAHA 中使用了默认 RE，请使用 TI 管理器导出配置，然后使用 “连接字符串 ”对话框导入配置。

• 如果使用非默认 RE，请将部署对象与 TI 管理器中的新 RE 相关联，并在 TI 管理器中导出配置。 使用 “连接字符串 ”对话框导入配置。

• 如果不使用连接字符串，则无法在 BizTalk Server 管理中切换 RU，因为已删除 “主机类型 ”对话框。

• 不支持通过 BizTalk Server 管理进行 RE 重写。 虽然可以使用消息上下文来实现 RE 重写，但我们不建议这样做。 建议使用连接字符串。

• 如果指定了非默认 SSO 应用程序，则可以使用 TI 管理器将 RE 与非默认 SSO 应用程序相关联，并继续使用静态 RE。 或者，可以在连接字符串中指定它。

  导入 TI 管理器导出的 XML

  除非执行迁移，否则不需要 TI 管理器。 可以将 RU 和 WIP 对象的定义导出到 XML 文件，可以通过 连接字符串 对话框导入该文件。

用于主机应用程序配置的 BizTalk 适配器利用 Host Integration Server 2009 中引入的动态 RE 功能。 使用动态 RE 时，只要已知主机连接信息，就可以在调用方法之前指定 TI 运行时所需的主机信息。 在调用其方法之前，不必在 TI 管理器中部署和关联 .NET 客户端程序集与预定义的 RE。

对于 BAHA，连接信息可以内置到一个连接字符串中，该连接字符串经过分析和设置为在运行时创建的 RE 对象。 配置托管主机应用程序适配器的端口时，可以指定有关 RE 的信息。 它作为 BizTalk 管理设施管理的端口配置信息的一部分存储。 使用此方法，使用 BAHA 将 .NET 应用程序与主机应用程序集成，只需使用 TI 设计器来创建 TI .NET 客户端程序集。 所有其他任务都可以在 BizTalk Server 中完成。

下表描述了工具栏菜单和操作。

另请参阅

适用于主机应用程序的 BizTalk 适配器