Version de WDScript : 2.0.7+

Renvoie la liste des rubriques d'un fichier Hyper File.

Syntaxe

<Résultat> = HListeRubrique(<Nom du fichier>, [<Chemin du WDD> [,<Mot de passe WDD>,]] [<Options>])

<Résultat> : Liste des rubriques présentes dans le fichier spécifié. Les différentes descriptions pour chaque rubrique sont séparées par un retour chariot (RC).

Si l'option hLstDétail n'est pas précisée, <Résultat> est sous la forme :
<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC?

Si l'option hLstDétail est précisée, <Résultat> est sous la forme :
<Nom de la rubrique1> + TAB + <Type> + TAB + <TypeHF> + TAB +<Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...

Si l'option hLstDétailPlus est précisée, <Résultat> est sous la forme :
<Nom de la rubrique1> + TAB + <Type> + TAB + <TypeHF> + TAB +<Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des numériques> + TAB + <Partie décimale des numériques> + RC + ...

<Nom de la rubrique> : nom de la rubrique

<Type> : type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique

<TypeHF> : type Hyper File de la rubrique
- 0 type inconnu
- 1 identifiant automatique sur 8 octets
- 2 texte
- 3 entier signé sur 2 octets
- 4 entier signé sur 1 octet
- 5 entier signé sur 4 octets
- 6 réel simple (sur 4 octets)
- 7 réel double (sur 8 octets)
- 8 numéro d'enregistrement (entier non signé)
- 9 entier non signé sur 2 octets
- 10 date sur 6 positions
- 11 heure
- 12 entier non signé sur 1 octet
- 13 réel turbo
- 14 date sur 8 positions
- 15 mémo texte
- 16 mémo binaire 4.0
- 17 monétaire
- 18 mémo binaire, image, son, OLE, etc
- 19 entier signé sur 8 octets
- 20 entier non signé sur 8 octets
- 21 image
- 22 entier non signé sur 4 octets
- 23 chaîne binaire
- 24 date+heure
- 25 durée
- 26 caractère
- 27 booléen
- 28 identifiant automatique (sur 4 octets)

<Taille> : taille de la rubrique

<Nombre d'indices> : nombre d'éléments du tableau

<Libellé> : libellé de la rubrique

<Partie entière des numériques> : nombre de chiffres de la partie entière des numériques

<Partie décimale des numériques> : nombre de chiffres de la partie décimale des numériques

<Nom du fichier> : Chaîne de caractères (avec guillemets) pour le nom du fichier (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 W-Langage est générée.

<Chemin du WDD> : Chaîne de caractères optionnelle (avec guillemets) contenant le chemin complet de l'analyse (.WDD). Si ce paramètre n'est pas précisé ou est égal à une chaîne vide, le fichier est recherché dans l'analyse en cours.

<Mot de passe du WDD> : Mot de passe défini pour l'analyse. Si aucun mot de passe n'est défini, ce paramètre doit être une chaîne vide.

<Options> : Constante ou combinaison de constantes pour le type de liste à extraire :
- hLstNormal (valeur par défaut) : égal à hLstRubrique + hLstMémo + HLstClé
- hLstClé : clés non composées uniquement
- hLstCléComposée : clés composées uniquement
- hLstDétail : informations détaillées
- hLstDétailPlus : pour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
- hLstMémo : rubriques mémo
- hLstOrdreLogique : trie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée)
- hLstRubrique : rubriques non clé et non mémo
- hLstRubriqueOrigine : utilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalisé).
- HLstTout : hLstRubrique + hLstMémo +HLstClé + hLstClécomposée
- hLstTriée : trie la liste par ordre alphabétique

Remarque

Sur une base Hyper File 5 : seules les options hLstNormal et hLstDétail sont disponibles.

Exemple

<wdscript>
// Renvoie la liste des rubriques dans un tableau HTML
</wdscript>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=1>
<TR VALIGN=TOP>
	<TH WIDTH=16%>Rubrique</TH>
	<TH WIDTH=28%>Type</TH>
	<TH WIDTH=*>Libellé</TH>
</TR>
<wdscript>
listeStr est une chaîne
retStr est une chaîne
col1 est un tableau de 10 chaînes
rang est un entier

listeStr = HListeRubrique("CLIENT", hLstDetail)
Boucle
	rang++
	retStr = ExtraitChaine(listeStr,rang,RC)
	Si retStr = EOT Alors Sortir

	col1[1] = ExtraitChaine(retStr,1)
	col1[3] = ExtraitChaine(retStr,3)
	col1[6]	= ExtraitChaine(retStr,6)
	<OUT>
	<TR VALIGN=MIDDLE>
		<TD WIDTH=16%>[%col1[1]%]</TD>
		<TD WIDTH=28%>[%col1[3]%]</TD>
		<TD WIDTH=*>[%col1[6]%]</TD>
	</TR>
	</OUT>
Fin // de Boucle

Echo ("</TABLE>")
</wdscript>

Commentaires

Les commentaires doivent si possible être postés en anglais. Ils sont soumis à la modération avant d'être publiés.

Ajouter votre commentaire