SEND_MAIL
Fonction de script : Envoie un e-mail à un utilisateur.
Syntaxe
SEND_MAIL (Receiver, [Cc], Subject, Text[, Attachment][, Agent][, Login])
|
Syntaxe
|
Description / format
|
|
Receiver
|
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
Défaut : ""
|
|
Subject
|
Description courte du message.
Format : littéral de script ou variable de script
Longueur maximale : 255 caractères
|
|
Text
|
Texte du message.
Format : littéral de script ou variable de script
|
|
Attachment
|
Chemin et nom des fichiers devant être envoyés en pièce jointe.
Format : littéral de script ou variable de script
Défaut : ""
Séparez chaque chemin par un point-virgule (;) si vous souhaitez envoyer plusieurs fichiers.
|
| Agent
|
Ce paramètre optionnel spécifie l'agent à utiliser pour envoyer le(s) courriels.
Valeur :
-
Nom de l'objet agent ou
- Chaîne fixe "*SERVER" ou
- Chaîne fixe "*DEFAUT" (valeur par défaut)
Si vous ne spécifiez pas d'agent ici, c'est la valeur par défaut qui s'applique, ce qui signifie que le système recherche les paramètres de SEND_MAIL_DEFAULT dans la variable UC_CLIENT_SETTINGS. Si l'agent n'est pas spécifié, le courriel est envoyé par AE/serveur
La valeur "*SERVER" permet de forcer l'envoi du courriel via AE/serveur (même si vous définissez un Agent/login centralisé dans UC_CLIENT_SETTINGS).
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.
Il est primordial d'avoir accès aux fichiers que vous voulez envoyer en pièce jointe.
Valeur :
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" : courriel envoyé avec succès.
"10034" : aucun hôte actif avec connexion e-mail.
"50006" : le serveur SMTP renvoie un code d'erreur.
"50012" : timeout, le serveur SMTP '&02' n'a pas répondu après '&01' secondes.
"50014" : pièce jointe inexistante.
"50027" : échec d'authentification sur le serveur STMP.
"50028" : adresse destinataire non valide. Le serveur SMTP l'a donc refusée.
"50029" : connexion du client SMTP au serveur SMTP impossible.
"50030" : erreur lors de la création du socket.
"50031" : extraction des informations de l'hôte du serveur SMTP impossible.
"50032" : communication impossible entre le client SMTP et le serveur SMTP.
"50033" : réception des données du serveur SMTP par le client SMTP impossible.
"50034" : envoi des données au serveur SMTP impossible.
"50035" : initialisation des sockets Windows impossible.
"50036" : extraction du nom d'hôte de l'ordinateur local impossible.
"53202" : le paramètre '&01' recherché est introuvable.
|
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.
Conseil : Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre en cas d'échec du courriel. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.
Cette fonction de script envoie systématiquement les courriels via l'agent spécifié ou Automation Engine. Notez donc que les fichiers à joindre doivent être accessibles via l'agent ou Automation Engine, soit directement, soit via un chemin UNC.
L'instruction de script écrit toutes les transactions en cours du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.
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. Ces paramètres sont ensuite utilisés si les paramètres Agent et Login ne sont pas spécifiés dans la fonction de script SEND_MAIL.
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")
Voir aussi :