Introduction
Ce tutoriel vous explique comment implémenter des scripts Groovy pour utiliser des grilles de données et des itérateurs de grille. La logique conditionnelle permet de définir les couleurs d'arrière-plan dans une grille de données, d'implémenter une analyse comparative des performances et de définir les valeurs de données par défaut dans une grille. Renseignez les sections dans l'ordre.
Contexte
Une interface de grille de données permet d'accéder aux cellules d'en-tête de PDV/Ligne/Colonne et fournit divers itérateurs pour effectuer des itérations sur les cellules de données.
Prérequis
Les tutoriels pratiques Cloud EPM peuvent vous obliger à importer un cliché dans une instance Cloud EPM Enterprise Service. Un cliché ne peut pas être importé sur une application ou un processus métier existant. Avant d'importer le cliché, utilisez une instance Cloud EPM Enterprise Service distincte ou enlevez l'application ou le processus métier existant de l'instance que vous prévoyez d'utiliser. L'import de l'instantané ne remplace ni ne restaure automatiquement le contenu existant.
Avant de commencer ce tutoriel, vous devez :
- Demandez à l'administrateur de service d'accéder à une instance Cloud EPM Enterprise Service. Aucun processus métier ne doit être créé pour l'instance.
- Chargez et importez cet instantané dans votre instance. Ce cliché nécessite le processus métier Planning. Si vous avez déjà importé le cliché pour un autre tutoriel Groovy, vous pouvez continuer à utiliser cette application sans importer à nouveau le cliché.
Remarques :
Si vous rencontrez des erreurs de migration lors de l'importation du cliché, réexécutez la migration en excluant le composant HSS-Shared Services, ainsi que les artefacts de sécurité et de préférences utilisateur du composant de base. Pour plus d'informations sur le téléchargement et l'import de clichés, reportez-vous à la documentation Administration de la migration pour Oracle Enterprise Performance Management Cloud.Conseil :
Les scripts dont vous avez besoin pour ce tutoriel sont liés en tant que fichiers texte dans chaque section.Définition de la couleur d'arrière-plan à l'aide de la logique conditionnelle
Dans cette section, vous implémentez un script Groovy pour définir la couleur d'arrière-plan des cellules dont la valeur de données est #MISSING sur la couleur █ (0x00BFFF), des cellules dont la valeur de données est inférieure ou égale à 50000 sur la couleur █ (0xFF8C00) et des cellules dont la valeur de données est supérieure à 50000 sur la couleur █ (0x00FA9A).
Remarques :
Une fois que vous avez défini un script Groovy, il peut être associé à n'importe quel formulaire, contrairement aux règles de validation des données, qui doivent être définies dans le contexte de chaque formulaire.Création d'un script Groovy
- Sur 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 système, développez EPM Cloud, HP4, puis Plan1. Cliquez sur Règles avec le bouton droit de la souris, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Set Background Color, puis cliquez sur OK.
- Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur 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 en cours, operation.grid, renvoyée pardataCellIterator.La variable
itimplicite fait référence à l'élément en cours d'itération. Dans ce cas, la variableitfait référence à la cellule de données en cours renvoyée pardataCellIterator.Conseil :
Vous pouvez également utiliser une variable nommée explicitement, telle quecell, comme indiqué dans l'exemple ci-dessous :
operation.grid.dataCellIterator.each { cell -> if(cell.missing) { cell.bgColor = 0x00BFFF } }
Pour la cellule de données actuelle, le script recherche une valeur manquante.Remarques :
cell.datarenvoie 0 (zéro) pour les cellules qui sont #MISSING ou zéro. Pour rechercher #MISSING dans une cellule et non zéro, vous pouvez utiliser la propriétécell.missing. Pour rechercher une valeur nulle dans une cellule et non #MISSING, vous pouvez utiliser une condition telle quecell.data == 0 && !cell.missing.
Si Vrai, le script définit la couleur d'arrière-plan de la cellule sur 0x00BFFF( █ )
Le script vérifie que la valeur de données est inférieure ou égale à 50000.
Si Vrai, le script définit la couleur d'arrière-plan de la cellule sur 0xFF8C00( █ )
Si la valeur de données de la cellule dépasse 50000, le script définit la couleur d'arrière-plan de la cellule sur 0x00FA9A ( █ ) - Dans la barre d'outils, cliquez sur
(Enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'information.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'information.
- Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.
Ajouter la règle à un formulaire
- Sur la page d'accueil de Planning, cliquez sur Données. Cliquez sur EmployeeDriverForm pour ouvrir le formulaire.

- Cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles métier.
- Ajoutez la couleur d'arrière-plan de l'ensemble Groovy aux règles métier sélectionnées.

- Sous Propriétés de règle métier, sélectionnez Exécuter après le chargement.

- Cliquez sur Enregistrer afin d'enregistrer la définition de formulaire. Cliquez sur OK pour fermer le message d'information.

- En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir 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 allez apprendre à utiliser les itérateurs fournis par l'interface DataGrid, à profiler le code et à ajouter des instructions de débogage à la console de jobs.
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 sur Règles, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Iterator Performance, puis cliquez sur OK.
- Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur 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 utilitaire nommée benchmark()qui utilise l'élémentGridIteratorindiqué pour effectuer une itération sur ses cellules et affiche la liste des noms de membre de toutes les dimensions que la cellule représente avec ses données. Il imprime également le temps pris par l'itérateur.
Démarrez une horloge.
Effectuez une itération sur chaque cellule à l'aide de la valeur GridIteratorindiquée et affichez 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.datarenvoie la valeur numérique de la cellule et$it.formattedValuerenvoie des valeurs non numériques telles que Texte, Liste dynamique ou Date, telles qu'elles ont été saisies par l'utilisateur.
Affichez le temps nécessaire à l'itérateur sur la console de jobs.
Consignez un message de débogage dans la console de jobs.
Appelez la méthode benchmark()avec un itérateur pour parcourir chaque cellule de la grille de données en cours.
Appelez la méthode benchmark()avec un itérateur pour parcourir les cellules modifiées dans la grille de données en cours.Conseil :
Cet itérateur peut être utilisé avec n'importe quelle propriété de l'objet DataCell qui renvoie un booléen tel que verrouillé, manquant, valide, readOnly, validIntersection, etc.
Appelez la méthode benchmark()avec un itérateur pour parcourir les cellules de données Min Salary et Min Bonus de la grille de données actuelle. - Dans la barre d'outils, cliquez sur
(Enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'information.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'information.
- Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.
Ajouter la règle à un formulaire
- Dans le formulaire EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles métier, puis ajoutez Performances de l'itérateur Groovy aux règles métier sélectionnées.

- Sous Propriétés de règle métier, pour la règle de performances d'itérateur Groovy, sélectionnez Exécuter après l'enregistrement.

- Cliquez sur Enregistrer afin d'enregistrer la définition de formulaire. Cliquez sur OK pour fermer le message d'information.

- En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir au formulaire.
Test du script Groovy
- Dans EmployeeDriverForm, remplacez Salaire minimum pour le grade 1 par
35000et Prime minimum pour le grade 2 par2000.
- Cliquez sur Enregistrer. La règle de performances de l'itérateur Groovy s'exécute une fois les données enregistrées. Cliquez sur OK pour fermer le message d'information.

- Cliquez sur
(Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console de jobs.
- Cliquez sur Performances de l'itérateur Groovy pour afficher les détails du travail. Sous Statut d'exécution, développez Terminé pour afficher 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 second n'imprime que les deux cellules qui ont été modifiées et le troisième n'imprime que les cellules des colonnes Salaire min. et Bonus min.
- Fermez la page Détails du job.
- Cliquez sur
(Navigateur), puis sélectionnez Données pour revenir à EmployeeDriverForm.
Définir les valeurs de données par défaut
Dans cette section, vous allez apprendre à 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 sur Règles, puis sélectionnez Nouveau.

- Pour Nom, entrez
Groovy Reset Grade Data, puis cliquez sur OK.
- Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur 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 en cours à partir de la variable de substitution de niveau application. getSubstitutionVariableValue("OEP_CurYr")lit la variable de substitution de niveau 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.Remarques :
DataGridBuilder prend également en charge l'enregistrement de données pour le compte d'un utilisateur système en acceptantExecuteAsUsercomme deuxième paramètre. L'enregistrement de données en tant qu'utilisateur système permet d'enregistrer les données sans appliquer la sécurité de l'utilisateur actuel. 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)
Construire une grille de données en ajoutant les membres de PDV, les membres de colonne et les lignes avec des valeurs de données. Si vous transmettez currentYearàaddPov, la règle de réinitialisation reste alignée sur le formulaire sans codage en dur une année.
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 une fois le bloc terminé, de sorte que la règle ne laisse pas la grille ouverte en mémoire.
Affichez le nombre de cellules acceptées ou rejetées par le générateur sur la console de jobs. 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'information.
- Cliquez sur
(Valider et déployer). Cliquez sur OK pour fermer le message d'information.
- Fermez Calculation Manager et revenez à la fenêtre du navigateur Planning.
Ajouter la règle à un formulaire
- Dans EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.

- Sélectionnez l'onglet Règles métier.
- Ajoutez Groovy Reset Grade Data aux règles métier sélectionnées.

- Sous Propriétés de la règle métier, pour la règle Groovy Reset Grade Data, laissez Run Before Load, Run After Load, Run Before Save et Run After Save effacés afin de pouvoir le lancer manuellement.

- Cliquez sur Enregistrer pour enregistrer la définition de formulaire, puis sur OK pour fermer le message d'information.

- En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir au formulaire.
Test du script Groovy
- Cliquez sur Actions, puis sélectionnez Règles et transmission dynamique.

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

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

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

Niveau de qualité Salaire minimum Salaire maximum Bonus minimum Bonus maximum Niveau 1 30 000 50 000 Manquant Manquant Niv.2 40 000 60 000 Manquant 5 000 3e année 70 000 90 000 Manquant 10 000 - Cliquez sur
(Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console de jobs.
- Cliquez sur Réinitialiser les données de grade Groovy pour afficher les détails de l'emploi. Sous Statut d'exécution, développez Terminé pour afficher le nombre de cellules acceptées et rejetées.

Liens connexes
- Tutoriels de planification : sélectionnez Implémenter Groovy dans la liste des domaines d'intérêt pour explorer d'autres tutoriels Groovy.
- Référence d'API Java pour les règles Groovy : découvrez les API Groovy disponibles pour développer des règles et des modèles Groovy.
- API REST pour Oracle Fusion Cloud EPM — Découvrez les API REST disponibles pour la gestion et l'automatisation des tâches Cloud EPM.
Ressources de formation supplémentaires
Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à d'autres contenus d'apprentissage gratuits sur le canal Oracle Learning YouTube. En outre, visitez Oracle University pour consulter les ressources de formation disponibles.
Pour obtenir de la documentation sur le produit, consultez Oracle Help Center.
Utilisation des grilles de donnée et des itérateurs dans Groovy
G42661-02
Novembre 2026
Copyright © 2026, Oracle et/ou ses filiales.