Introduction

Ce tutoriel vous présente le langage de script Groovy et vous explique comment créer un script Groovy pour Planning dans le service Oracle EPM Enterprise Cloud.

Contexte

Groovy est un langage agile et dynamique pour la plate-forme Java qui combine une intégration Java fluide avec les avantages des performances Java. De nombreuses fonctionnalités de Groovy sont inspirées de langages tels que Python, Ruby et Smalltalk, les rendant disponibles pour les développeurs Java à l'aide d'une syntaxe de type Java. Groovy a été adopté par de nombreuses grandes et petites entreprises, dont Oracle, IBM et SAP, pour ses puissantes fonctionnalités de langage statique et dynamique, sa sécurité pour les environnements cloud et les langages spécifiques aux domaines.

Prérequis

Les tutoriels pratiques Cloud EPM peuvent vous obliger à importer un cliché dans votre instance Cloud EPM Enterprise Service. Pour pouvoir importer un instantané de tutoriel, vous devez demander une autre instance Cloud EPM Enterprise Service ou supprimer l'application et le processus métier en cours. L'instantané du tutoriel ne sera pas importé sur votre application ou processus métier existant, ni remplacé ou restauré automatiquement l'application ou le processus métier que vous utilisez actuellement.

Avant de commencer ce tutoriel, vous devez :

  • Demandez à l'administrateur de service d'accéder à une instance Cloud EPM Enterprise Service.
  • Chargez et importez cet instantané dans votre instance Planning.

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.

Pourquoi Groovy ?

Comprendre les limites des scripts de calcul

Planning utilise des règles métier basées sur des scripts de calcul pour effectuer des calculs et des actions. Bien que ces scripts soient puissants, ils présentent certaines limites :

  • Ils ne peuvent pas générer dynamiquement des scripts à l'exécution en fonction de contextes autres que les invites d'exécution saisies par l'utilisateur. Par exemple, si vous modifiez quelques cellules dans un formulaire, une règle métier de script de calcul n'a aucun moyen d'identifier les données qui ont été modifiées, puis de calculer en fonction de ces données uniquement.
  • Ils ne peuvent pas indiquer dynamiquement le parent d'un membre en cours (par exemple, par type de projet ou région).
  • Vous ne pouvez pas valider les valeurs d'invite d'exécution ou de données saisies par l'utilisateur avant l'exécution du calcul.
  • Vous ne pouvez pas combiner plusieurs fonctions EPM en une seule règle ou un seul ensemble de règles (par exemple, exécuter automatiquement une opération de transmission dynamique après le calcul).
  • Ils peuvent rencontrer des problèmes de performances en raison de leur nature statique (par exemple, demander le calcul d'une grande partie de la base de données même si seulement quelques cellules ont été mises à jour).
  • Bien que des calculs spécifiques au contexte soient disponibles dans les formulaires en cliquant avec le bouton droit de la souris et en calculant uniquement une ligne spécifique, cette option est moins utile pour les formulaires volumineux ou lorsque vous mettez à jour des cellules dans plusieurs lignes.
  • Pour les applications ASO, elles ne fournissent que des calculs simples.

Avantages des règles de script Groovy

Avec la prise en charge des règles Groovy dans Oracle EPM Enterprise Cloud, vous pouvez résoudre tous ces problèmes. Les règles Groovy vous permettent de :

  • Générer dynamiquement des scripts de calcul à l'exécution en fonction des contextes définis dans le script Groovy
  • Ajouter des contrôles de validation pour les valeurs d'invite d'exécution avant d'exécuter des calculs, ajouter des contrôles de validation des données avant de soumettre des données et ajouter la gestion des erreurs
  • Lancer plusieurs fonctions EPM avec une seule règle (par exemple, exécuter un calcul, puis exécuter une opération de transmission dynamique pour déplacer les données calculées vers un cube de reporting)
  • Améliorer les performances en créant des calculs ciblés (par exemple, créer dynamiquement des scripts de calcul ciblés personnalisés en fonction des données modifiées dans le formulaire en cours)
  • Effectuer des calculs procéduraux complexes en mémoire avant de soumettre les résultats à la base de données

Groovy dans Oracle EPM Enterprise Cloud

Types de règle Groovy

Oracle prend en charge deux types de règle Groovy :

  1. Règles qui peuvent générer de manière dynamique des scripts de calcul lors de l'exécution selon le contexte, hors invites d'exécution, et renvoyer le script de calcul qui est ensuite exécuté sur Oracle Essbase.

    Par exemple, vous pouvez créer une règle afin de calculer les dépenses de projets uniquement pour la durée (dates d'entrée et d'entrée) du projet.

    Un autre exemple est le calcul basé sur les tendances qui restreint le calcul aux comptes disponibles dans le formulaire. Vous pouvez utiliser ce calcul pour divers formulaires dans Produits, Charges, Bilan et Flux de trésorerie. Le calcul est ainsi optimisé et peut être réutilisé.

  2. Règles Groovy pures qui peuvent, par exemple, valider des données et annuler l'opération si les données saisies vont à l'encontre des stratégies de l'entreprise.

Remarques :

Tout script Groovy qui renvoie une chaîne renvoie un script de calcul Essbase qui sera exécuté sur le cube Essbase indiqué. Evitez d'utiliser des chaînes comme valeur finale de la dernière instruction, à moins qu'il ne s'agisse d'un script de calculs que vous voulez exécuter après le lancement du script Groovy.

Vous créez des règles Groovy dans Calculation Manager et vous pouvez les exécuter à partir de n'importe quel emplacement de l'application où une règle métier peut être exécutée.

Utiliser les API de génération de scripts Groovy EPM

  • Les API de script Groovy EPM permettent aux scripts Groovy d'effectuer diverses opérations sur le modèle objet EPM. La plupart des objets, tels que l'application en cours, le cube et la grille, peuvent être extraits de la variable d'opération. Dans la plupart des cas, le point d'entrée vers l'API est une méthode sur la classe de base EpmScript ou l'objet Operation.
  • Le script de base et l'opération en cours comportent un ensemble de variables qui s'appliquent au script. Par exemple, si le script référence une variable telle que operation.grid et que la grille n'existe pas dans l'opération, lorsque le script est exécuté, le système arrête le script et consigne une erreur dans la console de jobs. Si le script comporte un traitement facultatif, tel que le formatage de la grille, s'il existe, il peut d'abord vérifier l'existence de la grille en appelant operation.hasGrid(). Des modèles similaires sont disponibles pour d'autres objets du modèle.
  • Conseil :

    Pour connaître la spécification d'API de la plate-forme de génération de scripts Groovy EPM, reportez-vous au manuel Oracle Enterprise Performance Management Cloud, Groovy Rules Java API Reference

Créer des règles de gestion Groovy

Oracle prend en charge deux types de règle Groovy :

  1. Dans une application Planning d'EPM Enterprise Cloud, ouvrez le navigateur et, sous Créer et gérer, cliquez sur Règles pour afficher Calculation Manager.
  2. Règles du navigateur
  3. Dans Calculation Manager, sélectionnez Actions, puis Nouvel objet. Dans la boîte de dialogue, sélectionnez un type d'application, une application et un cube. Pour le type d'objet, sélectionnez Règle. Saisissez le Nom de la règle, puis cliquez sur OK.
  4. Boîte de dialogue Nouvel objet
  5. Un message indiquant que la règle est créée et ouverte pour modification s'affiche. Cliquez sur OK pour continuer.
  6. Dans la liste déroulante Concepteur, sélectionnez Modifier le script.
  7. Modifier un script
  8. Dans la liste déroulante Type de script, sélectionnez Script Groovy.
  9. Script Groovy
  10. Cliquez sur Icône Enregistrer(Save). La règle est désormais une règle métier basée sur un script Groovy et vous pouvez utiliser l'éditeur pour développer votre script en fonction de votre cas d'emploi. L'exemple suivant illustre un script Groovy simple dans l'éditeur qui modifiera la couleur d'arrière-plan des cellules d'une grille de données, en fonction de seuils numériques. Vous pouvez également ouvrir le script pour le visualiser dans un onglet distinct.
  11. Exemple de script

Ressources de formation supplémentaires

Explorez d'autres ateliers sur le site 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.