| Sommaire |
|---|
Introduction
...
Environnement Master Divalto weavy V5.7 Winter’22 : masterVersion = 1.5.20221122
Divalto weavy Studio à jour : version V 5.2021.100.0 à ce jour
Remote Agent à jour (il s’agit du service Windows de l’Agent) : version V 1.516.94.0 à ce jour
Divalto infinity
...
Le détail de ce paramétrage est décrit dans le chapitre #Mise-en-place-environnement-Agent
Se connecter au studio sur la surcharge FINAL
S’assurer que le service Windows de l’Agent est opérationnel
Déclarer votre source de données OLEDB pour accéder à Divalto infinity en modifiant la chaîne de connexion de « DIVINF_infinity »
Modifier votre variable projet « DIVINF_PROJECTCODE » avec votre code projet Divalto weavy
Modifier si nécessaire les variables chemins qui commencent par « DIVINF_DIRECTORY »
Modifier si nécessaire les variables pour les extractions de données
Paramétrer la planification des scénarios « Infinity / Kit de Connexion Export » et « Infinity / Kit de Connexion Import »
Générer une version pour la prise en compte par le service Windows de l’Agent
Paramétrer les chemins dans le connecteur mobile dans Divalto infinity
...
Paramétrage de l’Agent
| Remarque |
|---|
Quand toutes les modifications ont été effectuées, ne pas oublier de générer une version pour la prise en compte par le service Windows de l’Agent. |
Sources de données
Permet de paramétrer l'accès à la base de données infinity.
...
myPassword : mot de passe
| Remarque |
|---|
En mode SaaS, la source de données est géré directement sur le serveur. Toute modification dans le Studio ne sera pas prise en compte. |
Variables globales
Afin de rendre la configuration plus adaptable, nous avons utilisé des variables qui sont mises à jour globalement à un seul endroit..
...
Nom | Description | Valeur par défaut |
|---|---|---|
DIVINF_DIRECTORY_DATAHUB | Répertoire de destination des fichiers pour le scrutateur datahub (weavy → infinity) | C:\Divalto\Interfaces\DataHub |
DIVINF_DIRECTORY_EXPORT | Répertoire de destination des fichiers exportés (infinity → weavy) Utilisation de la sous-variable « DIVINF_PROJECTCODE » dans la variable | D:\Agent\%DIVINF_PROJECTCODE%\Export |
DIVINF_DIRECTORY_IMPORT | Répertoire de destination des fichiers importés (weavy → infinity) Utilisation de la sous-variable « DIVINF_PROJECTCODE » dans la variable | D:\Agent\%DIVINF_PROJECTCODE%\Import |
DIVINF_DIRECTORY_SCRUTATEUR | Répertoire vers le cmd de création du fichier flag “ExportFinished.flag” | C:\Weavy\Agent |
DIVINF_DIRECTORY_TOOLS | Répertoire vers les cmd des outils de transformation : DataHub, RTF, DynamicFields | C:\Weavy\Agent\Tools |
DIVINF_DIRECTORY_WORKINGDIR | Répertoire de travail Utilisation de la sous-variable « DIVINF_PROJECTCODE » dans la variable | D:\Agent\%DIVINF_PROJECTCODE%\WorkingDir |
...
| Remarque |
|---|
En mode SaaS, les variables pour les |
...
chemins sont gérées directement sur le serveur. Toute modification dans le Studio ne sera pas prise en compte. |
Variables pour les extractions de données
Ces variables sont remplacées à la volée lors de l'exécution, ou lors d'une prévisualisation dans le requêteur de base de données.
Nom | Description | Valeur par défaut |
|---|---|---|
DIVINF_DECODING_NAME | Décodage Nom/Prénom des collaborateurs selon valeurs :
| PrenomNom |
DIVINF_ETB | Code établissement à exporter | '' |
DIVINF_FAMID | Famille statistiques à utiliser (1, 2 ou 3) | 1 |
DIVINF_HISTORY_DELIVERY_MONTH | Période d'historique des bons de livraisons à exporter (en mois) | 36 |
DIVINF_HISTORY_INVOICE_MONTH | Période d'historique des factures à exporter (en mois) | 36 |
DIVINF_HISTORY_ORDER_MONTH | Période d'historique des commandes à exporter (en mois) | 36 |
DIVINF_HISTORY_QUOTE_MONTH | Période d'historique des devis à exporter (en mois) | 36 |
DIVINF_HISTORY_STATISTIC_MONTH | Période d’historique des statistiques à exporter (en mois) | 36 |
DIVINF_NBEVENT | Nombre d'évènements par tiers | 10 |
DIVINF_PATHCUSTDOCUMENT | Chemin des fichiers joints Clients (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PATHDEALDOCUMENT | Chemin des fichiers joints Affaires (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PATHEVENTDOCUMENT | Chemin des fichiers joints Evénements (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PATHPRODOCUMENT | Chemin des fichiers joints Prospects (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PATHPRODUCTDOCUMENT | Chemin des fichiers joints Articles (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PATHPROJECTDOCUMENT | Chemin des fichiers joints Projets (si non présent dans MJOINT) | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_PICTUREPATH | Chemin des images | C:\divalto\ERP218\Fichiers\ficjoints |
DIVINF_SOCID | Code dossier à exporter | 998 |
Actions
Extraire des données
Permet de paramétrer les requêtes d’extractions de Divalto infinity vers Divalto weavy.
Exemple :
...
Dans le cadre du kit on retient les règles suivantes :
Libellé : commence par une numérotation pour trier correctement les extractions
Tag : permet de faire un regroupement par module
Actif : à cocher/décocher selon que l’on veut activer/désactiver une extraction
Source de données : utiliser « Divalto infinity »
Dossier de sortie : utilisation de la variable « DIVINF_DIRECTORY_EXPORT »
Fichier de sortie : fichier xxxx.csv à générer qui sera intégré par backend
Définition de la clé d’unicité : les fichiers générés sont en mode différentiel avec horodatage (sauf cas exceptionnel). Il faut donc définir une clé unique de l’extraction. La plupart du temps la 1ere colonne de la requête est la clé unique, d’où la valeur 0. Si par exemple, les deux premières colonnes de la requête constituent la clé unique alors il faudra mettre : 0 + 1.
Requête d’extraction : correspond à la requête exécutée sur la base de donnée Divalto infinity. Des variables peuvent être utilisées dans la requête.
Pour tester la requête : bouton « Tester » (test syntaxique rapide) ou « DbExplorer » (correspond à un explorateur SQL)
| Info |
|---|
Les fichiers en sortie seront automatiquement horodatés (sauf cas exceptionnels) sous la forme YYYYMMDD_hhmmss_xxxxx.csv Exemple : 20220520_113011_countries.csv |
Exécuter un programme
Permet d’appeler des outils externes.
Exemple :
...
Dans le cadre du kit on retient les règles suivantes :
...
Libellé : libellé du programme
...
Tag : permet de faire un regroupement par programme
...
Actif : à cocher/décocher selon que l’on veut activer/désactiver un programme
...
Programme à exécuter : fichier de commande xxx.cmd à exécuter
...
Généralités
Barre d’outils :
...
Détails :
 | Ajouter une nouvelle action en sélectionnant son type |
 | Editer une action |
 | Dupliquer une action |
 | Supprimer une action |
| Vider le cache des actions sélectionnées Permet de réinitialiser le mode différentiel pour repartir d’un export complet |
| Permet de visualiser l’historique d’exécution d’une action sur une période. |
 | Permet de filtrer l’affichage des actions |
Extraire des données
Permet de paramétrer les requêtes d’extractions de Divalto infinity vers Divalto weavy.
Exemple :
...
Dans le cadre du kit on retient les règles suivantes :
Libellé : commence par une numérotation pour trier correctement les extractions
Tag : permet de faire un regroupement par module
Actif : à cocher/décocher selon que l’on veut activer/désactiver une extraction
Source de données : utiliser « Divalto infinity »
Dossier de sortie : utilisation de la variable « DIVINF_DIRECTORY_EXPORT »
Fichier de sortie : fichier xxxx.csv à générer qui sera intégré par backend
Définition de la clé d’unicité : les fichiers générés sont en mode différentiel avec horodatage (sauf cas exceptionnel). Il faut donc définir une clé unique de l’extraction. La plupart du temps la 1ere colonne de la requête est la clé unique, d’où la valeur 0. Si par exemple, les deux premières colonnes de la requête constituent la clé unique alors il faudra mettre : 0 + 1.
Requête d’extraction : correspond à la requête exécutée sur la base de donnée Divalto infinity. Des variables peuvent être utilisées dans la requête.
Pour tester la requête : bouton « Tester » (test syntaxique rapide) ou « DbExplorer » (correspond à un explorateur SQL)
Vider le cache : permet de réinitialiser le mode différentiel pour repartir d’un export complet
| Info |
|---|
Les fichiers en sortie seront automatiquement horodatés (sauf cas exceptionnels) sous la forme YYYYMMDD_hhmmss_xxxxx.csv Exemple : 20220520_113011_countries.csv |
Exécuter un programme
Permet d’appeler des outils externes.
Exemple :
...
Dans le cadre du kit on retient les règles suivantes :
Libellé : libellé du programme
Tag : permet de faire un regroupement par programme
Actif : à cocher/décocher selon que l’on veut activer/désactiver un programme
Programme à exécuter : fichier de commande xxx.cmd à exécuter
Paramètres : paramètres à passer au programme, séparés par un espace
...
Libellé : libellé du téléchargement
Tag : permet de faire un regroupement par téléchargement
Actif : à cocher/décocher selon que l’on veut activer/désactiver un téléchargement
Arrêter le scénario en cas d’erreur : coché, car si le téléchargement des fichiers échoue, on ne veut pas continuer les autres traitements
Arrêter le scénario en cas de non exécution de l’action : coché, car s’il n’y a aucun fichier à télécharger, on ne veut pas continuer les autres traitements
Dossier source sur le serveur : dossier d’export des fichiers dans le cloud Divalto weavy (généralement « Backend_Export »)
Dossier de téléchargement : chemin défini dans la variable « DIVINF_DIRECTORY_IMPORT »
Action à exécuter si le fichier existe déjà dans le dossier de téléchargement : Ne rien faire, car on ne veut pas écraser les éventuels fichiers existants
Action à exécuter après le téléchargement d’un fichier : les fichiers envoyés seront sauvegardés dans « Backend_Export\executed »
Exécuter uniquement si le dossier téléchargement est vide : coché, pour ne pas écraser les éventuels fichiers existants
Scénarios
Infinity / Kit de Connexion Export
Ce scénario correspond au flux Divalto infinity → Divalto weavy. Il permet d’extraire les données de la base de données Divalto infinity (sous forme de fichier .csv) et les intégrer dans Divalto weavy via le backend « [KIT : Infinity / Agent] Import ».
Par défaut le scénario n’est pas actif. Il faudra donc paramétrer une périodicité ou des horaires fixes selon votre besoin puis l’activer.
Nous préconisons de le lancer en dehors des heures de fort travail sur vos applications : (par exemple à 13:00 et/ou 22:00).
...
Généralités
Barre d’outils :
...
Détails :
 | Ajouter un nouveau scénario |
 | Editer un scénario |
 | Dupliquer un scénario |
 | Supprimer un scénario |
  | Vider le cache des actions sélectionnées pour un scénario Permet de réinitialiser le mode différentiel pour repartir d’un export complet |
| Permet d’exécuter un scénario manuellement Possibilité de générer une nouvelle version pour la prise en compte des éventuelles modifications |
Infinity / Kit de Connexion Export
Ce scénario correspond au flux Divalto infinity → Divalto weavy. Il permet d’extraire les données de la base de données Divalto infinity (sous forme de fichier .csv) et les intégrer dans Divalto weavy via le backend « [KIT : Infinity / Agent] Import ».
Par défaut le scénario n’est pas actif. Il faudra donc paramétrer une périodicité ou des horaires fixes selon votre besoin puis l’activer.
Nous préconisons de le lancer en dehors des heures de fort travail sur vos applications : (par exemple à 13:00 et/ou 22:00).
...
Dans le scénario seront associés toutes les actions à exécuter.
...
Dans « Chemin », renseigner le code du chemin qui va pointer vers le chemin où se trouve les données à intégrer (F9 pour accéder au zoom).
Si installation standard, il s’agit de : D:\Agent\PROJET\Import\ (remplacer PROJET par le code projet Divalto weavy)
Dans « Fichiers joints issus du front », renseigner le code du chemin qui va pointer vers le chemin ou se trouve les fichiers joints à intégrer (F9 pour accéder au zoom).
Si installation standard, il s’agit de : D:\Agent\PROJET\Import\FileExport\ (remplacer PROJET par le code projet Divalto weavy)
...
.
Si installation standard, il s’agit de : D:\Agent\PROJET\Import\ (remplacer PROJET par le code projet Divalto weavy)
Dans « Fichiers joints issus du front », renseigner le code du chemin qui va pointer vers le chemin ou se trouve les fichiers joints à intégrer (F9 pour accéder au zoom).
Si installation standard, il s’agit de : D:\Agent\PROJET\Import\FileExport\ (remplacer PROJET par le code projet Divalto weavy)
Statut
Des informations sur les versions déployées sont disponibles via le bouton « Agent Status ».
Si une version a été générée et qu’elle n’est pas encore prise en compte par l’Agent, il y aura un décalage entre la configuration disponible (ici : 601) et la configuration actuelle de l’agent (ici : 600).
...
Après prise en compte par l’agent, la version est en phase entre la configuration disponible et la configuration actuelle de l’agent (ici : 601 pour les deux)
...
Le client de l’agent correspond au service Windows (Remote Agent) qui tourne sur le serveur.
Journaux
Résumé
Un petit résumé des dernières actions manuelles réalisées est affiché dans la partie inférieure de Divalto weavy Studio.
...
Logs
Un journal des logs détaillé est accessible via le bouton « Journaux distants ».
Il permet de voir le détail de chaque scénario et de chaque action qui ont été exécutés.
...