|
|
|
|
|
|
|
|
|
|
- Présentation
- Méthode 1: Fonctions de parcours
- Exemple de code
- Méthode 2: Instruction POUR TOUT
- Exemple de code
- Méthode 3: Fonction HFiltre
- Exemple
- Méthode 4: Utilisation d'une requête SQL
- Exemple
Comment faire un parcours de table avec un filtre?
Il existe plusieurs méthodes pour parcourir une table selon un filtre: Méthode 1: Fonctions de parcours Cette méthode utilise les fonctions de base du WLangage pour parcourir les tables: La fonction HLitRecherche permet d'accéder au premier enregistrement correspondant à la valeur de la borne minimale de la clé de recherche. La fonction HLitSuivant permet d'accéder à l'enregistrement suivant correspondant à la recherche. La fonction HTrouve permet de savoir s'il existe toujours un enregistrement correspondant à la valeur de la recherche. Exemple de code
HLitRecherche(CLIENT, Ville, "MONTPELLIER")
TANTQUE HTrouve(CLIENT)
HLitSuivant(CLIENT, Ville)
FIN
Méthode 2: Instruction POUR TOUT L'instruction POUR TOUT permet de parcourir les enregistrements d'une table. Dans notre cas, cette instruction va permettre de lire les enregistrements d'une table avec un filtre. L'instruction POUR TOUT attend les paramètres suivants: - le nom de la table à parcourir.
- le nom de l'index (ou clé) utilisé pour trier les enregistrements.
- la valeur de filtrage.
Les lectures du premier enregistrement et de l'enregistrement suivant sont effectuées par l'instruction POUR TOUT. Il n'est pas nécessaire d'utiliser les fonctions HLitXXX. Exemple de code
POUR TOUT CLIENT AVEC VILLE = "MONTPELLIER"
FIN
Méthode 3: Fonction HFiltre - Utilisez la fonction HFiltre pour appliquer un filtre d'enregistrements sur la table.
- Parcourez la table filtrée, avec les fonctions de parcours classiques.
- A la fin du parcours, désactivez le filtre par la fonction HDésactiveFiltre.
Exemple Recherche des commandes dont la date est comprise entre le 01/02/2017 et le 28/02/2017.
HFiltre(COMMANDE, DATECOMMANDE, "20170201", "20170228")
POUR TOUT COMMANDE
FIN
HDésactiveFiltre(COMMANDE)
Note: La fonction HFiltre permet plus de souplesse que les méthodes précédentes. Elle permet également de gérer des possibilités de filtre plus nombreuses. Consultez l'aide en ligne sur la fonction HFiltre pour connaître les différentes possibilités. Méthode 4: Utilisation d'une requête SQL Pour parcourir la table avec un filtre via une requête: - Créer la requête. La requête permet de filtrer les enregistrement voulus.
Rappel: Une requête SQL peut être réalisée: - dans l'éditeur de requêtes.
- par programmation.
Pour plus de détails sur la création d'une requête, consultez Création d'une requête. - Exécuter la requête (fonction HExécuteRequête ou HExécuteRequêteSQL).
- Lire le résultat de la requête en réalisant un parcours de table standard.
- Libérer la requête (fonction HLibèreRequête).
Exemple HExécuteRequête(REQ_ListeClient)
POUR TOUT REQ_ListeClient
FIN
HLibèreRequête(REQ_ListeClient)
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|