创建数据导出文件集成

通过“数据导出到文件”功能，您可以将数据从 Oracle Fusion Cloud Enterprise Performance Management 应用程序导出到数据文件。您可以使用数据文件将数据加载到 Oracle ERP Cloud 应用程序或外部系统。

创建“数据导出到文件”应用程序时，请注意以下事项：

  • 创建维时，按照数据文件中的列顺序分配列顺序。文件中的第一列是分配的 ACCOUNT 数据列。

  • 建议一次仅导出一年。如果日期范围跨年份界限，则数据可能会重复。

  • POV 类别不进行验证。

  • 可从数据导出文件创建检查规则。检查规则不能基于目标值。

  • 不能从数据导出文件进行回写。

  • 仅支持数字数据类型。如果需要导出文本、智能列表和日期，则使用 EPM 数据文件应用程序，类型为“EPM 数据文件”，数据提取选项为“0 级数据”。创建集成时，使用此应用程序作为目标。

    您还可以使用 Groovy 公共类 DataExporter。有关详细信息，请参阅“类 DataExporter”。

  • 对于“数据导出到文件”，默认工作流模式设置为简单。从云 EPM 导出数据时，不支持钻取，因此默认工作流模式设置为“简单”。

    如果要查看工作台中的数据以用于测试目的，则将工作流模式设置为完全。有关详细信息，请参阅“定义应用程序详细信息选项”。

  • 要添加时间戳，请在目标应用程序中创建新导出列，然后为下一列创建 SQL Like 映射，并在脚本中仅键入 CURRENT_TIMESTAMP。

    请注意，此方法使用完整时间戳，例如 21-JAN-22 04.14.33.677306 PM +00:00，它基于服务器时间，而不一定是本地时间。

    要设置时间戳的格式，请使用 TO_CHAR 语法。有关详细信息，请参阅“TO_CHAR (datetime)”。

  • 不会针对“数据导出到文件”应用程序验证目标值。

  • 执行集成时，数据集成会导出数据。数据集成创建输出数据文件。该数据文件的名称为 <Target App Name>_<Process ID>.dat，会写入 <APPL ROOT FOLDER>/outbox 目录。可从“进程详细信息”页面的 OUTPUT file 列访问数据文件。

  • 使用“数据导出目标应用程序”选项中的下载文件名字段，生成数据导出输出文件作为数据导出到文件集成定义的一部分时，您还可以指定自己的文件名，例如 PlanExport.csv。

    系统将在平台 inbox/outbox 文件夹中创建输出文件。可以通过以下方式访问 inbox/outbox 文件夹：从主页导航到应用程序卡，然后导航到概览，再从操作下拉列表中选择收件箱/发件箱资源管理器。

    您还可以通过将文件夹作为前缀添加到文件名（例如 inbox/PlanExport.csv 或 outbox/PlanExport.csv），在数据集成文件夹下创建文件。

    注：

    支持 inbox 下的子文件夹，例如 inbox/userx/PlanExport.csv。不能在 outbox 下创建子文件夹。

    如果将“下载文件名”字段留空，则会在发件箱文件夹中创建输出文件，名称为 <Application Name>_<Process ID>.dat。

  • 如果您每天都计划了数据导出作业并且需要将输出文件自动分发给个人，则使用《REST API for Enterprise Performance Management Cloud》中的 "Download Application Snapshot" 下载特定文件，提供该文件的路径作为 applicationSnapshotName 的值。例如，要下载收件箱中名为 s112.csv 的数据集成文件，则将文件引用为 "inbox/s112.csv" 作为路径参数。

要创建数据导出文件集成定义：

  1. 创建 .CSV 文件并按您要导出的顺序列出列。

    注：

    请勿在数据文件中包含“金额”列。如果包含了此列，可在创建应用程序后将其删除。

    文件的名称即是应用程序的名称，因此请正确命名该文件。

  2. 在数据集成主页中的操作菜单中，从设置操作下拉列表中选择应用程序。
  3. 在应用程序页上，单击 图中显示了“添加”图标。。
  4. 在创建应用程序页上，单击类别，然后选择数据导出。
    图中显示了“创建应用程序”页。
  5. 从类型中，选择数据导出到文件。
  6. 从文件中，选择要从中创建应用程序的源文件的名称。

    您还可以单击 图中显示了“搜索”图标。，并从文件浏览器页搜索文件。

  7. 在前缀中，指定一个前缀以确保应用程序名称唯一。
    前缀与文件名连接在一起组成唯一的应用程序名称。例如，如果要将一个应用程序命名为与现有应用程序相同的名称，您可以将您的姓名首字母指定为前缀。
  8. 单击确定。

    系统会注册应用程序。

  9. 从应用程序页中，单击数据目标应用程序右侧的 图中显示了“选择”图标。，然后选择应用程序详细信息。
  10. 选择维选项卡。
  11. 在应用程序详细信息中，选择维详细信息选项卡。
  12. 根据需要编辑维名称和数据列名称。
  13. 在顺序中，指定映射的处理顺序。

    例如，如果“帐户”设置为 1、“产品”设置为 2、“实体”设置为 3，则数据集成会依次处理“帐户”、“产品”和“实体”维的映射。

  14. 在列顺序中，指定数据导出文件中每个列的顺序。
    默认情况下，数据集成将按顺序指定“帐户”维作为第一列。
  15. 单击保存。
  16. 在应用程序详细信息中，选择选项选项卡。
  17. 选择数据导出文件的任何适用属性和值。
    有关详细信息，请参阅“数据导出目标应用程序选项”。
  18. 单击保存。
  19. 从数据集成主页中，单击 图中显示了“添加”图标。（创建），然后选择集成。

    此时将在“创建集成”视图中显示“常规”页。

  20. 在名称和说明中，输入新直接集成的名称和说明。
  21. 在位置中，输入新位置名称，或者选取现有位置来指定从何处加载数据。

    位置用于链接源和目标以及关联的成员映射。可以使用不同的选项集和筛选条件在同一位置定义多个集成。位置主要用于控制对集成的访问。您可以使用“位置安全性”来控制对最终用户的访问。

    如果输入新位置，则必须提供源和目标。保存集成时，数据集成会自动创建位置。

    如果选择现有位置，则数据集成会自动填充源和目标值，您无法对其进行更改。

  22. 单击 图中显示了“源”图标。（选择源）。
  23. 从选择源页中，选择直接集成源系统。
  24. 单击 图中显示了“目标”图标。（选择目标）。
  25. 从选择目标页中，选择数据导出文件目标应用程序。
  26. 单击保存。
  27. 选择映射维并将源维成员映射到相应的目标应用程序维成员。

    有关详细信息，请参阅“映射维”。

  28. 运行集成以从源系统中提取数据，并将其加载到数据导出文件目标应用程序中。
    有关详细信息，请参阅“运行集成”。