EDI 到 ROD 示例

本部分提供了将 EDI 事务(在包络中)发送到中心的示例,在中心,该事务被转换成面向记录的数据(ROD)文档,然后被发送到社区管理者。

解包并转换 EDI 交换

在本示例中,假设 Data Interchange Services 映射专家已经创建了一个转换映射, 该映射接受标准的 EDI 850 事务(用 X12V5R1 字典定义,对应于 X12 的 V5010),并将该事务转换成将由社区管理者的后端应用程序处理的面向记录的文档(ROD)。在本示例中,映射名为 S_DT_EDI_TO_ROD.eif。

Data Interchange Services 映射专家可以将转换映射直接导出到 WebSphere Partner Gateway 数据库。 或者,Data Interchange Services 映射专家可以向您发送文件,在这种情况下,您可以使用 bcgDISImport 实用程序来将文件导入 WebSphere Partner Gateway。本附录假设第二种方案。

导入转换映射

本部分描述导入转换映射的步骤,该映射接受 EDI 输入并将它转换成面向记录的数据(ROD)格式。 在导入转换映射过程中,您还会导入与映射关联的文档定义。

在导入转换映射之前,Data Interchange Services 映射专家必须将它发送给您。这组步骤假设系统上存在文件 S_DT_EDI_TO_ROD.eif。

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

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

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

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

    这样会显示 S_DT_EDI_TO_ROD 映射。

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

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

    表 19. 与映射关联的文档流定义
    目标
    包:不适用
    协议:X12V5R1(全部)
    文档流:850(全部)
    包:无
    协议:DEMO850CL_DICTIONARY(全部)文档流:DEMO850CLSUW(全部)

S_DT_EDI_TO_ROD 映射被定义成接受 X12 850 事务(它遵循 X12V5R1 标准),并将它转换成定制协议(DEMO850CL_DICTIONARY)和文档流(DEMO850CLSUW)。

配置目标

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

  1. 单击中心管理 > 中心配置 > 目标,然后单击创建目标
  2. 对于目标名称,输入:EDIFileTarget
  3. 从传输列表中,选择文件目录
  4. 对于根路径,输入:/Data/Manager/editarget
  5. 单击保存

社区参与者将 EDI 交换发送给该目标。

创建交互

您要创建两个交互 - 一个用于 EDI 包络,另一个用于 EDI 包络中的事务

创建表示 EDI 包络的交互。

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互 然后单击创建交互
  3. 下, 展开包:无协议:EDI-X12, 然后选择文档流:ISA
  4. 目标下, 展开包:不适用协议:EDI-X12, 然后选择文档流:ISA
  5. 从操作列表中,选择 EDI 解包
    注: 在该交互中未发生转换。 正在对 EDI 交换解包,从而产生单个事务(850)。因此,您不需要针对该交互的转换映射。
  6. 单击保存

创建一个交互,其源表示 850 事务,其目标表示已转换的文档。

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

该交互表示标准将 EDI X12 850 事务转换成另一种格式,因此,必须选择一种转换映射。

创建参与者

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

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

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

创建第二个参与者:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击创建
  2. 对于“公司登录名”,输入 TP1
  3. 对于“参与者显示名称”,输入 TP1
  4. 对于参与者类型,选择社区参与者
  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 能力。在本示例中,EDI 交换是由社区参与者(TP1)发出的,并且将传递到社区管理者。

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

激活连接

要激活连接:

  1. 单击帐户管理 > 参与者连接
  2. 从源列表选择 TP1
  3. 从目标列表选择 Manager
  4. 单击搜索
  5. 对表示包络的连接,单击激活
    表 20. 包络连接
    目标
    包:无(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)
    包:N/A(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)
  6. 对表示 850 事务到已转换文档的连接,单击激活
    表 21. EDI 事务到 ROD 文档的连接
    目标
    包:N/A(不适用)
    协议:X12V5R1
    文档流:850(全部)
    包:无(不适用)
    协议:DEMO850CL_DICTIONARY(全部)文档流:DEMO850CLSUW(全部)

添加属性

设置允许文档有重复标识的属性:

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击包:无旁的展开图标。
  3. 单击协议: EDI-X12 旁的编辑属性值图标。
  4. 向下滚动到页面的“文档流上下文属性”部分。在允许文档有重复文档标识行中, 从列表选择
  5. 单击保存

此时,如果 TP1 将一个包含 850 事务的 EDI 交换发送到社区管理者, 则 EDI 交换将被解包,从而产生一个 850 事务。然后,850 事务转换成 DEMO850CLSUW 文档类型, 已转换的文档被发送到社区管理者的网关。

将 TA1 添加到交换

在 X12 中,TA1 是一个可选段,可用于确认交换已接收。 发送方可以通过将 ISA 交换控制头的元素 14 设置成 1 来请求来自接收方的 TA1。WebSphere Partner Gateway 中的“允许 TA1请求”属性可用于控制当发送方请求 TA1 时是否发送它。

&WDI_TA1_ACK 映射是在安装 WebSphere Partner Gateway 期间安装的,所以不必导入它。

创建关联

要使映射与文档流定义关联,请执行下列步骤:

  1. 单击中心管理 > 中心配置 > 映射 > EDI FA 映射

    这样会显示 &WDI_TA1_ACK 映射。

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

    您会看到有关映射的信息,以及系统上可用的每种包的文件夹。

  3. 通过执行这些步骤,创建与文档流定义的关联:
    1. 选中包:无旁的复选框,并展开文件夹。
    2. 选中协议:EDI-X12(全部)旁的复选框,并展开文件夹。
    3. 选中文档流:ISA(全部) 旁的复选框。
    4. 单击保存

您已为包络创建了 &WDI_TA1_ACK1 映射和文档流定义间的关联。

创建交互

创建表示 TA1 事务的交互。

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互 然后单击创建交互
  3. 下, 展开包:不适用协议:&X44TA1, 然后选择文档流:TA1
  4. 目标下, 展开包:不适用协议:&X44TA1, 然后选择文档流:TA1
  5. 从操作列表中,选择传递
  6. 单击保存

创建一个交互,其源表示将持有 TA1 的 EDI 包络。

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

启用 B2B 能力

接下来,将新创建的交互添加到参与者的 B2B 能力。

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 单击该示例的源参与者(Manager)的查看详细信息图标。
    注: 请记住,TA1 从接收 ROD 文档的参与者流到发送它的参与者。 在本示例中,Manager 是 TA1 的源,参与者 TP1 是目标。
  3. 单击 B2B 能力
  4. 为源参与者启用两组能力。
    1. 首先,为 TA1 启用能力:
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:&X44TA1设置源下的角色不活动图标。
      4. 展开协议:&X44TA1
      5. 单击针对文档流:TA1(全部)设置源下的角色不活动图标。
    2. 接下来,为包络起用能力:
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:EDI-X12设置源下的角色不活动图标。
      4. 展开协议:EDI-X12(全部)
      5. 单击针对文档流:ISA(全部)设置源下的角色不活动图标。
  5. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  6. 单击该示例的目标参与者(TP1)的查看详细信息图标。
  7. 单击 B2B 能力
  8. 为目标参与者启用两组能力。
    1. 首先,启用表示 TA1 的文档流定义:
      1. 单击针对包:不适用设置目标下的角色不活动图标,以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:&X44TA1(全部)设置目标下的角色不活动图标。
      4. 展开协议:&X44TA1(全部)
      5. 单击针对文档流:TA1(全部)设置目标下的角色不活动图标。
    2. 接下来,启用表示 EDI 包络的文档流定义:
      1. 单击针对包:无设置目标下的角色不活动图标,以启用它。
      2. 展开包:无
      3. 单击针对协议:EDI-X12(全部)设置目标下的角色不活动图标。
      4. 展开协议:EDI-X12(全部)
      5. 单击针对文档流:ISA (全部)设置目标下面的角色不活动图标。

创建包络概要文件

接下来,为将要包含 TA1 的包络创建概要文件。

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

激活参与者连接

要激活连接:

  1. 单击帐户管理 > 参与者连接
  2. 从源列表选择 Manager
  3. 从目标列表选择 TP1
  4. 单击搜索
  5. 激活表示 TA1 的连接。
    表 22. TA1 连接
    目标
    包:N/A(不适用)
    协议:&X44TA1(全部)
    文档流:TA1(全部)
    包:N/A(不适用)
    协议:&X44TA1(全部)
    文档流:TA1(全部)
  6. 激活表示包络的连接:
    表 23. 包络连接
    目标
    包:N/A(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)
    包:无(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)

配置属性

要指定包络概要文件的属性:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 从列表选择 TP1
  3. 单击 B2B 能力
  4. 单击包:无旁的展开图标。
  5. 单击协议: EDI-X12(全部)旁的编辑图标。
  6. 允许 TA1 请求行中,选择
  7. 单击保存
  8. 再次单击 B2B 能力
  9. 单击包:不适用旁的展开图标。
  10. 单击协议:&X44TA1(全部)旁的编辑图标。
  11. 指定下列属性:
    1. 在“包络概要文件”行中,从列表选择 EnvProf1
    2. 在“交换限定符”行中,输入 01
    3. 在“交换标识”行中,输入 000000001
    4. 在“交换用途指示符”行中,输入 T
  12. 单击保存

在这一系列任务中,您已经将 TA1 确认添加到交换中。 当接收交换时,WebSphere Partner Gateway 将 TA1 发送回发送方(TP1)。TA1 被封包在符合包络概要文件 EnvProf1 的包络中,进行发送。

添加 FA 映射

本部分描述如何将标准的功能确认(997)添加到EDI 到 ROD 示例中描述的流。功能确认向发送方提供事务已接收的确认。

注: 该示例类似于将 TA1 添加到交换。但它与该示例没有直接关系。 它构建于您在EDI 到 ROD 示例中执行的任务之上。

WebSphere Partner Gateway 包括一组以 $DT_FA 开头的预先安装的功能确认映射名。 它后跟功能确认消息的名称和消息的版本和发行版。例如,997 功能确认消息 V2R4 名为 $DT_997V2R4。请参阅功能确认以获取随 WebSphere Partner Gateway 一起提供的映射列表。

创建关联

要使映射与文档流定义关联,请执行下列步骤:

  1. 单击中心管理 > 中心配置 > 映射 > EDI FA 映射

    这样会显示 &DT_FA997V2R4 映射。

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

    您会看到有关映射的信息,以及系统上可用的每种包类型的文件夹。

  3. 通过执行这些步骤,创建与文档流定义的关联:
    1. 选中包:不适用旁的复选框,并展开文件夹。
    2. 选中协议:X12V5R1 旁的复选框,并展开文件夹。
    3. 选中文档流:850 旁的复选框。
    4. 单击保存

您已经将该功能确认 997 映射与 X12 协议关联。

创建交互

创建表示 997 确认的交互。

  1. 单击中心管理 > 中心配置 > 文档流定义
  2. 单击管理交互 然后单击创建交互
  3. 下, 展开包:不适用协议:&DT99724, 然后选择文档流:997
  4. 目标下, 展开包:不适用协议:&DT99724, 然后选择文档流:997
  5. 从操作列表中,选择传递
  6. 单击保存

创建表示包络的交互。

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

启用 B2B 能力

接下来,将新创建的交互添加到参与者的 B2B 能力。

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 单击该示例的源参与者(Manager)的查看详细信息图标。
    注: 请记住,功能确认从接收 ROD 文档的参与者流到发送它的参与者。 在本示例中,Manager 是功能确认的源,参与者 TP1 是目标。
  3. 单击 B2B 能力
  4. 为源参与者启用两组能力。
    1. 首先,启用 FA 能力
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:&DT99724设置源下的角色不活动图标。
      4. 展开协议:&DT99724
      5. 单击针对文档流:997(全部)设置源下的角色不活动图标。
    2. 接下来,启用包络的能力:
      1. 单击针对包:不适用设置源下面的角色不活动图标以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:EDI-X12设置源下的角色不活动图标。
      4. 展开协议:EDI-X12(全部)
      5. 单击文档流:ISA(全部)设置源下的角色不活动图标。
  5. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  6. 单击该示例的目标参与者(TP1)的查看详细信息图标。
  7. 单击 B2B 能力
  8. 为目标参与者启用两组能力。
    1. 首先,启用表示 997 的文档流定义:
      1. 单击针对包:不适用设置目标下的角色不活动图标,以启用它。
      2. 展开包:不适用.
      3. 单击针对协议:&DT99724(全部)设置目标下的角色不活动图标。
      4. 展开协议:&DT99724(全部)
      5. 单击针对文档流:997(全部)设置目标下的角色不活动图标。
    2. 接下来,启用表示 EDI 包络的文档流定义:
      1. 单击针对包:无设置目标下的角色不活动图标,以启用它。
      2. 展开包:无
      3. 单击针对协议:EDI-X12(全部)设置目标下的角色不活动图标。
      4. 展开协议:EDI-X12(全部)
      5. 单击针对文档流:ISA(全部)设置目标下的角色不活动图标。

创建包络概要文件

接下来,为将要包含 997 功能确认的包络创建概要文件。 功能确认与事务一样,必须在发送之前对它进行封包。

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

激活参与者连接

要激活连接:

  1. 单击帐户管理 > 参与者连接
  2. 从源列表选择Manager
  3. 从目标列表选择 TP1
  4. 单击搜索
  5. 对表示 997 功能确认的连接,单击激活
    表 24. 功能确认连接
    目标
    包:N/A(不适用)
    协议:&DT99724(全部)
    文档流:997(全部)
    包:N/A(不适用)
    协议:&DT99724(全部)
    文档流:997(全部)
  6. 对表示将 EDI 包络发送回交换发起方的连接,单击激活
    表 25. 包络连接
    目标
    包:N/A(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)
    包:无(不适用)
    协议:EDI-X12(全部)
    文档流:ISA(全部)

配置属性

首先,指定要使用的 FA 映射:

  1. 单击帐户管理 > 概要文件 > 社区参与者,然后单击搜索
  2. 从列表选择 TP1
  3. 单击 B2B 能力
  4. 单击包:不适用旁的展开图标。
  5. 单击协议:X12V5R1(全部)旁的编辑图标。
  6. 在“FA 映射”行中,选择 &DT_FA997V2R4
  7. 再次单击 B2B 能力
  8. 单击包:不适用旁的展开图标。
  9. 单击协议:&DT99724(全部)旁的编辑图标。
  10. 指定下列属性:
    1. 在“包络概要文件”行中,从列表选择 EnvProf1
    2. 在“交换限定符”行中,输入 01
    3. 在“交换标识”行中,输入 000000001
    4. 在“交换用途指示符”行中,输入 T
  11. 单击保存

在这一系列任务中,您已经将 EDI-X12 997 功能确认添加到交换, 这样,当社区管理者接收文档时,它将 997 发送回发送方(TP1)。997 确认被封包在符合包络概要文件 EnvProf1 的包络中进行发送。

Copyright IBM Corp. 2003, 2005