Sync Agent (Cluster)

De Wiki1000
(Différences entre les versions)
(→Paramétrer les agents)
(→Principe général)
 
(12 révisions intermédiaires par 3 utilisateurs sont masquées)
Ligne 1 : Ligne 1 :
 +
{{new|700}}
 +
 
===Principe général===
 
===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  
 
* 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)
 
* 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 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.
 
* 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
 
* 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====
 
====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 :  
 
Si l'agent alimente une queue scrutée par une tâche de consommation de l'automate, les paramètres permettent :  
  
Ligne 25 : Ligne 26 :
  
 
====Message transmis par l'agent====
 
====Message transmis par l'agent====
−
 
 
{{:Message_de_traitement_(file_d'attente)}}
 
{{:Message_de_traitement_(file_d'attente)}}
  
−
 
+
===Sens Sage FRP 1000 vers SI===
−
===Sens Sage 1000 Azure vers SI===
+
* Un automate Sage FRP 1000 effectue un traitement générant un fichier à destination du SI. (1)
−
* Un automate Sage 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)
 
* 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)
 
* L'Agent de synchronisation surveille cette file d'attente (polling), il détecte le message te le consomme (3)
Ligne 36 : Ligne 35 :
  
 
===Paramétrer l'agent de synchronisation===
 
===Paramétrer l'agent de synchronisation===
−
 
 
L'installation de l'agent de synchronisation comprend deux exécutables
 
L'installation de l'agent de synchronisation comprend deux exécutables
  
Ligne 43 : Ligne 41 :
  
 
====Paramétrer les comptes====
 
====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.
 
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.}}
 
{{tip|La file d'attente sera créée si elle n'existe pas.}}
  
−
[[image:Syncagent-paramazure.png]]
+
[[image:Syncagent-paramazure.png|800px]]
 +
 
 +
=====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
 +
 
 +
{{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|800px]]
  
−
=====Compte Sage 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.
 
−
{{tip|Ce type de compte est utilisable uniquement pour un agent d'export.}}
 
 
{{tip|La file d'attente doit exister.}}
 
{{tip|La file d'attente doit exister.}}
  
−
[[image:Syncagent-paramsage1000.png]]
+
[[image:Syncagent-paramfileattente.png|800px]]
−
 
+
−
[[image:Syncagent-paramfileattente.png]]
+
  
 
====Paramétrer les agents====
 
====Paramétrer les agents====
−
 
 
On distingue deux types d'agent
 
On distingue deux types d'agent
  
Ligne 66 : Ligne 68 :
  
 
=====Agent d'export=====
 
=====Agent d'export=====
−
 
 
Les paramètres sont des paires "clefs/valeurs" qui sont associés au fichier envoyé dans la file d'attente.
 
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é.
 
Ces paramètres sont utilisés par l'automate pour traiter le fichier envoyé.
−
 
  
 
=====Agent d'import=====
 
=====Agent d'import=====
 +
{{warning|Ne pas utiliser les mêmes répertoires que pour les agents d'export}}
  
−
{{warning|Prendre de ne pas utiliser les mêmes répertoires que pour les agent d'export}}
+
[[Category:Cluster]]
−
 
+
[[Category:SyncAgent]]
−
 
+
[[Category:Version700]]
−
 
+
−
 
+
−
[[Category:Azure]]
+

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

version700-48x48.png

Sommaire

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.

Architecture-syncagent.png

  • 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-20px.png 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:

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-20px.png Tip : La file d'attente sera créée si elle n'existe pas.

Syncagent-paramazure.png

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

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

Syncagent-paramsage1000.png

Tip-20px.png Tip : La file d'attente doit exister.

Syncagent-paramfileattente.png

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
Exclam-20px.png Attention : Ne pas utiliser les mêmes répertoires que pour les agents d'export
Récupérée de « https://frp.sage.fr/wiki1000/index.php?title=Sync_Agent_(Cluster)&oldid=12938 »
Outils personnels