イントロダクション
このチュートリアルでは、データ・グリッドおよびデータ・グリッド・イテレータを操作するための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スクリプトの作成
- Planningホーム・ページで
(ナビゲータ)をクリックし、「作成および管理」で「ルール」をクリックしてCalculation Managerを開きます。
- 「システム・ビュー」タブで、EPM Cloud、HP4、Plan1の順に展開します。「ルール」を右クリックしてから、「新規」を選択します。

- 「名前」に
Groovy Set Background Colorと入力し、「OK」をクリックします。
- ルール・エディタで、「デザイナ」オプションを「スクリプトの編集」に変更し、「スクリプト・タイプ」を「Groovyスクリプト」に設定します。

- このスクリプトをコピーし、エディタに貼り付けてください。
operation.grid.dataCellIterator.each {
if(it.missing) {
it.bgColor = 0x00BFFF
} else if(it.data <= 50000)
it.bgColor = 0xFF8C00
else if(it.data > 50000)
it.bgColor = 0x00FA9A
}
このスクリプトは、dataCellIteratorによって戻された現在のデータ・グリッドoperation.gridの各データ・セルを反復処理します。暗黙的な
it変数は、反復処理される現在の項目を参照します。この場合、it変数は、dataCellIteratorによって返される現在のデータ・セルを参照します。ヒント :
次の例に示すように、cellなどの明示的に命名された変数を使用することもできます。
operation.grid.dataCellIterator.each { cell -> if(cell.missing) { cell.bgColor = 0x00BFFF } }
現在のデータ・セルの場合、スクリプトによって欠落値がチェックされます。ノート:
cell.dataは、#MISSINGまたはゼロのセルに対して0 (ゼロ)を返します。ゼロではなく#MISSINGのセルをチェックするには、cell.missingプロパティを使用します。#MISSINGではなくゼロ値のセルをチェックするには、cell.data == 0 && !cell.missingなどの条件を使用できます。
TRUEの場合、スクリプトはセルの背景色を0x00BFFF( █ )に設定します。
このスクリプトでは、データ値が50000以下かどうかがチェックされます。
TRUEの場合、スクリプトはセルの背景色を0xFF8C00( █ )に設定します。
セルのデータ値が50000を超える場合、スクリプトはセルの背景色を0x00FA9A ( █ )に設定します - ツールバーで、
(保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
(「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
- Calculation Managerを開いたまま、Planningブラウザ・ウィンドウに戻ります。
データ・フォームへのルールの追加
- Planningホーム・ページで、「データ」をクリックします。EmployeeDriverFormをクリックして、データ・フォームをオープンします。

- 「アクション」をクリックして、「編集」を選択します。

- 「ビジネス・ルール」タブを選択します。
- 選択したビジネス・ルールに「Groovy Set Background Color」を追加します。

- 「ビジネス・ルール・プロパティ」で、「ロード後に実行」を選択します。

- 「Save」をクリックして、フォームの定義を保存します。「OK」をクリックして情報メッセージを閉じます。

- ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。
- フォームがリロードされるときに、欠落しているセルが青色、
50000以下の値がオレンジ色、50000より大きい値が緑色であることを確認します。
スクリプトのプロファイリングとデバッグ
この項では、DataGridインタフェースで提供されるイテレータの使用方法、コードのプロファイル、およびジョブ・コンソールへのデバッグ文の追加について学習します。
Groovyスクリプトの作成
- 「Calculation Manager」ウィンドウに戻ります。
- 「System View」タブを選択します。Plan1で「ルール」を右クリックしてから、「新規」を選択します。

- 「名前」に
Groovy Iterator Performanceと入力し、「OK」をクリックします。
- ルール・エディタで、「デザイナ」オプションを「スクリプトの編集」に変更し、「スクリプト・タイプ」を「Groovyスクリプト」に設定します。

- このスクリプトをコピーし、エディタに貼り付けてください。
def benchmark(GridIterator itr) {
def start = currentTimeMillis()
itr.each { println "$it.memberNames, cell data: $it.data, $it.formattedValue" }
def elapsed = currentTimeMillis() - start
println "\nTime taken by iterator: $elapsed"
}
println "Iterate over all data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator()
println "Iterate over edited data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator({DataCell cell -> cell.edited})
println "Iterate over Min Salary and Min Bonus data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator('Min Salary', 'Min Bonus')
指定したGridIteratorを使用してセルを反復処理し、セルが表すすべてのディメンションのメンバー名のリストをデータとともに出力する、benchmark()というユーティリティ・メソッドを定義します。また、イテレータにかかった時間も出力されます。
タイマーを起動します。
指定したGridIteratorを使用して各セルを反復し、セルが表すすべてのディメンションのメンバー名のリストを、そのデータ値および書式設定された値とともに出力します。$it.dataはセルの数値を返し、$it.formattedValueはユーザーが入力したテキスト、スマート・リスト、日付などの非数値を返します。
イテレータがジョブ・コンソールに要した時間を出力します。
デバッグ・メッセージをジョブ・コンソールに記録します。
イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッド内の各セルを反復します。
イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッドで編集したセルを反復処理します。ヒント :
このイテレータは、ロック済、欠落、有効、readOnly、validIntersectionなどのブール値を返すDataCellオブジェクトの任意のプロパティとともに使用できます。
イテレータを使用してbenchmark()メソッドをコールし、現在のデータ・グリッドのMin SalaryおよびMin Bonusデータ・セルを反復処理します。 - ツールバーで、
(保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
(「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
- Calculation Managerを開いたまま、Planningブラウザ・ウィンドウに戻ります。
データ・フォームへのルールの追加
- EmployeeDriverFormフォームで、「アクション」をクリックし、「編集」を選択します。

- 「ビジネス・ルール」タブを選択し、「Groovyイテレータ・パフォーマンス」を「選択したビジネス・ルール」に追加します。

- 「ビジネス・ルール・プロパティ」で、「Groovyイテレータ・パフォーマンス」ルールの「保存後に実行」を選択します。

- 「Save」をクリックして、フォームの定義を保存します。「OK」をクリックして情報メッセージを閉じます。

- ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。
Groovyスクリプトのテスト
- EmployeeDriverFormで、等級1の「最低給与」を
35000に、等級2の「最低賞与」を2000に変更します。
- 「保存」をクリックします。Groovyイテレータ・パフォーマンス・ルールは、データの保存後に実行されます。「OK」をクリックして情報メッセージを閉じます。

(ナビゲータ)をクリックし、「アプリケーション」で「ジョブ」をクリックして、ジョブ・コンソールを開きます。
- 「Groovyイテレータ・パフォーマンス」をクリックして、ジョブの詳細を表示します。「実行ステータス」で、「完了」を展開し、Groovyスクリプトによって出力されるログ・メッセージを表示します。

最初のイテレータはすべてのセルとデータ値を出力し、2番目のイテレータは編集された2つのセルのみを出力し、3番目のイテレータは「最低給与」列と「最低賞与」列のセルのみを出力します。
- 「ジョブ詳細」を閉じます。
(ナビゲータ)をクリックし、「データ」を選択してEmployeeDriverFormに戻ります。
デフォルトのデータ値の設定
この項では、DataGridBuilderインタフェースを使用してグリッドにデフォルトのデータ値を設定する方法を学習します。
Groovyスクリプトの作成
- 「Calculation Manager」ウィンドウに戻ります。
- 「System View」タブを選択します。Plan1で、「Rules」を右クリックして、「New」を選択します。

- 「名前」に
Groovy Reset Grade Dataと入力し、「OK」をクリックします。
- ルール・エディタで、「デザイナ」オプションを「スクリプトの編集」に変更し、「スクリプト・タイプ」を「Groovyスクリプト」に設定します。

- このスクリプトをコピーし、エディタに貼り付けてください。
Cube cube = operation.application.getCube("Plan1")
String currentYear = operation.application.getSubstitutionVariableValue("OEP_CurYr")
DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY")
builder.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])
DataGridBuilder.Status status = new DataGridBuilder.Status()
builder.build(status).withCloseable { DataGrid grid ->
println("Total number of cells accepted: $status.numAcceptedCells")
println("Total number of cells rejected: $status.numRejectedCells")
println("First 100 rejected cells: $status.cellsRejected")
cube.saveGrid(grid)
}
Plan1キューブのキューブ・オブジェクトを作成し、アプリケーション・レベルの代替変数から現在の年を読み取ります。 getSubstitutionVariableValue("OEP_CurYr")は、アンパサンドなしでアプリケーション・レベルの代替変数を読み取ります。指定されたスナップショットでは、その値はFY26です。
キューブのDataGridBuilderを取得し、スクリプトが日付値を提供する形式を定義します。ノート:
DataGridBuilderでは、2番目のパラメータとしてExecuteAsUserを受け入れることで、システム・ユーザーにかわってデータを保存することもサポートされています。データをシステム・ユーザーとして保存すると、現在のユーザーのセキュリティを適用せずにデータを保存できます。ExecuteAsUserの有効な値は、CURRENT_USER(デフォルト)およびSYSTEM_USERです。次に例を示します。
DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)
POVメンバー、列メンバーおよびデータ値を含む行を追加して、データ・グリッドを構築します。 currentYearをaddPovに渡すと、リセット・ルールは年をハードコードせずにフォームに整列されます。
次のステップで作成したDataGridオブジェクトのステータス・オブジェクトを作成します。
withCloseableコンストラクトを使用してDataGridオブジェクトを作成します。ブロックが完了するとグリッドが閉じられるため、ルールはグリッドをメモリー内で開いたままにしません。
ビルダーによって受け入れられたか拒否されたセルの数をジョブ・コンソールに出力します。読取り専用セルは拒否されます。
データ・グリッドを保存します。
グリッドは自動的に閉じられます。 - ツールバーで、
(保存)をクリックしてスクリプトを保存します。「OK」をクリックして情報メッセージを閉じます。
(「Validate and Deploy」)をクリックします。「OK」をクリックして情報メッセージを閉じます。
- Calculation Managerを閉じて、Planningブラウザ・ウィンドウに戻ります。
データ・フォームへのルールの追加
- EmployeeDriverFormで、「アクション」をクリックし、「編集」を選択します。

- 「ビジネス・ルール」タブを選択します。
- 「Groovy Reset Grade Data」を「Selected Business Rules」に追加します。

- 「ビジネス・ルール・プロパティ」の「Groovyリセット等級データ」ルールで、「ロード前に実行」、「ロード後に実行」、「保存前に実行」および「保存後に実行」をクリアしたままにして、手動で起動できるようにします。

- 「Save」をクリックしてフォーム定義を保存し、「OK」をクリックして情報メッセージを閉じます。

- ページの下部で、「編集」EmployeeDriverFormタブを閉じてデータ・フォームに戻ります。
Groovyスクリプトのテスト
- 「アクション」をクリックし、「ルールとスマート・プッシュ」を選択します。

- 「ルール」で、「Groovy Reset Grade Data」を選択してルールを起動します。

- ルールが正常に完了したら、「OK」をクリックして情報メッセージを閉じます。

- グリッド・データが次の値にリセットされていることを確認します。

グレード 最低給与 最高給与 最小ボーナス 最大ボーナス グレード1 30000 50000 欠落 欠落 グレード2 40000 60000 欠落 5000 グレード3 70000 90000 欠落 10000
(ナビゲータ)をクリックし、「アプリケーション」で「ジョブ」をクリックして、ジョブ・コンソールを開きます。
- 「Groovy Reset Grade Data」をクリックして、ジョブ詳細を表示します。「実行ステータス」で、「完了」を展開して、受け入れられたセルと拒否されたセルの数を表示します。

関連リンク
- Planningチュートリアル— 関心領域リストから「Implementing Groovy」を選択して、追加のGroovyチュートリアルを確認します。
- GroovyルールのJava APIリファレンス—Groovyルールおよびテンプレートの開発に使用できるGroovy APIを確認します。
- Oracle Fusion Cloud EPMのREST API—Cloud EPMタスクの管理と自動化に使用できるREST APIをご紹介します。
その他の学習リソース
docs.oracle.com/learnの他のラボを調べるか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、利用可能なトレーニング・リソースについては、Oracle Universityをご覧ください。
製品ドキュメントについては、Oracle Help Centerを参照してください。