toolsyncuserguide

This is an old revision of the document!


Outil de synchronisation de données par fichier CSV

Ecrans fonctionnels

Rapports

Toutes les opérations donnent lieu à la génération d'un rapport qui sera stocké dans le répertoire “Reports” du gestionnaire de fichiers local de l'outil de synchronisation. Les rapports sont nommé selon l'opération déclenchée et horodatés à la date de leur écriture.

La génération des rapports peut être désactivée dans les paramètre globaux

Archivage

L'administrateur peut demander l'archivage automatique de tous les fichiers traités. Ces fichiers seront alors déplacés dans le répertoire “Archives” du gestionnaire de fichiers local de l'outil de synchronisation.

Trybacks

Les fichiers de “tryback” sont des fichiers constitués à partir des lignes originales de fichiers de commande qui n'ont pu être traitées avec succès. Le fichier généré reproduit la même ligne d'en-tête que le fichier original, de façon à pouvoir être réutilisé pour terminer le traitement une fois les problèmes identifiés et résolus.

La génération des fichiers de “tryback” peut être désactivé dans les paramètres centraux.

Alimentation externe en fichiers de commande

L'opérateur peut utiliser le gestionnaire de fichiers local de l'outil de synchronisation pour déposer des fichiers à traiter. Il lui est également possible de déclencher un outil pour traiter un fichier déposé au dernier moment.

Dans certains cas, ce sont des programmes externes qui alimentent de manière automatique les données en fournissant les fichiers CSV. Le système de fichiers de Moodle étant opaque, l'outil de synchronisation prévoit de réintégrer automatiquement dans son système de fichiers tout fichier déposé dans le répertoire :

 <moodledata>/sync
 

Cette récupération s'effectue avant toute action, programmée ou interactive sur l'un des outils d'intégration quelconque.

Exceptions : les fichiers commençant par '.' (fichiers cachés) ou par '_' (fichiers omis) ne sont pas concernés par cette synchronisation.

Pour réaliser une alimentation automatisée à distance :

  1. Préparer un compte sftp de service (sftp de préférence à ftp).
  2. Préparer votre SI distant pour venir déposer les fichier à traiter dans le répertoire mentionné ci-avant.
  3. Dans la configuration de l'outil, mémoriser les noms de fichiers correspondant dans les préconfigurations
  4. Configurer le traitement automatique (tâches progammées) pour chacun des fichiers à traiter.

Arbitrage au dépôt

Moodle ne doit pas être en mesure de récupérer un fichier qui est en cours de transfert FTP. De même, un agent SI externe doit être informé si le fichier local est en cours de récupération par le système de fichiers interne de Moodle.

Deux fichiers “verrous” sont gérés par le processus de réintégration afin d'aider à cette synchronisation :

  • Le fichier “lock.txt” : Indique que Moodle est en train de procéder à la récupération des fichiers externes.
  • Le fichier “alock.txt” : Est à créer par l'agent externe au début de sa procédure de transfert. Moodle teste si ce fichier existe lorsqu'il tente de récupérer les fichiers externes. Une fois le transfert terminé, l'agent SI externe doit supprimer ce fichier.

Une alarme est envoyée par mail à l'administrateur si l'un des deux fichiers existe et est trop ancien :

  • S'il s'agit du fichier “lock.txt” : Moodle commet des erreurs régulières lors de la récupération du fichier et ne parvient pas à supprimer son verrou.
  • S'il s'agit du fichier “alock.txt” : C'est le processus distant de livraison des fichiers qui est en cause.

Revenir au sommaire de l'outil

toolsyncuserguide.1444823962.txt.gz · Last modified: 2024/04/04 15:50 (external edit)