Envoyer un mail

Il y a 2 manières d’envoyer des mails :

• par requête : l’envoi de messages dans DIAPASON repose sur la fonction DIALOG «ENVOI-EMAIL ». Ce mot clé permet d’envoyer un message électronique via le serveur de messagerie DIAPASON à tous les destinataires accessibles depuis la messagerie interne ou externe. Il est utilisé dans les requêtes REB.

• via un document : il est aussi possible d’envoyer des messages en passant par les éditions de documents DIAPASON. En effet, l’onglet « Définition Mail » permet de paramétrer entièrement un message électronique suite à l’édition d’un document.

Les deux cas précédents utilisent donc la fonction DIALOG d’envoi de mail. Cette fonction repose sur l’utilisation d’un serveur de messagerie permettant de s’interfacer avec un grand nombre de messageries provenant de systèmes d’exploitation différents. La communication entre DIAPASON et la messagerie passe par le protocole standard : SMTP.

Utiliser un document pour envoyer un mail

L’utilisation des documents DIAPASON pour envoyer des messages est possible avec tous les types de documents.

Onglet « Définition Mail »

Cet onglet permet de configurer les informations générales sur le message.

Pour qu’un message soit envoyé suite à une édition, il faut tout d’abord cocher « Envoi par mail ». Puis, choisir le « Type message » correspondant au serveur de messagerie voulu. Ensuite, saisir au moins une adresse mail d’un « Destinataires ». Il est possible de joindre ou pas le document généré, de saisir un sujet et un corps de message.

Voir la documentation des documents.

Toutes les informations renseignées sur cette fiche sont décryptées dans la requête définie dans le type de message choisi. Celle-ci est paramétrée dans le champ « Requête envoi » de l’onglet « Envoi Mail ». La syntaxe de chaque champ et les répercussions de leurs valeurs sur l’envoi de messages dépendent des traitements effectués dans la requête d’envoi de messages. Le comportement et la syntaxe décrits ci-dessus correspondent à l’utilisation de la requête standard « ISEMaEnvoi ». L’utilisation d’une autre requête permet d’obtenir des effets totalement différents.

Envoyer un mail dans une requête

L’instruction « ENVOI-EMAIL » disponible dans toutes les requêtes de type REB permet d’envoyer des messages sans passer par une édition de document.

Contexte d’exécution de la requête

Lorsque l’envoi de message se fait par l’intermédiaire des éditions de document, le comportement est géré à l’intérieur de la requête REB associée au document.

Cette requête doit donc pouvoir accéder à toutes les informations relatives à l’exécution ou au paramétrage du document.

Liste des variables visibles dans la requête

• Variables VBP, SCR et VCR de l’exécution du document.

• Variables SCR de paramétrage du document.

  • SCR.EMA_AdrCpi Liste des adresses pour la copie du message (C)

  • SCR.EMA_AdrDes Liste des adresses des destinataires (C)

  • SCR.EMA_AdrRep Liste des adresses pour la réponse du message (C)

  • SCR.EMA_DocEdt Document en cours d’impression (C)

  • SCR.EMA_DocLib Désignation Document en cours

  • SCR.EMA_FicEdt Fichier résultat de l’édition (C)

  • SCR.EMA_MesCAT Catégorie GED rattachée

  • SCR.EMA_OptMes Options Envoi Message

  • SCR.EMA_PJiFic Fichiers des Pièces Jointes

  • SCR.EMA_PJiLib Libellés des Pièces Jointes

  • SCR.EMA_PJiTyp Types de pièces jointes

  • SCR.EMA_SrvMes Référence Serveur de messagerie

  • SCR.EMA_Sujet Description du sujet du message (C)

  • SCR.EMA_Texte Texte du message (C)

  • SCR.EMA_TypMeRef Référence Type de Message

  • SCR.EMA_AdrFig L’adresse est-elle figée ? (L)

  • SCR.EMA_DocPJi Le résultat du document est-il une pièce jointe ? (L)

• WfEntSel est positionné sur l’entité.

Utilisation des requêtes standards

Requête « ISEMaEnvoi »

Il existe une requête standard « ISEMaEnvoi » qui permet d’envoyer des messages. Cette requête utilise des requêtes procédures pour décrypter les paramètres du document (les différentes adresses, les pièces jointes, …).

• Récupération des destinataires sur le document (voir Destination Message)

• Récupération des pièces jointes sur le document (voir Pièces Jointes)

• Récupération des paramètres du document (voir Options)

• Exécution de la fonction « ENVOI-EMAIL » avec pour paramètres :

  • DESTINATAIRES= Liste des destinataires paramétrés dans la Requête « ISEMaPara »

  • OBJET= l’objet paramétré sur le document

  • MESSAGE= le message paramétré sur le document

  • PIECES-JOINTES= liste des pièces jointes paramétrés dans la Requête « ISEMaPJi »

Requête « ISEMaDes »

• Récupération des adresses destinataires des variables SCR.EMA_AdrDes, SCR.EMA_AdrCpi et SCR.EMA_AdrRep paramétrées sur le document.

• Construction de la liste des destinataires à partir des trois variables ci-dessus avec le formalisme suivant :

  • [ D=  « Destinataire » [ ; D=  « Destinataire »] [ ; D=  « Destinataire »]…]

  • [ C=  « DestinataireCopie » [ ; C=  « DestinataireCopie »] [ ; C=  « DestinataireCopie »]…]

  • [ R=  « DestinataireReponse » [ ; R=  « DestinataireReponse »] [ ; R=  « DestinataireReponse »]…]

Requête « ISEMaPara »

Pas utilisé.

Requête « ISEMaPJi »

Pour chaque élément de la liste SCR.EMA_PjiTyp

• Extraction des éléments des trois listes : SCR.EMA_PjiTyp, SCR.EMA_PJiLib et SCR.EMA_PJiFic

• Construction de la liste des pièces jointes à partir des trois variables ci-dessus avec le formalisme suivant : [ Type = Libellé | Fichier  [ ; Type = Libellé | Fichier ] …]

avec Type : [ FIC-JOINT-DIAPASON ] (Fichier accessible depuis le serveur DIAPASON)

| [ FIC-JOINT-EXTERNE ] (Fichier accessible depuis le serveur de messagerie)

| [ FIC-LIE ] (Le fichier doit être accessible lors de l’ouverture du message).

Libellé : le libellé de la pièce jointe.

Fichier : le nom du fichier avec son chemin absolu.