|
|
|
|
|
- Conditions d'utilisation
- Type de recherche
- Champ Table fichier
- Divers
TableCherche (Fonction) En anglais : TableSearch Effectue une recherche dans : - un champ Table,
- un champ Table hiérarchique,
Deux modes de recherche sont disponibles : - Recherche d'un élément dans une colonne.
- Recherche d'un élément dans la valeur mémorisée du champ.
// Recherche l'élément "Chemise" dans la colonne "COL_Produit" // Recherche générique à partir de ligne 5 soit ResCherche = TableCherche(COL_Produit, "Chemise", rechercheCommencePar, 5)
// Permet de lister toutes les occurrences d'une valeur recherchée. Résultat1 est un entier Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", rechercheIdentique) TANTQUE Résultat1 <> -1 Trace(Résultat1) Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", ... rechercheIdentique, Résultat1 + 1) FIN
Syntaxe
Rechercher un élément dans une colonne Masquer les détails
<Résultat> = TableCherche(<Nom de la colonne> , <Élément recherché> [, <Type de recherche> [, <Ligne de départ>]])
<Résultat> : Entier - Indice de l'élément trouvé,
- -1 si aucun élément ne correspond à la recherche.
Si la recherche est réalisée : - dans un champ Table par programmation, l'élément trouvé n'est pas sélectionné. Pour sélectionner l'élément trouvé, utilisez la fonction TableSelectPlus.
- dans un champ Table fichier, l'élément trouvé n'est pas sélectionné, les lignes du champ Table défilent jusqu'à l'élément recherché.
<Nom de la colonne> : Chaîne de caractères Nom de la colonne dans laquelle s'effectue la recherche. Si ce paramètre correspond à une chaîne vide (""), la colonne manipulée est la colonne à laquelle appartient le traitement en cours.Dans un champ Table ou Table hiérarchique fichier, la colonne de recherche doit être liée à une rubrique de type clé. Il n'est pas possible de faire une recherche sur une colonne non liée à une rubrique. <Élément recherché> : Type de l'élément recherché Élément à rechercher dans la colonne spécifiée. Si l'élément recherché est de type :- "Date" ou "Heure" : la recherche est effectuée sur la valeur retournée.
- "Monétaire + Euro" : la recherche est effectuée sur la devise mémorisée.
<Type de recherche> : Constante optionnelle de type Entier Type de recherche à effectuer :
| | rechercheCommencePar (ou Faux par compatibilité) | Recherche générique du type "Commence par" Les éléments ayant une valeur commençant par <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. | rechercheContient | Recherche générique du type "Contient" Les éléments ayant une valeur contenant <Élément recherché> sont retournés. | rechercheDéfaut | Recherche par défaut. Pour cette fonction, la recherche par défaut est une recherche à l'identique (du type "Egale à "). Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. | rechercheIdentique (ou Vrai par compatibilité) (Valeur par défaut) | Recherche à l'identique (du type "Egale à ") Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés. Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. |
<Ligne de départ> : Entier optionnel Numéro de la ligne de départ de la recherche dans la colonne. Si ce paramètre n'est pas spécifié, la recherche est effectuée dans toute la colonne. Ce paramètre permet de rechercher toutes les occurrences d'une chaîne dans une colonne. Ce paramètre est ignoré dans le cas d'un champ Table fichier. Remarques Conditions d'utilisation Syntaxe 1 : La recherche d'un élément dans une colonne est disponible pour : - un champ Table ou Table hiérarchique fichier.
- un champ Table ou Table hiérarchique par programmation.
- un champ Table en mode "Navigateur",
- un champ monosélection ou multisélection.
Rappel : La multisélection n'est pas disponible sur les champs Table "Serveur".
Pour un champ Table ou Table hiérarchique fichier : - le mode de parcours doit être automatique.
- la colonne doit être liée à une rubrique de type clé.
Type de recherche - Recherche à l'identique : Seuls les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés par la fonction TableCherche. Par exemple :
// Retourner tous les "Dupond" de la colonne "COL_ColonneNom" TableCherche(COL_ColonneNom, "Dupond")
Attention : Dans un champ Table par programmation, les espaces au début du texte sont ignorés. - Recherche générique : Les éléments commençant par <Élément recherché> sont retournés par la fonction TableCherche.
Par exemple :
// Retourner tous les noms commençant par "DUP" TableCherche(COL_ColonneNom, "DUP", rechercheCommencePar)
Divers - Dans un champ Table par programmation, la recherche effectuée avec la fonction TableCherche :
- n'est pas sensible à la casse (majuscules/minuscules).
- ignore les espaces au début du texte.
- Dans un champ Table fichier, la recherche effectuée avec la fonction TableCherche tient compte des caractéristiques de recherche définies dans l'analyse pour la rubrique liée à la colonne de recherche (sensible ou non à la casse, ...).
Classification Métier / UI : Code UI Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|