GTRMB - Règles de gestion des boîtes mail

   Cette transaction est utilisée pour définir les règles de gestion des boîtes mails.

   Une règle permet de sélectionner et traiter les nouveaux messages arrivés dans un dossier défini et correspondant à des critères sur l'adresse de l'expéditeur, l'objet et/ou le nom des pièces jointes.
Lorsqu'un message correspond aux critères définis, il est intégré dans le sas des mails entrants (CTEML), puis est systématiquement supprimé de la messagerie.

   Des actions complémentaires peuvent également être appliquées sur le mail :

• Lancement d'un traitement ou d'une procédure stockée d'intégration ;
• Copie du message dans un autre répertoire de la messagerie pour archivage ;
• Sauvegarde du message sur disque sous forme d'un fichier EML ;
• Mise en GED du fichier EML ;
• Extraction des pièces jointes du message sur disque.

   En cas d'échec de traitement, une notification par mail peut être envoyée à un gestionnaire et/ou à une liste d'utilisateurs.

   Permet de définir l'ordre d'application de la règle au sein d'un même dossier de messagerie.

   Chemin du dossier de messagerie à scanner.

   Cela permet d'arrêter le processus d'application des règles. Si cette case est cochée, lorsque la règle est appliquée à un message, aucune autre règle ne le sera. Les règles suivantes qui pourraient être appliquées au message ne seront pas traitées.

   Expression régulière permettant de tester l'objet du message pour déterminer si la règle s'applique.
Par exemple : l'expression régulière .*FACTURE.* permet de sélectionner tous les messages dont l'objet contient le mot FACTURE.

   Si ce champ n'est pas renseigné, l'objet du message n'est pas testé.

   Expression régulière permettant de tester l'adresse de l'expéditeur du message pour déterminer si la règle s'applique.
Si ce champ n'est pas renseigné, l'adresse de l'expéditeur du message n'est pas testée.

   Expression régulière permettant de tester le nom des fichiers joints au message.
La règle s'applique si le nom d'au moins un des fichiers joints correspond à l'expression régulière.
Si ce champ n'est pas renseigné, le nom des fichiers joints n'est pas testé.

   Non géré.

   En cas d'erreur dans le traitement des messages, le gestionnaire (GGES) de la boîte mail recevra une notification par mail (si son adresse électronique est renseignée).
Il est possible de définir d'autres utilisateurs à notifier en utilisant la liste de diffusion des erreurs.

   Permet de définir une liste d'utilisateurs (GLUS) à notifier en cas d'erreur dans le traitement des messages.
La notification sera envoyée au gestionnaire de la boîte mail ainsi qu'à tous les utilisateurs de la liste associés à un gestionnaire dont l'adresse électronique est renseignée.

   Le mécanisme d'intégration permet de lancer un traitement ou d'appeler une procédure stockée après le traitement d'un ou plusieurs mails afin de réaliser des actions complémentaires.

   Intégration par traitement
Le traitement dont le mnémonique est renseigné est lancé par l'utilisateur défini :
- Une fois, à la fin du traitement de tous les mails du dossier concerné par la règle si aucun critère d'exécution n'est défini ;
- Après le traitement de chaque mail, s'il existe au moins un critère de traitement saisi dans le champ "Informations complémentaires" de la règle.

   Critères d'exécution du traitement
Si aucun critère d'exécution n'est précisé de manière formelle, le critère COLONNE1 est transmis par défaut avec comme valeur l'adresse de la boîte mail traitée.

   Les critères d'exécution du traitement peuvent être précisés dans le champ "Informations complémentaires" de la règle, en respectant la syntaxe suivante : ADDPJB:CRITERE1=VALEUR1;CRITERE2=VALEUR2;...

   La valeur d'un critère peut être une valeur fixe saisie directement, ou correspondre à une des variables suivantes :
- {SUBJECT} : Objet du message traité ;
- {FROM} : Adresse de l'expéditeur du message ;
- {MESSAGEID} : Identifiant unique du message (UID).

   Les variables SUBJECT et FROM offrent la possibilité de se servir de l'expression régulière pour isoler une partie de l'objet ou de l'adresse de l'expéditeur du message. Pour n'utiliser qu'un groupe au sein de l'expression régulière, on utilise la syntaxe {SUBJECT:$1} où le symbole "$" préfixe le numéro de groupe à extraire.

   Exemple : ADDPJB:PJB1={SUBJECT:$1};PJB2={FROM};PJB3=TEST

   Intégration par procédure stockée
L'intégration par procédure stockée s'exécute après le traitement de chaque message par la règle, en appelant la procédure stockée dont le nom est spécifié.
Cette procédure stockée doit accepter en entrée les paramètres système standard, ainsi que 12 paramètres supplémentaires de type chaîne de caractères (varchar) :
- Le paramètre 1 auquel sera transmis le nom de la boîte mail ;
- Le paramètre 2 auquel sera transmis l'identifiant unique du message ;
- Les paramètres de 3 à 7 qui seront passés avec une valeur nulle ;
- Les paramètres 8 à 12 en sortie.

   Mnémonique du traitement d'intégration à lancer.

   Utilisateur (GUSI) avec lequel le traitement d'intégration sera lancé.

   Nom de la procédure stockée d'intégration à exécuter.

   Les messages traités par une règle sont supprimés sur le serveur de messagerie une fois la totalité du dossier traité.
Les options de stockage messagerie permettent d'en garder une copie dans un dossier d'archivage et/ou de supprimer le message immédiatement sur le serveur sans autre traitement.

   Si cette case est cochée, le mail sera supprimé immédiatement sans autre traitement par la règle, ni intégration dans le sas des mails entrants (CTFEM).

   Chemin du dossier d'archivage des mails sur la messagerie.
S'il est renseigné, le message sera copié dans ce dossier immédiatement après le traitement de la règle, permettant d'en conserver une copie après le traitement complet du dossier.
Cette fonctionnalité n'est disponible que pour le protocole IMAP.

   Les options de stockage physique permettent de télécharger et stocker les messages et/ou leurs pièces jointes dans un répertoire sur disque.
Cette sauvegarde ne sera pas gérée si la case "Suppression du mail" est cochée.

   Si cette case est cochée, le message sera sauvegardé sur disque sous la forme d'un fichier intitulé "mail.eml".

   Mise en GED du fichier EML
Il est possible de mettre en GED le fichier sauvegardé.
Pour cela, il faut utiliser la syntaxe suivante dans le champ "Informations complémentaires" de la règle : GEDIN:IDE=identifiant;DEN=entité;DTY=type;NUS=sous-numéro.
Les valeurs "identifiant", "entité", "type" et "sous-numéro" sont à remplacer soit par des valeurs fixes soit par les variables {SUBJECT}, {FROM} ou {MESSAGEID} (voir la section Intégration pour le détail de l'utilisation des variables).
Exemple : GEDIN:IDE={SUBJECT:$1};DEN=GMDOM;DTY=BASE;NUS={MESSAGEID}

   Si cette case est cochée, les pièces jointes seront extraites dans le répertoire du message et intégrées dans le sas des fichiers associés aux mails (CTFEM).
Les événements de calendrier présents dans un message sont automatiquement extraits sous la forme d'un fichier ICS.

   Chemin du répertoire de stockage des fichiers sur disque.
Pour chaque message traité, un répertoire nommé par l'identifiant unique (UID) du message sera créé sous cet emplacement.
Le fichier contenant le message et/ou ses pièces jointes sera créé dans ce sous-répertoire.