DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
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
Recherche un ou plusieurs emails selon des critères spécifiés, dans une base locale ou distante Lotus Notes ou Domino.
Cette recherche peut être effectuée :
  • soit dans une ou plusieurs parties de l'email.
  • soit à l'aide d'une formule de sélection de Lotus Notes.
Exemple
// Ouverture d'une session Lotus Notes
IDSession est un entier
IDSession = EmailOuvreSessionNotes("MotDePasse", "ServeurMars", ...
"mail/julie.nsf", "C:\Lotus Notes\julie.id")
...
// Recherche des emails contenant la chaîne "PC Soft"
// dans le sujet ou dans le corps du message
// Seuls les emails reçus sont pris en compte
SI EmailCherchePremierNotes(IDSession, emailSujet + emailCorps, ...
"PC Soft", notesReçu) = Vrai ALORS
// Enumération des emails trouvés
TANTQUE Email.EnDehors = Faux
// Affiche l'expéditeur et le sujet dans un champ Table
TableAjoute(TABLE_EmailTrouve, Email.Expéditeur + ...
TAB + Email.Sujet)
// Email trouvé suivant
EmailLitSuivant(IDSession)
FIN
SINON
Info("Aucun email n'a été trouvé")
FIN
// Ouverture d'une session Lotus Notes
IDSession est un entier
IDSession = EmailOuvreSessionNotes("MotDePasse", "ServeurMars", ...
"mail/julie.nsf", "C:\Lotus Notes\julie.id")
...
// Recherche grâce à une formule de sélection de Lotus Notes
// Recherche des emails contenant la chaîne "pc soft"
// dans le sujet ou dans le corps du message
// et contenant WinDev dans la catégorie
// Seuls les emails reçus et non lus sont pris en compte
SI EmailCherchePremierNotes(IDSession, emailSujet + emailCorps, ...
"PC Soft", "@contains(@lowercase(categories);'WinDev')", ...
notesReçu, emailNonLus) = Vrai ALORS
// Enumération des emails trouvés
TANTQUE Email.EnDehors = Faux
// Affiche l'expéditeur et le sujet dans un champ Table
TableAjoute(TABLE_EmailTrouve, Email.Expéditeur + ...
TAB + Email.Sujet)
// Email trouvé suivant
EmailLitSuivant(IDSession)
FIN
SINON
Info("Aucun email n'a été trouvé")
FIN
Syntaxe

Recherche dans une ou plusieurs parties d'une variable de type Email Masquer les détails

<Résultat> = EmailCherchePremierNotes(<Session> , <Email> , <Partie de l'email> , <Valeur cherchée> [, <Type d'email> [, <Mode de lecture>]])
<Résultat> : Booléen
  • Vrai si un ou plusieurs emails ont été trouvés,
  • 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.
Si aucun email n'a été trouvé, la variable ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<Session> : Entier ou Variable de type emailSessionNotes
La session peut être :
<Email> : Variable de type Email
Nom de la variable de type Email correspondant à l'email dans lequel la recherche doit être effectuée.
<Partie de l'email> : Constante ou combinaison de constante de type Entier
Partie de l'email dans laquelle ou lesquelles la <Valeur cherchée> doit être recherchée :
emailCorpsCorps des emails.
emailDestinataireDestinataires des emails.
emailExpéditeurExpéditeurs des emails.
emailSujetSujets des emails.

Ces constantes peuvent être combinées.
<Valeur cherchée> : Chaîne de caractères
Valeur recherchée dans les emails.
<Type d'email> : Constante ou combinaison de constantes optionnelle, de type Entier
Type d'email dans lequel la recherche va être effectuée :
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.
notesEnvoyéEmails envoyés.
notesReçuEmails reçus.
notesTous
(Valeur par défaut)
Tous les emails.

Ces constantes peuvent être combinées.
<Mode de lecture> : Constante ou chaîne de caractères optionnelle
Précise les messages qui doivent être lus :
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.

Recherche à l'aide d'une formule de sélection de Lotus Notes dans une variable de type Email Masquer les détails

<Résultat> = EmailCherchePremierNotes(<Session> , <Email> , <Partie de l'email> , <Valeur cherchée> , <Formule Lotus Notes> [, <Type d'email> [, <Mode de lecture>]])
<Résultat> : Booléen
  • Vrai si un ou plusieurs emails ont été trouvés,
  • 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.
Si aucun email n'a été trouvé, la variable ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<Session> : Entier ou Variable de type emailSessionNotes
La session peut être :
<Email> : Variable de type Email
Email dans lequel la recherche doit être effectuée.
<Partie de l'email> : Constante ou combinaison de constante de type Entier
Partie de l'email dans laquelle ou lesquelles la <Valeur cherchée> doit être recherchée :
emailAucunRecherche effectuée uniquement à l'aide d'une formule de sélection de Lotus Notes. Dans ce cas, le paramètre <Valeur cherchée> correspond à une chaîne vide ("").
Cette constante ne peut pas être combinée.
emailCorpsCorps des emails.
emailDestinataireDestinataires des emails.
emailExpéditeurExpéditeurs des emails.
emailSujetSujets des emails.

Ces constantes peuvent être combinées.
<Valeur cherchée> : Chaîne de caractères
  • Valeur recherchée dans les emails,
  • Chaîne vide ("") si le paramètre <Partie de l'email> correspond à la constante emailAucun.
<Formule Lotus Notes> : Chaîne de caractères
Formule de sélection des emails dans Lotus Notes. Pour plus de détails sur ces formules de sélection, consultez la documentation de Lotus Notes.
<Type d'email> : Constante ou combinaison de constantes optionnelle, de type Entier
Type d'email dans lequel la recherche va être effectuée :
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.
notesEnvoyéEmails envoyés.
notesReçuEmails reçus.
notesTous
(par défaut)
Tous les emails.

Ces constantes peuvent être combinées.
<Mode de lecture> : Constante ou chaîne de caractères optionnelle
Précise les messages qui doivent être lus :
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.

Recherche dans une ou plusieurs parties de la structure email Masquer les détails

<Résultat> = EmailCherchePremierNotes(<Session> , <Partie de l'email> , <Valeur cherchée> [, <Type d'email> [, <Mode de lecture>]])
<Résultat> : Booléen
  • Vrai si un ou plusieurs emails ont été trouvés,
  • 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.
Si aucun email n'a été trouvé, la variable ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<Session> : Entier ou Variable de type emailSessionNotes
La session peut être :
<Partie de l'email> : Constante ou combinaison de constante de type Entier
Partie de l'email dans laquelle ou lesquelles la <Valeur cherchée> doit être recherchée :
emailCorpsCorps des emails.
emailDestinataireDestinataires des emails.
emailExpéditeurExpéditeurs des emails.
emailSujetSujets des emails.

Ces constantes peuvent être combinées.
<Valeur cherchée> : Chaîne de caractères
Valeur recherchée dans les emails.
<Type d'email> : Constante ou combinaison de constantes optionnelle, de type Entier
Type d'email dans lequel la recherche va être effectuée :
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.
notesEnvoyéEmails envoyés.
notesReçuEmails reçus.
notesTous
(Valeur par défaut)
Tous les emails.

Ces constantes peuvent être combinées.
<Mode de lecture> : Constante ou chaîne de caractères optionnelle
Précise les messages qui doivent être lus :
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.

Recherche à l'aide d'une formule de sélection de Lotus Notes dans la structure Email Masquer les détails

<Résultat> = EmailCherchePremierNotes(<Session> , <Partie de l'email> , <Valeur cherchée> , <Formule Lotus Notes> [, <Type d'email> [, <Mode de lecture>]])
<Résultat> : Booléen
  • Vrai si un ou plusieurs emails ont été trouvés,
  • 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.
Si aucun email n'a été trouvé, ErreurDétectée reste à Faux et la variable Email.EnDehors est positionnée à Vrai.
<Session> : Entier ou Variable de type emailSessionNotes
La session peut être :
<Partie de l'email> : Constante ou combinaison de constante de type Entier
Partie de l'email dans laquelle ou lesquelles la <Valeur cherchée> doit être recherchée :
emailAucunRecherche effectuée uniquement à l'aide d'une formule de sélection de Lotus Notes. Dans ce cas, le paramètre <Valeur cherchée> correspond à une chaîne vide ("").
Cette constante ne peut pas être combinée.
emailCorpsCorps des emails.
emailDestinataireDestinataires des emails.
emailExpéditeurExpéditeurs des emails.
emailSujetSujets des emails.

Ces constantes peuvent être combinées.
<Valeur cherchée> : Chaîne de caractères
  • Valeur recherchée dans les emails,
  • Chaîne vide ("") si le paramètre <Partie de l'email> correspond à la constante emailAucun.
<Formule Lotus Notes> : Chaîne de caractères
Formule de sélection des emails dans Lotus Notes. Pour plus de détails sur ces formules de sélection, consultez la documentation de Lotus Notes.
<Type d'email> : Constante ou combinaison de constantes optionnelle, de type Entier
Type d'email dans lequel la recherche va être effectuée :
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.
notesEnvoyéEmails envoyés.
notesReçuEmails reçus.
notesTous
(Valeur par défaut)
Tous les emails.

Ces constantes peuvent être combinées.
<Mode de lecture> : Constante ou chaîne de caractères optionnelle
Précise les messages qui doivent être lus :
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
Composante : wd300com.dll
Version minimum requise
  • Version 11
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