指定提取选项

使用提取检查器的选项选项卡，您可以指定创建提取文件所用的选项（例如文件和数据格式）。

要指定提取选项：

  1. 在提取检查器的选项选项卡上，单击编辑。
  2. 可选：定义筛选器参数。
    • 节点筛选器：单击定义表达式 定义表达式 以打开表达式生成器，然后定义用于选择要提取的节点的表达式。表达式必须返回布尔值，并且只有筛选器表达式为 true 的节点才会包含在提取中。请参阅“使用表达式定义自定义业务逻辑”

      注：

      对于层代提取，节点筛选器不应用于祖先。
    • 祖先筛选器（仅层代提取）：单击定义表达式 定义表达式 以打开表达式生成器，然后定义用于筛选要提取的祖先节点的表达式。仅筛选器表达式为 true 的祖先节点才包括在提取中。这使您能够减少层代提取的级别，以便在层次具有太多级别时将该提取平衡到较低的深度。请参阅“使用表达式定义自定义业务逻辑”

      可选：单击 X 以移除节点或祖先表达式筛选器。

    • 筛选逻辑（仅限增量提取）：选择筛选逻辑是用作包含筛选器（即，仅与筛选器匹配的节点包含在提取中），还是排除筛选器（从提取中排除与筛选器匹配的节点）。
    • 重新连接父代（不适用于链接提取）：选择是否重新连接提取中的父代。请参阅“重新连接提取中的父代”。

      注：

      对于层代提取，重新连接父代始终启用并且无法更改。

    • 排除隐式共享的节点（仅适用于来自层次视点的提取，不适用于链接提取）：选择是否排除已在层次中不同位置的同一父代下处理的节点。请参阅“了解共享节点”。

      提示：

      提取位置信息（例如祖先、继承的值或使用位置逻辑的默认派生值）时，您可能希望避免排除隐式共享的节点。

  3. 定义文件格式选项：

    表 30-3 文件格式选项

    字段 描述 示例
    分隔符字符（仅限文本文件类型提取） 分隔文本字符串的字符。从以下选项中选择：
    • 逗号
    • 空格
    • 制表符
    • 指定：在分隔符字段中输入分隔符字符。可以输入多个字符作为分隔符，最多可输入 10 个字符。

      注：

      支持前导和尾部空格字符。例如，在逗号分隔符后添加空格会使提取显示 "A, B, C" 而不是 "A,B,C"。
    • 无 - 固定宽度（仅适用于完整提取）：使用固定列宽而不是分隔符字符对提取输出进行格式化。请参阅“提取中的固定宽度输出”。
    		 逗号
    换行样式（仅限文本文件类型提取） 用于前进到下一行的字符

    CR+LF (Windows)

    仅 CR (Mac)

    仅 LF (Linux)
    引号列（分隔符字符设置为无 - 固定宽度时不适用） 需要引号字符的列：
    • 无
    • 所有列
    • 根据值的需要：（默认值）为包含特殊字符（例如下面所列字符）的列添加引号字符：
      • 分隔符字符
      • 引号字符
      • 换行字符

    注：

    引号选项不适用于自定义页眉和页脚。
    		 无
    引号字符 用于指示引号列的字符 单引号
    Null 关键字 用于替换文件中的 null 值的关键字 空白
    已定义空字符串关键字 用于替换文件中已定义空值的关键字 无数据
    顶级节点关键字 用于层次中顶级节点的父代列属性值的关键字。

    如果没有提供，则系统会在父代列中为顶级节点输出空白值。

    		 Root
    透视分隔符 仅适用于字符串数据类型属性，用于分隔要透视的字符串的字符。选择值，或者选择指定并输入分隔符字符。您可以输入多个字符作为分隔符（最多 10 个），并且可以使用空白字符（例如制表符）。 逗号
    包括列标题记录 用于在文件开头包含标题记录的指示符 选定
    包含自定义页眉 选择此项以包含自定义页眉记录

    如果选中，则输入要包含的自定义页眉。可以在自定义页眉中插入替代参数。请参阅下面的在自定义页眉和页脚中使用替代参数。

    如果您同时使用生成的列标题记录，请指定自定义页眉应该放在生成的列标题之前还是之后。

    		 BOF（文件开头指示符）
    包含自定义页脚 选择此项以包含自定义页脚记录

    如果选中，则输入要包含的自定义页脚。可以在自定义页脚中插入替代参数。请参阅下文中的“在自定义页眉和页脚中使用替代参数”。

    		 EOF（文件末尾指示符）
    属性不在节点类型中时为 Null 选择此项以指定在要提取的节点的节点类型未使用某个属性时，该属性的输出为 NULL 值，而不是继承值或默认值的应用程序覆盖设置。

    如果指定了 Null 关键字，则该关键字将为该属性的输出。

    		 选定
  4. 定义数据格式选项：

    表 30-4 数据格式选项

    字段 描述 示例
    负号 指示负值的字符 括号
    千位分隔符 在数字中分隔千位的字符 逗号
    小数分隔符 在数字中分隔小数的字符

    注：

    两个分隔符不能使用同一字符。为一个分隔符选择某个字符时，该字符将从另一个分隔符的下拉菜单中移除。

    		 点
    布尔值

    指定是提取实际值、显示值，还是为布尔属性指定的值。

    注：

    如果选择指定，则输入表示 True 和 False 的值。可以为任一选项输入空白值。

    指定

    • True 的指定值：IC_INTERCOMPANY_YES
    • False 的指定值：
    允许的值属性

    指定是为允许的值属性提取实际值还是显示值。

    		 显示
    时区

    提取的时区

    		 UTC
    日期格式

    从下拉菜单中选择日期格式，或者选择指定并输入日期格式。

    注：

    请参阅“日期格式符号”。
    		 MM/dd/yyyy
    时间格式

    从下拉菜单中选择时间格式，或者选择指定并输入时间格式。

    注：

    示例日期/时间字段显示您选择或指定的日期和时间格式。

    		 HH:mm:ss
  5. 单击保存。

注：

时区、日期格式和时间格式在提取级别保存。这意味着，无论运行提取的用户的区域设置如何，提取中的时区和格式都始终相同。

提取中的固定宽度输出

在“分隔符字符”字段中选择无 - 固定宽度以指定提取应使用固定列宽（而不是分隔符字符）来确定提取文件中的列（仅适用于完整提取）。

每列的宽度按如下方式确定：

表 30-5 按列类型列出的列宽

列类型 宽度（字符）
特殊列
常量 常量的长度
提取运行 ID 36
提取时间戳 基于“提取选项”中的日期和时间格式
反向级别 4
记录编号 8
用户名 32
属性列
布尔 基于属性数据类型显示：
  • Y/N、T/F、1/0：1
  • Yes/No：3
  • True/False：5
日期 “提取选项”中日期格式的最大长度
浮点型 最大值的长度（包括千位分隔符和小数位数 +1）。

如果没有最大值，则长度设置为 16。
整数 最大值的长度（包括千位分隔符）。

如果没有最大值，则长度设置为 16。
列表 255
备注 最大值的长度。

如果没有最大值，则长度设置为 1024。
节点列表 255
节点 目标节点类型的 Core.Name 属性的最大长度。

如果没有最大值，则长度设置为 250。
数字字符串 最大值的长度。

如果没有最大值，则长度设置为 32。
序列 填充值的长度。

如果没有填充值，则长度设置为 40。
字符串 字符串值的最大长度。

如果没有最大长度，则长度设置为 1024。
时间戳 “提取选项”中日期和时间格式的最大长度，包括日期和时间之间的空格。

注：

长度小于固定列宽的值将填充空格字符。长度大于固定列宽的值将被截断。

在自定义页眉和页脚中使用替代参数

可以在自定义页眉和页脚中输入替代参数。运行提取时，参数的值将插入到提取中。例如，如果在自定义页脚中输入 <%Date%>，则运行提取时，会将运行提取的日期插入到页脚中。

提示：

替代参数不区分大小写。

以下替代参数可用：

  • <%Date%>：根据时区和格式的提取设置，返回运行提取的日期。如果未设置时区，则使用 UTC。
  • <%ExtractName%>：返回提取的名称。
  • <%FileName%>：返回提取文件名。
  • <%Time%>：根据时区和格式的提取设置，返回运行提取的时间。如果未设置时区，则使用 UTC。
  • <%Timestamp%>：根据时区和格式的提取设置，返回运行提取的日期和时间组合。
  • <%TimeLabelName%>：返回与视点关联的时间标签的名称。

    注：

    此参数仅适用于使用带时间标签的视点（视点具有历史时间标签）的提取。如果有专用时间标签可用，则该时间标签名称将插入到提取中。否则，将插入公共时间标签名称。
  • <%TimeLabelTimestamp%>：根据时区和格式的提取设置，返回与视点关联的时间标签的时间戳。

    注：

    此参数仅适用于使用带时间标签的视点（视点具有历史时间标签）的提取。如果有专用时间标签可用，则该时间标签的时间戳将插入到提取中。否则，将插入公共时间标签的时间戳。
  • <%Username%>：返回执行提取的用户名。
  • <%UserFirstName%>：返回执行提取的用户的名字。
  • <%UserLastName%>：返回执行提取的用户的姓氏。
  • <%UserEmail%>：返回执行提取的用户的电子邮件地址。
  • <%RecordCount%>：返回提取的记录数。此计数不包括记录计数中的页眉和页脚行，但它确实包括透视行，以便与上次使用的记录计数相匹配。

    注：

    此参数仅可用于自定义页脚行。不能在自定义页眉中插入记录计数。
  • <%AppVersion%>：返回 Oracle Fusion Cloud Enterprise Data Management 发行版号（例如 "Oracle EDM Cloud Release 25.09"）。