Paramétrage des adresses e-mail externes¶

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.

Fonctionnement général¶

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.

Paramétrage¶

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.