Manuel des Scripts Automation Engine > Organisation fonctionnelle > Traitement des erreurs et messages > SEND_MAIL

SEND_MAIL

Fonction de script : Envoie un e-mail à un utilisateur.

Syntaxe

SEND_MAIL(Receiver, [Cc], Subject, Text, [Attachment],[Agent, Login Object] | [_SERVER, _DEFAULT])

Syntaxe	Description / format
Destinataire	Destinataire du message. Format : littéral de script ou variable de script
Cc	Destinataires devant recevoir une copie de ce message. Format : littéral de script ou variable de script Valeur par défaut : ""
Sujet	Description courte du message. Format : littéral de script ou variable de script
Texte	Texte du message. Format : littéral de script ou variable de script
Pièce jointe	Chemin et nom des fichiers devant être envoyés en pièce jointe. Format : littéral de script ou variable de script Valeur par défaut : "" Séparez chaque chemin par un point-virgule (;) si vous souhaitez envoyer plusieurs fichiers.
Agent	Spécifie l'agent qui doit être utilisé pour envoyer le(s) message(s) email (optionnel) Valeur : Nom de l'objet agent ou Chaîne fixe "SERVER" ou Chaîne fixe "DEFAUT" (= valeur par défaut) Si aucun agen n'est spécifié, les e-mails sont envoyés par le serveur/AE. La valeur "SERVER" peut être utilisée pour forcer l'envoi d'e-mails via le serveur/AE (même si vous définissez un agent/Login central). Pour la valeur "DEFAULT", les valeurs UC_CLIENT_SETTINGS sont utilisées. L'agent indiqué et le système Automation Engine doivent avoir la même version.
Login	Ce paramètre optionnel indique l'objet Login utilisé pour envoyer un e-mail. (optionnel) Il est primordial d'avoir accès aux fichiers que vous voulez envoyer en pièce jointe. Valeur : Nom de l'objet login Ce paramètre est ignoré si le paramètre agent est défini par "SERVER" (objet Login inutile). Il est obligatoire si le paramètre agent* est spécifié.

Codes retour
"0" : l'e-mail a été correctement envoyé. "10034" : aucun hôte avec connexion e-mail n'est actif. "50006" : le serveur SMTP retourne un code d'erreur. "50012" : timeout, le serveur SMTP '&02' n'a pas répondu après '&01' secondes. "50014" : la pièce jointe n'existe pas. "50027" : l'authentification sur le serveur STMP a échoué. "50028" : l'adresse du destinataire n'est pas valide et a été par conséquent refusée par le serveur SMTP. "50029" : le client SMTP ne peut pas se connecter au serveur SMTP. "50030" : erreur lors de la création du socket. "50031" : les informations de l'hôte du serveur SMTP n'ont pas pu être récupérées. "50032" : le client SMTP ne peut plus communiquer avec le serveur SMTP. "50033" : le client SMTP ne peut pas recevoir de données du serveur SMTP. "50034" : aucune donnée ne peut être envoyée au serveur SMTP. "50035" : initialisation des sockets Windows impossible. "50036" : le nom d'hôte de l'ordinateur local ne peut pas être récupéré.

Codes retour

"0" : l'e-mail a été correctement envoyé.
"10034" : aucun hôte avec connexion e-mail n'est actif.
"50006" : le serveur SMTP retourne un code d'erreur.
"50012" : timeout, le serveur SMTP '&02' n'a pas répondu après '&01' secondes.
"50014" : la pièce jointe n'existe pas.
"50027" : l'authentification sur le serveur STMP a échoué.
"50028" : l'adresse du destinataire n'est pas valide et a été par conséquent refusée par le serveur SMTP.
"50029" : le client SMTP ne peut pas se connecter au serveur SMTP.
"50030" : erreur lors de la création du socket.
"50031" : les informations de l'hôte du serveur SMTP n'ont pas pu être récupérées.
"50032" : le client SMTP ne peut plus communiquer avec le serveur SMTP.
"50033" : le client SMTP ne peut pas recevoir de données du serveur SMTP.
"50034" : aucune donnée ne peut être envoyée au serveur SMTP.
"50035" : initialisation des sockets Windows impossible.
"50036" : le nom d'hôte de l'ordinateur local ne peut pas être récupéré.

Remarques

L'envoi d'un e-mail dépend des possibilités proposées par la configuration du PC de l'utilisateur.

La fonction de script ne vérifie pas si le destinataire indiqué existe réellement. Le message est envoyé même si le destinataire n'est pas correct.

Si l'e-mail ne peut pas être envoyé, car la pièce jointe est introuvable ou la connexion e-mail n'est pas active, le traitement du script continue par défaut. Dans ce cas, la fonction de script fournit le code retour correspondant.
Vous pouvez utilisez l'instruction de script :ON_ERROR pour interrompre le traitement du script si une erreur se produit. Vous pouvez utilisez les fonctions de script pour le traitement des erreurs pour analyser l'erreur.

Cet élément de script envoi toujours les e-mails via le Automation Engine. Les fichiers à envoyer en pièces jointes doivent se trouver sur l'ordinateur d'Automation Engine ou y être accessibles (chemin UNC).

Le nombre de caractères est limité à 1024 par ligne.

La fonction de script permet d'écrire les transactions ouvertes dans la base de données AE.

L'envoi d'e-mails requiert la configuration de la connexion d'e-mail.

Les paramètres Agent et Login peuvent aussi être définis dans la variable UC_CLIENT_SETTINGS en utilisant la clé SEND_MAIL_DEFAULT. Les paramètres indiqués dans les fonctions de script SEND_MAIL individuelles sont remplacées, partout dans le client, par la clé dans UC_CLIENT_SETTINGS.

Exemples

Dans le premier exemple, un e-mail est envoyé à un seul destinataire (aucune copie). Un fichier est attaché à cet e-mail.

:SET &OUT# = SEND_MAIL('brown@automic.at',,'Meeting','Meeting today at 5pm', '/AE/agenda')

Un e-mail contenant deux pièces jointes est envoyé à plusieurs personnes :

:SET &OUT# = SEND_MAIL("brown@automic.at;smith@automic.us",,"Meeting","Meeting canceled","c:\AUTOMIC\agenda.doc;c:\AUTOMIC\dates.txt")

Rubriques connexes :

Elément de script	Description
:SEND_MSG	Envoie des messages à des utilisateurs connectés à l'interface utilisateur.
:ON_ERROR	Détermine la réaction à certaines erreurs ou messages d'éléments de script.

Eléments de script - Traitement des erreurs et messages

Connexion e-mail

Exemples :
Récupération du message et du numéro de l'erreur

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle