用于主机文件的 BizTalk 适配器配置
概述
用于主机文件的 BizTalk 适配器是一种发送和接收适配器，使 BizTalk 业务流程能够与主机系统交互。 具体而言，适配器支持通过 TCP/IP 和 APPC 连接对大型机和 IBM i 平台上运行的主机文件执行发送和接收操作。 基于 Host Integration Server 技术，适配器使用数据访问库元数据程序集来配置连接，Microsoft .NET Framework主机文件的数据提供程序来发出 SQL 命令和存储过程。
适配器提供两个main函数：
对于 (单向响应和请求响应) 的 发送 操作，适配器会将 SQL 命令和系统命令发送到主机文件实例，并提供请求响应的选项。
对于 接收 操作 (仅单向) 适配器将创建一个 SQL 命令，用于轮询主机文件对象并创建每行消息，然后将其提交到 BizTalk 消息系统。
此外，用于主机文件的 BizTalk 适配器使用标准 BizTalk 适配器跟踪工具作为故障排除机制。
注意
适用于主机文件的 BizTalk 适配器是非事务性适配器。 这意味着执行操作后，无法撤消或回滚操作。
创建元数据程序集
安装适配器后，可以创建一个元数据程序集，用于描述远程系统以BizTalk Server。
在 Visual Studio 中创建主机文件应用程序的过程的一部分是描述主机文件系统的布局。 此过程将创建元数据程序集和架构。 元数据程序集是远程主机文件系统的编程表示形式，而架构是主机文件系统的 XML 表示形式。 你将使用元数据程序集来描述要BizTalk Server的主机文件系统。
有关如何在 Visual Studio 中创建主机文件应用程序的详细信息，请参阅 使用托管数据提供程序为主机文件创建应用程序。
创建发送端口
使用属于 BizTalk Server 管理员组成员的帐户登录。
在“BizTalk Server管理”中，依次展开“BizTalk 组”、“应用程序”，然后选择应用程序。
右键单击“ 发送端口”，选择“ 新建”，然后选择“ 静态单向发送端口 ”或“ 请求响应发送端口”。
在 “发送端口属性”中，将 “传输类型” 设置为 “主机文件”。 选择“ 配置”，并输入以下属性：
使用此选项 要执行此操作 连接字符串 用于连接到主机文件数据库的连接字符串的名称。
若要配置新的或现有的连接字符串，请单击省略号 (...) 。 这会启动数据源向导。 若要访问“帮助”，请在向导页上单击“ 帮助 ”，或打开“主机集成服务器帮助”，然后在 “数据源向导”中查找 (“主机文件”) 。文档目标命名空间 发送到主机的 XML 文档中使用的目标命名空间。 响应根元素名称 从主机接收的 XML 文档中使用的根元素名称。 (对于单向端口，此属性可能为空。) URI 统一资源标识符。 用于标识发送端口位置的名称。 选择“确定”，保存所做更改。
对于 “发送处理程序”，选择要运行适配器的主机实例，然后选择“ 发送管道”。
选择“确定”，保存所做更改。
在 “发送端口”中，右键单击新的发送端口，选择“ 登记 ”，然后选择“ 开始”。
创建接收端口和位置
使用属于 BizTalk Server 管理员组成员的帐户登录。
在“BizTalk Server管理”中，依次展开“BizTalk 组”、“应用程序”，然后选择应用程序。
右键单击“ 接收端口”，选择“ 新建”，然后选择“ 静态单向接收端口”。 配置 “接收端口属性”，然后选择“ 确定 ”以保存更改。
右键单击“ 接收位置”，选择“ 新建”，然后选择“ 单向接收位置”。 选择创建的接收端口，然后选择 “确定”。
在 “接收位置属性”中，将 “传输类型” 设置为 “HostFiles”。 选择“ 配置”，并输入以下属性：
使用此选项 要执行此操作 连接字符串 输入将用于连接到主机数据库的连接字符串的名称。
若要配置新的或现有的连接字符串，请单击省略号 (...) 。 这会启动数据源向导。 若要访问“帮助”，请在向导屏幕上单击“ 帮助 ”，或打开“主机集成服务器帮助”，并在 “数据源向导” (“主机文件”) 。
基于主机文件的 BizTalk 适配器配置接收位置或发送端口时，元数据定义应创建为主机集成Designer XML (HIDX) 元数据文件，用于编码和解码记录。 有关如何创建 HIDX 文件的说明，请参阅 使用托管数据提供程序为主机文件创建应用程序。文档根元素名称 从主机接收的 XML 文档中使用的根元素名称。 文档目标命名空间 从主机接收的 XML 文档中使用的目标命名空间。 SQL 命令 为每个轮询间隔执行一次的 Select 命令。 更新命令 在处理接收操作中的每一行之后执行的命令。 它可以是删除 SQL 命令中表中的行的 delete 语句，也可以是静态修改一行或多行的 update 命令。 指定此选项后，SQL 命令必须是 Select 语句并访问单个表。
可以通过单击省略号 (...) 按钮来指定其他属性。 这将打开 “更改命令 ”对话框，该对话框提供三个选项：
- 如果选择了其他两个选项，则不执行任何操作。
- 读取后删除 在适配器读取行后删除该行。
- 通过更新 ，可以键入要更新的 SQL 命令。URI 统一资源标识符。 标识接收端口位置的名称。 轮询间隔 轮询请求之间的单位数。 允许的范围是 1 - 65535。 轮询度量单位 轮询请求之间) 使用的度量单位 (秒、分钟或小时。 默认值为秒。 选择“确定”，保存所做更改。
对于 “接收处理程序”，请选择主机实例。 接收处理程序必须在此主机上运行。 选择 接收管道。
选择“确定”，保存所做更改。
在 “接收位置”中，右键单击接收位置，然后选择“ 启用”。
创建架构
使用主机文件架构生成向导为主机文件的 BizTalk 适配器创建 XSD 架构。 创建架构后，即可在BizTalk Server端继续配置。
打开BizTalk Server Visual Studio 项目。
右键单击项目，依次选择“ 添加”、“ 添加生成的项”和“ 添加适配器元数据”。
在“添加适配器向导”的“ 选择适配器” 页上，选择“ 主机文件”，然后选择“ 下一步”。
在主机文件适配器架构生成向导中：
在“数据库信息”中，浏览到现有连接字符串或新建一个。
这可以是初始目录、包集合、 (TCP 地址和端口) 或 (APPC 本地 LU、远程 LU 和模式) 、 (用户名和密码) 或 (集成安全) 。 最大长度为 1024。
在 “架构信息”中，定义要在架构中使用的默认命名空间、根元素和端口类型。
如果选择“ 接收端口”，则只需要请求文档根元素名称。 如果选择“ 发送端口”，则需要请求和响应文档根元素名称。
在“ 语句类型信息”中，选择要发出的数据库命令的类型。
如果在上一页上选择了“发送端口”，则可以选择发出 updategram、存储过程或 SELECT 语句。 如果选择了接收端口，则不需要执行此步骤。
在 “语句信息”中，输入有关主机文件的详细信息。 根据之前在早期页面上输入的信息，输入以下属性。 如果选择了发送端口：
发送 Updategram 如果选择使用发送端口和 updategram，则可以在此处选择 updategram 操作，以及 updategram 中将存在的表和列。
发送系统命令 如果选择使用发送端口并发出存储过程，则可以从当前连接的目录中选择存储过程。 不必在此页上输入所有参数的值。
发送 Select 语句 如果选择将发送端口与 SQL Select 语句一起使用，则可以在此处选择或浏览到该语句。
如果选择了接收端口：
接收 Select 语句 如果选择将接收端口与 SQL 语句一起使用，则可以在此处选择或浏览到该语句。
发送 Updategram 如果选择使用发送端口和 updategram，则可以在此处选择 updategram 操作，以及 updategram 中将存在的表和列。
发送存储过程 如果选择使用发送端口并发出存储过程，则可以从当前连接的目录中选择存储过程。 不必在此页上输入所有参数的值。
发送 Select 语句 如果选择将发送端口与 SQL Select 语句一起使用，则可以在此处选择或浏览到该语句。
完成后选择“完成”。
创建 BizTalk 应用程序
创建架构后，可以对 BizTalk 应用程序进行编码。 除了创建的架构和端口外，应用程序还使用在 Visual Studio 中创建的元数据程序集。
在 Visual Studio 中创建 BizTalk 项目。
使用创建的架构将主机文件系统描述到 BizTalk 应用程序。
使用创建的发送端口将数据发送到主机文件系统。
如有必要，请使用创建的接收端口和位置。
根据需要添加任何其他业务流程、组件或代码。
测试应用程序。
完成应用程序测试后，创建 .msi 包，将应用程序移动到过渡服务器或实时服务器。 创建BizTalk Server .msi包时，请确保包含你创建的主机文件元数据程序集。