DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Condition de sélection
  • Créer une vue sur un fichier de données filtré
  • Versions précédentes
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
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.
// Création d'une vue
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.
Hyper File 5.5 Une seule rubrique de tri doit être spécifiée dans le paramètre <Rubriques de tri>.
<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.
hVueAjouteConserve le contenu de la vue lors du prochain appel à la fonction HExécuteVue.
hVueBlocageLes enregistrements lus dans le fichier de données et intégrés à la vue sont bloqués.
hVueDéfautMode de création de vue par défaut
hVueDifféréeLa 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.
hVueDistincteLa 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.
Hyper File 5.5 Si la constante hVueDistincte est précisée, il n'est pas nécessaire de spécifier une rubrique de tri dans le paramètre <Rubriques de tri>. Dans ce cas, la constante hVueDistincte est ignorée.
hVueExclusiveOptimise le temps de création de la vue en bloquant directement tout le fichier source.
hVueInterruptibleLa création de la vue est interruptible au moyen de la touche ECHAP.
HFSQL Client/Serveur Cette constante n'est pas disponible.
<Taille d'une page> : Entier optionnel
Nombre d'enregistrements par page (pour une vue utilisée par accès distant).
HFSQL Client/Serveur Ce paramètre n'est pas pris en compte.
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érentValable pour tous les types
>Plus grandValable pour tous les types
>=Plus grand ou égalValable pour tous les types
<Plus petitValable pour tous les types
<=Plus petit ou égalValable pour tous les types
=Strictement égalValable pour tous les types
~=Environ égal : ne tient pas compte des espaces à droite, ni des accents, ni de la casse des caractèresValable 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èresValable pour les types chaîne uniquement
~]Contient : ne prend pas en compte de la casse des caractèresValable pour les types chaîne uniquement
]=Commence par : prend en compte de la casse des caractèresValable 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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppiPhone/iPadCode Utilisateur (MCU)AjaxHFSQL ClassicHFSQL Client/ServeurHyper File 5.5

Créer une vue sur un fichier de données filtré

La fonction HCréeVue tient compte du filtre posé sur le fichier de données source de la vue.
Cette caractéristique est supportée pour les vues créées à partir de fichiers de données HFSQL Classic ou Client/Serveur, Hyper File 5.5 et xBase.
WINDEV

Versions précédentes

Cette fonction remplace la fonction HCréeVue_55, conservée par compatibilité avec WINDEV 5.5.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
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