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.
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 | Liste de destinataires du message : [Type= "Destinataire1" [ ; Type= "Destinataire2"]…] Avec Type : [D] (adresse destinataire principal du message ) [C] (adresse destinataire copie) [B] (adresse destinataire copie cachée] [R] (adresse émetteur du mail – Adresse de réponse par défaut) [RT] (adresse de réponse au mail) |
OBJET | E | Oui | Caractère | Objet du message. |
MESSAGE | E | Oui | Caractère | Texte du message. |
PIECES-JOINTES | E | Oui | Caractère | Liste des pièces jointes : [Type = Libellé | Fichier [ ; Type = Libellé | Fichier]…] avec Type : [ FIC-JOINT-DIAPASON] (fichier accessible depuis le serveur DIAPASON) ou [ FIC-JOINT-EXTERNE] (Fichier accessible depuis le serveur de messagerie) ou [FIC-LIE] (Fichier accessible depuis le serveur de messagerie) ou [ FIC-GED-INTERNE ] (Le fichier doit être stocké dans une GED DIAPASON) Libellé : le libellé de la pièce jointe (peut-être vide si le nom du fichier suffit). Fichier : chemin absolu du fichier à joindre. 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 « ,» |
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.
![](../__attachments/115230583/att_1_for_223969592.png?inst-v=2e0628d9-a170-4eb1-b774-b0d7a84fa1a1)
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 : * |