La fonction VaToolBxSendMailSMTP permet d'envoyer un mail via un serveur SMTP (internet). Les fonctionnalités de cette fonction sont celles habituellement proposées par tout outil de messagerie (envoi à un ou plusieurs destinataires, dans les modes CC ou BCC, inclusion d'une ou plusieurs pièces jointes).
Prérequis
Pour la version Java, il est nécessaire d'avoir dans le contexte d'exécution les fichiers suivants (javamail) :
- activation.jar,
- mail.jar.
Ces fichiers sont inclus dans certaines versions de Tomcat 4.1 et dans Websphere 5.
Domaine d'application
Client Windows,
Serveur Windows,
Client Mobile,
Serveur Mobile,
Client Java,
Serveur Java,
Client Adélia Web,
Client Adélia Cloud.
Paramètres
ALPHA(n) |
Serveur |
Nom de l'hôte du serveur SMTP - optionnellement suivi du port de connexion (ex : stmp.free.fr, smtp.free.fr:25). Si le port de connexion n'est pas précisé, une valeur par défaut est utilisée (25 en mode normal, 465 en mode SSL). |
ALPHA(n) |
Utilisateur |
Nom d'utilisateur. |
ALPHA(n) |
MotDePasse |
Mot de passe associé à l'utilisateur. |
ALPHA(n) |
Expéditeur |
Nom de l'expéditeur. |
ALPHA(n) |
Destinataires |
Destinataires principaux (To). Liste d'adresses électroniques séparées par des ';'. |
ALPHA(n) |
Copies |
Destinataires en copie (Cc). Liste d'adresses électroniques séparées par des ';'. |
ALPHA(n) |
Bcopies |
Destinataires en copie cachée (Bcc). Liste d'adresses électroniques séparées par des ';'. |
ALPHA(n) |
Attaches |
Pièces jointes. Liste de noms de fichiers séparés par des ';'. |
ALPHA(n) |
Sujet |
Sujet du courrier. |
ALPHA(n) |
Corps |
Corps de texte du courrier. |
ALPHA(n) |
Options |
Options. Liste de couples "option=valeur" séparés par des ';'. Les options possibles sont documentées plus loin. |
ALPHA(250) |
Statut |
Statut de l'opération : *BLANK si l'opération s'est déroulée correctement. Contient un message d'erreur dans le cas contraire, qui peut aider à déterminer la cause de l'erreur. |
Remarque : le seul paramètre en sortie est le statut de l'opération (dernier paramètre).
Note concernant l'authentification de l'utilisateur :
La détection du mode d'authentification est automatique dès lors que le profil et le mot de passe sont renseignés. Il y a néanmoins des restrictions :
-
-
- la version Mobile ne supporte que les modes d'authentification simples (non sécurisés – PLAIN et login).
- seule la version Windows supporte l'authentification NTLM.
- le cryptage TLS n'est pas supporté de façon générale.
-
Notes concernant les accusés de réception et la notification d'état de la distribution :
-
Les accusés de réception et la notification d'état de la distribution sont envoyés sous la forme d'un email, à l'adresse spécifiée dans le champ "From :" du mail. Cette adresse doit donc être valide si vous souhaitez recevoir les accusés.
L'accusé de réception est une demande émise dans le mail, gérée par le client mail du destinataire.
Selon le client mail utilisé et sa configuration, la réponse peut être automatique, laissée à la discrétion du destinataire, ou simplement ignorée. Le fait de recevoir un accusé implique que le destinataire a ouvert le mail, mais le fait de ne pas en recevoir ne signifie pas forcément que le mail n'a pas été lu.La notification de distribution est gérée directement par le serveur SMTP. Vous ne recevrez une information "sure" que si l'ensemble des relais SMTP traversés par le message supportent cette fonction.
Si l'un des serveurs relais ne supporte pas la fonctionnalité, vous devriez recevoir une information partielle (message relayé jusqu'au domaine "domain"). Si le serveur SMTP spécifié à l'envoi ne fournit pas la fonction, vous ne recevrez aucune information.
Par exemple
| ALPHA(50) | Serveur |
| ALPHA(50) | Utilisateur |
| ALPHA(50) | MotDePasse |
| ALPHA(50) | Sujet |
| ALPHA(50) | Corps |
| ALPHA(50) | From |
| ALPHA(250) | To |
| ALPHA(250) | CC |
| ALPHA(250) | BCC |
| ALPHA(250) | Attaches |
| ALPHA(250) | Options |
| ALPHA(250) | Statut |
| Serveur | = 'mailhost.hardis.fr' |
| Utilisateur | = 'JDupont' |
| MotDePasse | = 'pwddupont' |
| From | = 'jean.dupont@hardis.fr' |
| To | = 'pierre.durand@paris.fr' |
| CC | = 'david.ludo@hardis.fr;eric.martin@paris.fr' |
| BCC | = 'claude.dupond@hardis.fr' |
| Attaches | = 'd:\mypicture1.jpg; d:\mypicture2.jpg ' |
| Sujet | = 'Ceci est un exemple' |
| Corps | = '<html><head/><body><b>Ceci est le corps de mon e-mail exemple</b> </body></html>' |
| Options | = 'html=1' |
| APPELER_DLL 'VaToolBx' 'VaToolBxSendMailSMTP' Serveur Utilisateur MotDePasse From To Cc Bcc Attaches Sujet Corps Options Statut | |
