配置 XML 转换作业

您可以创建 XML 转换作业,以将 XML 文件转换为所需的输出,还可以从 XML 分配 Capture 元数据字段值。您可以通过配置 XSLT 处理器定义的受支持组合并提供定制 XSLT 文件来完成此操作。此外,还可以将 XPath 表达式映射到 Capture 元数据字段。然后,第三方应用程序可以使用转换的 XML 文件来满足其他方的业务需求。

注:

您无法在 Oracle Content Management 入门版中创建 XML 转换作业。要使用此功能,您需要升级到 Oracle Content Management 高级版。有关详细信息,请参阅入门版与高级版

  1. 在左侧的过程窗格中选择您的过程。

    所选过程的配置页会显示在右侧。

  2. 打开处理选项卡。
  3. 在 XML 转换作业表中,单击 添加 XML 转换作业,如果要编辑现有作业,则单击 编辑 XML 转换作业。

    您也可以复制 XML 转换作业,方法是选择该 XML 转换作业,单击 复制转换作业 并在出现提示时输入新名称。通过复制作业可以快速复制并修改作业。

  4. 在文档选择页上:

    1. 在文档选择部分中执行以下操作:
      • 输入作业的名称和说明。

      • 要处理特定文档概要信息的 XML 转换作业,选择限制为文档概要信息字段中列出的一个或多个文档概要信息,或选择全部以处理所有定义的文档概要信息的文档。

    2. 在转换输出目标下拉列表中,选择适合的选项:
      • 文档:用转换结果替换原始文档。如果需要,还可以更改文档概要信息。
      • 文档,保留副本:保留原始副本。如果选择此选项,还可以选择文档概要信息。但是,您必须从保留附件类型下拉列表中选择附件类型。
      • 附件:将转换的结果存储为附件。您必须从新附件类型下拉列表中选择附件类型。
      • Capture 字段:在 Capture 字段中存储转换的结果。您必须从 Capture 字段下拉列表中选择文本字段。
    3. 在附件选择部分中:
      1. 如果适用于您在前面步骤中进行的选择,请选中处理附件复选框。
      2. 通过选中可用附件类型的复选框来限制为所需的附件类型。您也可以选择所有附件类型。
      3. 选择转换输出目标:
        • 附件:您可以选择更改附件类型。
        • 附件,保留副本:您可以选择附件类型。但是,您必须从保留附件类型下拉列表中选择附件类型。
        • Capture 字段:必须选择文本字段或 XML 字段。
  5. 在转换页上 — 转换定义:
    1. 如果尚未选中执行 XML 转换复选框,则选中该复选框以允许在此页上编辑字段值。取消选中该复选框将禁用编辑,同时在字段中保留上次保存的值。不需要 XML 转换时,可以取消选中此复选框。
    2. 在转换引擎部分中:
      • 选择兼容的 XSLT 版本、处理器和处理器版本。选择系统默认值,或者从与 Xalan 和 Saxon-HE 处理器及其版本兼容的可用 XSLT 版本中进行选择。
      • 指定输出文件扩展名,例如 XML、HTML、JSON、文本。

        注:

        如果输出文件扩展名不等于 XML,则禁用“字段映射”页。
    3. 要执行转换,请在 XML 样式表部分中上载或键入 XSLT。
    4. XSLT 中包含的参数应在“参数”表中定义。为此,请执行以下操作:
      1. 在参数表中,单击 添加参数。
      2. 在添加 XSLT 参数对话框中,添加参数名称并为其分配值。您可以为参数添加文本值或组合元数据值。
      3. 重复步骤 i 和 ii 以定义所需的参数。

        注:

        如果您没有为 XSLT 中定义的参数分配值,或者为 XSLT 中不存在的那些参数分配值,您将无法保存 XML 转换作业,并且在您尝试保存转换作业时通知您该信息。
    5. 在转换测试部分中,上载并测试转换的 XML,以确认它正确生成,然后单击下一步。还可以通过单击本部分右上方的预览来预览本部分中的内容。
  6. 在字段映射页上,定义到特定元素或属性的导航,以便用户可以从 XML 文档中提取其值:
    1. 选中执行 XPath 字段映射复选框以允许编辑 XPath 字段映射表。如果取消选中此复选框,将无法编辑该表。但仍保留上次保存的值。
    2. 如果必须严格遵守您将在下一步中选择的语法分析格式,请选中出现语法分析错误时批处理失败复选框。
    3. 在 XPath 字段映射表的右上方,单击 编辑 XPath 字段映射
    4. 在编辑 XPath 字段映射对话框中:
      1. 在 XPath 表达式字段中,为所选元数据数据字段指定 XPath 表达式并选择语法分析格式。

        在转换输出上(如果有)对 XPath 表达式求值。如果未执行转换,则在文档或附件上对 XPath 表达式求值。

      2. 在日期语法分析格式下拉列表中,选择语法分析格式。如果 Capture 字段是数字,您将看到数字语法分析格式下拉列表。如果需要,可以在下拉列表中选择定制语法分析格式。
      3. 单击确定。

        添加到 XPath 字段映射表的 XPath 表达式列中的值将语法分析为所选格式的日期。

    5. 单击确定。
  7. 在后处理页上,根据以下内容指定 XML 转换作业完成后发生的情况:
    • 没有系统错误情况是指满足上一页上所有标准的情况。成功的转换可以流向提交。
    • 系统错误是指转换失败的任何情况:未找到记录、找到太多记录等。对于不成功的转换,批处理会返回到 Content Capture 客户端进行修复。
    请参见配置 XML 转换作业的后处理和监视
  8. 检查概要页上的设置,然后单击提交保存作业。

  9. 配置批处理如何流向 XML 转换作业。请参见配置批处理流向 XML 转换作业。

  10. 测试您创建的 XML 转换作业。

配置 XML 转换作业的后处理和监视

使用 XML 转换作业的后处理选项可以指定处理完成之后的操作。

要配置 XML 转换作业的后处理和监视,请执行以下操作:
  1. 在左侧的过程窗格中选择您的过程。
    所选过程的配置页会显示在右侧。
  2. 打开处理器选项卡。
  3. 在 XML 转换作业表中,添加或编辑 XML 转换作业。
  4. 单击后处理页以显示处理成功(无系统错误)和处理失败(有一个或多个系统错误)的处理选项。接下来的步骤适用于以下两个部分:没有系统错误时和有系统错误时。
  5. 在批处理处理器和批处理处理器作业字段中,指定在 XML 转换作业完成后执行哪个处理步骤(如果有)。您可以选择无、提交处理器、识别处理器、到 TIFF 的转换、到 PDF 的转换、资产查找处理器或 XML 转换处理器。
  6. 在电子邮件地址字段中,可以选择输入要在处理成功或失败后向其发送电子邮件的地址。在配置和测试 XML 转换作业时,可设置在出现系统错误时向自己发送电子邮件通知,然后自动提醒管理员处理错误。
  7. 在剩余字段中,指定如何更改已处理的批处理。
    • 通过添加前缀来重命名批处理。例如,使用前缀 ERR 重命名失败的批处理以执行后续操作。

    • 更改批处理状态或优先级。例如,您可能会更改存在系统错误的批处理的状态,然后创建一个客户端概要信息,并将批处理筛选设置为此状态,以便有资格的用户手动编辑并完成出错的批处理。

  8. 单击提交,保存作业。

配置批处理流向 XML 转换作业

要运行 XML 转换作业,必须将批处理配置为流向该作业以供处理。为此,需要将 XML 转换作业设置为客户端概要信息中的后处理步骤。

可从以下各项配置批处理流:

停用或删除 XML 转换作业

如果删除 XML 转换作业,它将不再可用于将该作业设置为后处理步骤的批处理。如果指定为进行后处理的作业不可用,则会生成批处理错误。您可能需要在删除作业之前将其更改为脱机一段时间,从而使您能够解决其删除带来的意外问题。当在客户端概要信息中或在处理器作业的“后处理”页上选择了联机 XML 转换作业时,这些作业就会运行。您可以临时停止作业(使其脱机)或更改已停用的作业使其重新运行。

要停用或删除 XML 转换作业,请执行以下操作:
  1. 在左侧的过程窗格中选择您的过程。
    所选过程的配置页会显示在右侧。
  2. 打开处理选项卡。
  3. 要停用作业,请在 XML 转换作业表中将其选中,然后单击 停用或激活 XML 转换作业。

    也可以通过选择或取消选择“文档选择”页上的联机字段来停用或激活 XML 转换作业。

  4. 在 XML 转换作业表中选择停用的作业,然后单击 删除 XML 转换作业。
  5. 出现提示时,单击是,确认要删除此作业。