PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Ordre des rubriques
  • Affichage du résultat dans un champ Liste ou Combo
  • Type HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Renvoie la liste des rubriques :
  • présentes dans un fichier de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL. Les fichiers de données définis par les fonctions HDéclare, HDéclareExterne et HDécritFichier sont pris en compte.
  • Versions 19 et supérieures
    WEBDEV - Code Serveur présentes dans une variable de type Enregistrement.
    Nouveauté 19
    WEBDEV - Code Serveur présentes dans une variable de type Enregistrement.
    WEBDEV - Code Serveur présentes dans une variable de type Enregistrement.
Versions 18 et supérieures
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
Nouveauté 18
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Récupérer les rubriques d'un fichier de l'analyse en cours
ListeRubrique est une chaîne
ListeRubrique = HListeRubrique(CLIENT, hLstDétail)

// Ajoute la liste des rubriques dans COMBO_COMBO1
ListeAjoute(COMBO_COMBO1, ListeRubrique)
// Exécution d'une requête "SELECT *" et interrogation des rubriques
sdListeVILLE est une Source de Données
sListeRub est une chaîne
sContenuEnreg est une chaîne
sReq est une chaîne = "SELECT * FROM CODEPOSTAUX WHERE CODEPOSTAL ='34000'"

// Exécution de la requête
HExécuteRequêteSQL(sdListeVILLE, hRequêteDéfaut, sReq)
// Liste des rubriques de la requête.
sListeRub = HListeRubrique(sdListeVILLE)

// Parcours de la requête
POUR TOUT sdListeVILLE
        sContenuEnreg = ""
        // Pour chaque enregistrement, il faut parcourir les rubriques
        POUR TOUTE CHAÎNE sUneRubrique DE sListeRub SEPAREE PAR RC
                sContenuEnreg += {"sdListeVILLE." + sUneRubrique, indRubrique}
        FIN
        Info("Contenu de l'enregistrement : " + sContenuEnreg)
FIN
Syntaxe

Lister les rubriques d'un fichier de données Masquer les détails

<Résultat> = HListeRubrique(<Nom du fichier> [, <Chemin du WDD> [, <Mot de passe du WDD> [, <Options>]]])
<Résultat> : Chaîne de caractères
Liste des rubriques présentes dans le fichier de données spécifié. Les différentes descriptions de chaque rubrique sont séparées par RC (Retour Chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
hLstDétail non précisé<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC + ...
hLstDétail précisé<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...
hLstDétailPlus<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des rubriques numériques> + TAB + <Partie décimale des rubriques numériques> + RC + ...
Où :
  • <Nom de rubrique X> : Nom de la rubrique
  • <Type> : Type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique
  • <Type HFSQL> : Type HFSQL de la rubrique. Pour plus de détails, voir les Notes.
  • <Taille> : Taille de la rubrique
  • <Nombre d'indices> : Nombre d'éléments du tableau
  • <Libellé> : Libellé de la rubrique.
  • <Partie entière des rubriques numériques> : Nombre de chiffres de la partie entière des rubriques numériques
  • <Partie décimale des rubriques numériques> : Nombre de chiffres de la partie décimale des rubriques numériques
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données (de la requête ou de la vue) dont les rubriques doivent être listées.
Si un nom de requête est spécifié, cette requête doit être en cours d'exécution (fonctions HExécuteRequête ou HExécuteRequêteSQL) pour que la fonction HListeRubrique fonctionne. Dans le cas contraire, une erreur du WLangage est générée.
<Chemin du WDD> : Chaîne de caractères optionnelle
Chemin complet de l'analyse (c'est-à-dire du ficher .WDD) dans laquelle le fichier de données est décrit. Si ce paramètre n'est pas précisé ou est égal à une chaîne vide (""), le fichier de données est recherché dans l'analyse en cours.
<Mot de passe du WDD> : : Chaîne de caractères optionnelle
Mot de passe défini pour l'analyse. Si aucun mot de passe n'est défini, ce paramètre doit être égal à une chaîne vide ("").
<Options> : Constante ou combinaison de constantes optionnelle de type entier
Paramètre le type de liste à effectuer :
hLstNormal
(valeur par défaut)
Correspond à hLstRubrique + hLstMémo + hLstClé
hLstCléListe les rubriques clés (clés non composées uniquement)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstCléComposéeListe les rubriques clés composées uniquement
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstDétailInformations détaillées (idem versions antérieures).
hLstDétailPlusPour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstMémoListe les rubriques mémo
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstOrdreLogiqueTrie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstRubriqueListe les rubriques non clé et non mémo
hLstRubriqueOrigineUtilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques du fichier CLIENT.
Hyper File 5.5 Cette constante n'est pas prise en compte.

hLstToutListe tous les types de rubrique (hLstRubrique + hLstMémo + hLstClé + hLstClécomposée)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstTriéeTrie la liste par ordre alphabétique
Hyper File 5.5 Cette constante n'est pas prise en compte.
Versions 19 et supérieures
WEBDEV - Code Serveur

Lister les rubriques d'une variable de type Enregistrement Masquer les détails

<Résultat> = HListeRubrique(<Enregistrement> [, <Options>])
<Résultat> : Chaîne de caractères
Liste des rubriques présentes dans la variable de type Enregistrement spécifiée. Les différentes descriptions de chaque rubrique sont séparées par RC (Retour Chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
hLstDétail non précisé<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC + ...
hLstDétail précisé<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...
hLstDétailPlus<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des rubriques numériques> + TAB + <Partie décimale des rubriques numériques> + RC + ...
Où :
  • <Nom de rubrique X> : Nom de la rubrique
  • <Type> : Type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique
  • <Type HFSQL> : Type HFSQL de la rubrique. Pour plus de détails, voir les Notes.
  • <Taille> : Taille de la rubrique
  • <Nombre d'indices> : Nombre d'éléments du tableau
  • <Libellé> : Libellé de la rubrique.
  • <Partie entière des rubriques numériques> : Nombre de chiffres de la partie entière des rubriques numériques
  • <Partie décimale des rubriques numériques> : Nombre de chiffres de la partie décimale des rubriques numériques
<Enregistrement> : Variable de type Enregistrement
Nom de la variable de type Enregistrement à partir de laquelle la liste des rubriques doit être retrouvée.
<Options> : Constante ou combinaison de constantes optionnelle de type entier
Paramètre le type de liste à effectuer :
hLstNormal
(valeur par défaut)
Correspond à hLstRubrique + hLstMémo + hLstClé
hLstCléListe les rubriques clés (clés non composées uniquement).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstCléComposéeListe les rubriques clés composées uniquement.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstDétailInformations détaillées (idem versions antérieures).
hLstDétailPlusPour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstMémoListe les rubriques mémo
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstOrdreLogiqueTrie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstRubriqueListe les rubriques non clé et non mémo
hLstRubriqueOrigineUtilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques du fichier CLIENT.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstToutListe tous les types de rubrique (hLstRubrique + hLstMémo + hLstClé + hLstClécomposée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstTriéeTrie la liste par ordre alphabétique.
Hyper File 5.5 Cette constante n'est pas prise en compte.
Nouveauté 19
WEBDEV - Code Serveur

Lister les rubriques d'une variable de type Enregistrement Masquer les détails

<Résultat> = HListeRubrique(<Enregistrement> [, <Options>])
<Résultat> : Chaîne de caractères
Liste des rubriques présentes dans la variable de type Enregistrement spécifiée. Les différentes descriptions de chaque rubrique sont séparées par RC (Retour Chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
hLstDétail non précisé<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC + ...
hLstDétail précisé<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...
hLstDétailPlus<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des rubriques numériques> + TAB + <Partie décimale des rubriques numériques> + RC + ...
Où :
  • <Nom de rubrique X> : Nom de la rubrique
  • <Type> : Type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique
  • <Type HFSQL> : Type HFSQL de la rubrique. Pour plus de détails, voir les Notes.
  • <Taille> : Taille de la rubrique
  • <Nombre d'indices> : Nombre d'éléments du tableau
  • <Libellé> : Libellé de la rubrique.
  • <Partie entière des rubriques numériques> : Nombre de chiffres de la partie entière des rubriques numériques
  • <Partie décimale des rubriques numériques> : Nombre de chiffres de la partie décimale des rubriques numériques
<Enregistrement> : Variable de type Enregistrement
Nom de la variable de type Enregistrement à partir de laquelle la liste des rubriques doit être retrouvée.
<Options> : Constante ou combinaison de constantes optionnelle de type entier
Paramètre le type de liste à effectuer :
hLstNormal
(valeur par défaut)
Correspond à hLstRubrique + hLstMémo + hLstClé
hLstCléListe les rubriques clés (clés non composées uniquement).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstCléComposéeListe les rubriques clés composées uniquement.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstDétailInformations détaillées (idem versions antérieures).
hLstDétailPlusPour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstMémoListe les rubriques mémo
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstOrdreLogiqueTrie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstRubriqueListe les rubriques non clé et non mémo
hLstRubriqueOrigineUtilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques du fichier CLIENT.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstToutListe tous les types de rubrique (hLstRubrique + hLstMémo + hLstClé + hLstClécomposée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstTriéeTrie la liste par ordre alphabétique.
Hyper File 5.5 Cette constante n'est pas prise en compte.
WEBDEV - Code Serveur

Lister les rubriques d'une variable de type Enregistrement Masquer les détails

<Résultat> = HListeRubrique(<Enregistrement> [, <Options>])
<Résultat> : Chaîne de caractères
Liste des rubriques présentes dans la variable de type Enregistrement spécifiée. Les différentes descriptions de chaque rubrique sont séparées par RC (Retour Chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
hLstDétail non précisé<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC + ...
hLstDétail précisé<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...
hLstDétailPlus<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des rubriques numériques> + TAB + <Partie décimale des rubriques numériques> + RC + ...
Où :
  • <Nom de rubrique X> : Nom de la rubrique
  • <Type> : Type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique
  • <Type HFSQL> : Type HFSQL de la rubrique. Pour plus de détails, voir les Notes.
  • <Taille> : Taille de la rubrique
  • <Nombre d'indices> : Nombre d'éléments du tableau
  • <Libellé> : Libellé de la rubrique.
  • <Partie entière des rubriques numériques> : Nombre de chiffres de la partie entière des rubriques numériques
  • <Partie décimale des rubriques numériques> : Nombre de chiffres de la partie décimale des rubriques numériques
<Enregistrement> : Variable de type Enregistrement
Nom de la variable de type Enregistrement à partir de laquelle la liste des rubriques doit être retrouvée.
<Options> : Constante ou combinaison de constantes optionnelle de type entier
Paramètre le type de liste à effectuer :
hLstNormal
(valeur par défaut)
Correspond à hLstRubrique + hLstMémo + hLstClé
hLstCléListe les rubriques clés (clés non composées uniquement).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstCléComposéeListe les rubriques clés composées uniquement.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstDétailInformations détaillées (idem versions antérieures).
hLstDétailPlusPour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstMémoListe les rubriques mémo
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstOrdreLogiqueTrie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstRubriqueListe les rubriques non clé et non mémo
hLstRubriqueOrigineUtilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques du fichier CLIENT.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstToutListe tous les types de rubrique (hLstRubrique + hLstMémo + hLstClé + hLstClécomposée).
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstTriéeTrie la liste par ordre alphabétique.
Hyper File 5.5 Cette constante n'est pas prise en compte.
Remarques

Ordre des rubriques

Les rubriques listées dans <Résultat> sont triées en fonction de l'ordre physique des rubriques dans le fichier de données (sauf si la constante hLstTriée est utilisée).

Affichage du résultat dans un champ Liste ou Combo

<Résultat> peut être directement affecté à un champ Liste ou Combo grâce à la fonction ListeAjoute. Chaque ligne contiendra la description d'une rubrique.

Type HFSQL

Les types HFSQL possibles sont les suivants :
0type inconnu1identifiant automatique sur 8 octets
2rubrique texte3rubrique de type entier signé sur 2 octets
4rubrique de type entier signé sur 1 octet5rubrique de type entier signé sur 4 octets
6rubrique de type réel simple (sur 4 octets)7rubrique de type réel double (sur 8 octets)
8rubrique de type numéro d'enregistrement (entier non signé)9rubrique de type entier non signé sur 2 octets
10rubrique de type date sur 611rubrique de type heure
12rubrique de type entier non signé sur 1 octet13rubrique de type réel turbo
14rubrique de type date sur 815rubrique de type mémo texte
16rubrique de type mémo binaire 4.017rubrique de type monétaire
18rubrique de type mémo binaire, mémo Image,
mémo Son, mémo OLE ou mémo binaire autre
19rubrique de type entier signé sur 8 octets
20rubrique de type entier non signé sur 8 octets21rubrique de type image
22rubrique de type entier non signé sur 4 octets23rubrique de type chaîne binaire
24rubrique de type date+heure25rubrique de type durée
26rubrique de type caractère27rubrique de type booléen
28rubrique de type identifiant automatique (sur 4 octets)29rubrique de type texte Unicode
30rubrique de type mémo texte Unicode31rubrique de type numérique haute précision
32
Versions 20 et supérieures
rubrique de type Enumération
Nouveauté 20
rubrique de type Enumération
rubrique de type Enumération
33
Versions 20 et supérieures
rubrique de type Combinaison
Nouveauté 20
rubrique de type Combinaison
rubrique de type Combinaison
34
Versions 24 et supérieures
rubrique de type UUID sur 128 bits
Nouveauté 24
rubrique de type UUID sur 128 bits
rubrique de type UUID sur 128 bits
35
Versions 24 et supérieures
rubrique de type UUID automatique sur 128 bits
Nouveauté 24
rubrique de type UUID automatique sur 128 bits
rubrique de type UUID automatique sur 128 bits
36
Versions 24 et supérieures
rubrique de type UUID sur 256 bits
Nouveauté 24
rubrique de type UUID sur 256 bits
rubrique de type UUID sur 256 bits
37
Versions 24 et supérieures
rubrique de type UUID automatique sur 256 bits
Nouveauté 24
rubrique de type UUID automatique sur 256 bits
rubrique de type UUID automatique sur 256 bits
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Constantes pour les types de rubriques
on peut utiliser les constantes hRubXXX décrites dans la page http://doc.pcsoft.fr/fr-FR/?Type, au lieu d'utiliser les valeurs 0 à 31
John
18 mai 2010