Configuration complexe

Dans ce chapitre, nous vous présenterons différents cas d'utilisation typiques qui vous aideront à vous familiariser avec CONIGON ADIB. Si vous n'êtes pas encore familiarisé avec ADIB, nous vous conseillons de consulter d'abord les deux chapitres précédents

• Principes de base de la configuration
• Configuration des interfaces de données

Importation d'un fichier CSV dans une table de base de données

Il s'agit d'une interface de base, que nous utiliserons également dans le cas d'utilisation suivant pour créer un portail complet à partir d'une table de base de données.

Dans ce cas d'utilisation, vous apprendrez :

• À créer deux groupes de paramètres
  • Groupe de paramètres pour l'importation CSV
  • Groupe de paramètres pour la connexion MySQL
• À utiliser « dryRun » pour obtenir les noms de champs corrects (du fichier et de la table correspondante)
• À démarrer le processus via « direct start » pour vérifier si les données ont été correctement importées.

Tout d'abord, examinons le fichier (appelé « vbfliesen.csv ») que nous avons exporté depuis un système ERP et qui contient les champs/contenus suivants

REMARQUE IMPORTANTE : l'encodage du fichier doit être « UTF-8 ». Veuillez en tenir compte, car si vous l'exportez depuis Excel, il est souvent encodé en « ansi » ou « ISO-8859 » !

Nous avons déjà créé un nouveau tableau dans la base de données de destination avec les champs correspondants. Dans une nouvelle version d'ADIB, vous pouvez également choisir de créer le tableau de manière dynamique s'il n'existe pas encore.

Créer un nouveau step

Nous créons d'abord un step appelée « Test-Import ». Nous l'ajouterons à une tâche existante appelée « Job-Tests ».

Si vous n'avez pas encore de tâche, il suffit d'en créer une.

Pour créer la nouvelle étape

• Allez dans « ADIB Config » ==> « Étapes »

• Cliquez sur « Nouveau » et le « step creation wizard » s'ouvrira

  1. Step Type : Vous n'avez rien à sélectionner dans « Step Type » - cliquez simplement sur « Confirmer »
  2. Step Informations: Saisissez ensuite les textes que vous voyez sur la capture d'écran Cliquez ensuite sur « Suivant » pour passer à l'écran suivant de l'assistant de création d'étape
  3. **Modules ** : Vous choisissez ici les modules. Nous prendrons « Excel » comme srcModule.
  4. Cliquez ensuite sur Groupe de paramètres => « nouveau » et définissez « Importation Excel » comme nom
  5. Sur l'écran « Paramètres », vous définissez le nom du « Conteneur » * Dans le cas d'un fichier, il s'agit simplement du nom du fichier - dans notre cas « vbfliesen.csv »

  IMPORTANT : si vous définissez uniquement le nom sans répertoire, le fichier doit se trouver dans le dossier « externalData » accessible sur notre serveur, dans le dossier où nous avons placé le docker « IntegrationClient ». * Enfin, cliquez sur Suivant pour créer le nouveau groupe de paramètres et l'attribuer au module source de la nouvelle étape * Ensuite, nous définirons le module de destination => « MySQL ». * Vous devez ici créer un nouveau groupe de paramètres et le remplir avec les informations d'identification de votre base de données. * Si vous cliquez ensuite sur Suivant, le groupe de paramètres est créé et attribué au module de destination. * Les autres types de modules (ws-module, preprocess, postprocess) ne sont pas pertinents pour notre nouvelle étape. Vous pouvez donc simplement cliquer sur « Suivant » pour passer à l'écran suivant. *

4 . Other informations

• Ici, vous pouvez définir la position (par défaut : la prochaine position libre), si elle est active ou non et le mode (« transfert complet », « deltaWholeLine » et « deltaDroppedLine »). Vous pouvez également définir certaines fonctions (telles que connectstepid, valeurs de mappage, etc.).
• Pour simplifier, prenons l'écran suivant :
• Ensuite, vous devez cliquer plusieurs fois sur « Next» et ignorer les messages/avertissements (ils sont normaux, car nous n'avons pas supprimé les modules dont nous n'avons pas besoin).
• Vous accédez alors à l'écran de présentation des « étapes ». Si vous avez déjà plusieurs étapes, cliquez deux fois sur l'en-tête « positions » pour les trier par ordre décroissant, comme vous le voyez à l'écran :

DryRun

Cliquez maintenant sur le signe (+) dans la colonne des fonctions pour l'étape nouvellement créée.

• Sur cet écran, sélectionnez dans le champ « dryrun » l'entrée « conigon » (car c'est l'instance pour laquelle nous avons créé l'étape).
• Passez ensuite dans le menu de gauche à « Jobs » et sélectionnez le job « Job-Tests » (car c'est le job pour lequel nous avons créé la nouvelle étape).
• Cliquez sur le champ sous la colonne « Directstart » et sélectionnez à nouveau l'instance « conigon ».

• Cliquez ensuite sur l'icône en forme de crayon en haut de la page pour déclencher l'intégration client (« IC »).
  • Après quelques secondes (entre 10 et 100), vous serez informé que l'IC a terminé le travail.
• Passez maintenant à « monitoring » dans le menu de gauche et ouvrez le travail correspondant. Vous verrez que 28 lignes ont été importées (uniquement les noms de champs, car nous sommes en mode « dryrun »)

Configuration des positions de steps

Dryrun nous a renvoyé toutes les colonnes des modules source et destination pour notre étape. Il est maintenant temps de configurer les champs (appelés « positions d'étape ») qui doivent être transférés de la source vers la destination.

Cliquez sur « steps», recherchez le step nouvellement créée et cliquez sur l'icône la plus basse de la première colonne (« > »). Cela ouvrira les « positions ». Vous verrez quelque chose comme ceci :

Vous ne verrez aucune ligne dans ce « sous-tableau » car nous n'avons encore ajouté aucune position de step. Il existe plusieurs façons de le faire:

• Ajoutez les lignes une par une en cliquant sur « Créer », puis en sélectionnant sourceField et destField.
  • C'est une bonne approche si vous souhaitez simplement ajouter quelques lignes.
• Cliquez sur le bouton « Insérer tous les champs connus de src/ws/dest » : Cela ouvrira un assistant qui vous guidera tout au long du processus

1. Initiate

   • Vous définirez ici quel sera le maître du mappage des champs
     • SourceModule: Dans notre cas, il s'agit du fichier CSV que nous voulons importer
     • DestinationModule : Dans notre cas, il s'agit de la table MySQL dans laquelle nous voulons écrire les informations
     • ConnectStep : Cette option n'est visible que si l'étape est la suite d'une étape existante

   Nous choisissons Module de destination (dans notre cas, cela n'a pas d'importance car les noms de champs sont identiques) * Cliquez sur « Insérer et mapper les champs connus » * Vous verrez alors l'écran suivant 2. Browsing
   
   L'assistant a fait le travail, car il a automatiquement fait correspondre tous les champs. Néanmoins, vous pouvez/devez effectuer quelques adaptations ici * Supprimez les lignes que vous ne souhaitez pas importer * Modifiez le « Type de champ de destination » si nécessaire

   Soyez prudent lorsque vous utilisez des chiffres et que vous avez des connexions provenant de différents types de modules (par exemple, Excel - base de données, services web), car les applications ne fonctionnent pas toujours comme nous le souhaitons. L'utilisation de « varchar » est souvent le meilleur choix ! * Si vous êtes satisfait, vous pouvez cliquer sur « Actif », puis sur « Suivant ». 3. Overview

L'écran suivant vous donne simplement quelques informations sur la suite du processus. Cliquez simplement sur « Enregistrer » et le tour est joué. Si vous rouvrez ensuite les positions de l'étape, vous verrez une liste de 28 lignes...

Démarrage direct

Il est maintenant temps de démarrer le travail et d'importer les données. Revenez simplement à « Jobs » et sélectionnez à nouveau l'instance « conigon » sous « Directstart ». Dans ce cas, comme nous n'avons pas activé dryRun, votre client d'intégration importera toutes les données (pour toutes les positions activées) du fichier CSV vers la base de données. Une fois encore, vous serez informé dès que le processus sera terminé. Lorsque vous accédez à la surveillance, vous pouvez voir les résultats de l'importation

Dans notre cas, ADIB a importé 12 472 lignes en 28 secondes.