Récupérer des documents envoyés au parapheur distant
Prérequis : avoir configuré le fichier de paramétrage comme indiqué ici.
Un batch permet de regarder si les documents ont été signés ou refusés dans le parapheur distant.
1) Paramétrage xml
Copier le fichier modules/visa/batch/config/config.xml.default dans votre custom avec la même arborescence modules/visa/batch/config/config.xml et ouvrez-le
<?xml version="1.0" encoding="utf-8"?>
<ROOT>
<CONFIG>
<MaarchDirectory>/var/www/html/maarch_v2/</MaarchDirectory>
<CustomId>cs_maarch_v2</CustomId>
<validatedStatus>VAL</validatedStatus>
<validatedStatusOnlyVisa>VAL</validatedStatusOnlyVisa>
<refusedStatus>COU</refusedStatus>
<validatedStatusAnnot>NEW</validatedStatusAnnot>
<refusedStatusAnnot>DEL</refusedStatusAnnot>
<applicationUrl>http://localhost/maarch_v2/</applicationUrl>
<userWS>superadmin</userWS>
<passwordWS>superadmin</passwordWS>
</CONFIG>
<LOG4PHP>
<enabled>true</enabled>
<Log4PhpLogger>loggerTechnique</Log4PhpLogger>
<Log4PhpBusinessCode>retrieveMailsFromSignatoryBook</Log4PhpBusinessCode>
<Log4PhpConfigPath>/var/www/html/maarch_v2/apps/maarch_entreprise/xml/log4php.xml</Log4PhpConfigPath>
</LOG4PHP>
</ROOT>
- MaarchDirectory : Chemin absolu vers votre application Maarch courrier
- CustomId : Identifiant de votre custom
- validatedStatus : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été signée (visible dans la table status de la base de données Maarch Courrier)
- validatedStatusOnlyVisa : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été validée sans signature (utilisable uniquement avec xParaph)
- refusedStatus : Statut dans lequel sera le courrier principal lorsque la pièce jointe aura été refusée (visible dans la table status de la base de données Maarch Courrier)
- validatedStatusAnnot : Statut dans lequel sera le courrier principal lorsque le document aura été annoté et validé (visible dans la table status de la base de données Maarch Courrier)
- refusedStatusAnnot : Statut dans lequel sera le courrier principal lorsque le document aura été annoté et refusé (visible dans la table status de la base de données Maarch Courrier)
- applicationUrl : Url de votre aplication Maarch Courrier
- userWS : Identifiant d'un utilisateur de votre application Maarch Courrier. Il est recommandé d'utiliser un compte de webservice
- passwordWS : Mot de passe de l'utilisateur ci-dessus
- LOG4PHP => Adapter les chemins selon votre environnement
2) Batch
Copier le fichier modules/visa/batch/scripts/retrieveMailFromExternalSignatoryBook.sh.default en modules/visa/batch/scripts/retrieveMailFromExternalSignatoryBook.sh
Adapter les chemins selon votre environnement.
Ce batch doit être mis en tâche planifiée afin d'être exécuté régulièrement.
3) Fonctionnement
Le batch regarde :
- toutes les pièces jointes qui ont été envoyées au parapheur pour signature, et qui ne sont pas revenues.
- tous les documents qui ont été envoyées au parapheur pour annotation, et qui ne sont pas revenus On vérifie si le document a été refusé ou signé dans le parapheur.
Si la pièce jointe a été signée, on l'a récupère, et on l'ajoute en tant que pièce jointe signée. On passe le courier au statut défini dans la balise
Si la pièce jointe a été refusée, on récupère la note de refus, et on l'ajoute en tant que note au document dans Maarch Courrier. On passe le courier au statut défini dans la balise
Cas particulier MaarchParapheur :
Si la pièce jointe a été refusée, on la récupère, et on l'ajoute en tant que pièce jointe. On passe le courier au statut défini dans la balise
Cas particulier : Si plusieurs pièces jointes d'un même courrier ont été envoyées dans un parapheur distant, on passe le courrier au statut
| ------------------------------------ | ------------------------------------------------------------ |
| 
| Si vous avez plusieurs instances de Maarch Courrier connecté à un parapheur externe, vous pouvez configurer la récupération des données en configurant un fichier retrieveMailFromExternalSignatoryBook.sh pour chaque custom. |