VaToolBxSendMailSMTP

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.

Options possibles :

html	0/1	Texte du mail au format HTML.
mime	0/1	Encodage du mail au format MIME. Java : non supporté (encode toujours les courriers au format MIME). Windows, Mobile : encodage MIME forcé si il y a des pièces jointes.
encoding-utf-8	0/1	Encodage du mail au format utf-8. Java : nécessite la version 1.4 ou ultérieure de JavaMail. Pour les versions antérieures, vous pouvez forcer l'encodage unicode à l'aide de l'option —Dmail.mime.charset=utf-8" de la commande java.
connection-type	0/1/2	Type de connexion sécurisée. 0 : connexion non sécurisée 1 : connexion via SSL (port 465 par défaut) 2 : connexion via la commande STARTLS Note : le paramètre ssl=1 est supporté pour compatibilité ascendante, il équivaut à connection-type=1. Java : l'utilisation de la connexion SSL nécessite JAVAMAIL 1.4 ou supérieure l'utilisation de la commande STARTLS nécessite JAVAMAIL 1.4.2 ou supérieure la version de JAVAMAIL incluse avec le Runtime Adélia est la dernière version en date, soit, au moment de la rédaction de cette documentation, la version 1.5.1. Si vous travaillez avec un serveur SMTP ne supportant pas le protocole TLSv1 (protocole utilisé par JAVAMAIL par défaut), il est possible d'activer d'autres protocoles en définissant la variable "mail.smtp.ssl.protocols" sur la ligne de commande. Par exemple, pour activer SSL3, ajouter Dmail.smtp.ssl.protocols="SSLv3 TLSv1" à la ligne de commandes JAVA. Mobile : la connexion sécurisée n'est pas supportée.
priority	0/1/2/3	Priorité du mail. 0 : non spécifié 1 : basse 2 : normale 3 : haute
helo-host	nom d'hôte	Nom d'hôte envoyé au serveur SMTP (commandes HELO / EHLO). Par défaut il s'agit du nom d'hôte du poste exécutant la fonction.
ack	0/1	Demande un accusé de réception (voir notes plus loin).
dsn	0/1	Demande une notification de l'état de la distribution du message (voir notes plus loin).
logfile	' '	Nom d'un fichier de log affichant le contenu de l'échange avec le serveur SMTP.

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`

Liste des fonctions de la DLL VaToolBx par thème

↑ Haut de page