簡介

本教學課程示範如何實作 Groovy 命令檔來使用資料方格和資料方格重複程式。您可以使用條件邏輯來設定資料方格中的背景顏色、實行效能基準設定,以及在方格中設定預設資料值。依序完成區段。

背景

資料方格介面可讓您存取 POV/ 列 / 欄標頭儲存格,並提供各種重複程式以重複資料儲存格。

必要條件

Cloud EPM 實作教學課程可能需要您將快照匯入至 Cloud EPM Enterprise Service 例項。無法透過現有的應用程式或業務程序匯入快照。匯入快照之前,請使用個別的 Cloud EPM Enterprise Service 例項,或從您計畫使用的例項中移除現有的應用程式或業務程序。匯入快照並不會自動取代或回復現有的內容。

開始此教學課程之前,您必須:

  • 讓服務管理員可以存取 Cloud EPM Enterprise Service 例項。實例不應建立業務處理程序。
  • 上傳此快照並將其匯入您的執行處理。此快照需要 Planning 業務程序。如果您已經匯入另一個 Groovy 教學課程的快照,您可以繼續使用該應用程式,而不需再次匯入快照。

附註:

如果匯入快照時發生移轉錯誤,請重新執行移轉 (不包括 HSS-Shared Services 元件),以及「核心」元件中的「安全性與使用者偏好設定」人工因素。如需上傳與匯入快照的詳細資訊,請參考管理 Oracle Enterprise Performance Management Cloud 的移轉文件。

秘訣:

此教學課程所需的命令檔會連結為每個區段內的文字檔。

使用條件邏輯來設定背景顏色

在此區段中,您實作 Groovy 指令碼,以將資料值為 #MISSING 之儲存格的背景顏色設為顏色 O (0x00BFFF)、資料值小於或等於 50000 的儲存格設為顏色 O (0xFF8C00),以及資料值超過 50000 的儲存格設為顏色 O (0x00FA9A)。

附註:

定義 Groovy 指令碼之後,該指令碼可以與任何表單建立關聯,與需要在每個表單內容中定義的「資料驗證」規則不同。

建立 Groovy 指令碼

  1. 從「規劃首頁」中,按一下 瀏覽器 (導覽器),然後在「建立與管理」下,按一下規則以開啟 Calculation Manager。
    具有「建立與管理」底下規則的瀏覽器
  2. 在「系統檢視」頁籤上,依序展開 EPM Cloud 、HP4 及 Plan1 。在規則上按一下滑鼠右鍵,然後選取新建。
    已選取「規則」彈出式功能表和「新增」的「系統檢視」
  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 對於目前的資料儲存格,指令碼會檢查是否有遺漏的值。

    附註:

    請注意,cell.data 會針對 #MISSING 或零的儲存格傳回 0 (零)。若要檢查 #MISSING 的儲存格而非零,您可以使用 cell.missing 特性。若要檢查零值 (而非 #MISSING) 的儲存格,可以使用 cell.data == 0 && !cell.missing 等條件。

    參考代碼 3 如果為 TRUE,則命令檔會將儲存格的背景顏色設為 0x00BFFF (O)

    參考代碼 4 指令碼會檢查資料值是否小於或等於 50000。

    法規參考 5 如果為 TRUE,則命令檔會將儲存格的背景顏色設為 0xFF8C00 (O)

    法規參考 6 如果儲存格的資料值超過 50000,則指令碼會將儲存格的背景顏色設為 0x00FA9A ( █ )

  6. 在工具列上,按一下 儲存 (儲存) 以儲存命令檔。按一下確定,關閉資訊訊息。
    確認已儲存規則的資訊訊息
  7. 按一下 驗證和部署 (驗證與部署)。按一下確定,以關閉資訊訊息。
    確認成功部署的部署訊息
  8. 將 Calculation Manager 保持開啟,並返回 Planning 瀏覽器視窗。

新增規則至資料表單

  1. 在「規劃首頁」上,按一下資料。按一下 EmployeeDriverForm 以開啟資料表單。
    EmployeeDriverForm 以其初始資料開啟
  2. 按一下動作,然後選取編輯。
    選取了「編輯」的「動作」功能表
  3. 選取商業規則頁籤。
  4. 將 Groovy 集背景顏色新增至選取的商業規則。
    具有所選商業規則中 Groovy 規則的「商業規則」頁籤
  5. 在「商業規則特性」下,選取載入後執行。
    已選取「載入後執行」的商業規則特性
  6. 按一下儲存,儲存表單定義。按一下確定,以關閉資訊訊息。
    確認表單已儲存的資訊訊息
  7. 在頁面底端,關閉編輯 EmployeeDriverForm 頁籤以返回資料表單。
  8. 重新載入表單時,請確認缺少的儲存格為藍色、小於或等於 50000 的值為橘色,且大於 50000 的值為綠色。
    重新載入的表單含有藍色遺漏的儲存格,橘色值等於或低於臨界值,綠色值高於臨界值

對指令碼進行分析和除錯

在本節中,您將瞭解如何使用 DataGrid 介面提供的迭代器、設定檔程式碼,以及將除錯敘述句新增至工作主控台。

建立 Groovy 指令碼

  1. 返回 Calculation Manager 視窗。
  2. 選取系統檢視頁籤。在 Plan1 下,在規則上按一下滑鼠右鍵,然後選取新。
    在「規則」彈出式功能表中選取「新建」的「系統檢視」
  3. 針對「名稱」,輸入 Groovy Iterator Performance,然後按一下確定。
    已輸入 Groovy 重複程式效能的新規則對話方塊
  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() 方法,以重複目前資料方格中編輯的儲存格。

    秘訣:

    此重複程式可與傳回布林值 (例如 locked、missing、valid、readOnly、validIntersection 等) 之 DataCell 物件上的任何特性搭配使用。

    參考代碼 8 使用重複程式呼叫 benchmark() 方法,以重複目前資料方格中的「最低薪資」與「最低獎金」資料儲存格。

  6. 在工具列上,按一下 儲存 (儲存) 以儲存命令檔。按一下確定,關閉資訊訊息。
    確認已儲存 Groovy 重複程式效能的資訊訊息
  7. 按一下 驗證和部署 (驗證與部署)。按一下確定,關閉資訊訊息。
    確認成功部署的訊息
  8. 將 Calculation Manager 保持開啟,並返回 Planning 瀏覽器視窗。

新增規則至資料表單

  1. 在 EmployeeDriverForm 表單中,按一下動作,然後選取編輯。
    選取了「編輯」的「動作」功能表
  2. 選取商業規則頁籤,然後將 Groovy Iterator 效能新增至「選取的商業規則」。
    「商業規則」頁籤,其中 Groovy 重複程式效能已新增至選取的商業規則
  3. 在「商業規則特性」下,針對 Groovy Iterator 效能規則,選取儲存後執行。
    Groovy 重複程式效能設定為儲存後執行
  4. 按一下儲存,儲存表單定義。按一下確定,以關閉資訊訊息。
    確認表單已儲存的資訊訊息
  5. 在頁面底端,關閉編輯 EmployeeDriverForm 頁籤以返回資料表單。

測試 Groovy 指令碼

  1. 在 EmployeeDriverForm 中,將等級 1 的最低薪資變更為 35000,並將等級 2 的最低獎金變更為 2000。
    EmployeeDriverForm 與 FY26 的兩個已編輯儲存格
  2. 按一下儲存。儲存資料後會執行 Groovy 重複程式效能規則。按一下確定,關閉資訊訊息。
    確認已儲存資料並順利執行規則的資訊訊息
  3. 按一下 瀏覽器 (導覽器),然後在「應用程式」下,按一下工作以開啟「工作主控台」。
    具有已完成 Groovy 重複程式效能工作的工作主控台
  4. 按一下 Groovy Iterator 效能以顯示工作詳細資訊。在「執行狀態」下,展開已完成以檢視 Groovy 指令碼所列印的日誌訊息。
    顯示重複程式日誌訊息的已完成工作詳細資訊

    第一個重複程式會列印所有儲存格與資料值,第二個重複程式只會列印編輯的兩個儲存格,第三個重複程式則只會列印「最低薪資」與「最低獎金」欄的儲存格。

  5. 關閉「工作詳細資訊」。
  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. 按一下 驗證和部署 (驗證與部署)。按一下確定,以關閉資訊訊息。
    確認成功部署的訊息
  8. 關閉 Calculation Manager 並返回 Planning 瀏覽器視窗。

新增規則至資料表單

  1. 在 EmployeeDriverForm 中,按一下動作,然後選取編輯。
    選取了「編輯」的「動作」功能表
  2. 選取商業規則頁籤。
  3. 將 Groovy 重設等級資料新增至選取的商業規則。
    「商業規則」頁籤,內含所選商業規則中的 Groovy 重設等級資料
  4. 在「商業規則特性」下,對於「Groovy 重設等級資料」規則,將載入前執行、載入後執行、儲存前執行,以及清除儲存後執行,以便您可以手動啟動。
    已清除所有自動載入與儲存選項的 Groovy 重設等級資料
  5. 按一下儲存以儲存表單定義,然後按一下確定以關閉資訊訊息。
    確認表單已儲存的資訊訊息
  6. 在頁面底端,關閉編輯 EmployeeDriverForm 頁籤以返回資料表單。

測試 Groovy 指令碼

  1. 按一下動作,然後選取規則與智慧型發送。
    已選取「規則」和「智慧型發送」的「動作」功能表
  2. 在「規則」下,選取 Groovy 重設等級資料以啟動規則。
    已選取「Groovy 重設成績資料」的規則清單
  3. 當規則順利完成時,按一下確定以關閉資訊訊息。
    確認「Groovy 重設成績資料」已順利執行的資訊訊息
  4. 確認方格資料已重設為下列值。
    FY26 EmployeeDriverForm,已還原預設薪資與紅利值
    職級薪資下限薪資上限最低獎金最高獎金
    等級 13000050000遺漏遺漏
    等級 24000060000遺漏5000
    等級 37000090000遺漏10000
  5. 按一下 瀏覽器 (導覽器),然後在「應用程式」下,按一下工作以開啟「工作主控台」。
    具有已完成「Groovy 重設成績資料」工作的「工作主控台」
  6. 按一下 Groovy 重設成績資料以顯示職務詳細資料。在「執行狀態」下,展開已完成以檢視已接受與已拒絕的儲存格數目。
    已完成的 Groovy 重設具有已接受與已拒絕儲存格數目的職等資料職務明細

其他學習資源

在 docs.oracle.com/learn 上探索其他實驗室,或在 Oracle Learning YouTube 頻道上存取更多免費學習內容。此外,請造訪 Oracle University 以檢視可用的訓練資源。

如需產品文件,請造訪 Oracle Help Center 。