4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Sender


SMTP_Sender ( smtp_ID ; msgExpéditeur {; supprimerOption} ) -> Résultat

Paramètre	Type	Description
smtp_ID	Entier long	Référence du message
msgExpéditeur	Texte	Adresse électronique (1 seulement)
supprimerOption	Entier	0 = Ajouter, 1 = Remplacer, 2 = Supprimer
Résultat	Entier	Code d'erreur

Description

La commande SMTP_Sender permet de paramétrer l'adresse e-mail de la personne qui envoie le message. Cette commande est destinée à être utilisée lorsque l'expéditeur n'est pas le véritable auteur du message, ou pour désigner la personne qui, dans un groupe d'auteurs, a réellement envoyé le message. Cette commande n'est pas nécessaire lorsque le contenu du champ "Expéditeur" (Sender) est redondant avec celui du champ "Emetteur(s)" (From).

Lorsque les messages sont créés et envoyés automatiquement par un programme, la zone d'en-tête "Expéditeur" doit désigner le compte e-mail de l'administrateur du programme et non le compte géré par le programme.

smtp_ID contient l'identifiant du message électronique créé avec la commande SMTP_New.

Le paramètre msgExpéditeur contient l'adresse électronique à insérer dans l'en-tête "Expéditeur" du message. Une seule adresse peut être spécifiée pour cet en-tête.

Le paramètre supprimerOption permet de spécifier s'il faut conserver ou supprimer la zone d'en-tête "Expéditeur" éventuellement existante :

Si vous passez 0 (zéro), le contenu du paramètre passé est ajouté au contenu de l'en-tête existant.
Si vous passez 1, le contenu du paramètre passé remplace le contenu de l'en-tête existant. Dans ce cas, si vous avez passé une chaîne vide, l'en-tête "Expéditeur" est supprimé.
Si vous passez 2, l'en-tête "Expéditeur" est supprimé du message.
Si ce paramètre est omis, par défaut la valeur 0 est utilisée.

Exemple

Dans cet exemple, trois cadres composent un message concernant une modification de politique de l'entreprise. Ce message doit être distribué à tout le personnel de la société par la secrétaire. Les réponses éventuelles devront être envoyées aux trois personnes répertoriées dans l'en-tête "Emetteur(s)".

 $Emetteur:="prez@acme.com,vp@acme.com,cfo@acme.com"

 $Erreur:=SMTP_From($smtp_id;$Emetteur;0)

 $Erreur:=SMTP_Sender($smtp_id;"secretaire@acme.com";0)

 $Erreur:=SMTP_Subject($smtp_id;"Changement de politique de l'entreprise";0)

 $Erreur:=SMTP_To($smtp_id;◊Tous_employés;0)