演练 (X12):发送批处理 EDI 交换
本演练提供了一组分步过程,用于创建一个解决方案,以便使用BizTalk Server将批处理的 EDI 交换从一方发送到另一方。
必备条件
必须以BizTalk Server管理员或BizTalk Server B2B 操作员组的成员身份登录。
解决方案如何发送批处理 EDI 交换
该解决方案将执行以下操作:
接收位置接收来自 A 方的 EDI 交换。
注意
此列表中的事件可能不会按所示顺序发生。
接收管道将 EDI 格式的交换转换为内部 XML 格式。 接收管道确定要对交换进行批处理。 因此,BatchMarkerReceivePipeline 组件将
EDI.ToBeBatched==True
提升 和EDI.BatchId
属性。 然后,它将交换放入 MessageBox 中。批处理业务流程从 MessageBox 检索收到的交换,因为它基于
EDI.ToBeBatched==True
和EDI.BatchId==%BatchID%
订阅消息。接收位置接收来自发送第一个交换的同一参与方的第二个 EDI 交换。
接收位置按照第 2 步中的说明处理交换,然后将交换放入 MessageBox 中。
批处理业务流程按照第 3 步中的说明检索交换。
满足发布条件 (发布条件定义如何匹配交换) ,批处理业务流程将组合包含所有交换的交换,然后提升
EDI.ToBeBatched==False
、EDI.BatchName
和EDI.DestinationPartyName
上下文属性。 它将批处理交换放入 MessageBox 中。发送端口通过订阅上下文属性
EDI.ToBeBatched
==FalseEDI.BatchName
和EDI.DestinationPartyName
来选取批处理的交换。发送管道将其他属性应用于批处理交换的信封,然后将交换发送到目标方 B。
注意
有关详细信息,请参阅 汇编批处理 EDI 交换。
下图显示出此解决方案的结构。
此解决方案中的功能
为进行此演练,将启用以下功能:
该解决方案专用于使用 X12 编码而不是 EDIFACT 编码的交换。
注意
用于 HIPAA 和 EDIFACT 编码的配置与用于 X12 编码的配置几近相同。
将不会返回技术确认或功能确认来响应最初接收的交换或发送的任何批处理交换。
注意
有关生成 EDI 确认的信息,请参阅 演练 (X12) :接收 EDI 交换和发送回确认。
该解决方案使用一个单向接收端口和一个静态单向发送端口。 将使用 FILE 传输类型配置这些端口。
将启用 EDI 报告。
将保存事务集以从交换状态报告进行查看。
配置和测试演练
该解决方案所需的过程包括:
将必需的消息架构添加到 BizTalk 项目,然后生成并部署该项目,以使架构可供 BizTalk Server 在处理消息时使用。
更新 BatchControlMessageReccvLoc 接收位置中 SQL 适配器的轮询间隔,以便在单击“ 开始 ”按钮发送将激活批处理业务流程实例的控制消息时,批处理业务流程将立即激活。
为BizTalk Server创建接收端口,以接收来自参与方的 EDI X12 编码 .txt 输入消息。
为参与方 A 和参与方 B 创建一个参与方(贸易合作伙伴)。
为两个贸易合作伙伴分别创建一个业务配置文件。
通过配置要接收的消息的 EDI 属性,在两个配置文件之间创建一个协议。 为要发送的批处理消息配置 EDI 属性。 对于此解决方案,只要收到两个 850 交换,就会配置这些协议,以便 BizTalk Server 向参与方 B 发送批。
为BizTalk Server创建发送端口,以将批处理的 EDI 交换发送到贸易合作伙伴。 此发送端口将是一个静态单向发送端口。
将发送端口与处理交换并对其进行批量处理的协议相关联。
将两个测试 EDI 交换放入与接收位置关联的本地文件夹,并验证 BizTalk Server 是否已将批处理交换放入与发送端口关联的文件夹。
配置演练
本部分介绍配置演练的过程。
部署消息架构
在 Visual Studio 中,创建或打开 BizTalk 项目。
注意
本主题假定你已从你的应用程序添加了对包含 EDI 架构、管道和业务流程的 BizTalk EDI 应用程序的引用。 如果没有,请参阅添加对 BizTalk Server EDI 应用程序的引用。
右键单击项目,指向 “添加”,然后单击“ 现有项”。 移动到 \Program Files (x86) \Microsoft BizTalk Server <VERSION>XSD_Schema\EDI\X12\00401,然后双击与测试消息对应的架构。
注意
如果尚未将 EDI 架构解压缩到 \XSD_Schema\EDI 文件夹中,请执行 \XSD_Schema\EDI 文件夹中的 MicrosoftEdiXSDTemplates.exe文件, 将架构解压缩到默认文件夹中。
注意
对于测试消息,您可以使用在 EDI 接口开发人员教程中使用的 850 示例消息。 此文件在 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\ 中 SamplePO.txt。 如果这样做,则必须使用位于 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI 中的架构x12_00401_850.xsd。
设置程序集密钥文件,然后生成并部署该程序集。
更新轮询间隔
在BizTalk Server管理控制台中,打开 BizTalk 组、应用程序、BizTalk EDI 应用程序节点和接收位置节点。 在“ 接收位置” 节点下,右键单击“ BatchControlMessageRecvLoc”,然后单击“ 属性”。
对于 SQL 传输类型,请单击“ 配置”。
在“ SQL 传输属性 ”对话框中,将轮询间隔设置为较小的值。 例如,可以将 轮询度量单位 更改为 秒而不是分钟,以将轮询间隔更改为 5 秒。
注意
更改轮询间隔可确保将立即激活批处理业务流程。
依次单击“确定”和“确定”。
创建接收要进行批处理的 EDI 消息的单向接收端口
创建用于接收要进行批处理的 EDI 消息的本地文件夹。
在 BizTalk Server 管理控制台中,右键单击 BizTalk 应用程序 1 节点下的“接收端口”节点,指向“新建”,然后单击“单向接收端口”。
命名接收端口,然后在控制台树中单击“ 接收位置 ”。
单击 “新建” 。
命名接收位置,为“类型”选择“文件”,然后单击“配置”。
为 “接收文件夹”输入一个文件夹,为 “文件掩码”输入掩码,例如 *.txt。
单击 “确定” 。
对于 “接收管道”,请选择“ EdiReceive”。
依次单击“确定”和“确定”。
在控制台树中,单击“ 接收位置”。 在“ 接收位置 ”窗格中,右键单击接收位置,然后单击“ 启用”。
为参与方 A 创建团队和业务配置文件
右键单击BizTalk Server管理控制台中的“参与方”节点,指向“新建”,然后单击“群”。
在“名称”文本框中输入参与方 的名称 ,然后单击“ 确定”。
注意
通过选择“本地 BizTalk 处理由参与方或支持从此群检查发送消息”框,可以指定所创建的参与方适用于同时托管BizTalk Server的同一组织。 基于此,在创建协议时将启用或禁用某些属性。 但是,对于本演练,可以将此检查框保留为选中状态。
右键单击群名称,指向 “新建”,然后单击“ 业务配置文件”。
在“配置文件属性”对话框中的“常规”页上,在“名称”文本框中输入PartyA_Profile。
注意
创建群时,还会创建配置文件。 可以重命名并使用该配置文件,而不是创建新的配置文件。 若要重命名配置文件,请右键单击该配置文件,然后选择“ 属性”。 在“ 常规 ”页中,指定配置文件的名称。
为参与方 B 创建团队和业务配置文件
右键单击BizTalk Server管理控制台中的“参与方”节点,指向“新建”,然后单击“群”。
在“名称”文本框中输入参与方 的名称 ,然后单击“ 确定”。
注意
通过选择“本地 BizTalk 处理由参与方或支持从此群检查发送消息”框,可以指定所创建的参与方适用于同时托管BizTalk Server的同一组织。 基于此,在创建协议时将启用或禁用某些属性。 但是,对于本演练,可以将此检查框保留为选中状态。
右键单击群名称,指向 “新建”,然后单击“ 业务配置文件”。
在“配置文件属性”对话框的“常规”页上,在“名称”文本框中输入PartyB_Profile。
注意
创建群时,还会创建配置文件。 可以重命名并使用该配置文件,而不是创建新的配置文件。 若要重命名配置文件,请右键单击该配置文件,然后选择“ 属性”。 在“ 常规 ”页中,指定配置文件的名称。
在两个业务配置文件之间创建协议
右键单击 “PartyA_Profile”,指向“ 新建”,然后单击“ 协议”。
在 “常规属性” 页的“ 名称 ”文本框中,输入协议的名称。
从 “协议 ”下拉列表中,选择“ X12”。
在“ 第二个合作伙伴 ”部分中,从 “名称 ”下拉列表中选择“ PartyB”。
在“ 第二个合作伙伴 ”部分中,从 “配置文件 ”下拉列表中选择 “PartyB_Profile”。
你会注意到,“ 常规 ”选项卡旁边添加了两个新选项卡。每个选项卡用于配置单向协议,每个单向协议表示一个完整的消息 (事务,包括消息传输和确认传输) 。
在“ 常规 ”选项卡的“ 常规属性” 页上的 “通用主机设置” 部分中,选择“ 打开报告”,然后选择“ 存储用于报告的消息有效负载”。
在 PartyA-PartyB> 选项卡上执行以下任务。
在“交换设置”部分下的“标识符”页上,输入与测试消息中这些标头字段的值相对应 (ISA5、ISA6、ISA7 和 ISA8) 的限定符和标识符字段的值。
注意
BizTalk Server需要发送方和接收方的限定符和标识符字段才能执行协议解析。 它将交换标头中的 ISA5、 ISA6、 ISA7 和 ISA8 的值与协议属性中的值匹配。 BizTalk Server还将通过匹配发送方限定符和标识符 (来解决协议,而无需接收方限定符和标识符) 。 如果BizTalk Server无法解决协议,它将使用回退协议属性。
注意
如果使用“EDI 接口开发人员教程”中的 SamplePO.txt 文件作为测试消息,请将 ISA5 设置为 ZZ, 将 ISA6 设置为 THEM, 将 ISA7 设置为 ZZ,将 ISA8 设置为 US。
在“ 验证 ”页上的 “交换设置” 部分下,确保未选中“ 检查重复的 ISA13 ”选项。
注意
清除 “检查重复 ISA13 ”属性可接收同一消息的多个实例。
在“交换设置”部分下的“字符集和分隔符”页上,选择“CR LF”选项。
在“ 批处理配置 ”页上的 “交换设置” 部分下,执行以下操作:
单击“ 新建批处理”。
在“ 标识” 部分下,对于 “批名称” 文本,输入
Batch1
。在“ 筛选器 ”部分下,单击“ 筛选 ”按钮,然后在“ 批处理筛选器 ”对话框中执行以下操作:
单击 “属性” 列下的空单元格,然后选择“ BTS”。ReceivePortName。
单击“ 运算符” 列下的空单元格,然后选择 ==。
单击 “值 ”列下的空单元格,并输入之前创建的接收端口的名称。
单击 “确定” 。
在 “发布 ”部分下,选择“ 最大事务集数” 选项,从下拉列表中选择“ 交换”,然后在文本框中输入将批处理的交换数。 在此解决方案中,你将批处理两个交换,因此在文本框中输入
2
。在 “激活 ”部分下,选择“ 立即启动”。
在“ 信封 ”页上的 “事务集设置” 部分下,输入网格第一行中所有列的值。
使用此选项 要执行此操作 Default 选择“默认值”。 注意:选择此行作为默认值时,即使事务类型、版本/版本和目标命名空间的值与消息不匹配,也会使用 GS1、GS2、GS3、GS7 和 GS8 的值。 事务类型 选择测试消息的消息类型 “850 - 采购订单”。 版本/发行版 输入 EDI 版本 00401。 目标命名空间 选择 http://schemas.microsoft.com/BizTalk/EDI/X12/2006
。GS1 验证是否已选择测试消息的消息类型, PO - 采购订单 (850) 。 GS2 输入应用程序发件人的值,例如 “购买”。 GS3 输入应用程序接收器的值,例如 OrderControl。 GS4 选择所需的日期格式。 注意: 必须在下拉列表中选择值,而不仅仅是单击字段以显示默认值。 如果你仅单击字段,而没有从下拉列表中选择值,则实际上并未选择值。 GS5 选择所需的时间格式。 GS7 选择 “X - 认证标准委员会 X12”。 GS8 验证是否已输入 EDI 版本 00401。 注意
BizTalk Server将根据为事务类型、版本/发布和目标命名空间输入的值设置出站确认的 GS01、GS02、GS03、GS04、GS05、GS07 和 GS08 的值。 发送管道尝试将事务集类型、X12 版本和目标命名空间与消息标头中的对应值相匹配。 如果成功,它将使用与 事务类型、 版本/发布和 目标命名空间 值关联的 GS 值。
在 PartyB-PartyA> 选项卡上执行以下任务。
注意
在本演练中,我们在选项卡中指定所需的值,以便可以成功创建协议。 若要成功创建协议,这两个单向协议选项卡都必须具有为 ISA5、 ISA6、 ISA7 和 ISA8 定义的值。
在“交换设置”部分下的“标识符”页上,输入与测试消息中这些标头字段的值相对应 (ISA5、ISA6、ISA7 和 ISA8) 的限定符和标识符字段的值。
注意
如果使用“EDI 接口开发人员教程”中的 SamplePO.txt 文件作为测试消息,请将 ISA5 设置为 ZZ, 将 ISA6 设置为 US, 将 ISA7 设置为 ZZ,将 ISA8 设置为 THEM。
单击“应用”。
单击 “确定” 。 新添加的协议列在“参与方和业务配置文件”窗格的“协议”部分。 默认情况下,启用新添加的协议。
创建静态单向发送端口以发送批处理 EDI 交换
创建要将批处理 EDI 消息发送到的本地文件夹。
在 BizTalk Server 管理控制台中,右键单击 BizTalk Application 1 节点下的“发送端口”节点,指向“新建”,然后单击“静态单向发送端口”。
在“ 发送端口属性 ”对话框中,为发送端口命名。
在“传输”部分中,为“类型”选择“文件”,然后单击“配置”。
输入 目标文件夹的文件夹和 文件名,如 %MessageID%.txt。
单击 “确定” 。
在 “发送管道”中,选择“ EdiSend”。
在控制台树中,选择“ 筛选器”。 在 “筛选器 ”页上,执行以下操作:
在网格的第一行上,选择“EDI”。Property 的 DestinationPartyName,==对于 Operator,你选择的参与方将批处理发送到值的名称,和分组依据的名称。
第二行选择“EDI”。ToBeBatched 表示 Property,==为 Operator,False表示Value,And 表示 Group by。
在第三行中,选择“ EDI”。BatchName 表示 “属性”, == “ 运算符”为“,批名称表示 ”值”。
单击 “确定” 。
在控制台树中,单击“ 发送端口”。 在 “发送端口 ”窗格中,右键单击发送端口,然后单击“ 启动”。
将发送端口与为进行批处理创建的协议相关联
右键单击之前创建的协议,然后单击“ 属性”。
在“协议属性”对话框中的“PartyA-PartyB>”选项卡上,单击左窗格中的“发送端口”。
在“交换设置”部分下的“发送端口”页上,关联之前创建的发送端口。 在 “发送端口” 网格的“ 名称” 列下,单击一个空单元格,然后从下拉列表中选择发送端口。
单击 “确定” 。
测试演练
本部分提供有关如何测试演练的信息。
测试演练
在 Windows 资源管理器中,打开与接收位置关联的本地文件夹,然后将测试 EDI 交换放入该文件夹。
注意
对于测试消息,您可以使用在 EDI 接口开发人员教程中使用的 850 示例消息。 此文件在 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\ 中 SamplePO.txt。 如果这样做,则必须使用位于 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI 中的架构x12_00401_850.xsd。
将测试 EDI 交换的第二个副本放入 文件夹中。
打开与交换的发送端口关联的文件夹,并打开批处理交换。 验证交换是否包含一组 ISA 和 GS 标头以及两个事务集。
另请参阅
开发和配置 BizTalk Server EDI 解决方案
配置传出批
汇编批处理的 EDI 交换
汇编批处理的 EDI 交换
演练 (X12):接收 EDI 交换并发回确认信息
演练 (X12):发送 EDI 交换