Présentation
Ce tutoriel explique comment mettre en oeuvre des scripts Groovy pour utiliser des grilles de données et des itérateurs de grille de données. Vous utilisez une logique conditionnelle pour définir les couleurs d'arrière-plan dans une grille de données, mettre en oeuvre l'analyse comparative des performances et définir les valeurs de données par défaut dans une grille. Remplissez les sections dans l'ordre.
Contexte
Une interface de grille de données permet d'accéder aux cellules d'en-tête POV/Row/Column et fournit divers itérateurs pour effectuer une itération sur les cellules de données.
Préalables
Les tutoriels pratiques Cloud EPM peuvent nécessiter l'importation d'un instantané dans une instance Cloud EPM Enterprise Service. Un instantané ne peut pas être importé sur une application ou un processus d'affaires existant. Avant d'importer l'instantané, utilisez une instance distincte du service Cloud EPM Enterprise ou supprimez l'application ou le processus d'affaires existant de l'instance que vous prévoyez d'utiliser. L'importation de l'instantané ne remplace pas ou ne restaure pas automatiquement le contenu existant.
Avant de commencer ce tutoriel, vous devez :
- Permet à l'administrateur de service d'accéder à une instance Cloud EPM Enterprise Service. Aucun processus d'affaires ne doit être créé pour l'instance.
- Chargez et importez cet instantané dans votre instance. Cet instantané requiert le processus de gestion Planning. Si vous avez déjà importé l'instantané pour un autre tutoriel Groovy, vous pouvez continuer à utiliser cette application sans importer à nouveau l'instantané.
Note :
Si vous rencontrez des erreurs de migration lors de l'importation de l'instantané, réexécutez la migration à l'exclusion du composant HSS-Shared Services, ainsi que des artefacts Security et User Preferences du composant Core. Pour plus d'informations sur le chargement et l'importation d'instantanés, consultez la documentation sur l'administration de la migration pour Oracle Enterprise Performance Management Cloud.Conseil :
Les scripts dont vous avez besoin pour ce tutoriel sont liés sous forme de fichiers texte dans chaque section.Définir la couleur d'arrière-plan à l'aide d'une logique conditionnelle
Dans cette section, vous mettez en oeuvre un script Groovy pour régler la couleur d'arrière-plan des cellules dont la valeur de données est #MISSING à la couleur █ (0x00BFFF), des cellules dont la valeur de données est inférieure ou égale à 50000 à la couleur █ (0xFF8C00) et des cellules dont la valeur de données est supérieure à 50000 à la couleur █ (0x00FA9A).
Note :
Après avoir défini un script Groovy, il peut être associé à n'importe quel formulaire, contrairement aux règles de validation de données, qui doivent être définies dans le contexte de chaque formulaire.Création d'un script Groovy
- Dans la page d'accueil de Planning, cliquez sur
(Navigateur), puis, sous Créer et gérer, cliquez sur Règles pour ouvrir Calculation Manager.
- Dans l'onglet Vue du système, développez EPM Cloud, HP4, puis Plan1. Cliquez avec le bouton droit de la souris sur Règles, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Set Background Color, puis cliquez sur OK.
- Dans l'éditeur de règle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.

- Copiez ce script et collez-le dans l'éditeur.
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
}
Le script effectue une itération sur chaque cellule de données de la grille de données courante, operation.grid, retournée pardataCellIterator.La variable
itimplicite fait référence à l'élément courant en cours d'itération. Dans ce cas, la variableitfait référence à la cellule de données courante retournée pardataCellIterator.Conseil :
Vous pouvez également utiliser une variable nommée explicitement, telle quecell, comme illustré dans l'exemple ci-dessous :
operation.grid.dataCellIterator.each { cell -> if(cell.missing) { cell.bgColor = 0x00BFFF } }
Pour la cellule de données courante, le script recherche une valeur manquante.Note :
Notez quecell.dataretourne 0 (zéro) pour les cellules qui sont #MISSING ou zéro. Pour vérifier qu'une cellule contient #MISSING et non zéro, vous pouvez utiliser la propriétécell.missing. Pour vérifier la valeur zéro d'une cellule et non #MISSING, vous pouvez utiliser une condition telle quecell.data == 0 && !cell.missing.
Si VRAI, le script règle la couleur d'arrière-plan de la cellule à 0x00BFFF( █)
Le script vérifie que la valeur des données est inférieure ou égale à 50000.
Si VRAI, le script règle la couleur d'arrière-plan de la cellule à 0xFF8C00( █)
Si la valeur de données de la cellule est supérieure à 50000, le script règle la couleur d'arrière-plan de la cellule à 0x00FA9A ( █ ) - Dans la barre d'outils, cliquez sur
(enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'informations.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'informations.
- Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.
Ajout d'une règle à un formulaire
- Dans la page d'accueil de Planning, cliquez sur Données. Cliquez sur EmployeeDriverForm pour ouvrir le formulaire de données.

- Cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles d'affaires.
- Ajoutez Couleur d'arrière-plan du jeu de gouverneur aux règles d'affaires sélectionnées.

- Sous Propriétés de la règle d'affaires, sélectionnez Exécuter après le chargement.

- Cliquez sur enregistrer pour enregistrer la définition du formulaire. Cliquez sur OK pour fermer le message d'informations.

- Au bas de la page, fermez l'onglet Edit EmployeeDriverForm (Modifier) pour retourner au formulaire.
- Lorsque le formulaire est rechargé, vérifiez que les cellules manquantes sont bleues, que les valeurs inférieures ou égales à
50000sont orange et que les valeurs supérieures à50000sont vertes.
Profilage et débogage du script
Dans cette section, vous apprendrez à utiliser les itérateurs fournis par l'interface DataGrid, à profiler le code et à ajouter des énoncés de débogage à la console des tâches.
Création d'un script Groovy
- Revenez à la fenêtre Calculation Manager.
- Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit de la souris sur Règles, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Iterator Performance, puis cliquez sur OK.
- Dans l'éditeur de règle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.

- Copiez ce script et collez-le dans l'éditeur.
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')
Définissez une méthode d'utilitaire nommée benchmark()qui utilise la valeurGridIteratorspécifiée pour effectuer une itération sur ses cellules et qui imprime la liste des noms de membre de toutes les dimensions représentées par la cellule avec ses données. Il imprime également le temps pris par l'itérateur.
Démarrez une minuterie.
Effectuez une itération sur chaque cellule à l'aide de la valeur GridIteratorspécifiée et imprimez la liste des noms de membre de toutes les dimensions que la cellule représente, ainsi que sa valeur de données et sa valeur formatée.$it.dataretourne la valeur numérique de la cellule et$it.formattedValueretourne des valeurs non numériques telles que Texte, Liste dynamique ou Date telles qu'entrées par l'utilisateur.
Imprimez le temps nécessaire à l'itérateur pour accéder à la console des tâches.
Enregistrez un message de débogage dans la console des tâches.
Appelez la méthode benchmark()avec un itérateur pour effectuer une itération sur chaque cellule de la grille de données courante.
Appelez la méthode benchmark()à l'aide d'un itérateur pour effectuer une itération sur les cellules modifiées dans la grille de données courante.Conseil :
Cet itérateur peut être utilisé avec n'importe quelle propriété de l'objet DataCell qui retourne une valeur booléenne telle que verrouillée, manquante, valide, readOnly, validIntersection, etc.
Appelez la méthode benchmark()à l'aide d'un itérateur pour effectuer une itération sur les cellules de données Salaire minimal et Prime minimale dans la grille de données courante. - Dans la barre d'outils, cliquez sur
(enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'informations.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'informations.
- Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.
Ajout d'une règle à un formulaire
- Dans le formulaire EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles d'affaires, puis ajoutez Rendement de l'itérateur Groovy aux règles d'affaires sélectionnées.

- Sous Propriétés de règle d'affaires, pour la règle de performance Groovy Iterator, sélectionnez Exécuter après l'enregistrement.

- Cliquez sur enregistrer pour enregistrer la définition du formulaire. Cliquez sur OK pour fermer le message d'informations.

- Au bas de la page, fermez l'onglet Edit EmployeeDriverForm (Modifier) pour retourner au formulaire.
Test du script Groovy
- Dans EmployeeDriverForm, remplacez Min Salary (Salaire minimal) pour Grade 1 par
35000et Min Bonus (Prime minimale) pour Grade 2 par2000.
- Cliquez sur Enregistrer. La règle de performance Groovy Iterator s'exécute après l'enregistrement des données. Cliquez sur OK pour fermer le message d'informations.

- Cliquez sur
(Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console des tâches.
- Cliquez sur Performance de l'itérateur Groovy pour afficher les détails de la tâche. Sous Run Status (Statut d'exécution), développez Completed (Terminé) pour voir les messages de journal imprimés par le script Groovy.

Le premier itérateur imprime toutes les cellules et les valeurs de données, le deuxième itérateur n'imprime que les deux cellules qui ont été modifiées, et le troisième itérateur n'imprime que les cellules des colonnes Salaire min. et Prime min.
- Fermez les détails du travail.
- Cliquez sur
(Navigateur), puis sélectionnez Données pour retourner à EmployeeDriverForm.
Définition des valeurs de données par défaut
Dans cette section, vous apprendrez à définir les valeurs de données par défaut dans la grille à l'aide de l'interface DataGridBuilder.
Création d'un script Groovy
- Revenez à la fenêtre Calculation Manager.
- Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit de la souris sur Règles, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Reset Grade Data, puis cliquez sur OK.
- Dans l'éditeur de règle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.

- Copiez ce script et collez-le dans l'éditeur.
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)
}
Créez un objet de cube pour le cube Plan1 et lisez l'année courante à partir de la variable de substitution au niveau de l'application. getSubstitutionVariableValue("OEP_CurYr")lit la variable de substitution au niveau de l'application sans esperluette. Dans l'instantané fourni, sa valeur estFY26.
Obtenez une valeur DataGridBuilder pour le cube; définissez le format dans lequel le script fournit les valeurs de date.Note :
DataGridBuilder prend également en charge l'enregistrement des données au nom d'un utilisateur du système en acceptantExecuteAsUsercomme deuxième paramètre. L'enregistrement des données en tant qu'utilisateur système permet d'enregistrer les données sans appliquer la sécurité de l'utilisateur courant. Les valeurs valides pourExecuteAsUsersontCURRENT_USER(valeur par défaut) etSYSTEM_USER, comme dans l'exemple suivant :
DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)
Construisez une grille de données en ajoutant les membres PDV, les membres de colonne et les lignes avec des valeurs de données. La transmission de currentYearàaddPovmaintient la règle de réinitialisation alignée avec le formulaire sans codage en dur par an.
Créez un objet de statut pour l'objet DataGrid créé à l'étape suivante.
Créez l'objet DataGrid avec la construction withCloseable. Il ferme la grille lorsque le bloc est terminé, de sorte que la règle ne laisse pas la grille ouverte en mémoire.
Imprimer le nombre de cellules acceptées ou rejetées par le générateur sur la console des tâches. Toutes les cellules en lecture seule sont rejetées.
Enregistrez la grille de données.
La grille est automatiquement fermée. - Dans la barre d'outils, cliquez sur
(enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'informations.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'informations.
- Fermez Calculation Manager et revenez à la fenêtre du navigateur Planning.
Ajout d'une règle à un formulaire
- Dans EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles d'affaires.
- Ajoutez Groovy Reset Grade Data (Réinitialiser les données d'échelon Groovy) aux règles d'affaires sélectionnées.

- Sous Propriétés de règle d'affaires, pour la règle Groovy Réinitialiser les données d'échelon, laissez les champs Exécuter avant le chargement, Exécuter après le chargement, Exécuter avant l'enregistrement et Exécuter après l'enregistrement désélectionnés afin que vous puissiez les lancer manuellement.

- Cliquez sur Enregistrer pour enregistrer la définition du formulaire, puis cliquez sur OK pour fermer le message d'informations.

- Au bas de la page, fermez l'onglet Edit EmployeeDriverForm (Modifier) pour retourner au formulaire.
Test du script Groovy
- Cliquez sur Actions, puis sélectionnez Règles et poussée de données intelligente.

- Sous Règles, sélectionnez Réinitialiser les données d'échelon Groovy pour lancer la règle.

- Une fois la règle terminée, cliquez sur OK pour fermer le message d'informations.

- Vérifiez que les données de la grille ont été réinitialisées aux valeurs suivantes.

Échelon Salaire min. Salaire maximal Prime minimale Prime maximale Échelon 1 30 000 50 000 Valeurs Valeurs Échelon 2 40 000 60 000 Valeurs 5 000 Échelon 3 70 000 90 000 Valeurs 10 000 - Cliquez sur
(Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console des tâches.
- Cliquez sur Groovy Reset Grade Data (Réinitialiser les données d'échelon de l'entreprise) pour afficher les détails de l'emploi. Sous Run Status (Statut d'exécution), développez Completed (Terminé) pour voir le nombre de cellules acceptées et rejetées.

Liens connexes
- Tutoriels sur la planification — Sélectionnez Mise en oeuvre de Groovy dans la liste des domaines d'intérêt pour explorer d'autres tutoriels Groovy.
- Informations de référence sur les API Java pour les règles Groovy — Explorez les API Groovy disponibles pour développer des règles et des modèles Groovy.
- API REST pour Oracle Fusion Cloud EPM — Explorez les API REST disponibles pour gérer et automatiser les tâches Cloud EPM.
Autres ressources d'apprentissage
Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez Oracle University pour voir les ressources de formation disponibles.
Pour obtenir la documentation sur le produit, visitez Oracle Help Center.
Utilisation de grilles de données et d'itérateurs dans Groovy
G42660-02
Novembre 2026
Copyright © 2026, Oracle et/ou ses sociétés affiliées.