L’objectif de cet article est de montrer comment créer un connecteur de type CSV dans ADI et y intégrer des données d’un fichier CSV.
Note : l’intégration est adaptée au besoin final afin d’afficher dans les dashboards le nombre de commandes totales et/ou le nombre de commandes par type de canal …
Nous vous proposons aussi de regarder la Vidéo intégration données CSV disponible sur notre chaîne Youtube pour compléter cette lecture.
Intégration des données dans ADI
Dans cette partie, vous allez voir comment intégrer les données d’un CSV pour pouvoir alimenter l’entité commande que vous venez tout juste de créer. Dans cet exemple vous allez récupérer les deux attributs (ID, MONTANT).
- Allez dans l’onglet “Data Integration” en cliquant sur l’icône de la barre de menu en foncé à gauche. Choisir le space “FRM – Fetch”
Ajout de la librairie dans ADI
L’ajout d’un connecteur Axway qui permet à l’application de générer un fichier CSV.
- Dans la partie de droite: Détails, entrez le nom “Axway”
- Dans Library jar files, appuyez sur “Upload library jar” et sélectionnez le fichier “axway-2.13-SNAPSHOT.jar” précédemment téléchargé.
- Cliquez sur “Save”
Ajout du connecteur CSV dans ADI
- Maintenant, allez dans l’onglet “Connectors” du menu Endpoint
- Veuillez à ce qu’on soit toujours dans le space “FRM – Fetch”
- Cliquez sur “New Connector” et remplissez les champs comme l’image ci-dessous :
Ajout d’une Propriété du connecteur CSV dans ADI
L’ajout d’une variable dans la propriété qui permet de stocker le chemin du fichier CSV.
- Dans la partie de droite : Un clic sur “New Proprety”
- Dans la liste entrez le Name “FICHIER_COMMANDE”, Value “Simple ”, entrez le chemin du fichier CSV “\Path”
Paramétrage du mapping Commande du connecteur CSV dans ADI
- Allez dans le menu Endpoints et cliquez sur “Mappings”.
- Veuillez à ce que le champ In space soit “FRM – Fetch”
- Appuyez sur “New Mapping”
- Entrez le nom “Create_csv_Commande”
- Ajoutez les paramètres suivants en cliquant sur Add parameter
- Cliquez ensuite Add Instance Operation, appuyez sur select an entity et sélectionnez “Commande”.
- Appuyez sur “Done”
- Paramétrez comme les images qui suivent :
- Dans la partie Default Times
- Résolution: Constant laissez le champs vide , Now par défaut
- Operations begin: Constant laissez le champs vide , Now par défaut
- Operations end: Constant laissez le champ vide
Dans la partie Resolution
- Changez Error if instance of Commandenot found at resolution time par “Create an instance of Commande if not found at resolution time or after”
- Changez le menu déroulant à droite de Parameter par “ID”
- Dans la partie Operations, appuyez sur – Add an operation –. Sélectionnez “Change value(s) of attribut”
- Sélectionnez Montant en appuyant sur select
- Paramétrez comme suit :
- Cliquez sur “Save”
Paramétrage de la route
- Revenez dans le menu Transformations et cliquez sur “Routes”.
- Veillez à ce que le champ In space soit “FRM – Fetch”
- Cliquez sur “New Routing Context”
- Remplissez les champs suivants:
- Name : CSV_Commande
- Options: Manual start
- Librairies: None
Dans le grand champ, entrez la route suivante:
<?xml version=”1.0″ encoding=”UTF-8″?>
<routes xmlns=”http://camel.apache.org/schema/spring” xmlns:u=”http://www.systar.com/aluminium/camel-util”> <route> <from uri=”timer:StartRoute?repeatCount=1″/> <!– –> <!– Appelle de la propriété : FICHIER_COMMANDE –> <!– Spécifier le nom du fichier : Donnees_*–> <!– –>
<from uri=”file:{{FICHIER_COMMANDE}}?antInclude=Donnees_*&noop=false”/> <log message=”file : ${headers.CamelFileName}”/> <unmarshal> <csv delimiter=”;” skipHeaderRecord=”true”/> </unmarshal> <split> <simple>${body}</simple> <setBody> <u:map-create> <u:map-entry key=”ID”> <simple>${body[0]}</simple> </u:map-entry> <u:map-entry key=”MONTANT”> <simple>${body[1]}</simple> </u:map-entry> </u:map-create> </setBody>
<!– –> <!– Mapping : Create_csv_Commande –> <!– –>
<log message=”Commande OK : ${body}”/> <to uri=”tnd-absorption:Create_csv_Commande”/> </split> </route> </routes> |
Vérification de l’intégration des données
- Appuyez sur l’action pour lancer la route puis appuyez sur le bouton pour regardez les logs.
- Cochez “Info”, vous devriez avoir les même messages.
Vérifier avec Explore
- Appuyez sur le bouton à gauche de l’écran pour atteindre l’écran Explore
- Appuyez sur Commande pour le choix des entités, puis ID , MONTANT.
Apparaît alors un tableau avec les instances de l’attribut Global.
Vous avez réussi l’intégration des données d’un fichier CSV avec le connecteur CSV dans ADI !
D’autres tutoriels d’ADI sont aussi disponibles sur le site :
- Quelles sont les principales fonctions d’ADI ?
- Comment créer un un simple Dashboard avec ADI ?
- Comment créer un dashboard avec agrégations sous ADI ?
- Comment créer un connecteur Database dans ADI ?
- Comment créer une route camel dans ADI pour récupérer, filtrer et stocker des listes dans un CSV ?
- Comment créer un modèle de données avec ADI ?
- Comment créer un connecteur JDBC et intégrer des données dans ADI ?
N’hésitez pas à consulter la chaîne YouTube pour découvrir la vidéo tuto de cet article.
Depuis plus de 15 ans maintenant, je travaille sur des sujets liés à la BI et à l’amélioration des processus. J’ai participé à un grand nombre de projets en tant que leader technique sur de nombreuses technologies. De nature pédagogue, je donne également des cours de langage de programmation.
N’hésitez pas à me faire un retour sur cet article ou à me contacter sur LinkedIn pour échanger sur ces sujets!
Alexis
Laisser un commentaire