SMTP_QuickSend

4D v15

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, 8 = Envoyer Mime HTML sans SSL/TLS, 9 = Envoyer Mime HTML avec SSL/TLS
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

Introduit dans 4D v14 R5

La commande SMTP_QuickSend vous permet désormais d'envoyer des messages au format Mime HTML, avec ou sans protocole sécurisé SSL/TLS. Le Mime HTML (extension de fichier .mht ou .mhtml) est un format d'archive de page Web qui peut combiner du code HTML et des ressources externes telles que des images dans un seul document. Il est pris en charge par de nombreux navigateurs Web ainsi que par MS Word, par exemple. Comme ce format est également pris en charge par les zones 4D Write Pro, vous pouvez facilement enregistrer et envoyer des documents 4D Write Pro par mail avec toutes leurs ressources.

Passez 8 dans paramSession pour formater le message en Mime HTML et l'envoyer en mode standard.
Passez 9 dans paramSession pour formater le message en Mime HTML et l'envoyer en mode SSL/TLS.

A noter que ces valeurs correspondent à des combinaisons usuelles, toutefois le paramètre paramSession étant en fait un "champ de bits" (bit field), il permet de définir toute combinaison personnalisée à l'aide des opérateurs sur les bits :

Numéro de bit	Format utilisé si le bit est à 1
0	Utiliser SSL ou le paramétrage par défaut, connexion en clair et mise à niveau en SSL si possible.
1	Ne jamais mettre à niveau, rester en mode non encrypté même si SSL possible. Ce bit est ignoré si SSL (bit 0) est sélectionné.
2	Body du message en HTML, définir l'en-tête de façon appropriée.
3	Message MHTML, le bit 2 (HTML) est ignoré. L'utilisateur doit définir tous les en-têtes sauf "A", "De", "Date", et "Objet"

Note : Cette commande ne peut être utilisée dans les bases de données converties fonctionnant en mode "non-unicode".

Exemple

Vous avez enregistré un document .mht sur votre disque et souhaitez l'envoyer par email. Pour cela, vous pouvez écrire :

 $Message:=Document vers texte("c:\\documents\\invitation.mht")

 $Host:="smtp.gmail.com"

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

 $FromAddress:="harry@gmail.com"

 $Subject:="Faisons la fête"

 $Param:=9 //MHTML avec SSL

 $Port:=465 //Port SSL de gmail

 $User:="harry@gmail.com"

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

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