イントロダクション

このチュートリアルでは、データ・グリッドおよびデータ・グリッド・イテレータを操作するためのGroovyスクリプトの実装方法を示します。条件付きロジックを使用して、データ・グリッドに背景色を設定し、パフォーマンス・ベンチマークを実装し、グリッドにデフォルト・データ値を設定します。項を順番に入力します。

バックグラウンド

データ・グリッド・インタフェースで、POV/行/列のヘッダー・セルにアクセスでき、データ・セルを反復する様々なイテレータが提供されます。

前提条件

Cloud EPMのハンズオン・チュートリアルでは、Cloud EPM Enterprise Serviceインスタンスにスナップショットをインポートする必要がある場合があります。スナップショットは、既存のアプリケーションまたはビジネス・プロセスを介してインポートできません。スナップショットをインポートする前に、別のCloud EPM Enterprise Serviceインスタンスを使用するか、使用する予定のインスタンスから既存のアプリケーションまたはビジネス・プロセスを削除してください。スナップショットをインポートしても、既存のコンテンツは自動的に置換またはリストアされません。

このチュートリアルを始める前に次の用意をする必要があります。

  • サービス管理者にCloud EPM Enterprise Serviceインスタンスへのアクセス権を付与します。インスタンスにビジネス・プロセスを作成しないでください。
  • このスナップショットをアップロードして、インスタンスにインポートします。このスナップショットにはPlanningビジネス・プロセスが必要です。別のGroovyチュートリアルのスナップショットをすでにインポートしている場合は、スナップショットを再度インポートせずにそのアプリケーションを引き続き使用できます。

ノート:

スナップショットのインポート中に移行エラーが発生した場合は、HSS-Shared Servicesコンポーネントを除く移行、およびCoreコンポーネントのセキュリティ・アーティファクトとユーザー・プリファレンス・アーティファクトを再実行します。スナップショットのアップロードおよびインポートの詳細は、Oracle Enterprise Performance Management Cloud移行の管理のドキュメントを参照してください。

ヒント :

このチュートリアルに必要なスクリプトは、各セクション内にテキスト・ファイルとしてリンクされています。

条件付きロジックを使用した背景色の設定

この項では、Groovyスクリプトを実装して、データ値が#MISSINGのセルの背景色を色█ (0x00BFFF)、データ値が50000未満のセルを色█ (0xFF8C00)に設定し、データ値が50000を超えるセルを色█ (0x00FA9A)に設定します。

ノート:

Groovyスクリプトを定義した後、各フォームのコンテキストで定義する必要があるデータ検証ルールとは異なり、任意のフォームに関連付けることができます。

Groovyスクリプトの作成

  1. Planningホーム・ページでナビゲータ (ナビゲータ)をクリックし、「作成および管理」で「ルール」をクリックしてCalculation Managerを開きます。
    「作成および管理」の「ルール」を含むナビゲータ
  2. 「システム・ビュー」タブで、EPM Cloud、HP4、Plan1の順に展開します。「ルール」を右クリックしてから、「新規」を選択します。
    「ルール」コンテキスト・メニューおよび「新規」が選択されたシステム・ビュー
  3. 「名前」にGroovy Set Background Colorと入力し、「OK」をクリックします。
    ルール名、アプリケーションおよびキューブが表示された「新規ルール」ダイアログ
  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 このスクリプトは、dataCellIteratorによって戻された現在のデータ・グリッドoperation.gridの各データ・セルを反復処理します。

    暗黙的な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( █ )に設定します。

    コード参照4 このスクリプトでは、データ値が50000以下かどうかがチェックされます。

    コード参照5 TRUEの場合、スクリプトはセルの背景色を0xFF8C00 ( █ )に設定します。

    コード参照6 セルのデータ値が50000を超える場合、スクリプトはセルの背景色を0x00FA9A ( █ )に設定します

  6. ツールバーで、保存 (保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
    ルールが保存されたことを確認する情報メッセージ
  7. 検証およびデプロイ (「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
    デプロイメントの成功を確認するデプロイ・メッセージ
  8. Calculation Managerを開いたまま、Planningブラウザ・ウィンドウに戻ります。

データ・フォームへのルールの追加

  1. Planningホーム・ページで、「データ」をクリックします。EmployeeDriverFormをクリックして、データ・フォームをオープンします。
    EmployeeDriverFormは、初期データでオープンします。
  2. 「アクション」をクリックして、「編集」を選択します。
    「編集」が選択された「アクション」メニュー
  3. 「ビジネス・ルール」タブを選択します。
  4. 選択したビジネス・ルールに「Groovy Set Background Color」を追加します。
    「選択したビジネス・ルール」にGroovyルールが表示された「ビジネス・ルール」タブ
  5. 「ビジネス・ルール・プロパティ」で、「ロード後に実行」を選択します。
    「ロード後に実行」が選択されたビジネス・ルール・プロパティ
  6. 「Save」をクリックして、フォームの定義を保存します。「OK」をクリックして情報メッセージを閉じます。
    フォームが保存されたことを確認する情報メッセージ
  7. ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。
  8. フォームがリロードされるときに、欠落しているセルが青色、50000以下の値がオレンジ色、50000より大きい値が緑色であることを確認します。
    青色の欠落セル、しきい値以下のオレンジ色の値およびしきい値を超える緑色の値を含む再ロードされたフォーム

スクリプトのプロファイリングとデバッグ

この項では、DataGridインタフェースで提供されるイテレータの使用方法、コードのプロファイル、およびジョブ・コンソールへのデバッグ文の追加について学習します。

Groovyスクリプトの作成

  1. 「Calculation Manager」ウィンドウに戻ります。
  2. 「System View」タブを選択します。Plan1で「ルール」を右クリックしてから、「新規」を選択します。
    「ルール」コンテキスト・メニューで「新規」が選択されたシステム・ビュー
  3. 「名前」にGroovy Iterator Performanceと入力し、「OK」をクリックします。
    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 指定したGridIteratorを使用してセルを反復処理し、セルが表すすべてのディメンションのメンバー名のリストをデータとともに出力する、benchmark()というユーティリティ・メソッドを定義します。また、イテレータにかかった時間も出力されます。

    コード参照2 タイマーを起動します。

    コード参照3 指定したGridIteratorを使用して各セルを反復し、セルが表すすべてのディメンションのメンバー名のリストを、そのデータ値および書式設定された値とともに出力します。$it.dataはセルの数値を返し、$it.formattedValueはユーザーが入力したテキスト、スマート・リスト、日付などの非数値を返します。

    コード参照4 イテレータがジョブ・コンソールに要した時間を出力します。

    コード参照5 デバッグ・メッセージをジョブ・コンソールに記録します。

    コード参照6 イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッド内の各セルを反復します。

    コード参照7 イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッドで編集したセルを反復処理します。

    ヒント :

    このイテレータは、ロック済、欠落、有効、readOnly、validIntersectionなどのブール値を返すDataCellオブジェクトの任意のプロパティとともに使用できます。

    コード参照8 イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッドのMin SalaryおよびMin Bonusデータ・セルを反復処理します。

  6. ツールバーで、保存 (保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
    Groovyイテレータ・パフォーマンスが保存されたことを確認する情報メッセージ
  7. 検証およびデプロイ(「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
    正常にデプロイされたことを確認するメッセージ
  8. Calculation Managerを開いたまま、Planningブラウザ・ウィンドウに戻ります。

データ・フォームへのルールの追加

  1. EmployeeDriverFormフォームで、「アクション」をクリックし、「編集」を選択します。
    「編集」が選択された「アクション」メニュー
  2. 「ビジネス・ルール」タブを選択し、「Groovyイテレータ・パフォーマンス」を「選択したビジネス・ルール」に追加します。
    選択したビジネス・ルールにGroovyイテレータ・パフォーマンスが追加された「ビジネス・ルール」タブ
  3. 「ビジネス・ルール・プロパティ」で、「Groovyイテレータ・パフォーマンス」ルールの「保存後に実行」を選択します。
    保存後に実行するように構成されたGroovyイテレータ・パフォーマンス
  4. 「Save」をクリックして、フォームの定義を保存します。「OK」をクリックして情報メッセージを閉じます。
    フォームが保存されたことを確認する情報メッセージ
  5. ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。

Groovyスクリプトのテスト

  1. EmployeeDriverFormで、等級1の「最低給与」を35000に、等級2の「最低賞与」を2000に変更します。
    FY26の2つの編集済セルを含むEmployeeDriverForm
  2. 「保存」をクリックします。Groovyイテレータ・パフォーマンス・ルールは、データの保存後に実行されます。「OK」をクリックして情報メッセージを閉じます。
    データが保存され、ルールが正常に実行されたことを確認する情報メッセージ
  3. ナビゲータ (ナビゲータ)をクリックし、「アプリケーション」で「ジョブ」をクリックして、ジョブ・コンソールを開きます。
    完了したGroovyイテレータ・パフォーマンス・ジョブを含むジョブ・コンソール
  4. 「Groovyイテレータ・パフォーマンス」をクリックして、ジョブの詳細を表示します。「実行ステータス」で、「完了」を展開し、Groovyスクリプトによって出力されるログ・メッセージを表示します。
    イテレータ・ログ・メッセージが表示された完了ジョブの詳細

    最初のイテレータはすべてのセルとデータ値を出力し、2番目のイテレータは編集された2つのセルのみを出力し、3番目のイテレータは「最低給与」列と「最低賞与」列のセルのみを出力します。

  5. 「ジョブ詳細」を閉じます。
  6. ナビゲータ (ナビゲータ)をクリックし、「データ」を選択してEmployeeDriverFormに戻ります。

デフォルトのデータ値の設定

この項では、DataGridBuilderインタフェースを使用してグリッドにデフォルトのデータ値を設定する方法を学習します。

Groovyスクリプトの作成

  1. 「Calculation Manager」ウィンドウに戻ります。
  2. 「System View」タブを選択します。Plan1で、「Rules」を右クリックして、「New」を選択します。
    「ルール」コンテキスト・メニューで「新規」が選択されたシステム・ビュー
  3. 「名前」にGroovy Reset Grade Dataと入力し、「OK」をクリックします。
    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では、2番目のパラメータとして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. ツールバーで、保存 (保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
    Groovyリセット等級データが保存されたことを確認する情報メッセージ
  7. 検証およびデプロイ (「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
    正常にデプロイされたことを確認するメッセージ
  8. Calculation Managerを閉じて、Planningブラウザ・ウィンドウに戻ります。

データ・フォームへのルールの追加

  1. EmployeeDriverFormで、「アクション」をクリックし、「編集」を選択します。
    「編集」が選択された「アクション」メニュー
  2. 「ビジネス・ルール」タブを選択します。
  3. 「Groovy Reset Grade Data」を「Selected Business Rules」に追加します。
    選択したビジネス・ルールにGroovyリセット等級データがある「ビジネス・ルール」タブ
  4. 「ビジネス・ルール・プロパティ」の「Groovyリセット等級データ」ルールで、「ロード前に実行」、「ロード後に実行」、「保存前に実行」および「保存後に実行」をクリアしたままにして、手動で起動できるようにします。
    すべての自動ロードおよび保存オプションがクリアされた状態で等級データをリセットするGroovy
  5. 「Save」をクリックしてフォーム定義を保存し、「OK」をクリックして情報メッセージを閉じます。
    フォームが保存されたことを確認する情報メッセージ
  6. ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。

Groovyスクリプトのテスト

  1. 「アクション」をクリックし、「ルールとスマート・プッシュ」を選択します。
    「ルール」および「スマート・プッシュ」が選択された「アクション」メニュー
  2. 「ルール」で、「Groovy Reset Grade Data」を選択してルールを起動します。
    「Groovy Reset Grade Data」が選択された「Rules」リスト
  3. ルールが正常に完了したら、「OK」をクリックして情報メッセージを閉じます。
    Groovyリセット等級データが正常に実行されたことを確認する情報メッセージ
  4. グリッド・データが次の値にリセットされていることを確認します。
    デフォルトの給与および賞与の値が復元されたFY26 EmployeeDriverForm
    グレード最低給与最高給与最小ボーナス最大ボーナス
    グレード13000050000欠落欠落
    グレード24000060000欠落5000
    グレード37000090000欠落10000
  5. ナビゲータ (ナビゲータ)をクリックし、「アプリケーション」で「ジョブ」をクリックして、ジョブ・コンソールを開きます。
    完了したGroovy等級データのリセット・ジョブを含むジョブ・コンソール
  6. 「Groovy Reset Grade Data」をクリックして、ジョブ詳細を表示します。「実行ステータス」で、「完了」を展開して、受け入れられたセルと拒否されたセルの数を表示します。
    受理済および拒否済セル数を含むGroovy等級データのリセット・ジョブ詳細が完了しました

その他の学習リソース

docs.oracle.com/learnの他のラボを調べるか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、利用可能なトレーニング・リソースについては、Oracle Universityをご覧ください。

製品ドキュメントについては、Oracle Help Centerを参照してください。