Paramétrage du modèle de capture général

Le fichier général de configuration de MaarchCapture se trouve dans : ./config/Capture.xml

Il est commun à toutes les instances MaarchCourrier sur votre serveur d’instances mutualisées MaarchCourrier. Il est par contre unique sur vos postes de numérisation.

Capture des fichiers numérisés

Nous nous basons sur l’exemple présent dans le répertoire ./config/samples/Capture_standard_sample_windows.xml.default.

Ce paramétrage est à décliner sur les postes de numérisation où vous déployez MaarchCapture.

Le paramétrage type pour la capture de fichiers numérisés dans un répertoire et à destination de MaarchCourrier est le suivant :

<batch name="MAARCH_SCAN_TO_MC" directory="F:\maarch\MaarchCapture\files\" id="{batchname}-{timestamp}-{rand}" lock="0">
    <workflow name="MAARCH_SCAN_TO_MC" debug="false" logMode="default">
        <step name="ImportFiles" module='FileImport' function="ImportFiles">
            <input name="Directory">F:\maarch\MaarchCapture\files\TEST_IMPORT\</input>
            <input name="Target">Document</input>
            <input name="Action">none</input>
            <input name="MoveDirectory">F:\maarch\MaarchCapture\files\TEST_IMPORT\backup\</input>
            <input name="Recursive">0</input>
            <input name="CreateFolders">0</input>
        </step>
        <step name="SendToMaarch" module="MaarchWSClient" function="processBatch">
            <input name="WS">MaarchRestWS</input>
            <input name="Process">MaarchRestWSProcessFromScan</input>
            <input name="CatchError">true</input>
            <input name="configFile">MaarchWSClient_standard_sample.xml</input>
        </step>
    </workflow>
</batch>

Les éléments de paramétrage suivants sont à définir à chaque déploiement d’un nouveau poste de numérisation où vous déployez MaarchCapture :

• directory="F:\maarch\MaarchCapture\files\" représente le répertoire de travail de MaarchCapture. Seront déposés ici les logs et le fichier XML de traitement général du batch.
• name="Directory">F:\maarch\MaarchCapture\files\TEST_IMPORT\ répertoire d’import des fichiers en sortie du scanner.
• name="MoveDirectory">F:\maarch\MaarchCapture\files\TEST_IMPORT\backup\ répertoire de sauvegarde des fichiers traités.

L’étape de transfert des fichiers vers MaarchCourrier SendToMaarch n’a pas besoin d’être paramétrée dans ce fichier à partir du moment où vous utilisez MaarchWSClient_standard_sample.xml comme fichier de paramétrage de vos webservices, voir l'envoi dans MaarchCourrier.

Capture des courriels

Nous nous basons en partie sur l’exemple présent dans le répertoire ./config/samples/Capture_standard_sample_linux.xml.default.

Ce paramétrage type est déclinable par boite mail à capturer depuis votre serveur où est installé MaarchCapture.

Le paramétrage type pour la capture de courriels à destination de MaarchCourrier est le suivant :

<batch name="ID_INSTANCE_MAIL_1" directory="/opt/maarch/MaarchCapture/files/" id="{batchname}-{timestamp}-{rand}" lock="0">
    <workflow name="ID_INSTANCE_MAIL_1" debug="false" logMode="Maarch" maarchLogParam=""/var/www/html/ID_INSTANCE_MAIL_1/apps/maarch_entreprise/xml/log4php.xml" maarchLoggerName="loggerTechnique">
        <step function="CaptureMails" module="MailCapture" name="CAPTURE_MAIL_1">
            <input name="account">ID_INSTANCE_MAIL_1</input>
            <input name="Action">delete</input>
            <input name="configFile">ID_INSTANCE_MAIL_1 .xml</input>
            <input name="folder"></input>
            <input name="attachmentsOutputDir"></input>
            <input name="addHeaderInMailContent">false</input>
            <input name="folderError">incidents</input>
        </step>
        <step name="SendToMaarch" module="MaarchWSClient" function="processBatch">
            <input name="WS">ID_INSTANCE</input>
            <input name="Process">MaarchRestWSProcessFromMail</input>
            <input name="CatchError">true</input>
            <input name="configFile">MaarchWSClient_standard_sample.xml</input>
        </step>
    </workflow>
</batch>

Les éléments de paramétrage suivants sont à définir de façon identique pour tous vos paramétrages de courriels à capturer :

• directory="/opt/maarch/MaarchCapture/files/" représente le répertoire de travail de MaarchCapture. C’est ici que vous trouverez les fichiers capturés et logs détaillés du produit. Lorsque l’on est en mode debug= « false », ce répertoire contient uniquement les répertoires de travail des batchs ayant échoués.

• maarchLogParam="/var/www/html/ID_INSTANCE_MAIL_1/apps/maarch_entreprise/xml/log4php.xml" représente le chemin vers le paramétrage des logs d’instance MaarchCourrier. Ce paramétrage sert donc à dire à MaarchCapture où se trouvent les logs de MaarchCourrier pour que les erreurs de capture puissent être loggées dans le fichier central de logs de l’instance MaarchCourrier (technique.log).

Les éléments de paramétrage suivants sont à définir à chaque paramétrage de capture d’une boite mail supplémentaire pour une instance de MaarchCourrier :

• ID_INSTANCE_MAIL_1 correspond à l’identifiant unique d’une nouvelle boite mail à capturer. Si on devait capturer deux boites mails, il suffirait de déclarer un nouveau batch dont l’identifiant serait ID_INSTANCE_MAIL_2. Et ainsi de suite si d’autres boites mails seraient à capturer.