4D Doc Center : Envoi de courrier, Présentation

4D Internet Commands v14

Envoi de courrier, Présentation

SMTP (Simple Mail Transport Protocol) est le protocole standard du courrier électronique sur Internet. Avec les commandes Internet de 4D, vous pouvez créer des messages électroniques simples au moyen d'une seule commande, ou des messages complexes grâce à une série de commandes. Les commandes SMTP vous permettent de contrôler toutes les parties d'un message électronique, dont les en-têtes de Réponse à (Reply-To) et d'Expéditeur (Sender), les pièces jointes, les commentaires et les références.

L'intégration des commandes Internet dans 4D vous permet de développer des bases de données très puissantes pouvant envoyer des messages et des documents sur Internet. A l'aide des commandes SMTP, vous pourrez notamment :

automatiser l'envoi d'états ou de documents créés dans 4D,
construire des applications 4D informant automatiquement les développeurs lors d'événements spécifiques, par exemple en cas d'incident (en utilisant APPELER SUR ERREUR),
envoyer des mailings automatiquement à des personnes dans le monde entier.

Ces commandes, associées aux commandes POP3 (récupération de fichiers et de documents joints), FTP et TCP, fournissent au développeur les outils lui permettant d'augmenter de façon considérable les capacités de communications de ses bases de données 4D.

Deux méthodes de création d'un message électronique

Les commandes SMTP permettent d'envoyer du courrier électronique de deux manières distinctes, appelées précédemment méthode "simple" et méthode "complexe". La méthode "simple" implique une seule commande, SMTP_QuickSend, qui accepte tous les paramètres nécessaires à l'adressage et à l'envoi d'un message.

La majorité des messages envoyés dans le monde sont plutôt simples dans leur construction : quelqu'un "ici" souhaite envoyer un "message" quelconque à quelqu'un se trouvant "là-bas" à propos d'un "objet" spécifique. S'il s'agissait d'un courrier classique, vous devriez écrire le texte, fermer l'enveloppe, rédiger l'adresse puis porter la lettre au bureau de poste pour qu'elle soit expédiée. Avec SMTP_QuickSend, vous pouvez préciser l'Emetteur (From), le Destinataire (To), l'Objet (Subject) et le Corps du message (Message Body) au moyen d'une seule commande.

Cependant, certains messages peuvent nécessiter des paramétrages plus complexes. Par exemple, supposons que la lettre mentionnée plus haut doive être envoyée en plusieurs exemplaires à d'autres destinataires ou qu'un document comme votre rapport annuel doive lui être joint. Dans ce cas, vous devriez photocopier la lettre, imprimer des rapports et préparer une enveloppe pour chaque destinataire. Les commandes SMTP de 4D simplifient la distribution en vous permettant de contrôler tous les aspects de la transmission de courrier électronique. Les documents joints multiples, l'envoi de copie conforme (carbon copy) et de copie discrète (blind carbon) ainsi que toute spécification d'en-tête de courrier peuvent être gérés.

Comprendre la distribution du courrier

L'un des concepts clés pour la compréhension du fonctionnement des commandes SMTP se rapporte au mode de distribution du courrier à ses destinataires. Les commandes SMTP ne transmettent pas directement le courrier à chaque destinataire. Elles effectuent la composition et le formatage appropriés au courrier et transmettent le résultats au serveur SMTP spécifié par la commande SMTP_Host. Le serveur SMTP est généralement une machine se trouvant dans votre entreprise ou chez votre fournisseur d'accès à Internet. Le serveur SMTP détermine alors le chemin de transmission optimal pour votre courrier et programme sa distribution en fonction des paramètres configurés par l'administrateur du courrier.

Conditions minimales requises pour envoyer un message SMTP complexe

Pour une bonne transmission des messages électroniques via SMTP, les commandes doivent avoir été correctement paramétrées. La séquence de commandes suivante représente le minimum requis afin que la transmission de courrier puisse aboutir :

SMTP_New
Réserve un espace mémoire pour le nouveau message et fournit une référence devant être utilisée par les commandes ultérieures.

SMTP_Host
Spécifie le serveur SMTP auquel le message doit être transmis.

SMTP_From
Une adresse au moins doit être spécifiée dans l'en-tête "From".

SMTP_To
Une adresse au moins doit être spécifiée dans l'en-tête "To".

SMTP_Send
Envoie le message.

SMTP_Clear
Réinitialise (libère) l'espace mémoire réservé pour le message.

Si seules ces commandes sont exécutées, un message ne contenant pas d'objet ni de corps est envoyé. Il est donc nécessaire de définir des informations complémentaires pour envoyer un message.

Unicode par défaut (4D v14)

A compter de 4D v14, les champs "objet" (subject) et "corps" (body) des commandes SMTP utilisent par défaut le jeu de caractères UTF-8. Ce jeu de caractères sera correctement interprété par la quasi totalité des clients de messagerie. Ce fonctionnement simplifie largement l’utilisation des commandes SMTP et limite désormais l'utilité des commandes SMTP_Charset et SMTP_SetPrefs.