Extract 节点

本主题包含以下部分:

用途

使用 Extract 节点抽取您要由消息流中稍后的节点处理的输入消息的内容。使用 Extract 节点,您可以创建仅包含输入消息的内容子集的新输出消息。配置 Extract 节点时,通过定义映射语句,输出消息仅由您为包含指定的输入消息的那些元素组成。

Extract 节点在工作台中由以下图标表示:

Extract 节点图标

在消息流中使用此节点

如果在初始处理整个消息后,您仅需要消息的子集则可能发现此节点是有用的。例如,您可能要出于审计目的(在 Warehouse 节点中)存储整个消息,但仅传播小部分消息(可能是订单信息)供进一步处理。

您从新客户机接收订单,并且要收集其名称和地址供进一步提升。要这样做,使用 Extract 节点从每份订单获取该信息,并将它作为新消息发送到总部。在总部处理这些消息,以便可以在下一次营销活 动时可以包含客户的详细信息。

配置 Extract 节点

当您将 Extract 节点的实例放入消息流时,就可以配置它。右键单击编辑器视图中的节点,然后选择属性。将显示该节点的基本属性。

对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。

如下所示配置 Extract 节点:

  1. 映射模块中,标识要在该节点中执行的关联映射例程。缺省情况下,指定给映射例程的名称与定义例程的映射文件名相同。当您将文件的缺省名包含在消息流中时,它就是与节点名连接的消息流名称(例如,消息流 MFlow1 中第一个 Extract 节点的 MFlow1_Extract.mfmap)。指定的值中不能包含空格。

    如果单击这个输入字段旁边的浏览,会显示一个对话框,其中列出此节点可访问的所有可用映射例程。选择需要的例程,然后单击确定。 例程名称在映射模块中进行设置。

    要使用与此节点关联的映射例程,右键单击节点并选择打开映射。如果映射例程不存在,则在缺省文件中用缺省名称创建一个。 如果文件已存在,也可以在导航器视图中打开文件 <flow_name>_<node_name>.mfmap

    映射例程专用于与其关联的节点类型;您无法将为 Extract 节点开发的映射例程与任何其他使用映射的节点(如,DataInsert 节点)一起使用。如果创建映射例程,尽管可以从 ESQL 例程调用此例程,但不能从其他任何映射例程调用。

  2. 选择属性对话框导航器中的“描述”,以输入简短描述和/或详细描述。
  3. 单击应用在不关闭“属性”对话框的情况下对 Extract 节点进行更改。单击确定以应用更改,并关闭属性对话框。

    单击取消以关闭对话框,并废弃对属性所作的所有更改。

终端和属性

在以下表中描述了 Extract 节点终端。

终端 描述
In 接受供节点处理的消息的输入终端。
Failure 如果在抽取期间检测到故障,则这就是输入消息路由到的输出终端。
Out 如果成功处理了输入消息,则这就是转换的消息路由到的输出终端。

下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。

下表描述 Extract 节点的“基本”属性。

属性 M C 缺省值 描述
映射模块 Extract 映射例程的名称,该例程包含要对消息树执行的语句。此例程对于此节点类型是唯一的。

下表描述 Extract 节点的“描述”属性。

属性 M C 缺省值 描述
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac04710_