Version de WDScript : 2.0.5+

Positionne sur le premier enregistrement d'un fichier, lit l'enregistrement et met à jour ses variables (par exemple Produit.Ref correspond à la rubrique Ref du fichier Produit).

Syntaxe

HLitPremier ([<Nom du fichier> [,<Rubrique de parcours>] [,<Options>]])

<Nom du fichier> : Chaîne de caractères optionnelle avec guillemets pour le nom du fichier, de la vue ou de la requête manipulé. Si ce paramètre correspond à une chaîne vide, la fonction HLitPremier utilise le dernier fichier ouvert.

<Rubrique de parcours> : Chaîne de caractères optionnelle avec guillemets pour le nom de la rubrique utilisée pour parcourir le fichier ou la vue. Si ce nom n'est pas spécifié, la fonction HLitPremier va utiliser :
- Dans le cas d'un fichier, la dernière rubrique de parcours utilisée sur ce fichier ou si cette rubrique n'existe pas, la meilleure rubrique de parcours.
- Dans le cas d'une requête, le ORDER BY de la requête si il existe, sinon selon la dernière rubrique utilisée.
- Dans le cas d'une vue, la rubrique de tri de la vue (si elle existe), sinon sur la dernière rubrique utilisée.

<Options> : Ce paramètre peut être
- hBlocageNon : Aucun blocage (même si la fonction HDébutVerrou a été appelée), l'enregistrement pourra être lu ou modifié par une autre application pendant la lecture.
- hBlocageEcriture : Blocage en écriture : l'enregistrement en cours de lecture pourra être lu par une autre application mais ne pourra pas être modifié par une autre application.
- hBlocageLectureEcriture : Blocage en lecture/écriture : l'enregistrement en cours de lecture ne pourra ni être lu ni être modifié par une autre application.
- hRespecteFiltre : Le parcours prendra en compte le filtre mis en place avec la fonction HFiltre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre. Rappel : la fonction HFiltre renvoie la clé de parcours optimisée pour le filtre.
Attention : sur des fichiers de taille importante, des problèmes de performances peuvent survenir. Ce paramètre ne peut pas être utilisée sur HF 5.

Remarque

Par défaut, aucun blocage d'enregistrement n'est réalisé.

Exemple

<wdscript>
HLitPremier("PERSONNE", "NOMPRENOM")
TANTQUE H.Trouve
   <OUT>
   <P>[% NoSpace(PERSONNE.NOM) %] 
         [% NoSpace(PERSONNE.PRENOM) %]<br />
	 [%PERSONNE.AGE%]  <br />
   </OUT>
   HLitSuivant("PERSONNE", "NOMPRENOM")
FIN
</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