ENVOI-EMAIL

BUT

Cette fonction permet d’envoyer un message électronique via le serveur de messagerie DIAPASON. Cette fonction est utilisée dans les requêtes REB. L’utilisation de cette fonction n’a aucun effet si DIAPASON n’est pas paramétré pour fonctionner avec un serveur de messagerie.

Question simple, un mail c’est quoi? 🤓

Et bien, un mail c’est :

On retrouve les différentes parties du mail dans la fonction ENVOI-MAIL !

TYPE

CARACTERE

SYNTAXE

ENVOIE-EMAIL

DESTINATAIRES = [CLO. "Liste destinataires "][VLO.Liste destinataires]

OBJET = [CLO. "Objet "][VLO.Objet]

MESSAGE = [CLO. "Texte du message "][VLO.TexteMessage]

PIECES-JOINTES = [CLO. "Liste pièces jointes "][VLO.ListePiecesJointes]

TYPE MESSAGE = [CLO. "Type Message Sortant][VLO. TypeMessageSortant]

PARAMETRES EMAIL = [CLO. "Paramètres Email][VLO.ParametresEmail]

PARAMETRES

Paramètre	E/S	O	Type	Description
DESTINATAIRES	E	Oui	Caractère	Définir les destinataires Le paramètre destinataire est constitué d’une liste chainée (séparateur “;”) de l’ensemble des personnes concernées par l’email: `[Type= "Destinataire1" [ ; Type= "Destinataire2"]…] Avec` Un élément de la liste chainée est composé de : Rôle du destinataire (D = Destinataire principal, C = Destinataire en copie, R = Emetteur, B=adresse destinataire copie cachée, RT=adresse de réponse au mail) La constante “=” Le mail du destinataire Exemple: Pour envoyer un mail à Benoît avec François en copie et Fanny en émettrice: Destinataire = “D=bmorandet@elcia.com;C=fhoubert@elcia.com;R=ftastet@elcia.com”
OBJET	E	Oui	Caractère	Définir sujet et objet Rien de compliqué, il suffit de mettre du texte ! L’objet peut contenir du HTML dans le cas ou le message sortant utilisé interprète du HTML.
MESSAGE	E	Oui	Caractère	Texte du message.
PIECES-JOINTES	E	Oui	Caractère	Définir les pièces jointes Avant de vouloir envoyer une pièce jointe, vous devez savoir où est stocker le document en question. Concrètement vous avez trois possibilités : Document sur le serveur DIAPASON Document sur le serveur d’EDITION Document dans la GED DIAPASON En fonction de l’endroit où est stocké le document vous devrez utiliser des mots clefs différents pour définir votre paramètre des pièces jointes. Le paramètre pièce jointe est constitué d’une liste chainée (séparateur “;”) de l’ensemble des pièces jointes que vous souhaitez ajouter à votre mail. Chaque membre de la liste chainée est décomposé de cette manière : Type FIC-JOINT-DIAPASON (si sur serveur DIAPASON) FIC-JOINT-EXTERNE (Si sur serveur en dehors du serveur DIAPASON) FIC-GED-INTERNE (Si dans la GED DIAPASON) [FIC-LIE] (Fichier accessible depuis le serveur de messagerie) La constante “=” le libellé de la pièce jointe : c’est le libellé que vous verrez dans votre mail pour la pièce jointe (ici “Maestro Release Note V0.4.0.pdf”) La constante “\|” Fichier : l’emplacement du fichier avec son chemin absolu. Dans le cas d’un type « FIC-GED-INTERNE », doit contenir : l’identifiant GED du document ou la catégorie , la clé Version et le numéro de version séparés par des « ,» ou la catégorie et la clé Version séparées par des « ,» PieceJ= “FIC-JOINT-DIAPASON=Commande_145374.pdf\|172.12.285.6\Edt\15734.pdf;FIC-JOINT-GED=plan_14374.pdf\|46753434”
TYPE MESSAGE	E	Non	Caractère	Type de message pour initialisation de l’e-mail dans la boite aux lettres EIA (dossier, niveau importance …). Si non renseigné ou si le type de message donné est incohérent la fonction prendra en compte le type de message défaut défini sur le paramètre ‘EIA’,’TRC-MES’,’0’ (accessible depuis la branche « Traçabilité Mails » rubrique « Paramètres EIA » dans l’explorateur applicatif « Echanges Inter-Applicatifs ».
PARAMETRES MAIL	E	Non	Caractères	Paramètres optionnels pouvant être définis en sus de ceux définis sur le serveur de messagerie utilisé (issu du type de message). Ces paramètres sont définis sous la forme d’une liste chaînée telle que : Param1=Val1 ;Param2=Val2 ;.. ;ParamN=ValN

EXEMPLE

Cette requête permet d’envoyer un message à plusieurs destinataires.

COMMENTAIRE : "Adresses des destinataires du message".

VLO.Destinataires = CLO."D= " + CLO.Dest1@Domaine.fr

VLO.Destinataires=VLO.Destinataires + CLO.";" + CLO."D=" + CLO.Dest2@Domaine.fr

COMMENTAIRE : "Adresses des destinataires des copies du message"

VLO.Destinaires= VLO.Destinataires + CLO.";" + CLO."C=" + CLO.Copie1@Domaine.fr.

VLO.Destinaires= VLO.Destinataires + CLO. ";" + CLO."C=" + CLO.Copie2@Domaine.fr

COMMENTAIRE : "Adresses des destinataires des réponses au message"

VLO.Destinataires=VLO.Destinataires + CLO.";" + CLO."R=" + CLO.Dest3@Domaine.fr

VLO.EmaPiecesJointes=CLO.""

VLO.Sujet=CLO. "Sujet du message"

VLO.Texte=CLO. "Texte du message"

VLO.Resultat=ENVOI-EMAIL(DESTINATAIRES=VLO.Destinataires,OBJET=VLO.Sujet, MESSAGE=VLO.Texte,PIECES-JOINTES=VLO.EmaPiecesJointes)

NOTES

Gestion des pièces jointes issu d’une GED Diapason

Dans le cas ou l’on souhaite joindre à un mail un document stocké dans une GED Diapason avec le mot clef « FIC-GED-INTERNE », la syntaxe à utiliser est la suivante :

FIC-GED-INTERNE= Libellé | Identifiant GED [ ;…]

Avec «Libellé » : libellé souhaité lors de la réception du mail. Peut être vide.

« Identifiant GED » : il y plusieurs façon d’identifier le document en GED :

Soit utilisation de l’Identifiant du document (champ ADGEDDoc.ADGEDIde)
Soit utilisation de la Clé Versioning du document avec la syntaxe suivante:

Catégorie du document (ADGEDDoc.ADGEDCat) + « , » + Clé version (ADGEDDoc.ADGEDCleV) + « , » + Version du document (ADGEDDoc.ADGEDVer)

Si le numéro de version n’est pas valide ou n’est pas renseigné, c’est la version principale du document qui sera joint.

Si le document Joint est un groupe de document alors tous les documents liés seront automatiquement joints au mail. Si le libellé a été forcé, ce dernier sera appliqué à tous les documents joints.

Ce type de pièce jointe n’est géré que pour un serveur de service Diapason (P17) ou Java.

PARAMETRES MAILS GERES

Clé de variable	SSJ	SSD	Description
ACCUSELECTURE	X	X	Option permettant de recevoir un accusé de lecture. Ce paramètre doit avoir pour valeur une seule adresse mail, qui recevra l'accusé. « ACCUSELECTURE=adresse@messagerie.com »
PROFILER		X	Option permettant d’activer l’outil Profiler. Valeur possible :YES,Y,OUI,O,+,1,VRAI,V,TRUE,T,MAIL,ENVOIMAIL. Pour toute autre valeur, le profiler ne sera pas activer. Le fichier sera nommé Profiler_<Nom du fichier trace associé au service>.prof . Il sera généré par défaut dans le dossier des traces du serveur de service.
PROFILER_REPERTOIRE		X	Permet de forcer un dossier de génération différent du dossier de trace si le profiler est activé.
PROFILER_TRACEFILTER		X	option supplémentaire pour le profiler. Valeur possible : *