PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Utilisation du protocole POP3
  • Suppression de messages et nombre de messages reçus (protocole POP3)
  • Utilisation du client MS Exchange, de Pocket Outlook, de Lotus Notes ou Outlook
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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).
    Versions 20 et supérieures
    Il est également possible de forcer la destruction de tous les emails supprimés grâce à la fonction EmailDétruit.
    Nouveauté 20
    Il est également possible de forcer la destruction de tous les emails supprimés grâce à la fonction EmailDétruit.
    Il est également possible de forcer la destruction de tous les emails supprimés grâce à la fonction EmailDétruit.
  • WINDEVWEBDEV - Code ServeurWindows Mobile Client MS Exchange ou Pocket Outlook : 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, Pocket Outlook), 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.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Versions 22 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 22
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
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 à :
Versions 15 et supérieures
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas disponibles.
Nouveauté 15
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas disponibles.
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êtesWindowsWindows MobileAjaxCode Utilisateur (MCU)

Supprimer un email reçu par l'intermédiaire de MS Exchange, Pocket Outlook, Lotus Notes, 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êtesWindowsWindows MobileAjaxCode Utilisateur (MCU)

Utilisation du client MS Exchange, de Pocket Outlook, 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, Pocket Outlook, 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'application permet également de gérer plusieurs comptes emails différents. L'écriture d'un email s'appuie sur le champ de saisie HTML.
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 / IHM : Code métier
Composante : wd240com.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