|
|
|
|
|
|
|
|
|
|
- Borne minimale et borne maximale sur une rubrique clé de type texte ou clé composée
- Filtre et parcours filtré
- Condition de sélection
- Activation/Désactivation d'un filtre
- Filtre sur une clé composée
- Tables non HFSQL
HFiltre (Fonction) En anglais : HFilter
 Non disponible avec ce type de connexion
Définit et active un filtre sur une table, une vue ou une requête. Après son exécution, les cas suivants sont les plus fréquents: - le filtre ne peut pas être créé: la fonction HFiltre renvoie une chaîne vide. La fonction HErreur permet de récupérer l'identifiant de l'erreur.
- le filtre est créé: la fonction HFiltre renvoie la clé de parcours optimale à utiliser pour réaliser le parcours de la table, de la vue ou de la requête.
CléParcours est une chaîne
maville est une chaîne
maville = "MONTPELLIER"
CléParcours = HFiltre(Client, "VILLE='" + maville + "'")
HLitPremier(Client, CléParcours)
TANTQUE HEnDehors() = Faux
...
HLitSuivant(Client, CléParcours)
FIN
HDésactiveFiltre(Client)
CléParcours est une chaîne
CléParcours = HFiltre(Facture, DateFacture, "20050101", "20051231", ...
ChaîneConstruit("TotalTTC>1500 ET TypeRemise = '%1'" + , ...
Remplace(sTypeRemise, "'", "\'")))
SI CléParcours <> "" ALORS
HLitPremier(Facture, CléParcours)
TANTQUE HEnDehors() = Faux
Envoi_Lettre()
HLitSuivant(Facture, CléParcours)
FIN
FIN
...
HDésactiveFiltre(Facture)
Syntaxe
Filtre construit avec une clé de parcours bornée et une condition Masquer les détails
<Résultat> = HFiltre(<Table> , <Clé de parcours> , <Borne minimale> [, <Borne maximale> [, <Condition de sélection>]])
<Résultat> : Chaîne de caractères Rubrique de parcours. Correspond: - soit à la clé de parcours de la table si le filtre est activé.
- soit à une chaîne vide ("") si le filtre ne peut pas être mis en place.
<Table> : Chaîne de caractères Nom de la table, de la vue HFSQL ou de la requête manipulée. <Clé de parcours> : Chaîne de caractères Nom de la rubrique clé utilisée pour parcourir la table, la vue ou la requête. Cette rubrique doit être une clé de parcours de la table, de la vue ou de la requête. C'est sur cette rubrique que s'appliquent les bornes minimales et maximales. <Borne minimale> : Type de la rubrique de parcours Valeur minimale incluse de la rubrique de parcours (si la clé de parcours est définie avec un sens de parcours ascendant dans le schéma des données). Les enregistrements correspondant à cette valeur minimale seront inclus dans le filtre. Dans le cas d'un parcours descendant (c'est-à-dire si la clé de parcours est définie avec un sens de parcours descendant dans le schéma des données), c'est la valeur maximale de la rubrique de parcours.
Le type de ce paramètre doit correspondre au type de la rubrique de parcours. Par exemple, si la rubrique de parcours est une chaîne, la borne minimale doit être une chaîne. <Borne maximale> : Type de la rubrique de parcours, paramètre optionnel Valeur maximale incluse de la rubrique de parcours (cas d'un parcours ascendant). Les enregistrements correspondant à cette valeur maximale seront inclus dans le filtre. Le type de ce paramètre doit correspondre au type de la rubrique de parcours. Par exemple, si la rubrique de parcours est une chaîne, la borne maximale doit être une chaîne.
Dans le cas d'un parcours descendant, c'est la valeur minimale de la rubrique de parcours.
Si ce paramètre n'est pas précisé, la borne maximale du filtre correspond à la valeur du paramètre <Borne minimale>. <Condition de sélection> : Chaîne de caractères optionnelle Condition de sélection pour créer le filtre (voir Notes). Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode.
Filtre construit avec une condition Masquer les détails
<Résultat> = HFiltre(<Table> , <Condition de sélection>)
<Résultat> : Chaîne de caractères Rubrique de parcours. Correspond: - soit à la clé de parcours de la table si le filtre est activé
- soit à une chaîne vide si le filtre ne peut pas être mis en place
<Table> : Chaîne de caractères Nom de la table, de la vue HFSQL ou de la requête manipulée. <Condition de sélection> : Chaîne de caractères Condition de sélection pour créer le filtre (voir NOTES). Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode. Remarques Borne minimale et borne maximale sur une rubrique clé de type texte ou clé composée Si la borne minimale et la borne maximale sont identiques: - pour réaliser un filtre à l'identique sur une valeur, il suffit de préciser cette valeur dans le paramètre "Borne min".
Par exemple, pour sélectionner les clients dont le nom correspond à "Dupon":
HFiltre(Client, Nom, "Dupon")
Le client "Dupontel" ne sera pas sélectionné. - pour réaliser un filtre générique sur une valeur, il suffit de:
- compléter la borne minimale avec la constante hValMin pour lui donner la valeur minimale.
- compléter la borne maximale avec la constante hValMax pour lui donner la valeur maximale.
Par exemple, pour sélectionner les clients dont le nom commence par "Dupon":
HFiltre(Client, Nom, "Dupon" + hValMin, "Dupon" + hValMax)
Les clients "Dupon" et "Dupontel" seront sélectionnés.
Remarques: - La constante hValMin est équivalente à Caract(0).
- La constante hValMax est équivalente à Caract(255).
Filtre et parcours filtré Après l'exécution de la fonction HFiltre, le parcours de la table doit obligatoirement être effectué sur la rubrique renvoyée par la fonction HFiltre. Si une autre rubrique est utilisée pour le parcours de la table, le filtre ne sera pas pris en compte. Lorsqu'un filtre est défini et activé sur une table (une vue ou une requête), tout enregistrement lu correspond au filtre. Si il n'y a plus d'enregistrement correspondant au filtre lors du parcours: - la fonction HEnDehors renvoie Vrai.
- l'enregistrement en cours correspond au dernier enregistrement lu avec le filtre.
Par exemple: | | | Sur une table filtrée, après la fonction: | l'enregistrement en cours est: |
|---|
| HLitPremier | le premier enregistrement de la table correspondant au filtre | | HLitDernier | le dernier enregistrement de la table correspondant au filtre | | HLitSuivant (ou HAvance) | l'enregistrement suivant (ou le nième suivant) correspondant au filtre | | HLitPrécédent (ou HRecule) | l'enregistrement précédent (ou le nième précédent) correspondant au filtre |
Condition de sélection La syntaxe générale d'une condition a la forme suivante: "NomCli>'Dupont' et (CodePos=34 ou CodePos=32)" Les opérateurs acceptés sont variables en fonction du type des rubriques utilisées dans la condition: | | | | > | Plus grand | Valable pour tous les types | | >= | Plus grand ou égal | Valable pour tous les types | | < | Plus petit | Valable pour tous les types | | <> | Différent | Valable pour tous les types | | <= | Plus petit ou égal | Valable pour tous les types | | = | Strictement égal | Valable pour tous les types | | ] | Contient: prend en compte la casse des caractères | Valable pour les types chaîne uniquement | | ]= | Commence par: prend en compte la casse des caractères | Valable pour les types chaîne uniquement | | ~] | Contient: ne prend pas en compte la casse des caractères | Valable pour les types chaîne uniquement | | ~~ | Égalité très souple: ne différencie pas les caractères majuscules des caractères minuscules, ne tient pas compte des espaces situés avant et après la chaîne à tester, ne tient pas compte des caractères accentués minuscules, ne tient pas compte des espaces et des ponctuations à l'intérieur des chaînes. | Valable pour les types chaîne uniquement | | ~= | Environ égal: ne tient pas compte des espaces à droite, ni des accents, ni de la casse des caractères | Valable pour les types chaîne uniquement |
Remarques sur la condition de sélection: - Les chaînes constantes doivent être encadrées de simples quotes.
- Si le nom de la rubrique contient des simples quotes, elles doivent être doublées.
Par exemple: ‘Rubrique‘‘avec‘‘quotes‘ - Les comparaisons entre chaînes se font en fonction des paramètres spécifiés pour les index.
- Les mémos binaires et les clés composées ne peuvent pas faire partie d'une condition de sélection.
Pour les clés composées, il est conseillé d'utiliser la première syntaxe. Il n'est pas possible d'utiliser la syntaxe suivante:
HFiltre(NOMFICHIER, "CLECOMP~]'AAA' ET CLECOMP]='" + HConstruitValClé(NOMFICHIER, CLECOMP, 0) + "'")
- Si une chaîne de caractères (constante ou variable) contient une simple quote, il faut faire précéder cette simple quote par un anti-slash ( \ ).
- Pour optimiser le parcours du filtre, utilisez la fonction HStatCalcule sur la table avant de créer le filtre. En effet, le moteur HFSQL schéma des données la condition de sélection et s'appuie ensuite sur ces statistiques pour déterminer les rubriques les plus discriminantes qui permettront d'optimiser le parcours de la table.
- Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode.
- Il n'est pas possible d'utiliser dans la condition:
- plus de 6000 opérandes dans la condition.
- plus de 420 opérandes logiques de type ET/OR/XOR dans la condition.
Dans le cas contraire, une erreur 70209 apparaît: "Erreur lors de l'initialisation du filtre. Le nombre maximale d'opérandes a été atteint.".
Activation/Désactivation d'un filtre Lorsque la table (la requête ou la vue) est fermée (fonction HFerme par exemple), le filtre est supprimé. A un même instant, il ne peut exister qu'un seul filtre sur une table (une requête ou une vue). Si la fonction HFiltre est utilisée plusieurs fois, seul le dernier filtre sera pris en compte: le(s) filtre(s) précédent(s) seront supprimés.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|