Déploiement de la capture de fichiers numérisés

Ce paragraphe décrit le mode opératoire pour déployer la capture de fichiers numérisés par un scanner.

Ce mode opératoire peut être décliné lorsque l’on souhaite ajouter la capture de nouveaux flux de numérisation à une instance MaarchCourrier.

Une fois les fichiers type de paramétrage correctement préparés (voir paragraphes précédents), le mode opératoire consistera essentiellement à procéder à des copier/coller et au remplacement de la variable de fusion ID_INSTANCE. Nous prendrons l’exemple où ID_INSTANCE est valorisée de la façon suivante : cs_olivet

Dans votre cas, il faudra remplacer cs_olivet par l'identifiant de votre instance MaarchCourrier.

Par défaut, se positionner dans le répertoire de MaarchCapture :

cd /opt/maarch/MaarchCapture/

Dans notre exemple, il faut impérativement que les documents scannés arrivent dans le répertoire /opt/maarch/MaarchCapture/files/cs_olivet/

Avoir une configuration de base en prérequis

Si vous n'avez pas encore de fichier Capture.xml dans le répertoire ./config, nous vous conseillons alors d'aller en récupérer un depuis le répertoire ./config/samples/. Le candidat idéal pour commencer une configuration "standard" est Capture_standard_sample_linux.xml.default.

ls -al config/Capture.xml
# uniquement si erreur d'existance du fichier
cp config/samples/Capture_standard_sample_linux.xml.default config/Capture.xml

Paramétrage de la configuration générale pour la capture de courriels

Ajouter le bloc suivant dans le fichier ./config/Capture.xml (entre les balises batches):

nano ./config/Capture.xml
<batch name="MAARCH_SCAN_TO_MC_cs_olivet_1" directory="/opt/maarch/MaarchCapture/files/" id="{batchname}-{timestamp}-{rand}" lock="0">
    <workflow name="MAARCH_SCAN_TO_MC_cs_olivet_1" debug="true" logMode="Maarch" maarchLogParam="/var/www/html/MaarchCourrier/apps/maarch_entreprise/xml/log4php.xml" maarchLoggerName="loggerTechnique">
        <step name="ImportFiles" module='FileImport' function="ImportFiles">
            <input name="Directory">/opt/maarch/MaarchCapture/files/cs_olivet/</input>
            <input name="Target">Document</input>
            <input name="Action">none</input>
            <input name="MoveDirectory">/opt/maarch/MaarchCapture/files/cs_olivet/backup/</input>
            <input name="Recursive">0</input>
            <input name="CreateFolders">0</input>
        </step>
        <step name="SendToMaarch" module="MaarchWSClient" function="processBatch">
            <input name="WS">cs_olivet</input>
            <input name="Process">MaarchRestWSProcessFromScan</input>
            <input name="CatchError">true</input>
            <input name="configFile">MaarchWSClient_standard_sample.xml</input>
        </step>
    </workflow>
</batch>

mkdir -p /opt/maarch/MaarchCapture/files/cs_olivet/backup
chown -R maarch. /opt/maarch/MaarchCapture/files/

Paramétrage de l'envoi des courriels dans MaarchCourrier

Si le fichier ./modules/MaarchWSClient/MaarchWSClient_standard_sample.xml n'existe pas encore, alors il faut le récupérer à partir du répertoire samples.

ls -al modules/MaarchWSClient/MaarchWSClient_standard_sample.xml
# uniquement si erreur d'existance du fichier 
cp modules/MaarchWSClient/samples/MaarchWSClient_standard_sample.xml.default modules/MaarchWSClient/MaarchWSClient_standard_sample.xml

Ajouter le bloc suivant dans le haut du fichier ./modules/MaarchWSClient/MaarchWSClient_standard_sample.xml et configurer l’accès aux web services REST de l’instance MaarchCourrier cs_olivet :

nano ./modules/MaarchWSClient/MaarchWSClient_standard_sample.xml
<WS name="cs_olivet" type="REST" uri="http://userMaarchWS:passwordMaarchWS@courrier.metropoleorleans.fr/cs_oliver/rest/">
</WS>

Paramétrage du shell de lancement de MaarchCapture pour la capture de fichiers scannés

Créer le fichier ./scripts/MAARCH_SCAN_TO_MC_cs_olivet_1.sh :

nano ./scripts/MAARCH_SCAN_TO_MC_cs_olivet_1.sh
#!/bin/sh

cd /opt/maarch/MaarchCapture/
php MaarchCapture.php init -BatchName MAARCH_SCAN_TO_MC_cs_olivet_1

chmod +x ./scripts/MAARCH_SCAN_TO_MC_cs_olivet_1.sh

Planifier le shell créé dans votre planificateur de tâches :

su maarch
crontab -e

*/10 * * * * /opt/maarch/MaarchCapture/scripts/MAARCH_SCAN_TO_MC_cs_olivet_1.sh