DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Nombre de messages présents dans la boîte aux lettres (protocole POP3)
  • Nombre de messages présents dans la boîte aux lettres (messagerie Outlook)
  • Messagerie 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
Lit l'entête d'un email reçu :
  • soit par le protocole POP3 ou IMAP : l'email est présent dans la boîte aux lettres sur le serveur de messagerie.
  • WINDEVWEBDEV - Code Serveur soit par l'intermédiaire du logiciel de messagerie Lotus Notes ou Outlook : l'email reçu est présent sur le poste local dans la boîte de réception de Lotus Notes ou Outlook.
Les différentes variables de la structure email correspondant à l'entête du message sont remplies.
Cette fonction est utile lorsque la lecture de l'email est par exemple liée à la taille du message.
Si aucun email n'est trouvé, la variable Email.EnDehors est positionnée à Vrai.
Rappel : Avant de lire un email, il est nécessaire d'ouvrir une session avec une des fonctions suivantes : EmailOuvreSession, EmailOuvreSessionNotes ou EmailOuvreSessionOutlook.
Java Seule la lecture par le protocole POP3 est disponible.
Exemple
// Utilisation du protocole POP3
// Lecture des emails dont la taille ne dépasse pas TailleMaxEmail
I est un entier
POUR I = 1 À EmailNbMessage(NomUser)
SI EmailTailleMessage(NomUser, I) < TailleMaxEmail ALORS
// Procédure de lecture et traitement du message
LireMessage()
SINON
EmailLitEntêteMessage(NomUser, I)
// Procédure de réponse signalant que l'email n'a pas été lu
RenvoiMessage(Email.AdresseExpéditeur)
FIN
FIN
WINDEVWEBDEV - Code Serveur
// 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)
// Lecture de l'entête de l'email sélectionné dans la table
EmailLitEntêteMessage(IDSession, COL_ID)
Syntaxe

Lire l'entête d'un email géré par le protocole POP3 ou IMAP Masquer les détails

<Résultat> = EmailLitEntêteMessage(<Session> [, <Email>] , <Numéro message>)
<Résultat> : Booléen
  • Vrai si l'entête du message a été lu. Dans ce cas, la structure email est automatiquement mise à jour.
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
La variable Email.EnDehors est positionnée à Vrai si aucun message n'a été trouvé (pas de mail).
<Session> : Chaîne de caractères ou variable de type emailSessionPOP3 ou emailSessionIMAP
Identifie la session d'un utilisateur. Correspond :
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas supportées.
<Email> : Variable de type Email optionnelle
Nom de la variable de type Email à initialiser avec le contenu du message.
Java Ce paramètre n'est pas disponible
Si ce paramètre n'est pas spécifié, la structure Email est utilisée.
<Numéro message> : Entier
Numéro du message dont l'entête doit être lu.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax

Lire l'entête d'un email géré par l'intermédiaire de Lotus Notes ou Outlook Masquer les détails

<Résultat> = EmailLitEntêteMessage(<Session> [, <Email>] , <Identifiant message>)
<Résultat> : Booléen
  • Vrai si l'entête du message a été lu. Dans ce cas, la structure email est automatiquement mise à jour.
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
La variable Email.EnDehors est positionnée à Vrai si aucun message n'a été trouvé (pas de mail).
<Session> : Entier
Identifiant de la session email en cours. Cet identifiant peut être :
<Email> : Variable de type Email optionnelle
Nom de la variable de type Email à initialiser avec le contenu du message.
Si ce paramètre n'est pas spécifié, la structure Email est utilisée.
<Identifiant message> : Chaîne de caractères
Identifiant du message dont l'entête doit être lu. Cet identifiant est contenu dans la variable Email.ID lors de la lecture des emails.
Remarques

Nombre de messages présents dans la boîte aux lettres (protocole POP3)

Le nombre total des messages reçus est obtenu grâce à la fonction EmailNbMessage.
Si, dans la même session d'emails, 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 supprimés ne sont pas ré-affectés.
Par exemple : Lors de la connexion, quatre messages sont sur le serveur et ces messages sont numérotés de 1 à 4. Si le message 1 est supprimé :
  • La fonction EmailNbMessage renvoie 4.
  • La lecture du message 1 avec la fonction EmailLitMessage ou la fonction EmailLitEntêteMessage est impossible : le message n'existe plus. La variable Email.EnDehors retourne Vrai. Seuls les messages 2, 3 et 4 existent.
Les numéros des messages sont ré-affectés lors de la prochaine connexion.
WINDEVWEBDEV - Code Serveur

Nombre de messages présents dans la boîte aux lettres (messagerie Outlook)

Le nombre total des messages reçus est obtenu par la fonction EmailNbMessage.
Si, dans la même session d'emails, un message a été supprimé par la fonction EmailSupprimeMessage, la fonction EmailNbMessage renvoie le nombre correct de messages présents dans le dossier des emails reçus.
WINDEVWEBDEV - Code Serveur

Messagerie Outlook

Les fonctions WLangage EmailLitxxx fonctionnent uniquement avec le fichier de données Outlook (.pst) par défaut. Les autres fichiers de données ne sont pas gérés.
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

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