DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Pas d'email suivant
  • Initialisation de la lecture des emails
  • Utilisation du protocole POP 3
  • Utilisation de MS Exchange
  • 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'email reçu suivant l'email en cours :
  • soit par le protocole POP3 ou IMAP : les emails reçus sont présents dans la boîte aux lettres.
  • WINDEVWEBDEV - Code Serveur soit par l'intermédiaire du client MS Exchange : les emails reçus sont présents dans la boîte de réception de MS Exchange. L'email suivant est recherché dans la boîte de réception et sur le serveur.
  • WINDEVWEBDEV - Code Serveur soit par l'intermédiaire du logiciel de messagerie Lotus Notes ou Outlook : les emails reçus sont présents dans la boîte de réception de Lotus Notes ou Outlook. L'email suivant est recherché dans la boîte de réception.
Si aucun email n'est trouvé (pas de message suivant), la variable Email.EnDehors est positionnée à Vrai.
Rappel : Avant de lire un email, il est nécessaire d'ouvrir une session avec la fonction EmailOuvreSession, EmailOuvreSessionNotes ou EmailOuvreSessionOutlook.
LinuxJava Seule la lecture selon le protocole POP3 est disponible.
// Lecture du premier email
EmailLitPremier(IDEmail)
SI Email.EnDehors = Faux ALORS
// Affiche l'expéditeur et le sujet dans une table
TableAjoute(TABLE_EmailRecus, Email.Expéditeur + TAB + Email.Sujet)
// Lecture de l'email suivant
EmailLitSuivant(IDEmail)
FIN
Syntaxe

Lire l'email suivant reçu en utilisant le protocole POP3 ou IMAP Masquer les détails

<Résultat> = EmailLitSuivant(<Session> [, <Email>])
<Résultat> : Booléen
  • Vrai si le message a été lu,
  • Faux dans le cas contraire. En cas d'erreur, la variable ErreurDétectée est à Vrai.
    Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage. S'il n'y a pas d'emails, ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<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.
WINDEVWindowsCode Utilisateur (MCU)

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

<Résultat> = EmailLitSuivant(<Session> [, <Email> [, <Mode de lecture> [, <Type>]]])
<Résultat> : Booléen
  • Vrai si le message a été lu,
  • Faux dans le cas contraire. En cas d'erreur, la variable ErreurDétectée est à Vrai.
    Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage. S'il n'y a pas d'emails, ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<Session> : Entier ou variable de type emailSessionOutlook ou emailSessionNotes
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.
<Mode de lecture> : Constante ou chaîne de caractères optionnelle
Précise les messages qui doivent être lus :
emailNonLus ou "NON LUS"Seuls les messages qui n'ont pas été consultés seront lus.
emailTous ou "TOUS"
(Valeur par défaut)
Tous les messages seront lus.
<Type> : Chaîne de caractères optionnelle
Décrit le type de message à lire. Par défaut, <Type> = "IPM" (Inter Personal Message).
Remarques

Pas d'email suivant

Si aucun email n'a été trouvé (pas de message suivant), la variable Email.EnDehors est positionnée à Vrai. Le prochain appel à la fonction EmailLitSuivant permettra de lire le premier message reçu (équivalent à la fonction EmailLitPremier).

Initialisation de la lecture des emails

Si la lecture n'a pas été initialisée par la fonction EmailLitPremier, la fonction EmailLitSuivant permet de lire le premier message.

Utilisation du protocole POP 3

Lors de la lecture d'un message, les fichiers attachés à ce message peuvent être copiés sur le disque local grâce à la fonction EmailSauveFichierAttaché.
Conseil : Il est conseillé de sauvegarder les messages et leurs fichiers attachés sur le disque local puis de les supprimer du serveur. Cette opération permet :
  • d'alléger la boîte aux lettres sur le serveur,
  • d'améliorer et d'alléger les communications dans les sessions POP3 : seuls les nouveaux messages seront lus sur le serveur.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsCode Utilisateur (MCU)Ajax

Utilisation de MS Exchange

La fonction EmailMiseAJour permet de recevoir les messages depuis le serveur email Internet lors de l'utilisation de MS Exchange.
Lors de la lecture d'un message, les fichiers attachés à ce message sont copiés dans le répertoire temporaire de Windows. Le nom complet de ces fichiers est stocké dans le tableau Email.Attache. Il est possible de copier ces fichiers attachés grâce à la fonction fCopieFichier.
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.
Liste des exemples associés :
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.
WD JavaMail Exemples didactiques (WINDEV) : WD JavaMail
[ + ] Cet exemple est un exemple Java permettant de de lire et envoyer des emails.
Classification Métier / UI : Code métier
Composante : wd300com.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