Puissance de l’intégration Oracle EPM

Aperçu:

Cet article explique comment utiliser Groovy et les connecteurs pour appeler une API REST externe à l’aide de la technologie Oracle EPM Cloud et Middleware appelée MuleSoft.

Contexte:

Il existe une option pour appeler des API REST internes et externes à l’aide du modèle objet Groovy EPM. Pour générer des fichiers GL à partir des ERP et les charger dans FCCS à l’aide de la gestion des données (une API interne), vous écrivez et exécutez une règle Groovy qui appelle une API REST MuleSoft externe.

Conditions requises :

Posséder un accès à une instance Cloud EPM Enterprise Service en tant qu’administrateur de service.

Vous devez d’abord créer une interface dans MuleSoft pour que la procédure stockée dans les ERP génère le fichier de solde de suivi au format approprié avant de pouvoir commencer à utiliser les API MuleSoft, qui incluent l’API REST du point de terminaison. Visitez Veuillez visiter le lien ci-dessous pour savoir comment créer des points de terminaison dans le gestionnaire de partenaires de MuleSoft :

https://docs.mulesoft.com/partner-manager/latest/create-endpoints

Si vous rencontrez des erreurs de migration lors de l’importation de l’instantané, 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 dans le composant principal. Pour plus d’informations sur le téléchargement et l’importation d’instantanés, reportez-vous au Administration de la migration pour Oracle Enterprise Performance Management Cloud Documentation.

Création d’un script Groovy pour télécharger le fichier ERP Actual et chargement vers l’outil de consolidation.

Vous trouverez ci-dessous les étapes que nous avons définies pour l’intégration ci-dessus.

1. Création d’une connexion dans Oracle EPM pour appeler les services Web MuleSoft.
2. Avant d’appeler les endpoints de MuleSoft, il est nécessaire de les autoriser. Pour y parvenir, nous devons créer une logique qui génère un jeton de porteur en utilisant l’ID client et le secret de l’API MuleSoft. Le script ci-dessous nous aidera à générer efficacement le jeton du porteur. Nous transmettons l’ID client et le secret comme corps.
3. Nous analysons le résultat de la réponse JSON et attribuons le jeton à une variable en utilisant la méthode ci-dessous.« Jaccess_token » est le jeton du porteur généré à partir de la connexion « Mule » en utilisant la méthode ci-dessus.
4. Tout d’abord, nous autorisons le point de terminaison de l’API à l’aide d’un jeton de porteur à générer un fichier de solde de suivi pour l’exercice et la période demandés. Pour créer une nouvelle connexion, nous commençons par fournir les détails du point de terminaison.
5. Création d’une connexion pour le point de terminaison.
6. Utilisation d’un script Groovy pour se connecter et appeler le point de terminaison avec un jeton ours créé via une connexion de services Web.
7. Une URL transmise dans la méthode get() aura des paramètres pour spécifier l’exercice et la période pour les données du grand livre de l’ERP. La syntaxe de l’URL est la suivante : def url = « /eppmtrailbalance/us/summary?year=&month=« 
8. La réponse JSON « jsonResponse1 » contiendra les détails des fichiers de balance de vérification qui ont été générés à l’emplacement SFTP.
9. Il convient de noter que nous n’avons pas encore dans EPM le fichier que nous devons charger dans l’application de clôture de consolidation cible. À l’heure actuelle, il se trouve dans un emplacement de partage cloud, géré par un outil tiers appelé « MoveIT ». MoveIT sert d’interface de partage de fichiers à travers laquelle nous pouvons transférer ou modifier les fichiers nécessaires.
10. Nous avons mis en place des mesures supplémentaires pour garantir que nos fichiers financiers sont conformes et ne sont pas stockés dans un partage de fichiers cloud. Nous téléchargeons maintenant les fichiers du partage de fichiers cloud et les supprimons de MoveIT. MOVEit crypte les fichiers et utilise des protocoles de transfert de fichiers sécurisés tels que FTP(S) et SFTP pour transférer des données. Il fournit également des services d’automatisation, des analyses et des options de basculement.
11. Pour exploiter la puissance de l’intégration d’Oracle EPM, nous avons établi une nouvelle connexion pour MoveIT, un outil cloud accessible via une RestAPI pour le transfert de fichiers.
12. Pour appeler MoveIT, vous pouvez utiliser un script Groovy similaire à celui présenté ci-dessous.
    
13. Vous trouverez ci-dessous le script Groovy pour télécharger le fichier dans le répertoire de la boîte de réception EPM.
14. Après l’étape 6, la réponse JSON inclura les détails des fichiers créés à l’emplacement SFTP. Nous utiliserons ces informations pour télécharger le fichier depuis l’emplacement SFTP vers le répertoire EPM Inbox/Outbox.
    
15. Comme il s’agit de données financières, nous devons éviter tout problème de conformité en supprimant le fichier partagé dans le cloud de l’emplacement SFTP. Veuillez suivre les étapes ci-dessous pour ce faire.
16. Nous avons maintenant le fichier de balance de vérification dans le répertoire de la boîte de réception EPM et allons charger le fichier dans FCCS à l’aide de la règle de chargement de données créée pour transformer les fichiers.
17. Initiez la règle de chargement des données en établissant une connexion pour appeler l’API interne de gestion des données.
    
18. Le script est conçu pour exécuter la règle de chargement de données qui charge les fichiers du grand livre du répertoire Boîte de réception/Boîte d’envoi vers FCCS.
19. Toutes les procédures mentionnées ci-dessus nécessitent la soumission d’un paramètre. Le mappage approprié du chargement des données, de la logique de validation et du formatage d’importation est défini dans la gestion des données.
20. Vous trouverez ci-dessous les invites d’exécution créées pour prendre les paramètres et exécuter le script complet.
21. Après avoir créé toutes les étapes et le script nécessaires, assurez-vous de le valider et de le déployer en cliquant sur « Valider et déployer ».