管理定制 XML

仅当你将使用定制 XML 格式时你才需要执行本节中的步骤。

XML(即可扩展标记语言,Extensible Markup Language)是 Web 上结构化文档和数据的通用格式。通过使用“管理 XML 协议”页面,您可以创建并管理定制 XML 格式,可以将这些格式添加到可用文档流定义列表中。

XML 格式定义了 XML 文档集内的路径。 这使文档管理器能够检索唯一标识入站文档的值,并使之能访问文档内用来正确执行路由选择和处理所必需的信息。

创建 XML 格式是一个多步骤过程。您必须:

  1. 创建格式的协议,并使之与一个或多个包相关联
  2. 创建格式的文档流,并使之与新创建的协议相关联
  3. 创建格式

然后为新创建的格式创建有效的交互。

这些步骤将在以下各节中描述。您也可以在设置中心以支持定制 XML 文档中找到这些步骤的示例。

创建 CustomXML 协议定义格式

下列步骤描述了如何创建定制 XML 协议定义格式:

  1. 单击中心管理 > 文档流定义 > 创建文档流定义

    图 26. 创建文档流定义页面


  2. 对于文档流类型,请选择协议
  3. 对于代码,输入您在先前步骤选中的该类对象的值。例如,您可能要输入 XML。
  4. 对于名称,输入文档流定义的标识。例如,对于定制 XML 协议,您可以输入 Custom_XML。这个字段是必需的。
  5. 对于版本,请输入 1.0
  6. 输入协议描述(可选)。
  7. 文档级别设置成,因为您正在定义的是协议,而非文档流(文档流将在下一节中定义)。
  8. 状态设置成已启用
  9. 设置该协议的可见性。您大概会希望所有参与者都能看见它。
  10. 选择将封装这个新协议的包。 例如,如果您希望该协议与所有三个包相关联,则选择包:AS包:无包:后端集成
  11. 单击保存

创建文档定义流

接下来,再次使用“创建文档流定义”页面来创建文档流。

  1. 单击中心管理 > 文档流定义 > 创建文档流定义
  2. 对于文档流类型,请选择文档流
  3. 对于代码,输入您在先前步骤选中的该类对象(文档流)的值。
  4. 对于名称,输入文档流定义的标识。例如,你可以输入 XML_Tester 作为文档流的名称。这个字段是必需的。
  5. 对于版本,请输入 1.0
  6. 输入协议描述(可选)。
  7. 文档级别设置成(因为您正在定义文档级别)。
  8. 状态设置成已启用
  9. 设置该流的可见性。您大概会希望所有参与者都能看见它。
  10. 单击文件夹图标,展开您在前一个过程中选择的每个包。展开文件夹,然后选择您在前一节中创建的协议名(例如“协议:CustomXML”)。
  11. 单击保存

以下是“管理文档流定义”页面上的“AS 包”部分的一个示例,其中,已经创建了 CustomXML 协议,并将该协议与“AS”、“无”和“后端集成封装”相关联,并且创建 XML_Tester 文档流。

图 27. 具有添加了新的“定制 XML”协议和文档流的“文档流定义”页面


创建 XML 格式

在您创建定制 XML 协议(和与之关联的包或包的集合),并创建相关的文档后,您可以准备创建 XML 格式。

要创建 XML 格式,请使用下列过程。

  1. 单击中心管理 > 中心配置 > XML 格式
  2. 单击创建 XML 格式

    图 28. “查看 XML 格式”页面


  3. 对于路由格式,选择与该格式相关联的文档流定义。
  4. 对于文件类型,选择 XML

    注意: XML 是唯一可用的文件类型选项。

  5. 对于标识类型,选择用于标识入站文档类型的元素。选项有 DTDName SpaceRoot Tag
  6. 对于每个提供类型选型的字段,选择元素路径(到文档中值的路径),或者常量(文档中的实际值)。然后提供值。
    1. 对于源/目标企业标识,输入企业标识的路径。这个字段是必需的。
    2. 对于源文档流 & 版本,输入一个定义了 XML 文档中“文档流”和“版本”值的表达式。这个字段是必需的。
    3. 对于文档标识,输入文档标识编号的路径。
    4. 对于文档时间戳记,输入文档创造时间戳记的路径。
    5. 对于重复检查键 1-5,输入用于标识路由重复文档的路径。
  7. 单击保存

使用验证映射

WebSphere Business Integration Connect 使用验证映射来验证 RosettaNet 或 XML 文档的结构。如果您不需要导入验证映射,请跳至后面的创建交互

添加验证映射

操作可以有相关联的验证映射,以确保目的地参与者或后端系统可以解析文档。请注意,验证映射只验证文档的结构。它不验证消息内容。

注意: 一旦将验证映射与文档流定义相关联,就不能取消其关联。

要将新的验证映射添加到中心,请使用下列过程。

  1. 将验证映射文件保存到中心或保存到 WebSphere Business Integration Connect 可以读取文件的位置。
  2. 单击中心管理 > 中心配置 > 验证映射
  3. 单击创建
  4. 输入验证映射的描述。选择您想用来验证文档的模式文件的路径和名称。
  5. 单击保存

使映射与文档流定义相关联

要使验证映射与文档流定义相关联,请使用下列过程。

  1. 单击中心管理 > 中心配置 > 验证映射。控制台会显示“管理映射”页面。
  2. 单击您想要关联的“文档流定义”旁的验证映射放大镜图标。
  3. 单击文件夹图标,以逐个展开操作级别,或者选择全部以展开整个树。
  4. 选择您希望与验证映射相关联的文档流定义。
  5. 单击提交

Copyright IBM Corp. 1997, 2004