runIntegration

适用于

所需角色

用法

• 对于标准模式集成，您必须指定 importMode、exportMode 和 periodName 的值
• 对于快速模式集成，您必须指定 exportMode 的值
• 参数名称及其值区分大小写

• JOB_NAME 是在数据集成中定义的集成作业的名称。
• importMode 确定如何将数据导入到数据集成。可接受的导入模式包括：
  • Append，用于添加到数据集成中的现有 POV 数据。
  • Replace，用于删除 POV 数据并将其替换为文件中的数据。
  • Map and Validate，用于跳过数据导入，但使用更新的映射和逻辑帐户重新处理数据。
  • No Import，用于跳过将数据导入到数据集成临时表的操作。
• exportMode 确定如何将数据加载到目标应用程序。对于快速模式集成，不能使用 Check 和 No Export 作为 exportMode 参数的值。可接受的导出模式值包括：
  • Merge，用于更新现有数据并添加新数据。
  • Replace，用于清除 POV 中的现有数据并为其加载新数据。对于标准模式，“方案”、“版本”、“年”、“期间”和“实体”维中的数据将被清除。对于快速模式，“年”、“期间”和“实体”维中的数据将被清除。您可以为这两种模式定义自定义清除区域。
  • Accumulate，用于将数据添加到现有数据。适用于 Planning、Planning 模块、Financial Consolidation and Close、Tax Reporting、Profitability and Cost Management 和 Enterprise Profitability and Cost Management。
  • Subtract，用于从现有余额中减去数据。适用于 Profitability and Cost Management 和 Enterprise Profitability and Cost Management。

    对于快速模式集成：

    • 不能使用 Check 和 No Export 作为此参数的值。

    • 对于 Planning、Planning 模块和 Financial Consolidation and Close，只有以下值有效：Replace、Merge 和 Accumulate。

  • No Export，用于跳过数据导出。使用此模式，可在数据加载到目标应用程序之前，先将数据加载到临时表中以供查看。

  • Check，用于仅执行数据验证检查。

    如果 Oracle Fusion Cloud 作为目标，仅支持以下导出模式：

    • MERGE，用于合并数据集成临时表中的数据和现有数据
    • NONE，用于跳过从数据集成到应用程序的数据导出
• periodName 是一个或多个期间或期间范围的名称，每个期间或期间范围都用大括号括起，用于导入或导出数据。可接受的期间命名惯例如下：
  • 对于单期间加载，指定用大括号括起的期间名称，例如 {Jan-21}
  • 对于多个期间加载，将开始和结束期间名称括在大括号中，例如 {Jan-21}{Mar-21}（用于加载从 1 月 21 日开始到 3 月 21 日结束的所有期间的数据）
  • 对于 Planning、Planning 模块、Financial Consolidation and Close、自由形式和 Tax Reporting：可以指定业务流程期间名称和格式为 {Jan#FY21}{Mar#FY21} 的年份，以加载从 1 月 21 日开始到 3 月 21 日结束的所有期间的数据。

    期间名称必须用大括号括起。

    • 单个期间 - 是指期间映射中定义的单个期间的数据管理期间名称。
    • 多个期间 - 是指多个期间加载。该参数以 {Month-Year}{Month-Year} 格式指定。例如，{Jan-20}{Mar-20} 表示从 1 月 20 日到 3 月 20 日的多个期间加载。
    • Planning 期间名称 - 是指 {Month#Year} 格式的 Planning 期间名称，例如 {Jan#FY20}{Mar#FY20}。使用此惯例，您无需指定数据集成期间名称，而是指定“年”和“方案”维的成员名称。

      Planning、Tax Reporting 和 Financial Consolidation and Close 业务流程支持此参数。它适用于您的服务应用程序和从内部部署数据源派生的云部署。

      如果通过捕获“年”和“期间”成员名称从 EPM 云 Groovy 脚本触发，则使用此惯例非常有用。应用程序期间映射或全局期间映射必须存在期间映射的目标值中的“年”和“月”。

    • 替代变量 - 这是上述 Planning 期间名称格式的扩展，其中可以按 {Month#&CurYr}{&FcstMonth#&CurYr} 格式指定替代变量，而不是实际的“年”和“月”成员名称，例如 {Jan#&CurYr}{&FcstMonth#&CurYr}。

      支持实际成员名称和替代变量的组合。

      Planning、Tax Reporting 和 Financial Consolidation and Close 业务流程支持此格式。

      应用程序期间映射或全局期间映射必须存在于从中运行命令的环境的数据集成中，并且期间映射的目标值中存在“年”和“月”值在这种情况下，“年”和“月”是指执行期间替代变量的当前值。

    • GLOBAL POV - 执行全局 POV 期间的数据加载。使用格式 {GLOBAL_POV}。

    Note:

    如果您使用除本次讨论中所述参数以外的任何期间命名参数，您将收到 Invalid Input – HTTP 400 错误消息。

    从 REST API 文档复制 periodName 部分。下面概述了全局 POV、Subvar 等不同的格式。

  • {GLOBAL_POV}，用于在系统的全局 POV 中或在数据集成的应用程序设置中定义的期间内执行数据加载。

    Note:

    Planning、Planning 模块、Financial Consolidation and Close 和 Tax Reporting 支持 {Month#Year} 期间命名惯例格式。根据此惯例，您可以为“年”和“方案”维指定成员名称，而非数据集成期间名称。如果命令是通过捕获“年”和“期间”成员名称从 Groovy 脚本触发的，则此方法很有用。

    {Jan#&CurYr}{&FcstMonth#&CurYr} 替代变量命名惯例是前一期间命名惯例的扩展。如果对 Planning、Planning 模块、Financial Consolidation and Close 和 Tax Reporting 运行此命令，则可以指定替代变量而不是“年”和“月”成员名称。同样支持成员名称和替代变量的组合。

    仅当数据集成中已经存在目标值包含“年”和“月”的应用程序期间映射或全局期间映射时，前一期间命名惯例和替代变量命名惯例才有效。
• inputFileName,（对于基于文件的数据加载）用于指定要从中导入数据的收件箱中可用的文件名称。如果您在集成定义中指定目录名称，则仅传递文件名。如果不在集成定义中包含目录名称，请使用 inbox/DIR_NAME/FILE_NAME 格式，例如 inbox/GLBALANCES.txt 或 inbox/EBSGL/GLBALANCES.txt。如果文件已上传到环境中的默认位置，请使用 #epminbox/FILE_NAME 惯例（例如 #epminbox/GLBALANCES.txt）标识输入数据文件。

  此参数仅适用于基于本机文件的数据加载。如果不为基于文件的数据加载指定此参数值，则此命令会从集成定义中指定的文件导入数据。如果您为不基于文件的数据加载指定此参数值，该命令会将其忽略。

• PARAMETERS（可选）标识 PARAMETER_NAME="PARAMETER" 格式的运行时参数。参数包括源筛选器和目标选项。

  Note:

  此时您可以对目标应用程序的维（元数据）类型使用的唯一参数是 "Refresh Database"=Yes|No。

示例

• 单个期间导入：

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

• 多个期间导入：

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

• 基于增量文件的数据集成：

  epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt