|
|
|
|
|
- Condition de sélection
- Créer une vue sur un fichier de données filtré
- Versions précédentes
HCréeVue (Fonction) En anglais : HCreateView
Non disponible avec ce type de connexion
Avertissement
A partir de la version 20, les vues SQL et les vues matérialisées sont disponibles. Les vues manipulées par cette fonction correspondent à l'ancien mécanisme des vues. Elles ne correspondent ni aux vues SQL ni aux vues matérialisées.
Crée une vue HFSQL. Remarque : Pour fusionner plusieurs vues, utilisez la fonction HFusionneVue. Rappel : Une vue HFSQL correspond à une "image mémoire" de tout ou partie d'un fichier de données. Une vue est stockée en mémoire, ce qui la rend insensible aux modifications effectuées sur le fichier de données associé. Une fois créée, une vue se manipule comme un fichier de données HFSQL.
MaVue est une Source de Données
HCréeVue(MaVue, CLIENT, "*", "NOM,VILLE","NOM]='A'", hVueDéfaut)
Syntaxe
Créer une vue sur un fichier de données (fichier de données décrit dans l'analyse ou créé par programmation) Masquer les détails
<Résultat> = HCréeVue(<Vue à  créer> , <Fichier de données> [, <Rubriques> [, <Rubriques de tri> [, <Condition de sélection>]]] [, <Mode de création> [, <Taille d'une page>]])
<Résultat> : Booléen - Vrai si la vue a été créée,
- Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Vue à créer> : Source de données (ou chaîne de caractères) Vue à créer. L'utilisation d'une variable de type source de données permet d'optimiser les temps d'accès aux rubriques de la vue. <Fichier de données> : Chaîne de caractères Nom du fichier de données manipulé. Ce fichier de données peut correspondre à un fichier de données décrit dans l'analyse ou décrit par programmation (fonction HDécritFichier). Il est également possible d'utiliser une source de données. <Rubriques> : Chaîne de caractères optionnelle Liste des rubriques prises en compte dans la vue. Dans cette liste, les différentes rubriques sont séparées soit par des virgules, soit par des retour chariot (RC). Si ce paramètre n'est pas précisé ou correspond à la valeur "*", toutes les rubriques du fichier de données seront intégrées dans la vue. <Rubriques de tri> : Chaîne de caractères optionnelle Liste des rubriques de tri initial de la vue. Dans cette liste, les différentes rubriques de tri sont séparées soit par des virgules, soit par des retour chariot (RC). Le tri est appliqué selon l'ordre des rubriques dans la liste. Le sens de tri peut être indiqué pour chaque rubrique : - un signe "+" devant le nom de la rubrique indique un sens de tri croissant.
- un signe "-" devant le nom de la rubrique indique un sens de tri décroissant.
Si ce paramètre n'est pas spécifié ou correspond à une chaîne vide (""), aucun tri particulier n'est réalisé dans la vue. <Condition de sélection> : Chaîne de caractères optionnelle Condition de sélection des enregistrements. Toutes les rubriques du fichier de données peuvent faire partie de la condition (rubriques clé ou non clé). Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, aucune condition de sélection n'est appliquée. Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode. <Mode de création> : Constante optionnelle ou combinaison de constantes de type Entier (optionnel) Paramètre le mode de création de la vue. | | hVueAjoute | Conserve le contenu de la vue lors du prochain appel à la fonction HExécuteVue. | hVueBlocage | Les enregistrements lus dans le fichier de données et intégrés à la vue sont bloqués.
| hVueDéfaut | Mode de création de vue par défaut | hVueDifférée | La vue est créée, mais sera exécutée en différé avec la fonction HExécuteVue. Les données de la vue seront celles correspondant au moment de l'exécution de la vue. | hVueDistincte | La vue est créée avec élimination des doublons par rapport à la clé de tri (la ou les rubriques de tri doivent alors obligatoirement être précisées). Si plusieurs rubriques sont spécifiées, l'élimination des doublons est faite selon la composition des rubriques de tri spécifiées.
| hVueExclusive | Optimise le temps de création de la vue en bloquant directement tout le fichier source. | hVueInterruptible | La création de la vue est interruptible au moyen de la touche ECHAP.
|
<Taille d'une page> : Entier optionnel Nombre d'enregistrements par page (pour une vue utilisée par accès distant).
Remarques 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 : | | | <> | Différent | Valable pour tous les types | > | Plus grand | Valable pour tous les types | >= | Plus grand ou égal | Valable pour tous les types | < | Plus petit | Valable pour tous les types | <= | Plus petit ou égal | Valable pour tous les types | = | Strictement égal | Valable pour tous les types | ~= | 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 | ~~ | Egalité 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 | ] | Contient : prend en compte de la casse des caractères | Valable pour les types chaîne uniquement | ~] | Contient : ne prend pas en compte de la casse des caractères | Valable pour les types chaîne uniquement | ]= | Commence par : prend en compte 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.
- Le nom de la rubrique ne doit comporter que des lettres, des chiffres et des caractères soulignés ("_"). Si le nom de la rubrique contient d'autres caractères (apostrophe, ...), le nom de la rubrique doit être entouré de doubles quotes.
Par exemple : "e_mail@"]'fr' - Les comparaisons entre chaînes se font en fonction de la valeur ASCII des caractères et non pas d'une façon lexicographique ('a' > 'Z').
- Les mémos binaires et les clés composées ne peuvent pas faire partie d'une condition de sélection.
- Si une <constante chaîne> contient une simple quote (ou une double quote), il faut faire précéder cette simple quote (ou double quote) par un anti-slash ( \ ).
- Pour optimiser le parcours de la vue, utilisez la fonction HStatCalcule sur le fichier de données avant de créer la vue. En effet, le moteur HFSQL analyse la condition de sélection et s'appuie ensuite sur ces statistiques pour déterminer les rubriques les plus discriminantes qui permettront d'optimiser les parcours des fichiers de données.
- Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|