Sync Agent (Cluster)

De Wiki1000

(Différences entre les versions)

Version actuelle en date du 20 novembre 2019 à 10:32

Sommaire

1 Principe général
2 Sens SI vers Sage FRP 1000
- 2.1 Paramètres de l'agent
- 2.2 Message transmis par l'agent
3 Sens Sage FRP 1000 vers SI
4 Paramétrer l'agent de synchronisation
- 4.1 Paramétrer les comptes
  - 4.1.1 Utilisation d'une file d'attente Azure
  - 4.1.2 Utilisation d'une file d'attente Sage FRP 1000
- 4.2 Paramétrer les agents
  - 4.2.1 Agent d'export
  - 4.2.2 Agent d'import

Principe général

L'agent de synchronisation est un service permettant de simplifier l'intégration entre le système d'information du client (SI) et le compte Azure où est déployée la solution Sage FRP 1000.

L'agent de synchronisation s'installe sur une machine du SI du client
Il communique avec le compte Azure de la solution Sage FRP 1000.
Il permet de transférer des fichiers déposé dans des répertoire du SI vers des files d'attente Azure à destination de Sage FRP 1000 (sens import)
Il permet de surveiller des files d'attente Azure et de récupérer les fichiers mis à disposition par Sage FRP 1000 (sens export)

Sens SI vers Sage FRP 1000

Un fichier est déposé sur un répertoire surveillé par L'Agent de synchronisation. (1)
L'Agent de synchronisation détecte le fichier (2) et le transmet vers une file d'attente (3)
L'Agent de synchronisation archive le fichier (2) dans un répertoire de sauvegarde.
Le message posté dans la file d'attente est configuré par la configuration de l'Agent de synchronisation
Un automate Sage FRP 1000 consomme le message (4), en fonction du type du message il effectue un traitement sur le fichier de données.

Paramètres de l'agent

Si l'agent alimente une queue scrutée par une tâche de consommation de l'automate, les paramètres permettent :

d'instancier un processus et d’appeler une méthode
d'utiliser un import par descriptif
d'utiliser un import par format

Message transmis par l'agent

Le message de traitement est utilisé pour déclencher un traitement métier.

Tip : Vous pouvez utiliser le SyncAgent pour poster ce type de message dans une file d'attente

Paramètres communs

Paramètre	Utilisation
message.action	Type d'action
message.accessToken	Jeton d'authentification
message.share.mode	Mode de gestion du partage loop loop_all merge merge_all auto
message.share.society.names	Liste de sociétés (Noms) à traiter lorsque le mode de gestion est enchaîner.
message.share.societies	Liste de sociétés (OIDs) à traiter lorsque le mode de gestion est enchaîner.

Le type de l'action réalisée doit être contenu dans le paramètre "message.action"

Action	Géré par l'interface	Usage
print	Exécution des impressions	Exécution d'une impression
preview	Exécution des apperçus	Exécution d'un aperçu
import		Exécution d'un import (format ou descriptif)
export		Exécution d'un export
importformat		Import en utilisant un format
importdip		Import en utilisant un descriptif
delete		Execution de la suppression d'un objet
planification	Exécution des planifications	Exécution d'une planification
event	Enchainement des planifications	Execution des tâches en attente de cet évènement
processus		Execution d'une méthode d'une classe processus
process	Exécution différé d'un processus	Exécution d'un process métier d'automate
task		Exécution d'une tâche métier
admin		Exécution d'une tâche d'administration
test

Exemple:

Configuration du SyncAgent pour poster un message d'import d'écriture multi-société :

[\PARAMETER_IMPORT_ECRITURES]
message.action=processus
message.share.mode=loop
message.share.society.names=S1,S2,S3
processus.className=TProcessusImportEcritureFA
processus.methodName=ExecuterAutomate
processus.parameters.className=TParametreImportEcriture
processus.parameters.code=Import multi-societe
message.accessToken=100000009....

Voir aussi:

Gestion des tâches
Tâche d'automate de consommation de file d'attente
SyncAgent

Sens Sage FRP 1000 vers SI

Un automate Sage FRP 1000 effectue un traitement générant un fichier à destination du SI. (1)
La tâche de traitement poste le fichier généré sur une file d'attente Azure (2)
L'Agent de synchronisation surveille cette file d'attente (polling), il détecte le message te le consomme (3)
En fonction du contenu du message et de sa configuration l'Agent de synchronisation stocke le fichier dans un répertoire du SI. (4)

Paramétrer l'agent de synchronisation

L'installation de l'agent de synchronisation comprend deux exécutables

syncagent.exe qui est un service windows, et qui va procéder à la synchronisation
syncagentgui.exe qui permet le paramétrage

Paramétrer les comptes

Utilisation d'une file d'attente Azure

il faut renseigner le compte Azure, la clef publique et le nom de la file d'attente.

Tip : La file d'attente sera créée si elle n'existe pas.

Utilisation d'une file d'attente Sage FRP 1000

il faut renseigner le nom de l'hôte Sage FRP 1000, le nom du service FRP 1000 et le nom de la file d'attente.

La liste des files d'attente est obtenue du service

Attention : Le jeton d'authentification est obligatoire. Il est différent de celui nécessaire dans les paramètres de l'agent

Tip : La file d'attente doit exister.

Paramétrer les agents

On distingue deux types d'agent

L’agent d’export transfère des fichiers depuis un répertoire vers une file d’attente
L’agent d’import transfère des fichiers depuis une file d’attente vers un répertoire

Agent d'export

Les paramètres sont des paires "clefs/valeurs" qui sont associés au fichier envoyé dans la file d'attente.

Ces paramètres sont utilisés par l'automate pour traiter le fichier envoyé.

Agent d'import

Attention : Ne pas utiliser les mêmes répertoires que pour les agents d'export

@@ Ligne 2 : / Ligne 2 : @@
 ===Principe général===
-L'agent de synchronisation est un service permettant de simplifier l'intégration entre le système d'information du client (SI) et le compte Azure où est déployée la solution 1000 (Sage 1000 Azure).
+L'agent de synchronisation est un service permettant de simplifier l'intégration entre le système d'information du client (SI) et le compte Azure où est déployée la solution Sage FRP 1000.
-[[image:Architecture-syncagent.png]]
+[[image:Architecture-syncagent.png|800px]]
 * L'agent de synchronisation s'installe sur une machine du SI du client
-* Il communique avec le compte Azure de la solution Sage 1000.
+* Il communique avec le compte Azure de la solution Sage FRP 1000.
-* Il permet de transférer des fichiers déposé dans des répertoire du SI vers des files d'attente Azure à destination de Sage 1000 (sens import)
+* Il permet de transférer des fichiers déposé dans des répertoire du SI vers des files d'attente Azure à destination de Sage FRP 1000 (sens import)
-* Il permet de surveiller des files d'attente Azure et de récupérer les fichiers mis à disposition par Sage 1000 (sens export)
+* Il permet de surveiller des files d'attente Azure et de récupérer les fichiers mis à disposition par Sage FRP 1000 (sens export)
-===Sens SI vers Sage 1000 Azure===
+===Sens SI vers Sage FRP 1000===
 * Un fichier est déposé sur un répertoire surveillé par L'Agent de synchronisation. (1)
 * L'Agent de synchronisation détecte le fichier (2) et le transmet vers une file d'attente (3)
 * L'Agent de synchronisation archive le fichier (2) dans un répertoire de sauvegarde.
 * Le message posté dans la file d'attente est configuré par la configuration de l'Agent de synchronisation
-* Un automate Sage 1000 consomme le message (4), en fonction du type du message il effectue un traitement sur le fichier de données.
+* Un automate Sage FRP 1000 consomme le message (4), en fonction du type du message il effectue un traitement sur le fichier de données.
 ====Paramètres de l'agent====
@@ Ligne 28 : / Ligne 28 : @@
 {{:Message_de_traitement_(file_d'attente)}}
-===Sens Sage 1000 Azure vers SI===
+===Sens Sage FRP 1000 vers SI===
-* Un automate Sage 1000 effectue un traitement générant un fichier à destination du SI. (1)
+* Un automate Sage FRP 1000 effectue un traitement générant un fichier à destination du SI. (1)
 * La tâche de traitement poste le fichier généré sur une file d'attente Azure (2)
 * L'Agent de synchronisation surveille cette file d'attente (polling), il détecte le message te le consomme (3)
@@ Ligne 41 : / Ligne 41 : @@
 ====Paramétrer les comptes====
-=====Compte Azure=====
+=====Utilisation d'une file d'attente Azure=====
 il faut renseigner le compte Azure, la clef publique et le nom de la file d'attente.
 {{tip|La file d'attente sera créée si elle n'existe pas.}}
-[[image:Syncagent-paramazure.png]]
+[[image:Syncagent-paramazure.png|800px]]
-=====Compte Sage 1000=====
+=====Utilisation d'une file d'attente Sage FRP 1000=====
-il faut renseigner le nom de l'hôte Sage 1000, le nom du service 1000 et le nom de la file d'attente.
+il faut renseigner le nom de l'hôte Sage FRP 1000, le nom du service FRP 1000 et le nom de la file d'attente.
 La liste des files d'attente est obtenue du service
+{{warning|Le jeton d'authentification est obligatoire. Il est différent de celui nécessaire dans les paramètres de l'agent}}
-[[image:Syncagent-paramsage1000.png]]
+[[image:Syncagent-paramsage1000.png|800px]]
 {{tip|La file d'attente doit exister.}}
-[[image:Syncagent-paramfileattente.png]]
+[[image:Syncagent-paramfileattente.png|800px]]
 ====Paramétrer les agents====
@@ Ligne 74 : / Ligne 76 : @@
 [[Category:Cluster]]
+[[Category:SyncAgent]]
 [[Category:Version700]]