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

  1. Dans 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 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.
    Vue du système avec le menu contextuel Règles et Nouveau sélectionné
  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ègle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.
    Éditeur de règle avec le script de modification et le script Groovy sélectionnés
  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 au code 1 Le script effectue une itération sur chaque cellule de données de la grille de données courante, operation.grid, retournée par dataCellIterator.

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

    Conseil :

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

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

    Note :

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

    Référence au code 3 Si VRAI, le script règle la couleur d'arrière-plan de la cellule à 0x00BFFF( █)

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

    Référence au code 5 Si VRAI, le script règle la couleur d'arrière-plan de la cellule à 0xFF8C00 ( █)

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

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

Ajout d'une règle à un formulaire

  1. Dans la page d'accueil de Planning, cliquez sur Données. Cliquez sur EmployeeDriverForm pour ouvrir le formulaire de données.
    EmployeeDriverForm ouvert avec ses données initiales
  2. Cliquez sur Actions, puis sélectionnez Modifier.
    Menu Actions avec modification sélectionnée
  3. Sélectionnez l'onglet Règles d'affaires.
  4. Ajoutez Couleur d'arrière-plan du jeu de gouverneur aux règles d'affaires sélectionnées.
    Onglet Règles d'affaires avec la règle Groovy dans les règles d'affaires sélectionnées
  5. Sous Propriétés de la règle d'affaires, sélectionnez Exécuter après le chargement.
    Propriétés de règle d'affaires avec Exécuter après le chargement sélectionnées
  6. Cliquez sur enregistrer pour enregistrer la définition du formulaire. Cliquez sur OK pour fermer le message d'informations.
    Message d'information confirmant que le formulaire a été enregistré
  7. Au bas de la page, fermez l'onglet Edit EmployeeDriverForm (Modifier) pour retourner 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.
    Forme rechargée avec des cellules manquantes bleues, des valeurs orange au niveau ou en dessous du seuil et des valeurs vertes au-dessus du seuil

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

  1. Revenez à la fenêtre Calculation Manager.
  2. Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit de la souris sur Règles, puis sélectionnez Nouveau.
    Vue système avec nouvelle sélection 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 rendement d'itérateur Groovy entrée
  4. Dans l'éditeur de règle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.
    Éditeur de règle avec le script de modification et le script Groovy sélectionnés
  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 au code 1 Définissez une méthode d'utilitaire nommée benchmark() qui utilise la valeur GridIterator spé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.

    Référence au code 2 Démarrez une minuterie.

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

    Référence au code 4 Imprimez le temps nécessaire à l'itérateur pour accéder à la console des tâches.

    Référence au code 5 Enregistrez un message de débogage dans la console des tâches.

    Référence au code 6 Appelez la méthode benchmark() avec un itérateur pour effectuer une itération sur chaque cellule de la grille de données courante.

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

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

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

Ajout d'une règle à un formulaire

  1. Dans le formulaire EmployeeDriverForm, cliquez sur Actions, puis sélectionnez Modifier.
    Menu Actions avec modification sélectionnée
  2. Sélectionnez l'onglet Règles d'affaires, puis ajoutez Rendement de l'itérateur Groovy aux règles d'affaires sélectionnées.
    Onglet Règles d'affaires avec rendement d'itérateur Groovy ajouté aux règles d'affaires sélectionnées
  3. 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.
    Performance de l'itérateur Groovy configurée pour s'exécuter après l'enregistrement
  4. Cliquez sur enregistrer pour enregistrer la définition du formulaire. Cliquez sur OK pour fermer le message d'informations.
    Message d'information confirmant que le formulaire a été enregistré
  5. Au bas de la page, fermez l'onglet Edit EmployeeDriverForm (Modifier) pour retourner au formulaire.

Test du script Groovy

  1. Dans EmployeeDriverForm, remplacez Min Salary (Salaire minimal) pour Grade 1 par 35000 et Min Bonus (Prime minimale) pour Grade 2 par 2000.
    EmployeeDriverForm avec deux cellules modifiées pour FY26
  2. 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.
    Message d'informations 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 des tâches.
    Console des tâches avec le travail Groovy Iterator Performance terminé
  4. 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.
    Détails de la tâche terminée affichant les messages du journal de l'itérateur

    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.

  5. Fermez les détails du travail.
  6. Cliquez sur Navigateur (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

  1. Revenez à la fenêtre Calculation Manager.
  2. Sélectionnez l'onglet Vue système. Sous Plan1, cliquez avec le bouton droit de la souris sur Règles, puis sélectionnez Nouveau.
    Vue système avec nouvelle sélection 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 d'échelon entrées
  4. Dans l'éditeur de règle, remplacez l'option Concepteur par Modifier le script et réglez le type de script à Script Groovy.
    Éditeur de règle avec le script de modification et le script Groovy sélectionnés
  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 au code 1 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 est FY26.

    Référence au code 2 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 acceptant ExecuteAsUser comme 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 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 au code 3 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 à addPov maintient la règle de réinitialisation alignée avec le formulaire sans codage en dur par an.

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

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

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

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

    Référence au 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'informations.
    Message d'information confirmant l'enregistrement de la réinitialisation des données de classe Groovy
  7. Cliquez sur Valider et déployer (Valider et déployer). Cliquez sur OK pour fermer le message d'informations.
    Message confirmant le déploiement réussi
  8. Fermez Calculation Manager et revenez à la fenêtre du navigateur Planning.

Ajout d'une règle à un formulaire

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

Test du script Groovy

  1. Cliquez sur Actions, puis sélectionnez Règles et poussée de données intelligente.
    Menu Actions avec règles et poussée de données intelligente sélectionnées
  2. Sous Règles, sélectionnez Réinitialiser les données d'échelon Groovy pour lancer la règle.
    Liste de règles avec Groovy Réinitialiser les données d'échelon sélectionnée
  3. Une fois la règle terminée, cliquez sur OK pour fermer le message d'informations.
    Message d'information confirmant que Groovy a réinitialisé les données d'échelon avec succès
  4. Vérifiez que les données de la grille ont été réinitialisées aux valeurs suivantes.
    FY26 EmployeeDriverForm avec les valeurs de salaire et de prime par défaut restaurées
    ÉchelonSalaire min.Salaire maximalPrime minimalePrime maximale
    Échelon 130 00050 000ValeursValeurs
    Échelon 240 00060 000Valeurs5 000
    Échelon 370 00090 000Valeurs10 000
  5. Cliquez sur Navigateur (Navigateur), puis, sous Application, cliquez sur Travaux pour ouvrir la console des tâches.
    Console des tâches avec la tâche Groovy Reset Grade Data terminée
  6. 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.
    Détails de la tâche Groovy Réinitialiser les données d'échelon terminés avec le nombre de cellules acceptées et rejetées

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.