将“EPM 平台作业”作业类型用于 Planning 作业

通过提供作业名称、作业类型和参数,使用“EPM 平台作业”作业类型执行 Planning 作业。应在相应的 Planning 应用程序中定义一些作业,并在作业定义中保存一些或所有必需参数。对于这些作业类型,可以在作业定义中提供参数,也可以在运行时覆盖参数。其余作业可以在运行时触发,而无需保存的作业定义。

Planning 作业支持的“EPM 平台作业”作业类型包括:

  • 管理模式

  • 自动预测

  • 清除多维数据集

  • 压缩多维数据集

  • 多维数据集刷新

  • 执行分别输出定义

  • 导出审核

  • 导出合并日记帐

  • 导出数据

  • 导出作业控制台

  • 导出元数据

  • 导出安全性

  • 导入合并日记帐

  • 导入数据

  • 导入兑换率

  • 导入元数据

  • 导入安全性

  • 合并数据切片

  • 优化聚合

  • 规划类型映射

  • 重建多维数据集

  • 规则

  • 规则集

Note:

要了解如何在 Planning 中定义作业,请参阅《管理 Planning》中的“管理作业”。

作业类型参数添加为标签和值对(键值对),其中标签是属性的名称,而是此属性的分配值。

下面的作业类型参数名称和参数应与相应 REST API 支持的参数匹配(请参阅《REST API for Enterprise Performance Management Cloud》中的 "Execute a Job")。

Table 12-7 Planning 的“EPM 平台作业”作业类型参数

Planning 的“EPM 平台作业”作业类型参数 说明
作业类型

作业类型下拉列表中,选择要在 EPM 平台作业中执行的作业类型值或变量。

可以通过在“标签/值”字段中指定单个标签和值参数来限定作业类型。

作业名

指定要用于此作业执行的作业名称。

标签/值

作业类型参数添加为标签和值对(键值对),其中标签是属性的名称,而是此属性的分配值。

要添加新的标签/值对,请单击 图中显示了“添加标签”图标。

要删除标签/值对,请单击 图中显示了“删除标签”图标。

管理模式

更改 Planning 应用程序的登录级别。如果将登录级别设置为管理员,则所有交互式用户和规划者将在作业完成后从应用程序中注销。有关管理模式的详细信息,请参阅“调度作业”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "管理模式"。

自动预测

使用自动预测作业来调度预测。使用自动预测,管理员可以定义预测以基于历史数据预测将来绩效,并调度作业来运行该预测定义,从而自动执行预测过程。

有关自动预测的详细信息,请参阅《管理 Planning》中的“设置预测以自动运行”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "自动预测"。

清除多维数据集

使用“清除多维数据集”作业类型清除输入和报表多维数据集中的特定数据。

可以使用成员选择或使用成员选择的有效 MDX 查询来清除数据,还可以选择清除相关的支持详细信息、注释和附件。您也可以选择对数据进行物理或逻辑清除。

有关可以传递的作业类型参数和值的详细信息,请参阅“使用清除多维数据集作业类型”。

压缩多维数据集

压缩 ASO 多维数据集的大纲文件。压缩有助于使大纲文件保持最佳大小。压缩大纲不会清除数据。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "压缩多维数据集"。

多维数据集刷新

刷新 Planning 应用程序多维数据集。通常,在将元数据导入应用程序后刷新多维数据集。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Cube Refresh"。

执行分别输出定义

针对单个维的多个成员的单个报表或工作簿执行分别输出,并为每个成员发布一个 PDF 或 Excel 输出。

Note:

分别输出定义必须存在于使用 burstingDefinitionName 参数指定的文件夹中。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Cube Refresh"。

导出审核

将审核记录导出到一个逗号分隔值 (CSV) 文件。输出 CSV 文件包含第一个字符作为字节顺序标记 (Byte Order Mark, BOM) 字符 \ufeff。API 在 BOM 字符后写入加密的应用程序标识符。在双引号之间写入此应用程序标识符。CSV 文件头跟在应用程序标识符后面。有关详细信息,请参阅“审核任务和数据”。

可以使用可选 excludeApplicationId 参数不在导出文件中写入应用程序标识符。没有应用程序标识符的导出的审核报表无法导入回应用程序。

将压缩生成的 CSV 文件,输出为 ZIP 文件。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导出审核"。

导出合并日记帐

使用作业名称执行“导出合并日记帐”作业。执行此作业之前,应该在 Financial Consolidation and Close 中创建“导出合并日记帐”作业。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导出合并日记帐"。

导出数据

使用在 export data 类型的 Planning 作业中指定的导出数据设置(包括文件名),将应用程序数据导出到文件中。包含导出数据的文件存储在 Planning 存储库中。

使用 REST API 执行此作业时,还可以覆盖作业定义的某些参数。

导出数据支持替代变量。覆盖 rowMemberscolumnMemberspovMembers 定义时,可以使用替代变量。请参阅《管理 Planning》中的“创建替代变量并为其分配值”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Export Data"。

导出作业控制台

将作业控制台记录导出到一个逗号分隔值 (CSV) 文件。输出 CSV 文件包含第一个字符作为字节顺序标记 (Byte Order Mark, BOM) 字符 \ufeff。API 在 BOM 字符后写入加密的应用程序标识符。在双引号之间写入此应用程序标识符。CSV 文件头跟在应用程序标识符后面。

可以使用可选 excludeApplicationId 参数不在导出文件中写入应用程序标识符。没有应用程序标识符的导出的作业控制台数据文件无法导入回应用程序。

将压缩生成的 CSV 文件,输出为 ZIP 文件。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导出作业控制台"。

导出元数据

使用在 export metadata 类型的 Planning 作业中指定的设置,将元数据导出到文件中。包含导出元数据的文件存储在 Planning 存储库中。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导出元数据"。

导出安全性

将指定用户或组的安全记录或访问控制列表 (access control list, ACL) 记录导出到逗号分隔值 (CSV) 文件。有关对应用程序对象的访问权限的信息,请参阅“设置访问权限”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导出安全性"。

导入合并日记帐

使用作业名称执行“导入合并日记帐”作业。执行此作业之前,应该在 Financial Consolidation and Close 中创建“导入合并日记帐”作业。

有关此任务的详细信息,请参阅《使用 Financial Consolidation and Close》中的“导入合并日记帐”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导入合并日记帐"。

导入数据

使用在 Import Data 类型的 Planning 作业中指定的导入数据设置,将数据从 Planning 存储库中的文件导入应用程序中。

对于 PlanningFinancial Consolidation and CloseTax Reporting,您可以查看具有错误的已拒绝数据记录。为此,请指定一个错误文件,用于捕获未为每个维导入的数据记录。如果指定了错误文件,该 ZIP 文件将存储在发件箱中,您可在其中使用收件箱/发件箱资源管理器或者 EPM Automate 或 REST API(例如下载 API)等工具下载文件。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Import Data"。

导入兑换率

Planning 存储库中导入兑换率模板,并根据需要更改兑换率。然后,您可以使用在导入兑换率类型的 Planning 作业中指定的“导入兑换率”设置,将兑换率导入应用程序中。有关详细信息,请参阅 作业类型

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导入兑换率"。

导入元数据

使用在 import metadata 类型的 Planning 作业中指定的导入元数据设置,将元数据从 Planning 存储库中的文件导入应用程序中。

对于 PlanningFinancial Consolidation and CloseTax Reporting,您可以查看具有错误的已拒绝数据记录。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Import Metadata"。

导入安全性

从逗号分隔值 (CSV) 文件导入安全记录或访问控制列表 (access control list, ACL) 记录。有关对应用程序对象的访问权限的信息,请参阅“设置访问权限”。

Excel 文件格式:

  • Object Name:为其定义 ACL 的对象的名称
  • Name:为其定义 ACL 的用户或组的名称
  • Parent:对象的父代名称
  • Is User:确定是为用户还是为组定义 ACL 的标志(Y 或 N)
  • Object Type:对象的类型,例如 Forms folder
  • Access Type:权限的类型,例如 READ 或 READWRITE
  • Access Mode:其他信息,例如 ACL 是否适用于后代
  • Remove:要删除特定 ACL,请将此项设置为 Y

所有可能值:

对象类型:

  • SL_FORM - 表单
  • SL_COMPOSITE - 复合表单
  • SL_TASKLIST - 任务列表
  • SL_CALCRULE - 规则
  • SL_FORMFOLDER - 表单文件夹
  • SL_CALCFOLDER - 规则文件夹
  • SL_DIMENSION - 维
  • SL_CALCTEMPLATE - 模板
  • SL_REPORT - 管理报表
  • SL_REPORTSSHOT - 管理报表快照

访问类型:

  • NONE - 无
  • READ - 读取
  • WRITE - 写入
  • READWRITE - 读写
  • LAUNCH - 启动

访问模式:

  • MEMBER
  • CHILDREN
  • @ICHILDREN
  • @DESCENDANTS
  • @IDESCENDANTS

CSV 文件示例:

Object Name,Name,Parent,Is User,Object Type,Access Type,Access
          Mode,Remove
Object Name,Name,Parent,Is User,Object Type,Access Type,Access
          Mode,Remove
"Exchange Rates to
          USD","ats_user3","Y","SL_FORM","READWRITE","MEMBER","N" 
"Exchange Rates to
          USD","ats_user4","Y","SL_FORM","READWRITE","MEMBER","N" 
"Exchange Rates to
          USD","ats_user15","Y","SL_FORM","READ","MEMBER","N" 
"Exchange Rates to
          USD","ats_user10","Y","SL_FORM","NONE","MEMBER","N" 
"Calculate
          Benefits","group_1","N","SL_COMPOSITE","READWRITE","MEMBER","N"

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "导入安全性"。

合并数据切片

合并 ASO 多维数据集的增量数据切片。减少切片可以提高多维数据集的性能。您可以将所有增量数据切片合并到主数据库切片,或者将所有增量数据切片合并为单个数据切片,而不更改主数据库切片。还可以选择删除值为零的单元格。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "合并数据切片"。

优化聚合

提高 ASO 多维数据集的性能。此作业包含两个操作:启用查询跟踪和执行聚合流程。它执行聚合,可以选择为生成的文件指定最大磁盘空间,并可以选择使视图选择基于用户查询模式。此作业类型仅适用于聚合存储数据库。

使用此作业类型之前,必须先启用查询跟踪来捕获有关聚合存储多维数据集的跟踪统计信息。在启用查询跟踪之后,必须留出足够长的时间来收集用户数据检索模式,然后再根据查询数据执行聚合流程。执行聚合流程将删除现有的聚合视图,并根据收集的查询跟踪数据生成优化的视图。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "优化聚合"。

规划类型映射

根据在 plan type map 类型的 Planning 作业中指定的设置,将数据从一个块存储多维数据集复制到一个聚合存储多维数据集或者从一个多维数据集复制到另一个多维数据集。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Plan Type Map"。

重建多维数据集

对 BSO 多维数据集执行完全重建以消除或减少碎片。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "重建多维数据集"。

规则

启动业务规则。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "规则"。

规则集

启动业务规则集。

支持没有运行时提示或者具有运行时提示并使用默认值的规则集。您可以向规则集添加参数以获得更大的灵活性。有关规则集的详细信息,请参阅“设计业务规则集”。

有关可以传递的作业类型参数和值的详细信息,请参阅《REST API for Enterprise Performance Management Cloud》中的 "Ruleset"。

下面是“EPM 平台作业”作业类型的示例导出数据参数:

图中显示了 EPM 平台作业的导出数据作业参数。

下面是“EPM 平台作业”作业类型的示例多维数据集刷新参数:

图中显示了“EPM 平台作业”作业类型的多维数据集刷新参数。

下面是“EPM 平台作业”作业类型的示例“导入兑换率”作业参数:

图中显示了“导入兑换率”作业参数。

下面是“EPM 平台作业”作业类型的示例“规划类型映射”作业参数:

图中显示了 EPM 平台作业类型的“规划类型映射”作业参数。