La fonction VaToolBxJavaSendMail permet d'envoyer un mail. 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 : il est nécessaire d'avoir dans le contexte d'exécution les fichiers suivants :
-
- activation.jar,
- mail.jar.
Ces fichiers sont inclus dans certaines versions de Tomcat 4.1 et dans Websphere 5.
Domaine d'application
Client Java,
Serveur Java,
Client Adélia Web,
Client Adélia Cloud.
Paramètres
ALPHA(n) |
Protocole |
Protocole (ex : "smtp", "pop3", "imap", "nntp", "mmbox", "p7") |
ALPHA(n) |
Hote |
Nom de l'hôte |
NUM_BIN_2 |
Port |
Numéro du port |
ALPHA(n) |
Utilisateur |
Nom d'utilisateur |
ALPHA(n) |
MotDePasse |
Mot de passe associé à l'utilisateur |
ALPHA(n) |
Sujet |
Sujet du e-mail |
ALPHA(n) |
Corps |
Corps de texte du e-mail |
ALPHA(n) |
Expéditeur |
Nom de l'expéditeur |
ALPHA(n) |
Destinataire |
Destinataire principal (To) |
ALPHA(n) |
Copie(m) |
Tableau des destinataires en copie (Cc). Chaque poste du tableau correspond à un destinataire en copie. On s'arrête au premier poste à blanc. |
ALPHA(n) |
Bcopie(m) |
Tableau des destinataires en copie cachée (Bcc). Chaque poste du tableau correspond à un destinataire en copie caché. On s'arrête au premier poste à blanc. |
ALPHA(n) |
Attache(m) |
Tableau des noms de fichiers des pièces jointes au e-mail. Chaque poste correspond au nom complet d'un document attaché. On s'arrête au premier poste à blanc. |
BOOL |
CodeRetour |
Code retour de l'opération : *VRAI si l'opération s'est déroulée correctement. *FAUX dans le cas contraire. |
Remarque : le seul paramètre en sortie est le code retour (le 13ème et dernier paramètre).
Exemple
ALPHA(50) |
Protocole |
ALPHA(50) |
Hote |
NUM_BIN_2 |
Port |
ALPHA(50) |
User |
ALPHA(50) |
Password |
ALPHA(50) |
Sujet |
ALPHA(500) |
Corps |
ALPHA(50) |
From |
ALPHA(50) |
To |
ALPHA(50) |
CC(10) |
ALPHA(50) |
BCC(4) |
ALPHA(246) |
Attaches(3) |
BOOL |
CodeRetour |
|
|
Protocole |
= 'smtp' |
Hote |
= 'mailhost.hardis.fr' |
Port |
= 25 |
User |
= 'JDupont' |
Password |
= 'pwddupont' |
From |
= 'jean.dupont@hardis.fr' |
Sujet |
= 'Ceci est un exemple' |
Corps |
= 'Ceci est le corps de mon e-mail exemple' |
To |
= 'pierre.durand@paris.fr' |
CC(1) |
= 'david.ludo@hardis.fr' |
CC(2) |
= 'eric.martin@paris.fr' |
BCC(1) |
= 'claude.dupond@hardis.fr' |
Attaches(1) |
= 'd:\mypicture.jpg' |
APPELER_DLL 'VaToolBx' 'VaToolBxJavaSendMail' Protocole Hote Port User Password Sujet Corps From To Cc Bcc Attaches CodeRetour