Comment intégrer des données statiques dans ADI ?

L’objectif de ce document est de montrer comment  intégrer des données statiques dans ADI.

Note : l’intégration est adaptée au besoin final afin d’afficher dans nos dashboards le nombre de commandes totales et/ou le nombre de commandes par type de canal.

Intégration des données statiques dans ADI

 

Dans cette partie, vous allez intégrer les données pour pouvoir alimenter les entités que vous venez tout juste de créer.

• Allez dans l’onglet “Data Integration” en cliquant sur l’icône de la barre de menu en foncé à gauche.

 

 

Données statiques dans ADI : paramétrage de la date de début de l’application

Lorsque vous intégrerez vos données statique grâce à un mapping, il sera nécessaire de définir la date à laquelle les instances seront créés.
Pour cela, suivez les étapes suivantes :

• Allez dans “Properties” du menu

 

 

• Dans le menu “In space”, sélectionnez “FRM – Initializers”

 

 

• Puis, sélectionnez “New Property”

 

 

• Sur la nouvelle ligne qui s’affiche remplissez les champs suivants:
• Name: “APP_START”
• Value: “Simple”
• Champ vide: “2020-01-01T00:00:00”

 

 

• Cliquez sur “Save”

Données statiques dans ADI : Intégration des données de l’entité Canal de Commande

Paramétrage de la ressource

• Dans le menu Transformations, cliquez sur “Resources”.
• Veuillez à ce que le champ In space soit “FRM – Initializers”

• A présent, cliquez sur “New Resource”

Remplissez les champs suivants:

• Name: createCanalVenteEntite
• Type: Text
• Charset: UTF-8
• Content:         Ccanal_de_vente

                                INTERNET

                                BOUTIQUE

                                TELEVENTE

 

 

• Cliquez sur “Save”

Paramétrage de la route

Les routes sont des scripts en langage “Camel” qui vont permettre de paramétrer l’intégration des données.

• Cliquez sur “Routes” du menu transformation
• Verifiez que In space soit “FRM – Initializers”
• Appuyez sur “New Routing Context”

 

 

Complétez les champs comme l’image suivante:

• Name: initCanalVente
• Options: Manual Start
• Zone de texte:

 

• Appuyez sur “Save”

Paramétrage du mapping

Le mapping permet d’attribuer les données aux entités correspondantes grâce à l’exécution de la route.

• Appuyez sur “Mappings” du menu Endpoints
• Veuillez à ce que le champ In space soit égal à “FRM – Initializers”
• Cliquez sur “New Mapping”
• Donnez comme nom “createCanalVente”
• Sélectionnez Add parameter puis entrez le nom “typeCanal” et sélectionnez “String” dans le champ Type
• Appuyez sur “Done”
• Cliquez sur “Add Instance Operation”

 

 

• Cliquez sur “select an entity”
• Sélectionnez “Type de canal”
• Appuyez sur “Done”, une nouvelle partie apparaît

Paramétrez comme les images qui suivent:

• Dans la partie Default Times
• Résolution: Constant dans le champ qui suit remplacez Now par “{{APP_START}}”
• Operations begin: Constant dans le champ qui suit remplacez Now par “{{APP_START}}”
• Operations end: Constant laissez le champ vide

 

 

Dans la partie Resolution

• Changez “Error if instance of Canal de vente not found at resolution time” par “Create an instance of Canal de vente if not found at resolution time or after”
• Changez le menu déroulant à droite de Parameter par “typeCanal”

 

 

• Cliquez sur “Save”
• Revenez dans l’onglet “Routes” puis appuyez sur l’action start routing context

 

Vérification de l’intégration des données statiques dans ADI

• Vérifier les logs

 

• Vérifier avec Explore

Appuyez sur le bouton  à gauche de l’écran pour atteindre l’écran Explore

Appuyez sur Canal de vente pour le choix des entités, puis Type de canal.

 

 

Apparaît alors un tableau avec les instances de l’attribut Type de canal.

 

Vous avez réussi l’intégration des données.

 

Intégration des données de l’entité Global pour intégrer des données statiques dans ADI

Paramétrage de la ressource 

• Revenez dans le menu Transformations et cliquez sur “Resources”.
• Veuillez à ce que le champ In space soit “FRM – Initializers”

 

 

• Créer une nouvelle ressource Global avec les paramètres suivants:
• Name: resourceGlobal
• Type: Text
• Charset: UTF-8
• Content:      ID

                             Global

 

• Cliquez sur “Save”

Paramétrage de la route pour les données statiques dans ADI

• Cliquez sur “Routes” du menu transformation
• Vérifiez que In space soit “FRM – Initializers”
• Appuyez sur “New Routing Context”

 

Complétez comme l’image suivante:

• Name: initGlobal
• Options: Manual Start
• Zone de texte:

• Appuyez sur “Save”

Paramétrage du mapping des données statiques dans ADI

• Appuyez sur “Mappings” du menu Endpoints
• Veuillez à ce que le champ In space soit égal à “FRM – Initializers”
• Cliquez sur “New Mapping”
• Donnez comme nom “createGlobal”
• Sélectionnez Add parameter puis entrez le nom “ID” et sélectionnez “String” dans le champ Type
• Appuyez sur “Done”
• Cliquez sur “Add Instance Operation”

 

• Cliquez sur “select an entity”
• Sélectionnez “Global”
• Appuyez sur “Done”, une nouvelle partie apparaît

Paramétrez comme les images qui suivent :

• Dans la partie Default Times
• Résolution: Constant dans le champ qui suit remplacez Now par “{{APP_START}}”
• Operations begin: Constant dans le champ qui suit remplacez Now par “{{APP_START}}”
• Operations end: Constant laissez le champ vide

 

• Dans la partie Resolution
• Changez “Error if instance of Global not found at resolution time” par “Create an instance of Global if not found at resolution time or after”
• Changez le menu déroulant à droite de Parameter par “ID”

 

 

• Cliquez sur “Save”
• Revenez dans l’onglet “Routes” puis appuyez sur l’action start routing context

 

 

Vérification de l’intégration des données statiques dans ADI

1. Vérifiez les logs

2. Vérifiez avec Explore

• Appuyez sur le bouton à gauche de l’écran pour atteindre l’écran Explore
• Appuyez sur Global pour le choix des entités, puis ID

 

 

Apparaît alors un tableau avec les instances de l’attribut Global.

Ce tutoriel est terminé, vous savez maintenant comment intégrer des données statiques 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 un modèle de données avec ADI ?
• Comment créer un connecteur JDBC et intégrer des données dans ADI ?

Une vidéo démo est également disponible sur notre chaîne YouTube.

Nous parlons dans un autre article d’Akka Cluster, l’Event Sourcing et le CQRS.

 

---

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