Présentation
Ce tutoriel présente le langage de script Groovy et 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 et les avantages des performances Java. De nombreuses fonctionnalités de Groovy s'inspirent de langages tels que Python, Ruby et Smalltalk, qui les mettent à la disposition des développeurs Java à l'aide d'une syntaxe de type Java. Groovy a été adopté par de nombreuses grandes et petites entreprises, y compris Oracle, IBM et SAP, pour ses puissantes fonctionnalités de langage statique et dynamique, de sécurité pour les environnements en nuage et de langages propres à un domaine.
Préalables
Les tutoriels pratiques Cloud EPM peuvent nécessiter l'importation d'un instantané dans votre instance Cloud EPM Enterprise Service. Avant d'importer un instantané de tutoriel, vous devez demander une autre instance du service Cloud EPM Enterprise ou supprimer l'application et le processus d'affaires courants. L'instantané du tutoriel ne sera pas importé sur votre application ou processus d'affaires existant, et il ne remplacera pas ou ne restaurera pas automatiquement l'application ou le processus d'affaires avec lequel vous travaillez actuellement.
Avant de commencer ce tutoriel, vous devez :
- Permet à l'administrateur de service d'accéder à une instance Cloud EPM Enterprise Service.
- Chargez et importez cet instantané dans votre instance Planning.
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.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 au moment de l'exécution en fonction de contextes autres que les invites d'exécution entrées 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 uniquement à partir de ces données.
- Ils ne peuvent pas spécifier dynamiquement le parent d'un membre courant (par exemple, par type de projet ou région).
- Vous ne pouvez pas valider les données entrées par l'utilisateur ni les valeurs d'invite d'exécution avant l'exécution du calcul.
- Vous ne pouvez pas combiner plusieurs fonctions du système MRE en une seule règle ou en un seul jeu de règles (par exemple, exécuter automatiquement une opération de poussée de données intelligente après le calcul).
- Ils peuvent rencontrer des problèmes de performances en raison de leur nature statique (par exemple, nécessitant un calcul d'une grande partie de la base de données, même lorsque seules quelques cellules ont été mises à jour).
- Bien que des calculs limités propres 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
Grâce à 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 au moment de l'exécution en fonction des contextes définis dans le script Groovy
- Ajouter des vérifications de validation pour les valeurs d'invite d'exécution avant l'exécution des calculs, ajouter des vérifications de validation des données avant la soumission des données et ajouter le traitement des erreurs
- Lancer plusieurs fonctions EPM avec une seule règle (par exemple, exécuter un calcul, puis exécuter une opération de poussée de données intelligente pour déplacer les données calculées vers un cube de production de rapports)
- Améliorez la performance en créant des calculs ciblés (par exemple, en créant dynamiquement des scripts de calcul ciblés personnalisés en fonction des données modifiées dans le formulaire courant)
- 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ègles Groovy
Oracle prend en charge deux types de règle Groovy :
-
Règles qui peuvent générer dynamiquement des scripts de calcul au moment de l'exécution en fonction d'un contexte autre que les invites d'exécution et retourner le script de calcul qui est ensuite exécuté sur Oracle Essbase.
Par exemple, vous pouvez créer une règle pour calculer les frais des projets uniquement pour la durée (dates de début et de fin) du projet.
Un autre exemple est un calcul basé sur une tendance qui limite le calcul aux comptes disponibles dans le formulaire. Vous pouvez utiliser ce calcul pour divers formulaires dans Revenue, Expense, Balance Sheet et Cash Flow. Cela permet l'optimisation et la réutilisation.
-
Règles Groovy pures qui peuvent, par exemple, effectuer des validations de données et annuler l'opération si les données entrées enfreignent les politiques de la société.
Note :
Tout script Groovy qui retourne une chaîne retourne un script de calcul Essbase qui sera exécuté sur le cube Essbase spécifié. Évitez d'utiliser des chaînes comme valeur finale de la dernière instruction, sauf s'il s'agit d'un script de calcul que vous souhaitez exécuter après le lancement réussi 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 qu'une règle métier peut exécuter.
Utilisation des API de génération de script Groovy d'EPM
- Les API de script Groovy d'EPM permettent aux scripts Groovy d'effectuer diverses opérations sur le modèle d'objet EPM. La plupart des objets, tels que l'application courante, le cube et la grille, peuvent être extraits de la variable d'opération. Dans la plupart des cas, le point d'entrée de l'API sera soit les méthodes de la classe de base
EpmScript
, soit l'objetOperation
. - 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, le système arrête le script et enregistre une erreur dans la console des tâches lors de son exécution. Si le script a 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 appelantoperation.hasGrid()
. Des modèles similaires sont disponibles pour d'autres objets du modèle.
Conseil :
Pour les spécifications d'API de la plate-forme de script Groovy EPM, voir Informations de référence sur les API Java d'Oracle Enterprise Performance Management Cloud pour les règles GroovyCréation de règles Groovy
Oracle prend en charge deux types de règle Groovy :
- Dans une application Planning dans EPM Enterprise Cloud, ouvrez le navigateur et, sous Créer et gérer, cliquez sur Règles pour afficher Calculation Manager.
- 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. Entrez un nom pour la règle, puis cliquez sur OK.
- Un message indiquant que la règle est créée et ouverte pour modification s'affiche. Cliquez sur OK pour continuer.
- Dans la liste déroulante Concepteur, sélectionnez Modifier le script
- Dans la liste déroulante Type de script, sélectionnez Script Groovy.
- Cliquez sur
(Enregistrer). La règle est maintenant une règle basée sur un script Groovy, et vous pouvez utiliser l'éditeur pour développer votre script en fonction de votre cas d'utilisation. L'exemple suivant montre un script Groovy simple dans l'éditeur qui modifie 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 voir dans un onglet distinct.





Liens connexes
- Documentation : Utiliser des règles Groovy
- Vidéos sur Groovy sur le canal YouTube des tutoriels sur Oracle EPM
- EPM Cloud Planning - Tutoriels Groovy
- Informations de référence sur l'API Java pour Oracle Enterprise Performance Management Cloud et Groovy Rules
- API REST pour Oracle Enterprise Performance Management Cloud
- Référence de script Groovy
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.
Présentation de Groovy Business Rules
G43180-01
Septembre 2025