Module ScannedDocFlow
Module MGDex standard assurant la traçabilité des documents entre la bannette de numérisation et l'armoire d'indexation.
Principe
ScannedDocFlow est une déclinaison standard du connecteur MGDex, livrée pré-installée avec Multigest mais désactivée par défaut. Elle assure la traçabilité des documents numérisés tout au long de leur parcours : de leur import en bannette de numérisation jusqu'à leur indexation finale dans une armoire.
Comme les autres déclinaisons de MGDex, ScannedDocFlow s'appuie sur une base de données intermédiaire (MySQL), alimentée quotidiennement par un script de synchronisation. Il est possible d'accéder aux données de cette base :
directement, en connectant un outil tiers (par exemple Business Object) sur la base ;
via les WebServices REST exposés par le module.
Activation
Lors de l'installation standard de Multigest, le module MGDex est pré-installé et la configuration Apache correspondante est prévue, mais désactivée.
Activer les quatre Virtual Hosts
Vérifier, dans les fichiers ci-dessous, que la ligne d'inclusion correspondante n'est pas commentée (elle ne doit pas être précédée du caractère #) :
[…]\Apache2-4\conf\extra\HTTP\httpd-virtualhosts.conf
Include conf/extra/MODULES_MULTIGEST/Activation-modules-HTTP.conf
[…]\Apache2-4\conf\extra\HTTPS\httpd-ssl-virtualhosts.conf
Include conf/extra/MODULES_MULTIGEST/Activation-modules-HTTPS.conf
[…]\Apache2-4\conf\extra\MODULES_MULTIGEST\Activation-modules-HTTP.conf
Include conf/extra/MODULES_MULTIGEST/MGDEX/httpd-vh-mgdex.conf
[…]\Apache2-4\conf\extra\MODULES_MULTIGEST\Activation-modules-HTTPS.conf
Include conf/extra/MODULES_MULTIGEST/MGDEX/httpd-vh-ssl-mgdex.conf
Script de synchronisation
Le script doit être lancé quotidiennement — idéalement vers 4h du matin — et nécessite quelques minutes pour s'exécuter. Il alimente la base intermédiaire à partir des événements survenus la veille du jour d'exécution, entre minuit et 23h59.
Son algorithme se déroule en trois étapes :
Identifier les documents concernés, c'est-à-dire ceux ayant enregistré au moins une des actions suivantes sur la fenêtre considérée : import en bannette de numérisation, déplacement en bannette intermédiaire, indexation vers une armoire, édition ou renommage du document.
Extraire, pour chacun de ces documents, ses propriétés à chacune des étapes qu'il a traversées (bannette de numérisation, bannette intermédiaire, armoire d'indexation) — lorsque le document n'a pas encore atteint une étape, les données correspondantes ne peuvent naturellement pas être récupérées.
Créer un enregistrement par document dans la base MGDex.
Le paramétrage repose sur le fichier config.php à la racine du projet (connexion à la base de données, nom de la base Multigest, dossier de dépôt des exports CSV) et sur un jeu de requêtes SQL fourni dans /scanned_doc_flow/requests/. Le lancement quotidien s'effectue via le fichier synchronizeDatas.bat, généralement programmé avec le planificateur de tâches Windows (schtasks).
Objets et propriétés de la base de données
mgdex_armoire
Liste exhaustive des armoires de l'instance Multigest.
idnametypology— 1 pour une armoire en mode dossier, 0 pour une armoire en mode fichierpathfile— chemin physique de stockage des documents de l'armoire
mgdex_bannette
Liste exhaustive des bannettes de l'instance Multigest.
id(int)title(varchar 255) — nom de la bannettequantity_of_documents(int) — quantité de documents présents dans la bannette
mgdex_daily_bannettes_documents_events
Table centrale du module : liste des documents concernés par un événement d'écriture survenu sur la journée identifiée.
id,document_id— identifiants du document et du document dans son armoirebannette_a_id,bannette_a_name,bannette_a_datetime,bannette_a_user,bannette_a_filename,bannette_a_filesize— propriétés du document en bannette de numérisationbannette_b_id,bannette_b_name,bannette_b_datetime,bannette_b_user,bannette_b_filename,bannette_b_filesize,bannette_b_alteration— propriétés du document en bannette intermédiaire (bannette_b_alteration: indicateur d'altération du document, 0 non / 1 oui)armoire_id,armoire_name,armoire_datetime,armoire_user,armoire_filename,armoire_pdc,armoire_filesize,armoire_alteration— propriétés du document en armoire d'indexation
mgdex_mg_users
Liste exhaustive des utilisateurs de l'instance Multigest.
id(int) — identifiant de l'utilisateur Multigest (champ IDU)login(varchar 255)full_name(varchar 255)
WebServices
Récupération des documents
Retourne la liste de tous les documents importés par le script. Les paramètres first et quantity permettent de paginer les résultats.
first(facultatif) : indice du premier document à retourner.quantity(facultatif) : nombre de documents à retourner.format(facultatif) :html,jsonoucsv.
Exemple d'appel : http://mgdex/sdf/documents/100/50.json
Export de la liste en CSV
Retourne la même liste, exportée en CSV. Le fichier est enregistré sous le chemin défini dans la configuration (path_to_sdf_export_files / $exportFolder). Le format download permet de télécharger directement le fichier CSV, le format report affiche un bref rapport d'exécution.
Exemples d'appel : http://mgdex/sdf/export/csv/download · http://mgdex/sdf/export/csv/report
Last updated