DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Utilisation du protocole POP3
  • Suppression de messages et nombre de messages reçus (protocole POP3)
  • Utilisation du client MS Exchange, de Lotus Notes ou Outlook
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet de supprimer l'email en cours via un protocole spécifique :
  • Protocole POP3 : l'email est supprimé directement sur le serveur d'emails.
  • Protocole IMAP : l'email est marqué "effacé/supprimé". Il sera réellement supprimé du serveur d'emails lors de la prochaine commande "expunge" (par exemple, vider la corbeille depuis un WebMail).
    Il est également possible de forcer la destruction de tous les emails supprimés grâce à la fonction EmailDétruit.
  • WINDEVWEBDEV - Code Serveur Client MS Exchange : l'email est supprimé de la boîte de réception des messages.
  • WINDEVWEBDEV - Code Serveur Messagerie Lotus Notes ou Outlook : l'email est supprimé de la boîte de réception des messages.
Après l'exécution de la fonction EmailSupprimeMessage, la variable Email.EnDehors est positionnée à Vrai.
Rappel : Avant de manipuler un email (lecture ou suppression d'un email par exemple), il est nécessaire d'ouvrir une session avec la fonction EmailOuvreSession (pour le protocole POP3, MS Exchange), avec la fonction EmailOuvreSessionNotes (pour le logiciel de messagerie Lotus Notes) ou avec la fonction EmailOuvreSessionOutlook ou OutlookOuvreSession (pour le logiciel de messagerie Outlook).
LinuxJava Seule la suppression d'emails par le protocole POP3 est disponible.
cMaSession est une emailSessionIMAP
...
SI EmailOuvreSession(cMaSession) ALORS
cMonEmail est un Email
EmailLitPremier(cMaSession, cMonEmail)
TANTQUE PAS cMonEmail..EnDehors
EmailSupprimeMessage(cMaSession, cMonEmail)
EmailLitSuivant(cMaSession, cMonEmail)
FIN
EmailFermeSession(cMaSession)
FIN
// Utilisation avec le logiciel de messagerie Outlook
// TABLE_TableEmail contient l'ensemble des emails reçus
// COL_Exp contient le nom de l'expéditeur (variable Email.Expéditeur)
// COL_Sujet contient le sujet de l'email (variable Email.Sujet)
// COL_ID contient l'identifiant de l'email (variable Email.ID)
// Suppression de l'email sélectionné dans le champ Table
EmailSupprimeMessage(IDSession, COL_ID)
Syntaxe

Supprimer un email reçu en utilisant le protocole POP3 ou IMAP Masquer les détails

<Résultat> = EmailSupprimeMessage(<Session> [, <Email ou Numéro du message>])
<Résultat> : Booléen
  • Vrai si le message a été supprimé,
  • Faux dans le cas contraire.
<Session> : Chaîne de caractères ou variable de type emailSessionPOP3 ou emailSessionIMAP
Identifie la session d'un utilisateur. Ce paramètre correspond à :
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas disponibles.
<Email ou Numéro du message> : Variable de type Email ou Entier optionnel
Si ce paramètre est une variable de type Email, le message correspondant à la variable est supprimé.
Si ce paramètre est un entier, il désigne le numéro du message à supprimer sur le serveur.
Si ce paramètre n'est pas précisé, le dernier message lu est supprimé du serveur d'emails.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsCode Utilisateur (MCU)Ajax

Supprimer un email reçu par l'intermédiaire de MS Exchange, Lotus Notes ou Outlook Masquer les détails

<Résultat> = EmailSupprimeMessage(<Session> [, <Email ou Identifiant du message>])
<Résultat> : Booléen
  • Vrai si le message a été supprimé,
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Session> : Entier ou variable de type EMailSessionOutlook
Identifiant de la session email en cours. Cette valeur peut être :
<Email ou Identifiant du message> : Variable de type Email ou Chaîne de caractères optionnelle
Si ce paramètre est une variable de type Email, le message correspondant à la variable est supprimé.
Si ce paramètre est une chaîne de caractères, il désigne l'identifiant du message à supprimer sur le serveur.
Si le paramètre n'est pas précisé, le dernier message lu est supprimé du serveur d'emails et la variable Email.EnDehors est positionnée à Vrai.
Remarques

Utilisation du protocole POP3

Si le paramètre <Numéro message> :
  • n'est pas précisé : le dernier message lu est supprimé du serveur d'emails.
  • est précisé : le message identifié par <Numéro message> est supprimé du serveur d'emails.
Lors de la suppression d'un message avec la fonction EmailSupprimeMessage :
  • Le message ne sera effectivement supprimé du serveur d'emails que lors de la déconnexion (fonction EmailFermeSession).
  • La variable Email.EnDehors est positionnée à Vrai.

Suppression de messages et nombre de messages reçus (protocole POP3)

Si un message a été supprimé par la fonction EmailSupprimeMessage :
  • la fonction EmailNbMessage renvoie le nombre de messages présents sur le serveur d'emails avant la suppression.
  • les numéros des messages ne sont pas ré-affectés.
Ainsi, si quatre messages sont présents sur le serveur lors de la connexion, ces messages sont numérotés de 1 à 4. Si le message 1 est supprimé :
  • La fonction EmailNbMessage (utilisée dans la même session) renvoie 4.
  • La lecture du message 1 avec la fonction EmailLitMessage est impossible car le message n'existe plus (seuls les messages 2, 3 et 4 existent).
Les numéros des messages sont ré-affectés lors de la prochaine connexion.
Attention : Gmail via une session POP3 : lors de l'utilisation de la fonction EmailSupprimeMessage, l'email est marqué comme supprimé mais il n'est pas supprimé. Il s'agit du comportement normal de Gmail via POP3.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsCode Utilisateur (MCU)Ajax

Utilisation du client MS Exchange, de Lotus Notes ou Outlook

Le dernier message lu est supprimé des messages reçus. Ce message ne sera plus visualisé lors du parcours des messages par les fonctions EmailLitPremier et EmailLitSuivant.
Après l'exécution de la fonction EmailSupprimeMessage, la variable Email.EnDehors est positionnée à Vrai.
Il est possible de retrouver un message supprimé en consultant la boîte des messages supprimés de MS Exchange, Lotus Notes ou Outlook.
Liste des exemples associés :
WD Mail Exemples complets (WINDEV) : WD Mail
[ + ] Cette application est un client mail complet développé en WINDEV. Il s'appuie sur les objets Email.
Ce client mail permet de récupérer et d'envoyer des emails en utilisant les protocoles POP, IMAP et SMTP.
Il est possible d'appliquer des filtres sur le courrier entrant.
L'écriture d'un email s'appuie sur le champ Editeur HTML.
L'affichage des emails utilise le champ Affichage HTML.
L'application permet de gérer plusieurs comptes emails différents.
Les fonctions Email POP3 Exemples unitaires (WINDEV) : Les fonctions Email POP3
[ + ] Utilisation des fonctions Email pour gérer le protocole POP3.
Ce protocole sert à récupérer des emails depuis un serveur.
Classification Métier / UI : Code métier
Composante : wd300com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
marche pas pour imap
EmailSupprimeMessage(cMaSession, cMonEmail)

provoque une erreur d'édition
Jean philippe
03 nov. 2018

Dernière modification : 21/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale