Verified Commit 1bc89f74 authored by Giovannoni Laurent's avatar Giovannoni Laurent
Browse files

FEAT add process to deploy new mail for an instance

parent 783d8986
Déploiement de la configuration pour une instance de MaarchCourrier
===========================
home
deploy
deploy_mail_capture
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](ws_maarch_courrier.md).
## 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.
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment