Réception de courrier, Présentation

4D Internet Commands v16

Les commandes POP3 permettent à votre base de données de récupérer des messages d'un serveur de courrier POP3. Les commandes Internet de 4D sont conformes aux spécifications MIME, elles peuvent reconnaître et extraire des messages contenant plusieurs pièces jointes.

Les commandes POP3 sont réparties en deux thèmes, "IC POP3 Review Mail" et "IC Downloaded Mail", correspondant aux deux modes de lecture du courrier électronique. Le premier mode consiste à prendre connaissance du contenu du courrier, à le télécharger. Le second mode consiste à travailler sur les messages téléchargés.

La taille des fichiers à télécharger va déterminer l'utilisation d'un mode par rapport à l'autre. Par exemple, un seul message électronique auquel est joint un fichier de 5 Mo pourrait facilement dépasser la capacité de stockage de la base de données. Seul un BLOB ou une image 4D est capable d'accueillir des données de cette taille, mais la conversion d'un message ou d'un document joint dans ce format est souvent inefficace car la messagerie cliente doit mobiliser de grandes ressources mémoire pour accéder à l'image ou au BLOB.
Pour résoudre ce problème, la commande POP3_Download transfère un message du serveur POP3 directement sur le disque local de l'utilisateur. Il suffit ensuite d'utiliser les commandes du thème "IC Downloaded Mail" pour manipuler le fichier sur disque.

L'utilisation des commandes POP3 nécessite une bonne compréhension des paramètres numéroMsg et uniqueID. numéroMsg représente le numéro d'un message dans la boîte aux lettres au moment de l'exécution de la commande POP3_Login. A la connexion, les messages de la boîte aux lettres sont numérotés de 1 à x (x étant le nombre d'éléments présents dans la boîte aux lettres). Les numéros sont affectés en fonction de l'ordre dans lequel les messages ont été reçus, le numéro 1 étant le plus ancien. Les numéros affectés aux messages ne sont valides que pendant la période comprise entre POP3_Login et POP3_Logout.

Au moment de l'exécution de POP3_Logout, tout message marqué comme "devant être supprimé" disparaît. Lorsque l'utilisateur se reconnecte au serveur, les messages présents dans la boîte aux lettres sont de nouveau numérotés de 1 à x. Par exemple, s'il y a 10 messages dans la boîte aux lettres, et si les messages numérotés de 1 à 5 sont supprimés, les messages 6 à 10 seront renumérotés de 1 à 5 la prochaine fois que l'utilisateur consultera sa boîte aux lettres.

Pour illustrer ce fonctionnement, supposons que vous vous connectiez à un serveur POP3 et obteniez la liste de messages suivante :

numéroMsg	uniqueID	Date	De	Objet
1	bd573a4dbd573a4d	1 Jul 1998 …	jimw@acme.com	Clients potentiels …
2	bd574dc7bd574dc7	1 Jul 1998 …	frank@acme.com	Commande de licence sur site
3	bd575f06bd575f06	3 Jul 1998 …	joe@acme.com	Qui veut déjeuner ?
4	bd5761d4bd5761d4	4 Jul 1998 …	kelly@acme.com	Appel de votre femme…
5	bd577dc7db577dc5	4 Jul 1995 …	track@fedex.com	Suivi FedEx

Pendant la session, vous supprimez les messages 3 et 4. Lorsque vous quittez la session, vos demandes de suppression sont exécutées. Lorsque vous retournez sur le serveur, la liste de messages est alors renumérotée ainsi :

numéroMsg	uniqueID	Date	De	Objet
1	bd573a4dbd573a4d	1 Jul 1998 …	jimw@acme.com	Clients potentiels …
2	bd574dc7bd574dc7	1 Jul 1998 …	frank@acme.com	Commande de licence sur site
3	bd577dc7db577dc5	4 Jul 1995 …	track@fedex.com	Suivi FedEx

numéroMsg n'est pas une valeur statique se rapportant à un message spécifique, elle indique la position relative d'un message de la boîte aux lettres au moment de l'ouverture de la session.

En revanche, uniqueID est un numéro unique affecté au message lors de sa réception par le serveur. Ce numéro est défini par le serveur POP3 sur la base de l'heure et de la date auxquelles le message est reçu. Malheureusement, les serveurs POP3 n'utilisent pas uniqueID comme référence principale des messages. Aussi, lorsque vous manipulez des messages avec les commandes POP3, vous devez passer numéroMsg comme paramètre d'identification des messages sur le serveur. Par conséquent, vous devez être prudent lorsque vous développez des applications qui référencent des messages dans la base de données tout en laissant le contenu du message sur le serveur.

Note : Pour une plus grande souplesse, les commandes Internet de 4D permettent de passer directement une référence de connexion POP3 aux commandes TCP de bas niveau et inversement. Pour plus d'informations, reportez-vous à la section Routines de bas niveau, Présentation.