Maarch Courrier permet de définir une liste d'adresses e-mail externes associées soit à des entités spécifiques, soit rendues globalement accessibles à l'ensemble des utilisateurs de l'application. Son utilisation facilite la sélection rapide d'adresses fréquemment nécessaires ou pré-définies par l'administration pour certains cas fonctionnels précis, évitant ainsi une saisie répétée manuelle par les utilisateurs.
Lorsqu'un utilisateur souhaite envoyer un mail, si le paramétrage des adresses e-mail externes est activé alors tous les emails qu'il peut utiliser comme expéditeur seront fournis en plus de l'e-mail configuré pour l'utilisateur et de ceux définis pour les entités à qui il appartient.
La configuration se fait dans le fichier de configuration config/externalMailEntities.xml
Voici la partie à configurer :
<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
<externalEntityMail>
<defaultName>Prefecture</defaultName>
<targetEntityId></targetEntityId> <!-- Laisser vide pour que l'adresse soit utilisable par tout le monde. Dans ce cas, la balise defaultName sera prise en compte -->
<EntityMail>service.prefecture@gmail.com</EntityMail>
</externalEntityMail>
<externalEntityMail>
<targetEntityId>COU</targetEntityId>
<EntityMail>service.courrier@gmail.com</EntityMail>
</externalEntityMail>
</ROOT>
Chaque élément <externalEntityMail>
définit une adresse e-mail externe ainsi que son contexte d'utilisation. Cet élément comprend les sous-éléments suivants
<targetEntityId>
(optionnel) :
Code identifiant unique d'une entité spécifique dans l'application.
Si vide, l'adresse est accessible à tous les utilisateurs.
Si renseignée, la visibilité de l'adresse est restreinte aux seuls utilisateurs rattachés à cette entité précise.<defaultName>
(optionnel, mais recommandé) :
Nom affiché lorsque l'adresse est applicable à tous les utilisateurs (devient obligatoire si le <targetEntityId>
est vide).
Ce champ est ignoré dès lors qu'un <targetEntityId>
précis est renseigné.<EntityMail>
(obligatoire) : Mentionne explicitement l'adresse e-mail devant être exploitée par l'application selon les contextes associés.