XML 到 EDI 的示例
本部分提供一个示例,社区管理者将 XML 文档发送到中心,其中,该文档将被转换成 EDI 事务,封包在 EDI 交换中,然后被发送到参与者。
在本示例中,假设 Data Interchange Services 映射专家已经创建了一个转换映射,它接受 XML 文档并将之转换成标准的
EDI 850 事务(用 MX12V3R1 字典定义),该事务将由参与者处理。
在本示例中,映射名为 S_DT_XML_TO_EDI.eif。
Data Interchange Services 映射专家可以将转换映射直接导出到 WebSphere Partner Gateway 数据库。
或者,Data Interchange Services 映射专家可以向您发送文件,在这种情况下,您可以使用 bcgDISImport 实用程序来将它导入
WebSphere Partner Gateway。本附录假设第二种方案。
导入转换映射
本部分描述导入转换映射的步骤,该映射接受 XML 输入并将它转换成 EDI 事务。
在导入转换映射过程中,还将导入与映射关联的文档定义。
在导入转换映射之前,Data Interchange Services 映射专家必须将它发送给您。这组步骤假设系统上存在文件 S_DT_XML_TO_EDI.eif。
- 打开命令窗口。
- 输入下列命令或脚本:
- 在 UNIX 系统上:
<ProductDir>/bin/bcgDISImport.sh <database_user_ID>
<password> S_DT_XML_TO_EDI.eif
- 在 Windows 系统上:
<ProductDir>\bin\bcgDISImport.bat <database_user_ID>
<password> S_DT_XML_TO_EDI.eif
其中,<database_user_ID> 和 <password>
是当您将数据库作为 WebSphere Partner Gateway 安装的一部分进行安装时使用的值。
验证转换映射和文档流定义
要验证您导入的转换映射和文档定义在“社区控制台”中是否可用,请执行下列步骤:
- 单击中心管理 > 中心配置 > 映射 > 转换映射。
这样会显示 S_DT_XML_TO_EDI 映射。
- 单击映射旁的查看详细信息图标。
您将看到与该映射关联的文档流定义:
表 29. 与映射关联的文档流定义
源 |
目标 |
包:无
协议:FVT-XML-TEST(全部)
文档流:ICGCPO(全部) |
包:不适用
协议:MX12V3R1(全部)
文档流:850(全部) |
S_DT_XML_TO_EDI 映射被定义成接受 XML 文档并将它转换成 EDI 事务。
配置目标
在本部分中,您将为中心创建文件系统目录目标:
- 单击中心管理 > 中心配置 > 目标,然后单击创建目标。
- 对于目标名称,输入:XMLFileTarget
- 从传输列表中,选择文件目录。
- 对于根路径,输入:/Data/Manager/xmltarget
- 从配置点列表,选择预处理。
- 从“可用列表”中选择 com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler,
然后单击添加以将它移到“已配置的列表”中。
- 单击保存。
社区管理者将 XML 文档发送到该目标。
创建交互
您将创建两个交互 - 一个针对 XML 到 EDI 变换,一个针对EDI 包络。
创建一个交互,它具有表示 XML 文档的源;创建一个目标,它表示已转换的 850 交互。
- 单击中心管理 > 中心配置 > 文档流定义。
- 单击管理交互 然后单击创建交互。
- 展开包:无和协议:FVT-XML-TEST,
然后选择文档流:ICGCPO。
- 展开包:不适用和协议:MX12V3R1,
然后选择文档流:850。
- 从转换映射列表,选择 S_DT_XML_TO_EDI。
- 从操作列表,选择 XML 转换和 EDI 验证。
- 单击保存。
该交互表示 XML 文档到 EDI 事务的转换,因此,必须选择转换映射。
创建表示 EDI 包络的交互。
- 单击中心管理 > 中心配置 > 文档流定义。
- 单击管理交互 然后单击创建交互。
- 展开包:不适用和协议:EDI-X12,
然后选择文档流:ISA。
- 展开包:无和协议:EDI-X12,
然后选择文档流:ISA。
- 从操作列表中,选择传递。
注: 在该交互中未发生转换。
- 单击保存。
创建参与者
在本示例中,有两个参与者:社区管理者(Manager)和参与者(TP1)。
创建社区管理者概要文件:
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击创建。
- 对于“公司登录名”,输入:ComManager
- 对于“参与者显示名”,输入:Manager。
- 对于“参与者类型”,选择社区管理者。
- 对于企业标识单击新建,然后输入 000000000 作为自由格式的标识。
注: 请确保选择“自由格式”,而不是 DUNS。
- 对于企业标识再次单击新建,然后输入 01-000000000 作为自由格式标识。
- 单击保存。
创建第二个参与者:
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击创建。
- 对于“公司登录名”,输入 TP1
- 对于“参与者显示名称”,输入 TP1
- 对于“参与者类型”,选择Manager。
- 对于企业标识单击新建,然后输入 000000001 作为自由格式的标识。
注: 请确保选择“自由格式”,而不是 DUNS。
- 对于企业标识再次单击新建,然后输入 01-000000001 作为自由格式标识。
- 单击保存。
创建网关
为示例中的两个参与者创建文件目录网关。首先,为 Manager 创建网关:
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 单击 Manager 概要文件旁的查看详细信息图标。
- 单击网关,然后单击创建。
-
输入下列网关值。
请记住:文件目录(完整路径)必须已经存在于文件系统中。
- 对于名称,输入 ManagerFileGateway。
- 从传输列表中,选择文件目录。
- 对于地址,输入:file:///Data/Manager/filegateway
- 单击保存。
- 单击列表以列出社区管理者的所有网关。
- 单击查看缺省网关。
- 从生产列表中,选择您在步骤4中创建的网关。
- 单击保存。
接下来,为参与者创建网关。
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 通过单击 TP1 旁的查看详细信息图标,选择您为该示例创建的另一个参与者。
- 单击网关,然后单击创建。
-
输入下列网关值。
请记住:文件目录(完整路径)必须已经存在。
- 对于名称,输入 TP1FileGateway。
- 从传输列表中,选择文件目录。
- 对于地址,输入:file:///Data/TP1/filegateway
- 单击保存。
- 单击列表以列出参与者的所有网关。
- 单击查看缺省网关。
- 从生产列表中,选择您在步骤4中创建的网关。
- 单击保存。
设置 B2B 能力
启用该交换中两个参与者的 B2B 能力。在本示例中,XML 文档是由社区管理者发出的,并且将传递到参与者。
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 单击该示例的源参与者(ComMan)的查看详细信息图标。
- 单击 B2B 能力。
- 为源参与者启用 3 组能力。
- 启用表示 XML 文档的文档流定义:
- 单击包:无的设置源下的角色不活动图标,以启用它。
- 展开包:无。
- 单击针对协议:FVT-XML-TEST(全部)的设置源下的角色不活动图标。
- 展开协议:FVT-XML-TEST(全部)。
- 单击针对文档流:ICGCPO(全部)的设置源下的角色不活动图标。
- 接下来,启用表示已转换文档的文档流定义:
- 单击针对包:不适用的设置源下面的角色不活动图标以启用它。
- 展开包:不适用.
- 单击针对协议:MX12V3R1(全部)的设置源下的角色不活动图标。
- 展开协议:MX12V3R1(全部)。
- 单击针对文档流:850 的设置源下的角色不活动图标。
- 然后,启用表示 EDI 包络的文档流定义:
- 单击针对包:不适用的设置源下面的角色不活动图标以启用它。
- 展开包:不适用.
- 单击针对协议 EDI-X12(全部)的设置源下的角色不活动图标。
- 展开协议 EDI-X12(全部)。
- 单击针对文档流:ISA(全部)的设置源下的角色不活动图标。
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 单击该示例的目标参与者(TP1)的查看详细信息图标。
- 单击 B2B 能力。
- 为目标参与者启用两组能力。
- 首先,启用表示 EDI 850 事务的文档流定义:
- 单击针对包:不适用的设置目标下的角色不活动图标,以启用它。
- 展开包:不适用.
- 单击针对协议:MX12V3R1(全部)的设置目标下的角色不活动图标。
- 展开协议:MX12V3R1(全部)。
- 单击针对文档流:850(全部)的设置目标下的角色不活动图标。
- 接下来,启用文档流定义:
- 单击针对包:无的设置目标下的角色不活动图标,以启用它。
- 展开包:无。
- 单击针对协议:EDI-X12(全部)的设置目标下的角色不活动图标。
- 展开协议:EDI-X12(全部)。
- 单击针对文档流:ISA(全部)的设置目标下的角色不活动图标。
创建包络概要文件
接下来,为将要包含已转换 850 事务的包络创建概要文件。
- 单击中心管理 > 中心配置 > EDI > 包络概要文件。
- 单击创建。
- 输入概要文件的名称:EnvProf1。
- 从 EDI 标准列表,选择 X12。
- 缺省情况下,常规按钮是选中的。
为包络的常规属性输入下列值:
- INTCTLLEN:9
- GRPCTLLEN:9
- TRXCTLLEN:9
- MAXDOCS:1000
- 单击交换按钮,并为交换属性输入下列值:
- ISA01:01
- ISA02:ISA0000002
- ISA03:02
- ISA04:ISA0000004
- ISA11:U
- ISA12:00301
- ISA15:T
- 单击保存。
创建 XML 格式
在本部分中,您将创建定制的 XML 格式。
- 单击中心管理 > 中心配置 > XML 格式。
- 单击创建 XML 格式。
- 对于“路由格式”,选择 FVT-XML-TEST ALL。
- 对于“文件类型”,选择 XML。
- 对于“标识类型”,选择根标记,并输入 MMDoc。
- 对于“源企业标识”,选择常量,并输入 000000000。
- 对于“目标企业标识”,选择常量,并输入 000000001。
- 对于“源文档流”,选择常量,并输入 ICGCPO。
- 对于“源文档流版本”,选择常量,并输入 ALL。
- 单击保存。
激活连接
激活参与者连接:
- 单击帐户管理 > 参与者连接。
- 从源列表选择Manager。
- 从目标列表选择 TP1。
- 单击搜索。
- 对以下连接单击激活:
表 30. XML 文档到 EDI 事务的连接
源 |
目标 |
包:无(不适用)
协议:FVT-XML-TEST(全部)
文档流:ICGCPO(全部) |
包:N/A(不适用)
协议:MX12V3R1(全部)
文档流:850(全部) |
- 对表示 EDI 包络的连接,单击激活:
表 31. EDI 包络连接
源 |
目标 |
包:N/A(不适用)
协议:EDI-X12(全部)
文档流:ISA(全部) |
包:无(不适用)
协议:EDI-X12(全部)
文档流:ISA(全部) |
配置属性
配置目标参与者(TP1)和源参与者(Manager)的 B2B 能力属性:
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 单击 TPI 旁边的查看详细信息图标以选中它。
- 单击 B2B 能力。
- 单击包:不适用旁的展开图标。
- 单击协议:MX12V3R1 旁的编辑图标。
- 指定下列属性:
- 在“包络概要文件”行中,从列表选择 EnvProf1。
- 在“交换限定符”行中,输入 01。
- 在“交换标识”行中,输入 000000001。
- 在“交换用途指示符”行中,输入 T。
- 单击保存。
- 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索。
- 单击 Manager 旁的查看详细信息以选择它。
- 单击 B2B 能力。
- 单击包:不适用旁的展开图标。
- 单击协议:MX12V3R1(全部)旁的编辑图标。
- 指定下列属性:
- 在“交换限定符”行中,输入 01。
- 在“交换标识”行中,输入 000000000。
- 在“交换用途指示符”行中,输入 T。
- 单击保存。
此时,如果源参与者(社区管理者)将 XML 文档发送到参与者,
则会(在中心)将它转换成 EDI 事务并封包,然后发送到参与者的网关。
