PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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)
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Lit 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.
  • Windows Mobile soit par l'intermédiaire de Pocket Outlook (compte utilisateur différent du compte "ActiveSync") : l'email est placé dans la boîte de réception de Pocket Outlook.
Cette fonction ne modifie pas la position courante.
Les différentes variables de la structure email (ou de la variable de type Email) sont remplies.
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.
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.
// Utilisation avec le protocole POP3
I est un entier
nbMSG est un entier = EmailNbMessage(NomUser)
POUR I = 1 À nbMSG
SI EmailLitMessage(NomUser, I) = Vrai ALORS
SI Email.EnDehors <> Vrai ALORS
CL.NOM = Email.Expéditeur
CL.MESSAGE_TXT = Email.Message
...
SINON
Info("Ce message a été supprimé")
FIN
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'email sélectionné dans le champ Table
EmailLitMessage(IDSession, COL_ID)
// Récupération du contenu de l'email
Info("Message de l'email : " + Email.Message)
 
Syntaxe

Lire un email géré par le protocole POP3 ou IMAP Masquer les détails

<Résultat> = EmailLitMessage(<Session> [, <Email>] , <Numéro message>)
<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. 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 :
Versions 15 et supérieures
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas supportées.
Nouveauté 15
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas supportées.
Java Les variables de type emailSessionPOP3 et emailSessionIMAP ne sont pas supportées.
<Email> : Variable de type Email optionnelle
Versions 15 et supérieures
Nom de la variable de type Email à initialiser avec le contenu du message.
Java Ce paramètre n'est pas disponible
Nouveauté 15
Nom de la variable de type Email à initialiser avec le contenu du message.
Java Ce paramètre n'est pas disponible
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
  • Indice du message à lire en POP3
  • Identifiant (UID) du message en IMAP.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)

Lire un email géré par l'intermédiaire de Pocket Outlook, Lotus Notes, Outlook Masquer les détails

<Résultat> = EmailLitMessage(<Session> [, <Email>] , <Identifiant message>)
<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. 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 ou variable de type emailSessionOutlook ou emailSessionNotes
Identifiant de la session email en cours. Cet identifiant peut être :
<Email> : Variable de type Email optionnelle
Versions 15 et supérieures
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.
Nouveauté 15
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.
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 (avec guillemets)
Identifiant du message à lire. 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 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 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. 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 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 ServeurWindows Mobile

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.

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 sur les serveurs POP3 : seuls les nouveaux messages seront lus sur le serveur.
WINDEVEtats et RequêtesAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppCode Utilisateur (MCU)

Jauge de progression

Pour suivre la progression de la réception de l'email, utilisez la fonction EmailJauge.
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.
Classification Métier / IHM : Code métier
Composante : wd240com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire