4D Doc Center : SMTP

4D Internet Commands v14

SMTP_QuickSend


SMTP_QuickSend ( nomServeur ; msgDe ; msgA ; msgObjet ; message {; paramSession}{; port}{; nomUtilisateur ; motDePasse} ) -> Résultat

Paramètre	Type	Description
nomServeur	Chaîne	Nom ou adresse IP du serveur
msgDe	Texte	Adresse électronique ou Liste d'adresses
msgA	Texte	Adresse électronique ou Liste d'adresses
msgObjet	Texte	Objet du message (UTF-8 par défaut)
message	Texte	Message (UTF-8 par défaut)
paramSession	Entier long	0 ou omis = Ne pas utiliser SSL mais bascule permise, 1 = Utiliser SSL, 2 = Ne jamais utiliser SSL (bascule non permise), 4 = Envoyer texte HTML sans SSL, 5 = Envoyer texte HTML avec SSL
port	Entier long	Numéro de port à utiliser
nomUtilisateur	Texte	Nom d’utilisateur pour l’authentification
motDePasse	Texte	Mot de passe pour l’authentification
Résultat	Entier	Code d'erreur

Description

La commande SMTP_QuickSend vous permet de créer et d'envoyer un message en une seule commande. Si vous avez besoin d'un plus grand contrôle sur votre message, ou s'il est plus complexe, utilisez plutôt la commande SMTP_New.

Le paramètre nomServeur contient le nom ou l'adresse IP du serveur SMTP auquel le message sera envoyé pour distribution.

Le paramètre msgDe contient une ou plusieurs adresses électroniques complètes indiquant l'expéditeur initial du message. Toutes les adresses figurant dans l'en-tête Emetteur (From) sont visibles par tous les destinataires du message.

Le paramètre msgA contient une ou plusieurs adresses électroniques complètes. Les adresses figurant dans l'en-tête msgA recevront chacune une copie originale du message. Chaque destinataire du message pourra visualiser les autres adresses électroniques auxquelles le message a été envoyé.

Le paramètre objet contient un texte concis décrivant l'objet du message.

Note : Par défaut, l'objet et le corps du message sont encodés en UTF-8, ce qui garantit que les caractères envoyés seront correctement interprétés par la quasi totalité des clients de messagerie. Si vous souhaitez utiliser un jeu de caractères spécifique, reportez-vous aux commandes SMTP_SetPrefs et SMTP_Charset.

Le paramètre message contient le corps du message électronique. Pour des raisons historiques, la taille du message est limitée à 32 Ko.

Le paramètre optionnel paramSession vous permet de définir le format du message (texte standard ou HTML) et le mode d'activation du protocole SSL pour la connexion :

si vous passez 0 ou omettez ce paramètre, le message sera formaté en texte et envoyé en mode standard non sécurisé. Si le serveur propose une mise à jour en SSL/TLS après l'authentification, la bascule est effectuée automatiquement (fonctionnement du SSL/TLS en mode explicite).
si vous passez 1, le message sera formaté en texte et envoyé en SSL (mode synchrone),
si vous passez 2, le message sera formaté en texte et envoyé en mode standard mais sans prise en charge de la mise à jour en SSL/TLS,
si vous passez 4, le message sera formaté en HTML et envoyé en mode standard,
si vous passez 5, le message sera formaté en HTML et envoyé en mode SSL/TLS.

Le paramètre optionnel port vous permet de spécifier le numéro de port SMTP à utiliser pour la connexion avec le serveur. Les valeurs les plus fréquemment utilisées sont :

25 = port SMTP standard non sécurisé (port par défaut si le paramètre est omis)
465 = port SMTPS (SSL/TLS)
587 = port SMTP standard mais sécurisé ; passez ce port pour les connexions avec un serveur MS Exchange (mode explicite).

Les paramètres optionnels nomUtilisateur et motDePasse permettent d'authentifier l'émetteur auprès du serveur de messagerie. Ces paramètres doivent être passés ensemble. A noter que le mode d'authentification le plus sécurisé pris en charge par le serveur sera utilisé (à l'image du mode par défaut de la commande SMTP_Auth).

Exemple 1

Exemple d'utilisation de cette commande :

 $NomServeur:="www.4d.com"

 $MsgÀ:="adupont@4d.fr"

 $MsgDe:="jsmith@4d.com"

 $Objet:="Rapport de ventes"

 $Message:="Pouvez-vous m'envoyer le rapport des ventes de janvier 2009 ? Merci."

 $Erreur:=SMTP_QuickSend($NomServeur;$MsgDe;$MsgÀ;$Objet;$Message;1)

 Si($Erreur#0)

    ALERTE("Erreur: SMTP_QuickSend"+Caractere(13)+IT_ErrorText($Erreur))

 Fin de si

Exemple 2

Exemple d'utilisation de la commande pour un envoi de message sécurisé via un serveur MS Exchange:

 $NomServeur:="exchange.4d.com"

 $MsgA:="adupont@gmail.com"

 $MsgDe:="un.utilisateur@4d.com"

 $Objet:="Message de test"

 $Message:="Ceci est un test d'envoi en mode sécurisé. Merci de ne pas répondre."

 $Erreur:=SMTP_QuickSend($NomServeur;$MsgDe;$MsgA;$Objet;$Message;0;587;"un.utilisateur";"@!motdepasse@!")

Exemple 3

Envoi d’un message en HTML avec SSL/TLS :

 $Host:="smtp.gmail.com"

 $ToAddress:="john@4d.com"

 $FromAddress:="jeanmarc@gmail.com"

 $Subject:="Message HTML"

 $Message:="Rendez-vous au <b>café du monde</b> !!"

 $Param:=5 //HTML avec SSL

 $Port:=465 //Port SSL de gmail

 $User:="jeanmarc@gmail.com"

 $Password:="xyz&@!&@"

 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;$Param;$Port;$User;$Password)