Introduction

L’Agent est la nouvelle version du ControlCenter.

Il est scindé en 2 parties. Une partie sous forme de service Windows qui doit être installé au plus près de la base de données. Une autre partie concerne le paramétrage : extraction de données, téléchargement, exécution de programmes.

Cette documentation ne traite pas l’installation technique de l’Agent mais se concentre sur le paramétrage dans le cadre du kit de connexion Divalto infinity.

Avantages de l’Agent :

• La configuration est intégrée à Divalto weavy Studio

• Transfert de fichier intégré sans paramétrage particulier

• Possibilité de faire des surcharges

• Un seul service Windows pour traiter plusieurs projets

Prérequis

Divalto weavy

• Environnement Master Divalto weavy V6.0 Summer’23 : masterVersion = 1.6.20230523

• Divalto weavy Studio à jour : version V 5.22.13.0 à ce jour

• Remote Agent à jour (il s’agit du service Windows de l’Agent) : version V 1.20.0.0 à ce jour

Divalto infinity

Les versions supportées sont :

• Divalto infinity 7.5e

• Divalto infinity 10.3

• Divalto infinity 10.4

• Divalto infinity 10.5

• Divalto infinity 10.6

• Divalto infinity 10.7

• Divalto infinity 10.8

• Divalto infinity 10.9

• Divalto infinity 10.10

Importation des interfaces

Si votre projet Divalto weavy est issu d'un Master infinity WINTER' 22 et ultérieures, il contient déjà une surcharge infinity ainsi que toutes les interfaces concernant l’Agent et son backend associé.

L'import est inutile, cependant il faudra tout de même les paramétrer.

Si ce n’est pas le cas il faut importer la configuration complète.

Pour se faire, à partir de Divalto weavy Studio, aller dans le menu « Configuration -> Importer la configuration » :

Open

Charger le package avec le bouton « Charger les données » et sélectionner le dossier « Surcharge\DIVINF » présent dans le kit.

Open

Divalto weavy va vérifier la compatibilité de votre projet avec ce package, et le cas échéant vous proposer de mettre à jour.

Les ajouts/modifications concernant l’Agent seront présents dans l’onglet « Agent ».

Par la même occasion si le nouveau backend « [KIT : Infinity / Agent] Import » lié à l’Agent n’est pas encore à jour, il va également être proposé dans l’interface.

Après avoir vérifié et acquitté vos éventuels conflits, appliquer la configuration avec le bouton « Appliquer la configuration ».

Les paramétrages de l’Agent concernant le kit de connexion Divalto infinity seront présentes dans la surcharge DIVINF. Des modifications pourront être apportées dans la surcharge FINAL.

Présentation générale de l’Agent

Dans le Studio Divalto weavy, onglet « Agent ».

1 - Listes des types d'actions paramétrées :

• Synchroniser un dossier avec le cloud

• Extraire des données

• Télécharger des fichiers depuis le cloud

• Envoyer des fichiers vers le cloud

• Exécuter un programme

2 - Scénarios : il s’agit des planifications à exécuter à intervalles réguliers

3 - Actions du scénario : actions à exécuter dans le scénario

4 - Sources de données : permet de définir l’accès à la base de données Divalto infinity

5 - Variables globales : permet d’initialiser des variables qui pourront être utilisées dans les extractions et les chemins

6 - Générer une version : permet la prise en compte par le service Windows de l’Agent de toutes les modifications effectuées dans le paramétrage

7 - DbExplorer : permet de tester des requêtes grâce à un requêteur intégré à l’Agent

8 - Journaux : accès aux logs de l’Agent

9 - Exporter : permet d’exporter la surcharge FINAL. Attention les préfixes des codes sont tous mis à FINAL dans le fichier exporté. Par exemple, DIVINF_SCENARIO1 deviendra dans le fichier d'export, FINAL_SCENARIO1

10 - Importer : permet d’importer le fichier qui a été exporté dans la surcharge FINAL

11 - Actualiser : permet de rafraichir l’onglet « Agent »

12 - Agent : indique le statut et la version de l’Agent qui est installé sur le serveur

• Pastille verte : le service Windows de l’Agent est opérationnel

• Pastille rouge : le service Windows de l’Agent est à l’arrêt

Paramétrage minimal pour utiliser l’Agent

Ci-dessous les paramétrages à effectuer dans le Studio lors de la mise en place d’un nouveau projet.

Le détail de ce paramétrage est décrit dans le chapitre #Mise-en-place-environnement-Agent

1. Se connecter au studio sur la surcharge FINAL

2. S’assurer que le service Windows de l’Agent est opérationnel

3. Déclarer votre source de données OLEDB pour accéder à Divalto infinity en modifiant la chaîne de connexion de « DIVINF_infinity »

4. Modifier votre variable projet « DIVINF_PROJECTCODE » avec votre code projet Divalto weavy

5. Modifier si nécessaire les variables chemins qui commencent par « DIVINF_DIRECTORY »

6. Modifier si nécessaire les variables pour les extractions de données

7. Paramétrer la planification des scénarios « Infinity / Kit de Connexion Export vx.y » selon votre version de Divalto infinity et « Infinity / Kit de Connexion Import »

8. Générer une version pour la prise en compte par le service Windows de l’Agent

9. Paramétrer les chemins dans le connecteur mobile dans Divalto infinity

Mise en place de l’environnement Agent

Structure des dossiers

La configuration de l’Agent fournie dans le kit de connexion Divalto infinity est paramétrée pour utiliser une certaine arborescence localement où il est installé.

Vous pouvez changer cet emplacement, mais cela nécessitera que vous repassiez sur la configuration des variables de chemins.

Dans l'installation du kit de connexion, vous disposez d'un dossier « Agent-Arborescence ». Les répertoires sont scindés en 2 parties pour différencier les données des outils.

Outils :

Copier le sous-répertoire « Weavy » sur votre lecteur C:\

Données :

Copier le sous-répertoire « Agent » sur votre lecteur D:\

Remplacer PROJET par le code de votre projet. Plusieurs projet Divalto weavy pourront être contenus dans le sous-répertoire « Agent », en conservant la même arborescence.

Service Windows de l’Agent

L’installation et la configuration du service Windows de l’Agent ne font pas l’objet de cette documentation.

Mais il s’agit d’un préalable avant de continuer le paramétrage dans le Studio.

Paramétrage de l’Agent

Sources de données

Permet de paramétrer l'accès à la base de données infinity.

Pour y accéder : dans l’onglet « Agent », bouton « Source de données ».

Par défaut nous utilisons une connexion de type “Infinity“ qui correspond à de l'OLEDB, qu’il faudra paramétrer en surcharge.

Paramètres :

myServerAddress : adresse du serveur SQL

myDataBase : nom de la base de données

myUsername : login de connexion

myPassword : mot de passe

Variables globales

Afin de rendre la configuration plus adaptable, nous avons utilisé des variables qui sont mises à jour globalement à un seul endroit..

Elles peuvent être utilisées dans les requêtes d’extractions de données et dans les différents chemins.

Pour définir encore plus facilement des chemins, on peut utiliser des variables dans des variables.

Pour y accéder : dans l’onglet « Agent », bouton « Variables globales ».

Les variables peuvent être modifiées en surcharge.

Variable pour le projet

Il s’agit d’une variable de base, qui est utilisée dans d’autres variables pour les chemins.

Variables pour les chemins

Ces variables sont remplacées à la volée lors de l’exécution des scénarios.

Elles commencent par « DIVINF_DIRECTORY » et sont à provisonner au démarrage du projet si nécessaire.

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.

Actions

Généralités

Barre d’outils :

Détails :

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

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

Convert To Dynamic Fields

• Sens : Divalto infinity → Divalto weavy

• Description : Conversion d'un fichier de définition des rubriques de Divalto infinity (par défaut dynamic_definition.csv) vers plusieurs fichiers schéma (.json) afin de créer les champs côté Divalto weavy

• Batch à exécuter :

  • Nom : ConvertToDynamicFields.cmd

  • Version : AG-20230523

• Programme :

  • Nom : ConvertToDynamicFields;exe

  • Version : 1.0.0.3

• Paramètres :

  • Chemin vers le dossier des outils : variable « DIVINF_DIRECTORY_TOOLS »

  • Chemin vers le dossier d'export : variable « DIVINF_DIRECTORY_EXPORT »

  • Chemin vers le dossier de travail : variable « DIVINF_DIRECTORY_WORKINGDIR »

Convert From Dynamic Fields

• Sens : Divalto weavy -> Divalto infinity

• Description : Conversion de plusieurs fichiers xxxx_dynamicfields.txt contenant les valeurs des rubriques vers un fichier DynamicFieldValue.txt interprétable par Divalto infinity

• Batch à exécuter :

  • Nom : ConvertFromDynamicFields.cmd

  • Version : AG-20230523

• Programme :

  • Nom : ConvertToDynamicFields;exe

  • Version : 1.0.0.3

• Paramètres :

  • Chemin vers le dossier des outils : variable « DIVINF_DIRECTORY_TOOLS »

  • Code société : variable « DIVINF_SOCID »

  • Chemin vers le dossier d'import : variable « DIVINF_DIRECTORY_IMPORT »

Convert RTF To TXT/HTML

• Sens : Divalto infinity -> Divalto weavy

• Description : Conversion d'une colonne dans un fichier de RTF vers TXT/HTML

• Batch à exécuter :

  • Nom : ConvertRTF.cmd

  • Version : AG-20230523

• Programme :

  • Nom : Convert.exe

  • Version : 1.0.0.0

• Paramètres :

  • Chemin vers le dossier des outils : variable « DIVINF_DIRECTORY_TOOLS »

  • Chemin vers le dossier d'export : variable « DIVINF_DIRECTORY_EXPORT »

  • Indique que l'on gère la conversion vers l'html en mettant -html ou -basichtml (html simplifié) : -basichtml par défaut

Convert TXT/HTML To RTF

• Sens : Divalto weavy -> Divalto infinity

• Description : Conversion d'une colonne dans un fichier de TXT/HTML vers RTF

• Batch à exécuter :

  • Nom : ConvertRTFRetour.cmd

  • Version : AG-20230523

• Programme :

  • Nom : Convert.exe

  • Version : 1.0.0.0

• Paramètres :

  • Chemin vers le dossier des outils : variable « DIVINF_DIRECTORY_TOOLS »

  • Chemin vers le dossier d’import : variable « DIVINF_DIRECTORY_IMPORT »

Convert To DataHub

• Sens : Divalto weavy -> Divalto infinity

• Description : Conversion d'un fichier des temps (.txt) vers le format Datahub (.dhub)

• Batch à exécuter :

  • Nom : ConvertDataHub.cmd

  • Version : AG-20230523

• Programme :

  • Nom : ConvertForDataHub.exe

  • Version : 1.0.0.1

• Paramètres :

  • Chemin vers le dossier des outils : variable « DIVINF_DIRECTORY_TOOLS »

  • Chemin vers le dossier d’import : variable « DIVINF_DIRECTORY_IMPORT »

  • Chemin vers le dossier de destination des fichiers DataHub : variable « DIVINF_DIRECTORY_DATAHUB »

Flag Scrutateur Infinity

• Sens : Divalto weavy -> Divalto infinity

• Description : Génération d’un fichier « ExportFinished.flag » (dans %DIVINF_DIRECTORY_IMPORT%\ProcessStatus) pour dire au scrutateur mobile Divalto infinity qu’il y a des fichiers à intégrer

• Batch à exécuter :

  • Nom : ScrutateurInfinity.cmd

  • Version : AG-20230523

• Programme : /

• Paramètres :

  • Chemin vers le dossier d’import : variable « DIVINF_DIRECTORY_IMPORT »

Synchroniser un dossier avec le cloud

Permet de synchroniser des fichiers, images, … vers le cloud Divalto weavy afin qu’ils puissent être intégrés par le backend « [KIT : Infinity / Agent] Import ».

Dans le cadre du kit on retient les règles suivantes :

• Libellé : libellé de la synchronisation

• Tag : permet de faire un regroupement

• Actif : à cocher/décocher selon que l’on veut activer/désactiver une synchronisation

• Type de source : « Liste de fichiers »

• Chemin du dossier source : liste des fichiers définis dans « DocumentFileListe.csv » dans le chemin défini dans la variable « DIVINF_DIRECTORY_WORKINGDIR »

• Dossier de réception sur le serveur : dossier d’import des images dans le cloud Divalto weavy (généralement « Document »)

• Supprimer du serveur les fichiers qui n’existent plus : permet de supprimer les éventuels fichiers obsolètes qui sont encore sur le serveur

Envoyer des fichiers vers le cloud

Permet d’envoyer des fichiers de données (.csv, .json) vers le cloud Divalto weavy afin qu’ils puissent être intégrés par le backend « [KIT : Infinity / Agent] Import ».

Dans le cadre du kit on retient les règles suivantes :

• Libellé : libellé de l’upload

• Tag : permet de faire un regroupement par upload

• Actif : à cocher/décocher selon que l’on veut activer/désactiver un upload

• Type de source : « Dossier »

• Chemin du dossier source : chemin défini dans la variable « DIVINF_DIRECTORY_EXPORT »

• Dossier de réception sur le serveur : dossier d’import des fichiers dans le cloud Divalto weavy (généralement « Backend_Import »)

• Filtres de fichiers : on prend les fichiers .csv (fichiers de données) et .json (fichiers schémas des champs dynamiques)

• Automate Backend à exécuter après l’upload des fichiers : backend qui sera exécuté automatiquement à la fin de l’upload (« [KIT : Infinity / Agent] Import »)

• Action à exécuter après l’upload d’un fichier vers le serveur : les fichiers envoyés seront sauvegardés dans « %DIVINF_DIRECTORY_EXPORT%\executed »

Télécharger des fichiers depuis le cloud

Permet de télécharger des fichiers depuis le cloud Divalto weavy afin qu’ils puissent êtres intégrés par le scrutateur mobile Divalto infinity.

Dans le cadre du kit on retient les règles suivantes :

• 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

Généralités

Barre d’outils :

Détails :

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 ».

Pour faciliter le paramétrage, nous proposons un ensemble de scénarios prédéfinis par rapport à la version de Divalto infinity à interfacer.

Il est à noter que les scénarios pour les versions 10.6 et 10.8 de Divalto infinity ne sont pas proposées car il s’agissait de versions temporaires d’une durée de vie maximale de 1 an et qui sont donc obsolètes aujourd’hui.

Par défaut aucun scénario n’est actif. Il faudra donc paramétrer une périodicité ou des horaires fixes selon votre besoin puis activer un seul scénario d’export.

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.

Une éventuelle action inactive présente dans un scénario ne sera évidement pas exécutée (elle apparaît en grisée).

Infinity / Kit de Connexion Import

Ce scénario correspond au flux Divalto weavy → Divalto infinity. Il permet de transmettre les données de la base de données Divalto weavy extraits par l’automate des Events « [Infinity] Export » (sous forme de fichiers .txt) au scrutateur mobile Divalto infinity.

Le paramétrage de la périodicité ou des horaires fixes du scénario devra donc être couplé à cet automate des Events « [Infinity] Export » afin que les enchainements dans le temps soit bien exécutés dans le bon ordre.

Penser également à activer le scénario.

Dans le scénario seront associés toutes les actions à exécuter.

Backend dédié à l’Agent

Un nouveau backend « [KIT : Infinity / Agent] Import » a été mis en place. Il sera a exécuter exclusivement par l’Agent.

Nouveautés par rapport au backend lié au ControlCenter :

• Renumérotation pour une meilleure lisibilité

• Prise en compte de l’horodatage de l’Agent (pour rappel sous la forme : YYYYMMDD_hhmmss_xxxxx.csv)

• La description a été documentée avec l’action de l’Agent qui a généré le fichier à prendre en compte

Paramétrage du connecteur mobile Divalto infinity

Pour la prise en compte des nouveaux chemins définis dans l’Agent, il faut configurer en ce sens le connecteur mobile de Divalto infinity.

En étant connecté à Divalto infinity, sur votre dossier, aller dans « Administration » → « Mobilité » → « Paramétrage mobilité » → « Synchronisation infinity Mobile » puis onglet « Mobile → Infinity ».

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)

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.

On voit également les nouvelles versions du paramétrage qui ont été générées et prises en compte.

Remarque :

Il faut bien distinguer les erreurs volontaires, des autres erreurs.

Dans l’extrait ci-dessous on peut voir une erreur lors du téléchargement de fichiers depuis le cloud Divalto weavy.

Cette erreur est volontaire car on ne veut pas continuer les autres actions s’il n’y a pas de fichier à télécharger.

Paramétrage de l’action :

Opérateur

L’outil « Operator » intégré au Studio permet de reprendre des configurations personnalisées d’une base à une autre.

Trois options sont disponibles concernant l’Agent.

Copier la configuration de l’agent : coché par défaut

En complément :

Copier les variables : décoché par défaut. Attention les variables peuvent être différentes entre un projet de développement et un projet en production (pensez à la variable « DIVINF_PROJECTCODE » qui contient le code projet).

Copier les scénarios : décoché par défaut. Attention les scénarios peuvent être différentes entre un projet de développement et un projet en production, notamment les horaires d’exécution.