PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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
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
Versions 15 et supérieures

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 :
notesTous
(Valeur par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
Nouveauté 15

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 :
notesTous
(Valeur par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.

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 :
notesTous
(Valeur par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
Versions 15 et supérieures

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 :
notesTous
(par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
Nouveauté 15

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 :
notesTous
(par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement 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 :
notesTous
(par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement 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 :
notesTous
(Valeur par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement 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 :
notesTous
(Valeur par défaut)
Tous les emails.
notesReçuEmails reçus.
notesEnvoyéEmails envoyés.
notesASuivreEmails marqués "A suivre".
notesBrouillonEmails brouillon.

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 :
emailTous ou "TOUS"
(Valeur par défaut)
La recherche est effectuée dans les emails lus et dans les emails non lus.
emailNonLus ou "NON LUS"La recherche est effectuée uniquement dans les emails non lus.
Composante : wd240com.dll
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire