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。

  1. 打开命令窗口。
  2. 输入下列命令或脚本:

验证转换映射和文档流定义

要验证您导入的转换映射和文档定义在“社区控制台”中是否可用,请执行下列步骤:

  1. 单击中心管理 > 中心配置 > 映射 > 转换映射

    这样会显示 S_DT_XML_TO_EDI 映射。

  2. 单击映射旁的查看详细信息图标。

    您将看到与该映射关联的文档流定义:

    表 29. 与映射关联的文档流定义
    目标
    包:无
    协议:FVT-XML-TEST(全部)
    文档流:ICGCPO(全部)
    包:不适用
    协议:MX12V3R1(全部)
    文档流:850(全部)

S_DT_XML_TO_EDI 映射被定义成接受 XML 文档并将它转换成 EDI 事务。

配置目标

在本部分中,您将为中心创建文件系统目录目标:

  1. 单击中心管理 > 中心配置 > 目标,然后单击创建目标
  2. 对于目标名称,输入:XMLFileTarget
  3. 从传输列表中,选择文件目录
  4. 对于根路径,输入:/Data/Manager/xmltarget
  5. 从配置点列表,选择预处理
  6. 从“可用列表”中选择 com.ibm.bcg.edi.receiver.preprocesshandler.XMLSplitterHandler, 然后单击添加以将它移到“已配置的列表”中。
  7. 单击保存

社区管理者将 XML 文档发送到该目标。

创建交互

您将创建两个交互 - 一个针对 XML 到 EDI 变换,一个针对EDI 包络

创建一个交互,它具有表示 XML 文档的源;创建一个目标,它表示已转换的 850 交互。

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互 然后单击创建交互
  3. 展开包:无协议:FVT-XML-TEST, 然后选择文档流:ICGCPO
  4. 展开包:不适用协议:MX12V3R1, 然后选择文档流:850
  5. 从转换映射列表,选择 S_DT_XML_TO_EDI
  6. 从操作列表,选择 XML 转换和 EDI 验证
  7. 单击保存

该交互表示 XML 文档到 EDI 事务的转换,因此,必须选择转换映射。

创建表示 EDI 包络的交互。

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互 然后单击创建交互
  3. 展开包:不适用协议:EDI-X12, 然后选择文档流:ISA
  4. 展开包:无协议:EDI-X12, 然后选择文档流:ISA
  5. 从操作列表中,选择传递
    注: 在该交互中未发生转换。
  6. 单击保存

创建参与者

在本示例中,有两个参与者:社区管理者(Manager)和参与者(TP1)。

创建社区管理者概要文件:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击创建
  2. 对于“公司登录名”,输入:ComManager
  3. 对于“参与者显示名”,输入:Manager
  4. 对于“参与者类型”,选择社区管理者
  5. 对于企业标识单击新建,然后输入 000000000 作为自由格式的标识。
    注: 请确保选择“自由格式”,而不是 DUNS。
  6. 对于企业标识再次单击新建,然后输入 01-000000000 作为自由格式标识。
  7. 单击保存

创建第二个参与者:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击创建
  2. 对于“公司登录名”,输入 TP1
  3. 对于“参与者显示名称”,输入 TP1
  4. 对于“参与者类型”,选择Manager
  5. 对于企业标识单击新建,然后输入 000000001 作为自由格式的标识。
    注: 请确保选择“自由格式”,而不是 DUNS。
  6. 对于企业标识再次单击新建,然后输入 01-000000001 作为自由格式标识。
  7. 单击保存

创建网关

为示例中的两个参与者创建文件目录网关。首先,为 Manager 创建网关:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 单击 Manager 概要文件旁的查看详细信息图标。
  3. 单击网关,然后单击创建
  4. 输入下列网关值。 请记住:文件目录(完整路径)必须已经存在于文件系统中。
    1. 对于名称,输入 ManagerFileGateway
    2. 从传输列表中,选择文件目录
    3. 对于地址,输入:file:///Data/Manager/filegateway
    4. 单击保存
  5. 单击列表以列出社区管理者的所有网关。
  6. 单击查看缺省网关
  7. 生产列表中,选择您在步骤4中创建的网关。
  8. 单击保存

接下来,为参与者创建网关。

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 通过单击 TP1 旁的查看详细信息图标,选择您为该示例创建的另一个参与者。
  3. 单击网关,然后单击创建
  4. 输入下列网关值。 请记住:文件目录(完整路径)必须已经存在。
    1. 对于名称,输入 TP1FileGateway
    2. 从传输列表中,选择文件目录
    3. 对于地址,输入:file:///Data/TP1/filegateway
    4. 单击保存
  5. 单击列表以列出参与者的所有网关。
  6. 单击查看缺省网关
  7. 生产列表中,选择您在步骤4中创建的网关。
  8. 单击保存

设置 B2B 能力

启用该交换中两个参与者的 B2B 能力。在本示例中,XML 文档是由社区管理者发出的,并且将传递到参与者。

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 单击该示例的源参与者(ComMan)的查看详细信息图标。
  3. 单击 B2B 能力
  4. 为源参与者启用 3 组能力。
    1. 启用表示 XML 文档的文档流定义:
      1. 单击包:无设置源下的角色不活动图标,以启用它。
      2. 展开包:无
      3. 单击针对协议:FVT-XML-TEST(全部)设置源下的角色不活动图标。
      4. 展开协议:FVT-XML-TEST(全部)
      5. 单击针对文档流:ICGCPO(全部)设置源下的角色不活动图标。
    2. 接下来,启用表示已转换文档的文档流定义:
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:MX12V3R1(全部)设置源下的角色不活动图标。
      4. 展开协议:MX12V3R1(全部)
      5. 单击针对文档流:850设置源下的角色不活动图标。
    3. 然后,启用表示 EDI 包络的文档流定义:
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议 EDI-X12(全部)设置源下的角色不活动图标。
      4. 展开协议 EDI-X12(全部)
      5. 单击针对文档流:ISA(全部)设置源下的角色不活动图标。
  5. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  6. 单击该示例的目标参与者(TP1)的查看详细信息图标。
  7. 单击 B2B 能力
  8. 为目标参与者启用两组能力。
    1. 首先,启用表示 EDI 850 事务的文档流定义:
      1. 单击针对包:不适用设置目标下的角色不活动图标,以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:MX12V3R1(全部)设置目标下的角色不活动图标。
      4. 展开协议:MX12V3R1(全部)
      5. 单击针对文档流:850(全部)设置目标下的角色不活动图标。
    2. 接下来,启用文档流定义:
      1. 单击针对包:无设置目标下的角色不活动图标,以启用它。
      2. 展开包:无
      3. 单击针对协议:EDI-X12(全部)设置目标下的角色不活动图标。
      4. 展开协议:EDI-X12(全部)
      5. 单击针对文档流:ISA(全部)设置目标下的角色不活动图标。

创建包络概要文件

接下来,为将要包含已转换 850 事务的包络创建概要文件。

  1. 单击中心管理 > 中心配置 > EDI > 包络概要文件
  2. 单击创建
  3. 输入概要文件的名称:EnvProf1
  4. 从 EDI 标准列表,选择 X12
  5. 缺省情况下,常规按钮是选中的。 为包络的常规属性输入下列值:
  6. 单击交换按钮,并为交换属性输入下列值:
  7. 单击保存

创建 XML 格式

在本部分中,您将创建定制的 XML 格式。

  1. 单击中心管理 > 中心配置 > XML 格式
  2. 单击创建 XML 格式
  3. 对于“路由格式”,选择 FVT-XML-TEST ALL
  4. 对于“文件类型”,选择 XML
  5. 对于“标识类型”,选择根标记,并输入 MMDoc
  6. 对于“源企业标识”,选择常量,并输入 000000000
  7. 对于“目标企业标识”,选择常量,并输入 000000001
  8. 对于“源文档流”,选择常量,并输入 ICGCPO
  9. 对于“源文档流版本”,选择常量,并输入 ALL
  10. 单击保存

激活连接

激活参与者连接:

  1. 单击帐户管理 > 参与者连接
  2. 从源列表选择Manager
  3. 从目标列表选择 TP1
  4. 单击搜索
  5. 对以下连接单击激活
    表 30. XML 文档到 EDI 事务的连接
    目标
    包:无(不适用)
    协议:FVT-XML-TEST(全部)
    文档流:ICGCPO(全部)
    包:N/A(不适用)
    协议:MX12V3R1(全部)
    文档流:850(全部)
  6. 对表示 EDI 包络的连接,单击激活
    表 31. EDI 包络连接
    目标
    包:N/A(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)
    包:无(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)

配置属性

配置目标参与者(TP1)和源参与者(Manager)的 B2B 能力属性:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 单击 TPI 旁边的查看详细信息图标以选中它。
  3. 单击 B2B 能力
  4. 单击包:不适用旁的展开图标。
  5. 单击协议:MX12V3R1 旁的编辑图标。
  6. 指定下列属性:
    1. 在“包络概要文件”行中,从列表选择 EnvProf1
    2. 在“交换限定符”行中,输入 01
    3. 在“交换标识”行中,输入 000000001
    4. 在“交换用途指示符”行中,输入 T
  7. 单击保存
  8. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  9. 单击 Manager 旁的查看详细信息以选择它。
  10. 单击 B2B 能力
  11. 单击包:不适用旁的展开图标。
  12. 单击协议:MX12V3R1(全部)旁的编辑图标。
  13. 指定下列属性:
    1. 在“交换限定符”行中,输入 01
    2. 在“交换标识”行中,输入 000000000
    3. 在“交换用途指示符”行中,输入 T
  14. 单击保存

此时,如果源参与者(社区管理者)将 XML 文档发送到参与者, 则会(在中心)将它转换成 EDI 事务并封包,然后发送到参与者的网关。

Copyright IBM Corp. 2003, 2005