Passer au contenu principal
Adaptive Insights
Knowledge and Support - Adaptive Insights

Exporter des données de planification avec l’exportateur de planification par script

Vous pouvez utiliser le Scripted Planning Exporter (SPE), un Pentaho plug-in personnalisé, pour exporter des données de planification dans des systèmes externes. (Pour des informations supplémentaires sur Adaptive’s l’utilisation de Pentaho, voir Configuration d’une source de données par script.)

 

Comprendre le SPE

Le SPE fonctionne en effectuant un appel vers Adaptive Planning l’API REST d’exportation puis archive les résultats de cet appel API sur un fichier que vous spécifiez. Le SPE prend en charge la sortie dans des formats de fichier CSV et XML. (Toutes les données d’exportation ne peuvent pas être transformées au format CSV.)

Le SPE est un plug-in regroupé avec l’agent de données Adaptive commençant par la version v51.17.0734. Vous pouvez vérifier quelle version de Adaptive Gestionnaire de services de l’agent de données dont vous disposez en ouvrant le programme. Le numéro de version s’affiche sur les informations dans l’onglet À propos de. (Pour les informations relatives à l’installation de l’Adaptive Agent de données, voir Installation du Adap­tive Gestionnaire de services de l’agent de données.) Lorsque le SPE est installé, il s’affiche dans le dossier Entrée sur l’onglet Conception de Spoon, comme indiqué ci-dessous.

La terminologie relative à l’Adaptateur d’exportateur de planification par script peut être légèrement confuse. Étant donné que les données passent de la planification au script puis vers une destination ­externe, l’exportation de données s’effectue à partir de la planification et l’importation de données s’effectue vers la destination­ externe. Cependant à y regarder de prèsSpoon, le SPE constitue une étape d’entrée, car il propose une entrée au script. Il porte donc la mention "Entrée Adaptive Planning" dans Spoon.

Vous pouvez lancer le SPE directement depuis l’environnement Spoon ou à distance en l’incluant dans un chargeur par script. Le processus général d’utilisation de SPE consiste à rédiger un script créant­une demande XML au format accepté par le serveur de planification, transférant ces éléments au SPE puis traitant les résultats. Vous trouverez ci-dessous un exemple de script indiquant les exigences minimales pour un script SPE :

 Entrée ------------------------------------------- Exportateur de planification par script : chaîneXMLdemande : demande au format XML FormatRéponseCible : DossierCible CSV ou XML : dossier cible pour archiver le fichier de résultat généré par cette sortie plug-in : Le type de champ de sortie est Chaîne, à l’exception de requestSuccess qui est de type booléen : Booléen, ‘O’ ou ‘N’ messagePlanification : concatène les messages de planification en une chaîne, délimitée par un NomFichierRéponse ‘###’ : renseigner le chemin du nom de fichier réponse NomsChamp : nom de colonne dans l’en-tête CSV ou VALEUR NULLE si le FormatRéponseCible correspond au nombreEnregistrementsRetournés XML : Chaîne, nombre d’enregistrements renvoyés par la Planification, ou VALEUR NULLE si le FormatRéponseCfible est XML 

 Les meilleures pratiques pour ce script comprennent les éléments suivants :

  • Tous les noms de champ d’entrée sont sensibles à la casse. Vérifiez qu’ils sont définis en conséquence dans le Kettle script.
  • ChaîneDemandeXML : chaque API d’exportation a son propre format de demande XML. Voir l’Adaptive PlanningAPI RESTpour obtenir des informations supplémentaires.
  • FormatRéponseCible : à partir d’API v11, seule la charge utile de l’API « exporterDonnées » peut être transformée au format CSV. Toutes les autres exportations doivent être au format XML.
  • DossierCible : en général, vous souhaitez que la case Limiter l’accès de l’exécuteur aux fichiers ne soit pas cochée dans le Gestionnaire Service de l’agent, puisque le dossier cible peut se situer n’importe où dans le système fichiers.
  • NomFichierRéponse : Le format du nom du fichier réponse est le suivant : <Dossier­cible>_RéponseApi_<MéthodeExportation>_<UUID>.<FormatCible >; par exemple, C:\pdiTemp\ApResponse_exportData_83980a17b3dc40c48282483cb9ea5e96.csv
  • demandeCorrecte : si la demande d’exportation passe côté serveur de planification, la valeur du requestSuccess est Vrai (« O »). Si la demande d’exportation se traduit par un appel à la planification, le SPE lance une exception avec les messages d’erreur renvoyés par le serveur de planification.

Le flux de travail général d’extraction d’informations à partir de la planification et d’envoi vers un fichier sortie­s’affiche ci-dessous.

Utilisation d’API d’exportation de planification depuis le script Kettle

Le SPE utilise Adaptive Planning des API v11 ou version supérieure. Vous pouvez utiliser les API suivants avec le SPE :

  • valeursPersonnaliséesRapport  : renvoie un ensemble de données pour les critères de rapport demandés dans l’instance demandée
  • exporterDonnées : récupérer un ensemble de valeurs à partir d’une version spécifiée

Pour de plus amples informations sur les Adaptive API, voir l’ Adaptive API.

Configuration du plug-in SPE Kettle

Pour configurer le plug-in SPE Kettle, procédez de la façon suivante :

La boîte de dialogue Adaptive Planning Étape d’entrée s’affiche (indiquée ci-dessous).

  1. Cliquez sur Adaptive Planning Entrée dans l’onglet Spoon Conception, comme indiqué précédemment.

  2. Saisissez les informations SPE’ :

  • Agent actif : Renseigné automatiquement par le SPE.
  • Hôte d’instance : renseigné automatiquement par le SPE.
  • Code d’instance : Renseigné automatiquement par le SPE.
  • Connexion : valeur du paramètre de contexte de connexion.
  • Mot de passe de connexion : valeur du paramètre de contexte mot de passe.
  • Paramètres régionaux : valeurs par défaut en_US.
  1. Cliquez sur Ok.

Vous devez créer un script qui définit les entrées et les sorties pour l’opération SPE. (Voir l’exemple de script plus haut).

Configuration du SPE dans l’IU Cloud d’Adaptive Integration’

Le processus général de création d’un chargeur par script avec IU Cloud d’Integration’est le suivant :

  • créer un chargeur par script
  • sélectionner un point d’entrée
  • configurer les paramètres requis

Créer d’abord un chargeur par script. Pour en savoir plus sur la façon de procéder, voir Création de chargeurs par script. Vous devez également sélectionner un point d’entrée dans la liste déroulante. Le point d’entrée est défini par le nom du script à exécuter lorsque le chargeur par script est exécuté.

Enfin, vous devez mapper et exposer les paramètres de contexte locaux et partagés, définis dans le chargeur par script, sous forme de variables d’environnement dans l’environnement Kettle/Spoon. Par exemple, si un paramètre de contexte nommé "connexion" est défini à l’écran de configuration du chargeur, à la section Paramètres, il est exposé comme variable "${connexion}" dans l’environnement Kettle. L’image ci-dessous indique la définition de deux paramètres de contexte dans un chargeur par script.

L’image suivante indique des références dans le SPE pour les deux variables correspondantes Kettle définies ci-dessus.

Vous pouvez mettre à jour les Kettle variables au moment de la conception, avec les valeurs de paramètre­actuelles de contexte par défaut, en lançant l’Adaptive éditeur de script et en déclenchant une actualisation en cliquant sur Actualiser la configuration.

  • Cet article vous a été utile ?