EmailLitPremier (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails

Les fichiers attachés
Utilisation de MS Exchange
Jauge de progression

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

EmailLitPremier (Fonction)

En anglais : EmailReadFirst

Lit le premier 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.

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.

Exemple

Voir des exemples supplémentaires

// Lecture du premier email
EmailLitPremier(IDEmail)
SI Email.EnDehors = Faux ALORS
// Affiche l'email dans la fenêtre FEN_Email_RCV
Ouvre(FEN_Email_RCV)
FIN

Syntaxe

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

<Résultat> = EmailLitPremier(<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 :
au nom d'utilisateur utilisé pour ouvrir la session email (fonction EmailOuvreSession).
à une variable de type emailSessionPOP3.
à une variable de type emailSessionIMAP.

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

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

<Résultat> = EmailLitPremier(<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 :
un entier renvoyé par la fonction EmailOuvreSessionOutlook ou OutlookOuvreSession.
une variable de type emailSessionOutlook.
une variable de type emailSessionNotes.
une variable de type emailSessionIMAP.

<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

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 : seuls les nouveaux messages seront lus sur le serveur.

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.

Jauge de progression

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

Liste des exemples associés :