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

  1. Sur la page d'accueil de Planning, cliquez sur Navigateur (Navigateur), puis, sous Créer et gérer, cliquez sur Règles pour ouvrir Calculation Manager.
    Navigateur avec règles sous Créer et gérer
  2. 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.
    Vue système avec le menu contextuel Règles et Nouvelle sélection
  3. Pour Nom, entrez Groovy Set Background Color, puis cliquez sur OK.
    Boîte de dialogue Nouvelle règle avec le nom de règle, l'application et le cube
  4. Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur Script Groovy.
    Editeur de règles avec l'option Modifier le script et Groovy Script sélectionnée
  5. Copiez ce script et collez-le dans l'éditeur.
    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
    }
    

    Référence du code 1 Le script effectue une itération sur chaque cellule de données de la grille de données en cours, operation.grid, renvoyée par dataCellIterator.

    La variable it implicite fait référence à l'élément en cours d'itération. Dans ce cas, la variable it fait référence à la cellule de données en cours renvoyée par dataCellIterator.

    Conseil :

    Vous pouvez également utiliser une variable nommée explicitement, telle que cell, comme indiqué dans l'exemple ci-dessous :
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    Référence du code 2 Pour la cellule de données actuelle, le script recherche une valeur manquante.

    Remarques :

    cell.data renvoie 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 que cell.data == 0 && !cell.missing.

    Référence du code 3 Si Vrai, le script définit la couleur d'arrière-plan de la cellule sur 0x00BFFF( █ )

    Référence du code 4 Le script vérifie que la valeur de données est inférieure ou égale à 50000.

    Référence du code 5 Si Vrai, le script définit la couleur d'arrière-plan de la cellule sur 0xFF8C00 ( █ )

    Référence du code 6 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 ( █ )

  6. Dans la barre d'outils, cliquez sur Enregistrer (Enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que la règle est enregistrée
  7. Cliquez sur Valider et déployer (Valider et déployer). Cliquez sur OK pour fermer le message d'information.
    Message de déploiement confirmant la réussite du déploiement
  8. Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.

Ajouter la règle à un formulaire

  1. Sur la page d'accueil de Planning, cliquez sur Données. Cliquez sur EmployeeDriverForm pour ouvrir le formulaire.
    EmployeeDriverForm ouvert avec ses données initiales
  2. Cliquez sur Actions, puis sélectionnez Modifier.
    Menu Actions avec l'option Modifier sélectionnée
  3. Sélectionnez l'onglet Règles métier.
  4. Ajoutez la couleur d'arrière-plan de l'ensemble Groovy aux règles métier sélectionnées.
    Onglet Business Rules avec la règle Groovy dans les règles métier sélectionnées
  5. Sous Propriétés de règle métier, sélectionnez Exécuter après le chargement.
    Propriétés de la règle métier avec l'option Exécuter après le chargement sélectionnée
  6. Cliquez sur Enregistrer afin d'enregistrer la définition de formulaire. Cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que le formulaire a été enregistré
  7. En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir au formulaire.
  8. Lorsque le formulaire est rechargé, vérifiez que les cellules manquantes sont bleues, que les valeurs inférieures ou égales à 50000 sont orange et que les valeurs supérieures à 50000 sont vertes.
    Formulaire rechargé avec des cellules manquantes bleues, des valeurs orange au seuil ou en dessous et des valeurs vertes au-dessus du seuil

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

  1. Revenez à la fenêtre Calculation Manager.
  2. Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit sur Règles, puis sélectionnez Nouveau.
    Vue système avec New sélectionné dans le menu contextuel Règles
  3. Pour Nom, entrez Groovy Iterator Performance, puis cliquez sur OK.
    Boîte de dialogue Nouvelle règle avec les performances de l'itérateur Groovy saisies
  4. Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur Script Groovy.
    Editeur de règles avec l'option Modifier le script et Groovy Script sélectionnée
  5. Copiez ce script et collez-le dans l'éditeur.
    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')
    

    Référence du code 1 Définissez une méthode utilitaire nommée benchmark() qui utilise l'élément GridIterator indiqué 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.

    Référence du code 2 Démarrez une horloge.

    Référence du code 3 Effectuez une itération sur chaque cellule à l'aide de la valeur GridIterator indiqué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.data renvoie la valeur numérique de la cellule et $it.formattedValue renvoie des valeurs non numériques telles que Texte, Liste dynamique ou Date, telles qu'elles ont été saisies par l'utilisateur.

    Référence du code 4 Affichez le temps nécessaire à l'itérateur sur la console de jobs.

    Référence du code 5 Consignez un message de débogage dans la console de jobs.

    Référence du code 6 Appelez la méthode benchmark() avec un itérateur pour parcourir chaque cellule de la grille de données en cours.

    Référence du code 7 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.

    Référence du code 8 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.

  6. Dans la barre d'outils, cliquez sur Enregistrer (Enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que Groovy Iterator Performance est enregistré
  7. Cliquez sur Valider et déployer (Valider et déployer). Cliquez sur OK pour fermer le message d'information.
    Message confirmant le déploiement réussi
  8. Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.

Ajouter la règle à un formulaire

  1. Dans le formulaire EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.
    Menu Actions avec l'option Modifier sélectionnée
  2. Sélectionnez l'onglet Règles métier, puis ajoutez Performances de l'itérateur Groovy aux règles métier sélectionnées.
    Onglet Business Rules avec Groovy Iterator Performance ajouté aux règles métier sélectionnées
  3. 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.
    Performances de l'itérateur Groovy configurées pour s'exécuter après enregistrement
  4. Cliquez sur Enregistrer afin d'enregistrer la définition de formulaire. Cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que le formulaire a été enregistré
  5. En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir au formulaire.

Test du script Groovy

  1. Dans EmployeeDriverForm, remplacez Salaire minimum pour le grade 1 par 35000 et Prime minimum pour le grade 2 par 2000.
    EmployeeDriverForm avec deux cellules modifiées pour FY26
  2. 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.
    Message d'information confirmant que les données ont été enregistrées et que les règles ont été exécutées
  3. Cliquez sur Navigateur (Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console de jobs.
    Console de jobs avec le travail Groovy Iterator Performance terminé
  4. 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.
    Détails du travail terminé affichant les messages du journal d'itérateur

    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.

  5. Fermez la page Détails du job.
  6. Cliquez sur Navigateur (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

  1. Revenez à la fenêtre Calculation Manager.
  2. Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit sur Règles, puis sélectionnez Nouveau.
    Vue système avec New sélectionné dans le menu contextuel Règles
  3. Pour Nom, entrez Groovy Reset Grade Data, puis cliquez sur OK.
    Boîte de dialogue Nouvelle règle avec Groovy Réinitialiser les données de grade saisies
  4. Dans l'éditeur de règles, remplacez l'option Concepteur par Modifier le script et définissez le type de script sur Script Groovy.
    Editeur de règles avec l'option Modifier le script et Groovy Script sélectionnée
  5. Copiez ce script et collez-le dans l'éditeur.
    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}
    

    Référence du code 1 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 est FY26.

    Référence du code 2 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 acceptant ExecuteAsUser comme 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 pour ExecuteAsUser sont CURRENT_USER (valeur par défaut) et SYSTEM_USER, comme dans l'exemple suivant :

    DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)

    Référence du code 3 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.

    Référence du code 4 Créez un objet de statut pour l'objet DataGrid créé à l'étape suivante.

    Référence du code 5 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.

    Référence du code 6 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.

    Référence du code 7 Enregistrez la grille de données.

    Référence du code 8 La grille est automatiquement fermée.

  6. Dans la barre d'outils, cliquez sur Enregistrer (Enregistrer) pour enregistrer le script. Cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que les données de grade de réinitialisation Groovy sont enregistrées
  7. Cliquez sur Valider et déployer (Valider et déployer). Cliquez sur OK pour fermer le message d'information.
    Message confirmant le déploiement réussi
  8. Fermez Calculation Manager et revenez à la fenêtre du navigateur Planning.

Ajouter la règle à un formulaire

  1. Dans EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.
    Menu Actions avec l'option Modifier sélectionnée
  2. Sélectionnez l'onglet Règles métier.
  3. Ajoutez Groovy Reset Grade Data aux règles métier sélectionnées.
    Onglet Règles métier avec Groovy Réinitialiser les données de grade dans les règles métier sélectionnées
  4. 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.
    Groovy Réinitialiser les données de grade avec toutes les options de chargement et d'enregistrement automatiques effacées
  5. Cliquez sur Enregistrer pour enregistrer la définition de formulaire, puis sur OK pour fermer le message d'information.
    Message d'information confirmant que le formulaire a été enregistré
  6. En bas de la page, fermez l'onglet Modifier EmployeeDriverForm pour revenir au formulaire.

Test du script Groovy

  1. Cliquez sur Actions, puis sélectionnez Règles et transmission dynamique.
    Menu Actions avec sélection des règles et de la transmission dynamique
  2. Sous Règles, sélectionnez Réinitialiser les données de grade Groovy pour lancer la règle.
    Liste de règles avec Groovy Réinitialiser les données de grade sélectionnée
  3. Une fois la règle terminée, cliquez sur OK pour fermer le message d'information.
    Message d'information confirmant que la réinitialisation des données de grade Groovy a réussi
  4. Vérifiez que les données de grille ont été réinitialisées aux valeurs suivantes.
    FY26 EmployeeDriverForm avec les valeurs de salaire et de prime par défaut restaurées
    Niveau de qualitéSalaire minimumSalaire maximumBonus minimumBonus maximum
    Niveau 130 00050 000ManquantManquant
    Niv.240 00060 000Manquant5 000
    3e année70 00090 000Manquant10 000
  5. Cliquez sur Navigateur (Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console de jobs.
    Console des jobs avec le job Groovy Reset Grade Data terminé
  6. 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.
    Détails du travail Groovy Reset Grade Data terminés avec nombre de cellules acceptées et rejetées

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.