DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur de requêtes / Création de requêtes
  • Présentation
  • Comment le faire ?
  • Champ d'une fenêtre ou d'une page : passer du mode intégré au mode indépendant
  • Etat basé sur une requête intégrée : Passer du mode intégré au mode indépendant
  • Manipuler une rubrique de la requête intégrée par programmation
  • Comment manipuler les requêtes indépendantes ou intégrées ?
  • Sous l'éditeur de pages ou de fenêtres : Tableau récapitulatif
  • Sous l'éditeur d'états : Tableau récapitulatif
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
Mode de création de requêtes : requête indépendante ou intégrée
ODBCNon disponible avec ce type de connexion
Présentation
L'éditeur de requêtes peut être utilisé de deux façons différentes pour créer une requête :
  • création de la requête directement sous l'éditeur de requêtes :
    • Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Requêtes" et sélectionnez le type de requête à créer.
      Cette requête correspond à un élément du projet (fichier ".WDR") et peut être utilisée comme source de données d'un état, d'un champ d'une fenêtre ou d'une page (champ Liste, Combo ou Table), en programmation, dans une autre requête, ... La requête est dite indépendante.
  • création de la requête lors de la création du champ Liste, Table ou de l'état basé sur cette requête (option "Une requête que je veux définir maintenant" dans l'assistant de création du champ ou de l'état). Aucun fichier spécifique n'est créé. La requête est dite intégrée.
Une requête intégrée ne peut pas être utilisée comme source de données d'un élément (état, ...) différent de celui où cette requête a été créée.
Comment le faire ?

Champ d'une fenêtre ou d'une page : passer du mode intégré au mode indépendant

Pour extraire une requête d'un champ d'une fenêtre ou d'une page :
  1. Affichez la fenêtre ou la page sous l'éditeur.
  2. Sélectionnez le champ basé sur une requête intégrée.
  3. Dans le menu contextuel du champ, sélectionnez l'option "Requête intégrée .. Ouvrir la requête associée".
    Attention : la fenêtre ou la page doit avoir été enregistrée au moins une fois.
  4. L'éditeur de requêtes s'ouvre et affiche le graphe de la requête. Sous le volet "Accueil", dans le groupe "Général", déroulez "Enregistrer" et sélectionnez "Exporter .. Vers une requête indépendante".
  5. Enregistrez la nouvelle requête. La requête est désormais indépendante. Vous pouvez l'utiliser dans toutes les fenêtres, les pages et états de votre projet.

Etat basé sur une requête intégrée : Passer du mode intégré au mode indépendant

Pour extraire une requête d'un état :
  1. Affichez l'état sur requête intégrée (sous l'éditeur d'états).
  2. Sélectionnez l'option "Éditer la requête" du menu contextuel de l'état. La requête s'affiche sous l'éditeur de requêtes. Attention : l'état doit avoir été enregistré au moins une fois.
  3. Sous le volet "Accueil", dans le groupe "Général", déroulez "Enregistrer" et sélectionnez "Exporter .. Vers une requête indépendante".
  4. Enregistrez la nouvelle requête. La requête est désormais indépendante.

Manipuler une rubrique de la requête intégrée par programmation

Pour accéder à une rubrique de la requête intégrée depuis un des codes du champ ou de l'état associé à cette requête, utilisez la syntaxe :
MaSource.MaRubrique

Ce mot-clé MaSource permet notamment de manipuler les paramètres d'une requête intégrée (dans les états, les champs Combo, Liste et Table fichier).
Remarque : le mot-clé MaSource ne doit pas être utilisé dans le code d'initialisation du champ ou dans le code d'ouverture de l'état.
Comment manipuler les requêtes indépendantes ou intégrées ?
HFSQL ClassicHFSQL Client/ServeurConnecteurs Natifs (Accès Natifs)

Sous l'éditeur de pages ou de fenêtres : Tableau récapitulatif

Type de requêteRequête intégréeRequête indépendante
Fonction d'initialisationRequête non paramétrée : Initialisation automatique.

Requête paramétrée : Il est nécessaire de spécifier les paramètres :
  • soit avec la fonction hExécuteRequête.
  • soit en utilisant la notation <Nom requête>.<Nom paramètre> ou MaSource.<Nom paramètre>.
Requête non paramétrée : Initialisation automatique.
Il est également possible d'utiliser la fonction hExécuteRequête.

Requête paramétrée : Il est nécessaire de spécifier les paramètres :
  • soit avec la fonction hExécuteRequête.
  • soit en utilisant la notation <Nom requête>.<Nom paramètre>.
Fonction permettant de passer le paramètre hRequêteSansCorrectionTransformer la requête intégrée en requête indépendantehExécuteRequête

Pour plus de détails sur la gestion des requêtes dans les champs, consultez Champs Table, Liste et Combo fichier liés à des requêtes.

Sous l'éditeur d'états : Tableau récapitulatif

Type de requêteRequête intégréeRequête indépendante
Fonction d'initialisationRequête non paramétrée : iInitRequêteEtat

Requête paramétrée : Il est nécessaire de spécifier les paramètres :
  • soit avec la fonction iInitRequêteEtat.
  • soit en utilisant la notation MaSource.<Nom paramètre>.
hExécuteRequête, iInitRequêteEtat
Fonction permettant de passer le paramètre hRequêteSansCorrectionTransformer la requête intégrée en requête indépendantehExécuteRequête
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