JavaScript doit être activé pour que ce contenu s'affiche correctement
Introduction
Ce tutoriel vous explique comment appeler une API REST externe à partir d'un script Groovy dans Oracle EPM Cloud Planning. Vous apprendrez également à créer un menu d'actions contextuel comportant une option d'appel du script et comment l'associer à un formulaire.
Renseignez les sections dans l'ordre.
Contexte
Le modèle objet EPM Groovy permet d'appeler des API REST internes (inter-POD ou autres services Oracle Cloud) et externes. Dans cet exemple, vous créez et exécutez une règle Groovy pour appeler une API REST Google Places externe afin d'ajouter ou de mettre à jour les informations d'adresse de l'employé dans le formulaire ManageEmployees.
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.
Téléchargez et importez ce cliché dans l'instance Planning. Si vous avez déjà téléchargé ce cliché pour un autre tutoriel Groovy, vous pouvez continuer à utiliser le même cliché.
Avant de commencer à utiliser les API Google Maps Platform qui incluent l'API Places (Nouveau) utilisée dans ce tutoriel, vous devez vous inscrire et créer un compte de facturation pour acquérir une clé d'API. Pour en savoir plus, reportez-vous à Introduction à Google Maps Platform.
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.
Charger des variables de calcul Planning
Dans cette section, vous allez télécharger des variables de calcul à partir d'un fichier XML pour les utiliser dans le script Groovy.
Cliquez avec le bouton droit de la souris sur le lien de HP4_Plan2_Variables.xml et enregistrez le fichier sur votre disque local.
Cliquez sur (Navigateur), puis, sous Créer et gérer, sélectionnez Règles pour ouvrir Calculation Manager.
Dans la vue système, développez EPM Cloud, puis HP4. Cliquez avec le bouton droit de la souris sur Plan2 et sélectionnez Importer.
Sous Détails de l'importation de fichiers, accédez à HP4_Plan2_Variables.xml et sélectionnez-le à partir de votre lecteur local.
Sous Détails de l'emplacement, sélectionnez les valeurs suivantes :
Type d'application : EPM Cloud
Application : HP4
Cube : Plan2
Sous Options d'import, sélectionnez Remplacer les objets existants.
Cliquez sur Importer. Vérifiez les résultats de l'importation, puis cliquez sur OK.
Remarques :
Le message pour chaque objet peut dire "Inserted" ou "Updated".
Cliquez sur Annuler pour fermer la boîte de dialogue Importer.
Créer une connexion nommée dans Planning
Dans cette section, vous créez une connexion Maps pour l'API Google Places.
Laissez Calculation Manager ouvert et revenez à la fenêtre du navigateur Planning.
Cliquez sur (Navigateur), puis, sous Outils, sélectionnez Connexions.
/*RTPS: {Employee} {EmployeeAddress} {Scenario} {Year} {Period} {Entity} {Version}*/
Member employee = rtps.Employee.member
// Get the complete address using the Google Places API (New).
// Use the original RTP value if Google Maps can't find the address.
def address = rtps.EmployeeAddress
HttpResponse<String> jsonResponse = operation.application
.getConnection("Maps")
.post()
.header("Content-Type", "application/json")
.body(json([
"textQuery": rtps.EmployeeAddress.enteredValue
]))
.asString()
println("Google Maps HTTP status: ${jsonResponse.status}")
println("Google Maps response:")
println(jsonResponse.body)
ReadContext ctx = JsonPath.parse(jsonResponse.body)
List places = ctx.read('$.places') as List
if (jsonResponse.status >= 200 && jsonResponse.status < 300 && places && !places.isEmpty()) {
String formattedAddress = ctx.read('$.places[0].formattedAddress')
println("Google Maps formatted address: ${formattedAddress}")
address = getTextCellId(formattedAddress, true)
} else {
println("Google Maps did not return a place. Using original address: ${rtps.EmployeeAddress.enteredValue}")
}
// Generate the calc script to save the employee address
"""SET CREATENONMISSINGBLK ON;
FIX(${fixValues(rtps.Scenario, rtps.Year, rtps.Period, rtps.Entity, rtps.Version, employee)}, "USD")
"Employee Address" = $address;
ENDFIX;"""
Définissez toutes les invites d'exécution (RTP) utilisées par cette règle sur la première ligne.
Obtenez l'objet Member pour l'employé spécifié par le RTP de l'employé.
Utilisez le RTP EmployeeAddress comme adresse par défaut lorsqu'aucune adresse formatée n'est affectée.
Utilisez la connexion Mappes pour envoyer une demande HTTP POST. Définissez le type de contenu sur application/json et transmettez la valeur EmployeeAddress entrée dans le champ textQuery JSON.
Consignez le statut HTTP et le corps de réponse pour le dépannage.
Analysez la réponse JSON à l'aide de JsonPath. Convertissez explicitement le tableau places vers List afin que la vérification du type statique puisse résoudre isEmpty(). Lorsque le statut de la réponse est Succès et que la liste n'est pas vide, lisez places[0].formattedAddress, convertissez-la en ID de cellule de texte et affectez-la à address. Sinon, conservez la valeur RTP d'origine.
Générez le script de calcul pour enregistrer l'adresse de l'employé au croisement spécifié par les RTP.
Remarques :
La connexion Maps est un lien de communication entre le script Groovy et la ressource API Google Places (Nouveau).
Dans la barre d'outils, cliquez sur (Enregistrer). Cliquez sur OK pour fermer le message d'information.
Remarques :
L'enregistrement du script affiche les variables dans l'onglet Variables.
Dans l'onglet Variables, sélectionnez Est masqué pour Employé, Entité, Période, Scénario, Version et Année afin que les utilisateurs n'entrent une valeur que pour EmployeeAddress.
Remarques :
Lorsque les utilisateurs exécutent la règle à partir du formulaire, ces variables masquées reçoivent des valeurs du contexte du formulaire.
Cliquez à nouveau sur (Enregistrer). Pour fermer le message d'information, cliquez sur OK.
Cliquez sur (Valider et déployer). Entrez les valeurs RTP suivantes pour la validation :
Employé : "Full Time Employees"
Entité : "No Entity"
Période : Jan
Scénario : Current
version : "BU Version_1"
Année : FY26
Sélectionnez Appliquer des valeurs à la règle pour enregistrer ces valeurs comme valeurs par défaut pour la validation, puis cliquez sur OK.
Remarques :
La validation n'exécute pas la règle, mais des membres valides sont requis pour que la validation réussisse.
Lorsque vous y êtes invité, cliquez sur OK, puis fermez Calculation Manager.
Créer des menus d'action de planification pour exécuter des scripts Groovy
Dans cette section, vous créez un menu d'actions Gérer les employés avec une option de menu qui exécute la règle Groovy.
Dans Planning, cliquez sur (Navigateur), puis, sous Créer et gérer, sélectionnez Menus d'action.
Remarques :
Si vous avez terminé d'autres tutoriels Groovy, le menu d'action Gérer les employés peut déjà exister. Si tel est le cas, passez à l'étape 4.
Cliquez sur (Menu Créer) pour créer un menu d'actions.
Pour Nom de menu, entrez Manage Employees, puis cliquez sur OK.
Sélectionnez le menu d'actions Manage Employees, puis cliquez sur (menu Edit).
Cliquez sur (Ajouter un enfant). Entrez ou sélectionnez les valeurs suivantes :
Champ d'option
Valeur
Option de menu
Update Employee Address
Intitulé
Update Employee Address
Type
Règle métier
Paramètres requis
Employé
Cube
Plan2
Règle métier
Groovy - Ajouter ou mettre à jour l'adresse de l'employé
Cliquez sur Enregistrer. Lorsque le message confirmant la confirmation s'affiche, cliquez sur OK.
Cliquez sur Enregistrer pour enregistrer le menu d'actions. Lorsque le message confirmant la confirmation s'affiche, cliquez sur OK.
Cliquez sur Annuler pour fermer l'éditeur de menu Action.
Associer des menus d'action de planification à des panneaux
Dans cette section, vous associez le menu d'actions Gérer les employés au formulaire ManageEmployees.
Cliquez sur (Navigateur), puis sélectionnez Données.
Cliquez sur ManageEmployees pour ouvrir le formulaire.
Cliquez sur Actions, puis sélectionnez Modifier pour modifier le formulaire.
Un nouvel onglet dynamique s'affiche avec l'éditeur de formulaire.
Sélectionnez l'onglet Autres options.
Ajoutez Gérer les employés à la liste Menus sélectionnés, puis cliquez sur Enregistrer.
Cliquez sur OK pour fermer le message d'information.
En bas de la page, fermez l'onglet dynamique Modifier ManageEmployees pour revenir au formulaire.
Test du script Groovy
Dans cette section, vous exécutez la règle à partir du formulaire ManageEmployees ouvert pour extraire et enregistrer une adresse complète, puis consultez le journal du travail.
Cliquez avec le bouton droit de la souris sur Employé 1 et sélectionnez Mettre à jour l'adresse de l'employé.
Dans l'invite Adresse de l'employé, entrez Oracle, Redwood Shores, puis cliquez sur Lancer.
Cliquez sur OK pour fermer le message d'information.
Une fois terminée, l'adresse complète renvoyée par Google Maps est enregistrée comme adresse pour l'employé 1.
Cliquez sur (Navigateur), puis, sous Application, sélectionnez Travaux pour ouvrir la console de jobs.
Cliquez sur Ajouter ou mettre à jour l'adresse de l'employé 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.
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.