简介

本教程演示如何实施 Groovy 脚本以使用数据网格和数据网格迭代器。可以使用条件逻辑设置数据网格中的背景颜色、实施性能基准并设置网格中的默认数据值。按顺序完成部分。

背景信息

通过数据网格界面,可以访问 POV/行/列标题单元格,并提供各种迭代器来迭代数据单元格。

先决条件

Cloud EPM 实操教程可能需要您将快照导入 Cloud EPM Enterprise Service 实例。无法通过现有应用程序或业务流程导入快照。在导入快照之前,请使用单独的 Cloud EPM Enterprise Service 实例,或者从计划使用的实例中删除现有应用程序或业务流程。导入快照不会自动替换或恢复现有内容。

在开始本教程之前,您必须:

  • 具有服务管理员对 Cloud EPM Enterprise Service 实例的访问权限。不应创建实例的业务流程。
  • 上载此快照并将其导入到您的实例。此快照需要 Planning 业务流程。如果您已经为另一个 Groovy 教程导入了快照,则可以继续使用该应用程序,而无需再次导入快照。

注意:

如果导入快照时遇到迁移错误,请重新运行迁移(不包括 HSS-Shared Services 组件),以及核心组件中的“安全性”和“用户首选项”对象。有关上载和导入快照的更多信息,请参阅 Administering Migration for Oracle Enterprise Performance Management Cloud 文档。

提示:

本教程所需的脚本作为每个部分中的文本文件链接。

使用条件逻辑设置背景颜色

在本节中,您将实施 Groovy 脚本,将数据值为 #MISSING 的单元的背景颜色设置为 █ (0x00BFFF) 颜色,将数据值小于或等于 50000 的单元设置为 █ (0xFF8C00) 颜色,将数据值大于 50000 的单元设置为 █ (0x00FA9A) 颜色。

注意:

在定义 Groovy 脚本之后,它可以与任何表单关联,这与需要在每个表单的上下文中定义的“数据验证”规则不同。

创建 Groovy 脚本

  1. 从 Planning 主页中,单击 导航器(导航器),然后在“Create and Manage(创建和管理)”下,单击 Rules(规则)以打开 Calculation Manager。
    “Create and Manage(创建和管理)”下的“Rules(规则)”的导航器
  2. 在“系统视图”选项卡上,依次展开 EPM 云、HP4 和 Plan1 。右键单击规则,然后选择新建。
    选择了“Rules(规则)”上下文菜单和“New(新建)”的系统视图
  3. 对于“名称”,输入 Groovy Set Background Color,然后单击确定。
    包含规则名称、应用程序和多维数据集的“新建规则”对话框
  4. 在规则编辑器中,将设计器选项更改为编辑脚本,并将脚本类型设置为 Groovy 脚本。
    选择了“编辑脚本”和“Groovy 脚本”的规则编辑器
  5. 复制此脚本并将其粘贴到编辑器中。
    Code reference 1operation.grid.dataCellIterator.each {
    Code reference 2    if(it.missing) {
    Code reference 3        it.bgColor = 0x00BFFF
    Code reference 4    } else if(it.data <= 50000)
    Code reference 5        it.bgColor = 0xFF8C00
        else if(it.data > 50000)
    Code reference 6        it.bgColor = 0x00FA9A
    }
    

    规范参考 1 该脚本将迭代当前数据网格 operation.grid 中由 dataCellIterator 返回的每个数据单元格。

    隐式 it 变量引用要迭代的当前项。在这种情况下,it 变量引用 dataCellIterator 返回的当前数据单元。

    提示:

    您还可以使用显式命名的变量(如 cell),如下例所示:
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    规范参考 2 对于当前数据单元格,脚本将检查缺少的值。

    注意:

    请注意,对于 #MISSING 或零的单元格,cell.data 返回 0(零)。要检查 #MISSING 的单元格而不是零,可以使用 cell.missing 属性。要检查单元格中的零值而不是 #MISSING,可以使用条件,例如 cell.data == 0 && !cell.missing。

    规范参考 3 如果为 TRUE,脚本会将单元格的背景颜色设置为 0x00BFFF( █ )

    规范参考 4 该脚本将检查数据值是否小于或等于 50000。

    规范参考 5 如果为 TRUE,脚本会将单元格的背景颜色设置为 0xFF8C00 ( █ )

    规范参考 6 如果单元格的数据值大于 50000,则脚本会将单元格的背景颜色设置为 0x00FA9A ( █ )

  6. 在工具栏上,单击 保存(保存)以保存脚本。单击确定以关闭信息消息。
    确认规则已保存的信息消息
  7. 单击 验证和部署 (Validate and Deploy)。单击确定以关闭信息消息。
    部署消息,确认部署成功
  8. 将 Calculation Manager 保持打开状态并返回到 Planning 浏览器窗口。

将规则添加到数据表单

  1. 在 Planning 主页上,单击数据。单击 EmployeeDriverForm 以打开数据表单。
    EmployeeDriverForm 打开,其中包含其初始数据
  2. 单击操作,然后选择编辑。
    选择了“编辑”的操作菜单
  3. 选择 Business Rules 选项卡。
  4. 将 Groovy Set Background Color(Groovy 设置背景颜色)添加到选定的业务规则中。
    “Business Rules(业务规则)”选项卡,其中“Selected Business Rules(选定业务规则)”中包含 Groovy 规则
  5. 在“业务规则属性”下,选择加载后运行。
    选择了“加载后运行”的业务规则属性
  6. 单击保存以保存表单定义。单击确定以关闭信息消息。
    确认表单已保存的信息消息
  7. 在页面底部,关闭编辑 EmployeeDriverForm 选项卡以返回到数据表单。
  8. 重新加载表单时,验证缺少的单元格是否为蓝色、小于或等于 50000 的值是否为橙色,大于 50000 的值是否为绿色。
    已重新加载表单,其中缺少蓝色单元格,橙色值等于或低于阈值,绿色值高于阈值

分析和调试脚本

在本部分中,将学习如何使用 DataGrid 接口提供的迭代器、分析代码以及向作业控制台添加调试语句。

创建 Groovy 脚本

  1. 返回到 Calculation Manager 窗口。
  2. 选择系统视图选项卡。在 Plan1 下,右键单击规则,然后选择新建。
    在规则上下文菜单中选择了“新建”的系统视图
  3. 对于“名称”,输入 Groovy Iterator Performance,然后单击确定。
    已输入 Groovy Iterator Performance 的“新建规则”对话框
  4. 在规则编辑器中,将设计器选项更改为编辑脚本,并将脚本类型设置为 Groovy 脚本。
    选择了“编辑脚本”和“Groovy 脚本”的规则编辑器
  5. 复制此脚本并将其粘贴到编辑器中。
    Code reference 1def benchmark(GridIterator itr) {
    Code reference 2    def start = currentTimeMillis()
    Code reference 3    itr.each { println "$it.memberNames, cell data: $it.data, $it.formattedValue" }
        def elapsed = currentTimeMillis() - start
    Code reference 4    println "\nTime taken by iterator: $elapsed"
    }
    
    Code reference 5println "Iterate over all data cells in this data grid...\n"
    Code reference 6benchmark operation.grid.dataCellIterator()
    
    println "Iterate over edited data cells in this data grid...\n"
    Code reference 7benchmark operation.grid.dataCellIterator({DataCell cell -> cell.edited})
    
    println "Iterate over Min Salary and Min Bonus data cells in this data grid...\n"
    Code reference 8benchmark operation.grid.dataCellIterator('Min Salary', 'Min Bonus')
    

    规范参考 1 定义一个名为 benchmark() 的实用程序方法,该方法使用指定的 GridIterator 迭代其单元格,并输出单元格表示的所有维的成员名称列表及其数据。它还会输出迭代程序花费的时间。

    规范参考 2 启动计时器。

    规范参考 3 使用指定的 GridIterator 对每个单元格进行迭代,并输出单元格表示的所有维的成员名称列表及其数据值和格式化值。$it.data 返回单元格的数字值,$it.formattedValue 返回用户输入的非数字值,如文本、智能列表或日期。

    规范参考 4 将迭代程序花费的时间输出到作业控制台。

    规范参考 5 将调试消息记录到作业控制台。

    规范参考 6 使用迭代器调用 benchmark() 方法以迭代当前数据网格中的每个单元格。

    规范参考 7 使用迭代器调用 benchmark() 方法以迭代当前数据网格中已编辑的单元格。

    提示:

    此迭代器可与 DataCell 对象上返回布尔值的任何属性一起使用,例如 lock、miss、valid、readOnly、validIntersection 等。

    规范参考 8 使用迭代器调用 benchmark() 方法,以迭代当前数据网格中的最小薪金和最小奖金数据单元格。

  6. 在工具栏上,单击 保存(保存)以保存脚本。单击确定以关闭信息消息。
    确认已保存 Groovy Iterator Performance 的信息消息
  7. 单击 验证和部署 (Validate and Deploy)。单击确定以关闭信息消息。
    消息确认部署成功
  8. 将 Calculation Manager 保持打开状态并返回到 Planning 浏览器窗口。

将规则添加到数据表单

  1. 在 EmployeeDriverForm 表单中,单击操作,然后选择编辑。
    选择了“编辑”的操作菜单
  2. 选择 Business Rules(业务规则)选项卡,然后将 Groovy Iterator Performance(Groovy 迭代器性能)添加到选定的业务规则。
    将 Groovy Iterator Performance 添加到选定业务规则的“业务规则”选项卡
  3. 在“业务规则属性”下,为“Groovy 迭代器性能”规则选择保存后运行。
    配置为在保存后运行的 Groovy 迭代器性能
  4. 单击保存以保存表单定义。单击确定以关闭信息消息。
    确认表单已保存的信息消息
  5. 在页面底部,关闭编辑 EmployeeDriverForm 选项卡以返回到数据表单。

测试 Groovy 脚本

  1. 在 EmployeeDriverForm 中,将 1 级的最低薪金更改为 35000,将 2 级的最低奖金更改为 2000。
    EmployeeDriverForm,其中包含 FY26 的两个已编辑单元格
  2. 单击保存。“Groovy Iterator Performance(Groovy 迭代器性能)”规则在保存数据后运行。单击确定以关闭信息消息。
    确认数据已保存且规则运行成功的信息消息
  3. 单击 导航器(导航器),然后单击“应用程序”下的作业以打开作业控制台。
    具有已完成的 Groovy Iterator 性能作业的作业控制台
  4. 单击 Groovy Iterator Performance 以显示作业详细信息。在 "Run Status"(运行状态)下,展开 Completed(已完成)以查看 Groovy 脚本打印的日志消息。
    显示 iterator 日志消息的已完成作业详细信息

    第一个迭代程序打印所有单元格和数据值,第二个迭代程序仅打印已编辑的两个单元格,第三个迭代程序仅打印“最低薪金”和“最低奖金”列的单元格。

  5. 关闭 "Job Details"(作业详细信息)。
  6. 单击 导航器(导航器),然后选择数据以返回到 EmployeeDriverForm。

设置默认数据值

在此部分中,将学习如何使用 DataGridBuilder 界面在网格中设置默认数据值。

创建 Groovy 脚本

  1. 返回到 Calculation Manager 窗口。
  2. 选择系统视图选项卡。在 Plan1 下,右键单击规则,然后选择新建。
    在规则上下文菜单中选择了“新建”的系统视图
  3. 对于“名称”,输入 Groovy Reset Grade Data,然后单击确定。
    输入了 Groovy 重置成绩数据的“新建规则”对话框
  4. 在规则编辑器中,将设计器选项更改为编辑脚本,并将脚本类型设置为 Groovy 脚本。
    选择了“编辑脚本”和“Groovy 脚本”的规则编辑器
  5. 复制此脚本并将其粘贴到编辑器中。
    Code reference 1Cube cube = operation.application.getCube("Plan1")
    String currentYear = operation.application.getSubstitutionVariableValue("OEP_CurYr")
    
    Code reference 2DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY")
    Code reference 3builder.addPov(currentYear, 'Current', 'USD', 'BegBalance', 'BU Version_1', 'No Entity')
    builder.addColumn('Min Salary', 'Max Salary', 'Min Bonus', 'Max Bonus')
    builder.addRow(['Grade 1'], [30000, 50000, '#missing', '#missing'])
    builder.addRow(['Grade 2'], [40000, 60000, '#missing', 5000])
    builder.addRow(['Grade 3'], [70000, 90000, '#missing', 10000])
    
    Code reference 4DataGridBuilder.Status status = new DataGridBuilder.Status()
    Code reference 5builder.build(status).withCloseable { DataGrid grid ->
    Code reference 6    println("Total number of cells accepted: $status.numAcceptedCells")
        println("Total number of cells rejected: $status.numRejectedCells")
        println("First 100 rejected cells: $status.cellsRejected")
    Code reference 7    cube.saveGrid(grid)
    Code reference 8}
    

    规范参考 1 为 Plan1 多维数据集构建多维数据集对象,并从应用程序级替代变量读取当前年份。getSubstitutionVariableValue("OEP_CurYr") 读取应用程序级替代变量而不使用 & 符号。在提供的快照中,其值为 FY26。

    规范参考 2 获取多维数据集的 DataGridBuilder;定义脚本提供日期值的格式。

    注意:

    DataGridBuilder 还支持代表系统用户保存数据,方法是接受 ExecuteAsUser 作为第二个参数。将数据另存为系统用户允许在不应用当前用户安全性的情况下保存数据。ExecuteAsUser 的有效值为 CURRENT_USER(默认值)和 SYSTEM_USER,如下例所示:

    DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)

    规范参考 3 通过添加 POV 成员、列成员和具有数据值的行来构建数据网格。 将 currentYear 传递到 addPov 会使重置规则与表单保持一致,而无需每年硬编码。

    规范参考 4 为在下一步中创建的 DataGrid 对象构建状态对象。

    规范参考 5 使用 withCloseable 构造构建 DataGrid 对象。当块完成时,它将关闭网格,因此该规则不会使网格在内存中保持打开状态。

    规范参考 6 将构建器接受或拒绝的单元数输出到作业控制台。将拒绝任何只读单元格。

    规范参考 7 保存数据网格。

    规范参考 8 网格将自动关闭。

  6. 在工具栏上,单击 保存(保存)以保存脚本。单击确定以关闭信息消息。
    确认已保存 Groovy 重置成绩数据的信息消息
  7. 单击 验证和部署 (Validate and Deploy)。单击确定以关闭信息消息。
    消息确认部署成功
  8. 关闭 Calculation Manager 并返回到 Planning 浏览器窗口。

将规则添加到数据表单

  1. 在 EmployeeDriverForm 中,单击操作,然后选择编辑。
    选择了“编辑”的操作菜单
  2. 选择 Business Rules 选项卡。
  3. 将 Groovy Reset Grade Data(Groovy 重置薪资级别数据)添加到选定的业务规则。
    业务规则标签,其中 Groovy 重置选定业务规则中的薪资级别数据
  4. 在“业务规则属性”下,对于“Groovy 重置薪资级别数据”规则,将加载前运行、加载后运行、保存前运行和保存后运行保持清除状态,以便您可以手动启动它。
    Groovy 重置成绩数据,并清除所有自动加载和保存选项
  5. 单击保存以保存表单定义,然后单击确定以关闭信息消息。
    确认表单已保存的信息消息
  6. 在页面底部,关闭编辑 EmployeeDriverForm 选项卡以返回到数据表单。

测试 Groovy 脚本

  1. 单击操作,然后选择规则和智能推送。
    选择了“规则”和“智能推送”的操作菜单
  2. 在“规则”下,选择 Groovy Reset Grade Data(Groovy 重置薪资级别数据)以启动规则。
    选择了 Groovy 重置薪资级别数据的规则列表
  3. 规则成功完成后,单击确定以关闭信息消息。
    确认 Groovy 重置成绩数据已成功运行的信息消息
  4. 验证网格数据是否已重置为以下值。
    FY26 EmployeeDriverForm,其中恢复了默认薪金和奖金值
    薪资级别最低工资最高工资最小奖金最大奖金
    薪资级别 13000050000缺少缺少
    薪资级别 24000060000缺少5000
    薪资级别 37000090000缺少10000
  5. 单击 导航器(导航器),然后单击“应用程序”下的作业以打开作业控制台。
    完成了 Groovy Reset Grade Data 作业的作业控制台
  6. 单击 Groovy Reset Grade Data 可显示作业详细信息。在 "Run Status"(运行状态)下,展开 Completed(已完成)以查看已接受和已拒绝单元格的数量。
    已完成的 Groovy 重置成绩数据作业详细信息,其中包含已接受和已拒绝的单元格计数

更多学习资源

通过 docs.oracle.com/learn 浏览其他实验室,或者通过 Oracle Learning YouTube 频道访问更多免费学习内容。此外,请访问 Oracle University 查看可用的培训资源。

有关产品文档,请访问 Oracle 帮助中心。