DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Lotus Notes / Fonctions Notes
  • Recherche dans les colonnes d'une vue
  • Colonnes de type DateHeure
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 le premier document présent dans la vue en cours dans Lotus Notes. Cette recherche s'effectue uniquement dans les colonnes triables de la vue en cours.
La recherche est effectuée en faisant correspondre chaque valeur spécifiée à la valeur présente dans la colonne triable correspondante. Le document trouvé correspond au document ayant toutes les valeurs spécifiées.
La vue en cours a été spécifiée à l'aide de la fonction NotesActiveVue.
Exemple
// Ouverture de la connexion
IDConnexion est un entier
IDConnexion = NotesOuvreConnexion("MotDePasse", "ServeurMars", ...
"C:\Users\Julie\AppData\Local\Lotus\Notes\Data\user.id")
// Spécification de la base Lotus Notes à utiliser
IDBase est un entier
IDBase = NotesOuvreBase(IDConnexion, "julie.nsf")
...
// Activation de la vue
NotesActiveVue(IDBase, "MesClients")
// Cette vue contient les colonnes "Nom", "Prénom", "Age" et "Ville"
// Seules les colonnes "Nom", "Prénom" et "Ville" sont triables
// Recherche dans cette vue des personnes dont le nom commence par "Mar",
// le prénom par "Jean" et la ville par "Saint"
NotesVueCherchePremier(IDBase, notesCommencePar, "Mar", "Jean", "Saint")
// Parcours des personnes trouvées
TANTQUE NotesEnDehors(IDBase) = Faux
...  
// Traitements
NotesDocumentSuivant(IDBase)
FIN
Syntaxe
<Résultat> = NotesVueCherchePremier(<Identifiant de la session> , <Mode de recherche> , <Valeur recherchée 1> [, <Valeur recherchée 2> [... [, <Valeur recherchée N>]]])
<Résultat> : Booléen
  • Vrai si la recherche a bien été effectuée,
  • 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.
<Identifiant de la session> : Entier
Identifiant de la session à utiliser. Cet identifiant est renvoyé par la fonction EmailOuvreSessionNotes ou NotesOuvreBase.
<Mode de recherche> : Constante de type entier
Mode de recherche à effectuer :
notesCommenceParRecherche de type "Commence par".
Cette constante est disponible uniquement sur les colonnes de type chaîne.
notesEgalRecherche de type "Identique".
notesInférieurRecherche de type "Strictement inférieur à".
notesInférieurOuEgalRecherche de type "Inférieur ou égal à".
notesSupérieurRecherche de type "Strictement supérieur à".
notesSupérieurOuEgalRecherche de type "Supérieur ou égal à".

Pour les colonnes de type chaîne, la recherche ignore toujours la casse et l'accentuation.
<Valeur recherchée 1> : Type de la colonne dans laquelle la recherche est effectuée
Valeur recherchée dans la 1ère colonne triable rencontrée.
Cette valeur est automatiquement convertie dans le type de la colonne en cours (Texte, Nombre ou DateHeure).
Pour les colonnes de type DateHeure, si la valeur recherchée correspond à une chaîne de caractères, cette chaîne doit utiliser le format "AAAAMMJJ", "AAAAMMJJHHMMSS" ou "AAAAMMJJHHMMSSccc".
<Valeur recherchée 2> : Type de la colonne dans laquelle la recherche est effectuée (optionnel)
Valeur recherchée dans la seconde colonne triable rencontrée.
Cette valeur est automatiquement convertie dans le type de la colonne en cours (Texte, Nombre ou DateHeure).
Pour les colonnes de type DateHeure, si la valeur recherchée correspond à une chaîne de caractères, cette chaîne doit utiliser le format "AAAAMMJJ", "AAAAMMJJHHMMSS" ou "AAAAMMJJHHMMSSccc".
<Valeur recherchée N> : Type de la colonne dans laquelle la recherche est effectuée (optionnel)
Valeur recherchée dans la Nème colonne triable rencontrée.
Cette valeur est automatiquement convertie dans le type de la colonne en cours (Texte, Nombre ou DateHeure).
Pour les colonnes de type DateHeure, si la valeur recherchée correspond à une chaîne de caractères, cette chaîne doit utiliser le format "AAAAMMJJ", "AAAAMMJJHHMMSS" ou "AAAAMMJJHHMMSSccc".
Remarques

Recherche dans les colonnes d'une vue

Une vue possède une ou plusieurs colonnes triables. La recherche réalisée grâce à la fonction NotesVueCherchePremier s'effectue uniquement dans les colonnes triables de la vue en cours. Il n'est pas possible d'effectuer de recherche sur une colonne non-triable. Il n'est pas non plus possible de sauter une colonne triable.
Par exemple :
  • la vue "A" possède les colonnes 1, 2 et 3. Ces trois colonnes sont triables. Il est possible d'effectuer une recherche sur la colonne 1, sur les colonnes 1 et 2 ou 1, 2 et 3. Mais il n'est pas possible d'effectuer une recherche sur les colonnes 1 et 3 ou uniquement sur la colonne 2 ou sur la colonne 3.
  • la vue "B" possède les colonnes 1, 2 et 3. Seules les colonnes 1 et 3 sont triables. Il est possible d'effectuer une recherche sur la colonne 1 ou sur les colonnes 1 et 3. Mais il n'est pas possible d'effectuer une recherche sur les colonnes 1 et 2 ou 1, 2 et 3 ou uniquement sur la colonne 2 ou sur la colonne 3.

Colonnes de type DateHeure

Les recherches de type "Identique" (constante notesEgal) effectuées dans les colonnes de type DateHeure peuvent être erronées. En effet, la précision de la valeur stockée par la colonne peut être supérieure à la précision de la valeur recherchée.
Composante : wd300mess.dll
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale