DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • La structure Email et les variables de type Email
  • Les fichiers attachés
  • Jauge de progression
  • 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 le dernier 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.
  • WINDEV soit par l'intermédiaire du client MS Exchange : l'email est présent sur le poste local dans la boîte de réception de MS Exchange.
  • WINDEV soit par l'intermédiaire du logiciel de messagerie Lotus Notes ou Outlook : l'email est présent sur le poste local dans la boîte de réception de Lotus Notes ou Outlook.
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 la fonction EmailOuvreSession, EmailOuvreSessionNotes ou EmailOuvreSessionOutlook.
Java Seule la lecture par le protocole POP3 est disponible.
// Lecture du dernier email
SI EmailLitDernier(NomUser) = Vrai ALORS
// Si l'email existe, ouvre FEN_Email_RCV pour lire l'email
SI Email.EnDehors = Faux ALORS
Ouvre(FEN_Email_RCV)
SINON
Info("Pas de mail")
FIN
SINON
Erreur()
FIN
Syntaxe

Lire le dernier email géré par le protocole POP3/IMAP Masquer les détails

<Résultat> = EmailLitDernier(<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.
La variable Email.EnDehors est positionnée à Vrai si aucun message n'a été trouvé (pas de mail) et la variable ErreurDétectée reste à Faux.
<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 correspondant à l'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.
WINDEVCode Utilisateur (MCU)

Lire le dernier email géré par l'intermédiaire de MS Exchange, Lotus Notes, Outlook Masquer les détails

<Résultat> = EmailLitDernier(<Session> [, <Email> [, <Mode lecture>]])
<Résultat> : Booléen
  • Vrai si le message a été lu. Dans ce cas, la structure email est automatiquement mise à jour.
  • 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.
La variable Email.EnDehors est positionnée à Vrai si aucun message n'a été trouvé (pas de mail) et ErreurDétectée reste à Faux.
<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 correspondant à l'email à initialiser avec le contenu du message.
Si ce paramètre n'est pas spécifié, la structure Email est utilisée.
<Mode 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.
Remarques

La structure Email et les variables de type Email

Deux méthodes de manipulation des emails sont disponibles :
  • La structure Email est une structure globale permettant de manipuler simplement un message.
  • Les variables de type Email offrent des fonctionnalités plus avancées (data binding, sérialisation, instances multiples).
Lors de la lecture de l'email, la structure Email est automatiquement mise à jour en fonction du contenu du message.
Les variables Email.Cci et Email.NbCci (ou la propriété Cci dans le cas de l'utilisation d'une variable de type Email) sont vidées.

Les fichiers attachés

Lors de la lecture d'un message, les fichiers attachés à ce message peuvent être copiés sur le disque local (ou sur le disque du serveur) grâce à la fonction EmailSauveFichierAttaché.
Conseil : Il est conseillé de sauvegarder les messages et leurs fichiers attachés sur le disque local (ou sur le disque du serveur) puis de les supprimer du serveur d'email. Cette opération permet :
  • d'alléger la boîte aux lettres sur le serveur,
  • d'améliorer et d'alléger les communications pour les serveurs POP3 : seuls les nouveaux messages seront lus sur le serveur.
WINDEVWindowsUniversal Windows 10 AppCode Utilisateur (MCU)

Jauge de progression

Pour suivre la progression de la réception de l'email, utilisez la fonction EmailJauge.
WINDEV

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.
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