Une requête permet de sélectionner simplement certains enregistrements d'un ou de plusieurs fichiers de données. Une requête permet aussi de réaliser des calculs sur les données sélectionnées. Il est ainsi possible, par exemple, de sélectionner toutes les commandes des clients habitant New York et de réaliser un total du montant des commandes par client.

• soit la requête est créée et enregistrée sous l'éditeur de requêtes. L'état est alors basé sur le fichier correspondant à la requête (fichier ".WDR"). La requête peut être réutilisée dans un autre état, une fenêtre, un champ, ... La requête peut être modifiée à tout moment sous l'éditeur de requêtes. La requête est dite indépendante. Pour plus de détails, consultez le paragraphe Etat sur requête indépendante.
• soit la requête est créée lors de la création de l'état. La requête est alors intégrée à l'état. Aucun fichier spécifique à la requête n'est créé. La requête peut uniquement être modifiée à partir de l'état qui l'a créée. Elle ne peut pas être réutilisée dans un autre état, une fenêtre, un champ, ... La requête est dite intégrée. Pour plus de détails, consultez le paragraphe Etat sur requête intégrée.
• soit la requête est basée sur des données provenant d'une connexion (non disponible sous WINDEV Mobile). Pour plus de détails, consultez Créer une requête SQL via une connexion (ODBC, Connecteur Natif, ...).
  Remarque : Ce type d'état sur requête est disponible même si aucune analyse n'est associée au projet WINDEV ou WEBDEV.

• Comment créer un état sur une requête indépendante.
• Comment créer un état sur une requête intégrée.
• Comment créer un état sur une requête paramétrée.
• Comment imprimer un état sur une requête.
  • Cas général.
  • Cas d'une requête paramétrée.

Présentation

La requête doit être créée avant la création de l'état (pour plus de détails, consultez Créer une requête). Lors de la création de l'état, il suffit de spécifier le nom de la requête utilisée.

Créer un état sur requête indépendante

Pour créer un état sur requête indépendante :

1. Cliquez sur parmi les boutons d'accès rapide.
   • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
   • L'assistant de création d'un état s'affiche.
2. Choisissez la présentation de votre état (tableau, fiche, étiquette, ...). Pour plus de détails, consultez Les différents types d'états.
3. Sélectionnez si nécessaire le modèle d'états à utiliser. Un modèle d'états permet de respecter une mise en page spécifique. Pour plus de détails sur les modèles d'états, consultez Les modèles d'états.
4. Sélectionnez la source de données de l'état (option "D'un fichier de données ou d'une requête existante").
5. Sélectionnez la requête sur laquelle est basé l'état. Seules les requêtes présentes dans l'application en cours sont proposées.
6. Pour grouper les enregistrements, il est possible de créer des ruptures sur les rubriques de tri. Pour créer des ruptures, répondez "Oui" à la question "Voulez-vous des ruptures dans l'état ?".
   L'étape suivante de l'assistant permet alors de sélectionner les rubriques de tri correspondant aux ruptures. Pour plus de détails sur les ruptures, consultez les Ruptures dans un état.
7. Pour chaque rubrique affichée dans l'état :
   • saisissez le libellé correspondant. Ce libellé sera affiché :
     • soit avant la rubrique. Par exemple :
       
     • soit dans l'entête de la colonne (cas des états Tableau). Par exemple :
       
       Ce libellé pourra être modifié directement sous l'éditeur d'états.
   • sélectionnez le bloc dans lequel le champ associé à la rubrique doit être imprimé. La position des différents champs pourra être modifiée directement sous l'éditeur d'états. Pour plus de détails sur les différents blocs et sur leur position dans un état, consultez Blocs d'un état.
8. Modifiez si nécessaire l'ordre d'affichage des différents champs dans l'état à l'aide des boutons fléchés à droite du tableau.
9. Si la requête associée à l'état contient au moins une rubrique de type numérique, il est possible de réaliser des calculs sur ces rubriques. Spécifiez le calcul réalisé pour chaque rubrique (somme, moyenne, ...). Deux types de calculs sont possibles :
   • calcul général : un champ Calculé sera créé dans le bloc Fin de document.
   • calcul sur rupture : un champ Calculé sera créé dans le bloc Bas de rupture. Dans les calculs sur rupture, le résultat du calcul est réinitialisé à chaque rupture. Pour réaliser un calcul sur rupture, une rupture doit être présente dans l'état en cours de création.
10. Selon le type d'état en cours de création, indiquez les options spécifiques correspondantes.
    

    Type d'état	Options spécifiques
    État sur formulaire	Image du formulaire, impression de l'image du formulaire, ... Options détaillées dans la page Etat sur formulaire
    État Étiquette	Format des étiquettes, nombre d'exemplaires identiques, ... Options détaillées dans la page Etat Étiquette

11. Spécifiez le format de la feuille sur laquelle l'état va être imprimé. Par défaut, l'état est imprimé sur une feuille au format A4.
    Remarque : Par défaut, les champs de l'état sont disposés sur une seule colonne. Pour réaliser un état multicolonne, il suffit de spécifier le nombre de colonnes voulues dans l'onglet "Format" de la fenêtre de description de l'état.
12. Sélectionnez le gabarit de l'état si nécessaire.
13. Saisissez le nom et le titre de l'état (nom du fichier ".WDE" correspondant à l'état). Ce nom permettra d'identifier l'état dans vos programmes.
    
14. Validez la création de l'état.
15. L'éditeur d'états propose automatiquement de changer le format de l'état utilisé si les conditions suivantes sont réunies :
    • l'état en cours de création comporte un tableau.
    • le format de l'état ne permet pas d'afficher l'ensemble des colonnes du tableau.
16. Si nécessaire, indiquez le mode de réduction de l'état :
    • Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
    • Utiliser le mode paysage.
    • Réduire l'état par rapport à l'original. Attention : selon le pourcentage de réduction choisi, l'état imprimé pourra devenir illisible.
17. L'état en cours de création s'affiche sous l'éditeur d'états.

Présentation

La requête est créée directement lors de la création de l'état. Cette requête sera modifiée directement depuis l'éditeur d'états (option "Éditer la requête" du menu contextuel de l'état). Si des modifications sont réalisées dans la requête, l'éditeur d'états liste les modifications réalisées et les incidences sur l'état.

1. Affichez l'état basé sur la requête intégrée (sous l'éditeur d'états).
2. Sélectionnez l'option "Editer la requête" du menu contextuel de l'état. Autre solution : sous le volet "Modification", dans le groupe "Etat", cliquez sur "Éditer la requête". La requête s'affiche sous l'éditeur de requêtes.
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.

Créer un état sur requête intégrée

Pour créer un état sur requête intégrée :

1. Cliquez sur parmi les boutons d'accès rapide.
   • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
   • L'assistant de création d'un état s'affiche.
2. Choisissez la présentation de votre état (tableau, fiche, étiquette, ...). Pour plus de détails, consultez Les différents types d'états.
3. Sélectionnez si nécessaire le modèle d'états à utiliser. Un modèle d'états permet de respecter une mise en page spécifique. Pour plus de détails sur les modèles d'états, consultez Les modèles d'états.
4. Sélectionnez la source de données de l'état (option "D'une nouvelle requête").
5. L'assistant de création de requêtes se lance. Sélectionnez les différentes rubriques utilisées par la requête.
   Remarque : Pour simplifier la sélection des rubriques, affichez ces rubriques par ordre alphabétique ou par fichier associé.
6. Définissez les caractéristiques de la requête (condition de sélection, groupe, tri, ...) en cliquant sur le bouton correspondant.
   Pour plus de détails, consultez :
   • les conditions de sélection d'une requête,
   • les opérations possibles dans une requête,
   • l'ordre de tri des enregistrements d'une requête (ordre important pour les ruptures).
7. Passez à l'étape suivante.
8. Pour grouper les enregistrements, il est possible de créer des ruptures sur les rubriques de tri définies dans la requête. Pour créer des ruptures, répondez "Oui" à la question "Voulez-vous des ruptures dans l'état ?".
   L'étape suivante permet alors de sélectionner les rubriques de tri correspondant aux ruptures. Pour plus de détails sur les ruptures, consultez les Ruptures dans un état.
9. Pour chaque rubrique de la requête affichée dans l'état :
   • saisissez le libellé correspondant. Ce libellé sera affiché :
     • soit avant la rubrique. Par exemple :
       
       
     • soit dans l'entête de la colonne (cas des états Tableau). Par exemple :
       
       Ce libellé pourra être modifié directement sous l'éditeur d'états.
   • sélectionnez le bloc dans lequel le champ associé à la rubrique doit être imprimé. La position des différents champs pourra être modifiée directement sous l'éditeur d'états. Pour plus de détails sur les différents blocs et sur leur position dans un état, consultez Blocs d'un état.
10. Modifiez si nécessaire l'ordre d'affichage des différents champs dans l'état à l'aide des boutons fléchés à droite du tableau.
11. Si la requête associée à l'état contient au moins une rubrique de type numérique, il est possible de réaliser des calculs sur ces rubriques. Spécifiez le calcul réalisé pour chaque rubrique (somme, moyenne, ...). Deux types de calculs sont possibles :
    • calcul général : un champ Calculé sera créé dans le bloc Fin de document.
    • calcul sur rupture : un champ Calculé sera créé dans le bloc Bas de rupture. Dans les calculs sur rupture, le résultat du calcul est réinitialisé à chaque rupture. Pour réaliser un calcul sur rupture, une rupture doit être présente dans l'état en cours de création.
12. Selon le type d'état en cours de création, indiquez les options spécifiques correspondantes.
    

    Type d'état	Options spécifiques
    État sur formulaire	Image du formulaire, impression de l'image du formulaire, ... Options détaillées dans la page Etat sur formulaire
    État Étiquette	Format des étiquettes, nombre d'exemplaires identiques, ... Options détaillées dans la page Etat Étiquette

13. Spécifiez le format de la feuille sur laquelle l'état va être imprimé. Par défaut, l'état est imprimé sur une feuille au format A4.
    Remarque : Par défaut, les champs de l'état sont disposés sur une seule colonne. Pour réaliser un état multicolonne, il suffit de spécifier le nombre de colonnes voulues dans l'onglet "Format" de la fenêtre de description de l'état.
14. Sélectionnez le gabarit de l'état si nécessaire.
15. Saisissez le nom et le titre de l'état (nom du fichier ".WDE" correspondant à l'état). Ce nom permettra d'identifier l'état dans vos programmes.
    
16. Validez la création de l'état.
17. L'éditeur d'états propose automatiquement de changer le format de l'état utilisé si les conditions suivantes sont réunies :
    • l'état en cours de création comporte un tableau.
    • le format de l'état ne permet pas d'afficher l'ensemble des colonnes du tableau.
18. Si nécessaire, indiquez le mode de réduction de l'état :
    • Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
    • Utiliser le mode paysage.
    • Réduire l'état par rapport à l'original. Attention : selon le pourcentage de réduction choisi, l'état imprimé pourra devenir illisible.
19. L'état en cours de création s'affiche sous l'éditeur d'états.

Manipuler une rubrique de la requête intégrée depuis un code de l'état

Pour accéder à une rubrique de la requête intégrée depuis un des codes de l'état, de ses champs ou de ses blocs, utilisez la syntaxe :

Une requête (intégrée ou indépendante) peut être paramétrée. Dans ce cas, une ou plusieurs conditions de sélection dépendent d'un paramètre lors de l'exécution de la requête. Ce paramètre pourra par exemple correspondre à la valeur d'un champ de saisie dans une fenêtre.

• lors du test de l'état basé sur une requête paramétrée, une fenêtre s'affiche permettant de saisir les paramètres de la requête.
• en exécution, les paramètres de la requête doivent être spécifiés à l'aide de la fonction iInitRequêteEtat (avant l'utilisation de la fonction iImprimeEtat).

Remarque : Pour plus de détails sur les requêtes paramétrées, consultez Requête paramétrée.

Pour imprimer un état basé sur une requête, il faut distinguer deux cas :

• État sur une requête sans paramètre.
• État sur une requête avec paramètres.

• Si des paramètres doivent être passés à l'état, ces paramètres doivent être indiqués dans la fonction iImprimeEtat, après le nom de l'état à imprimer. Pour plus de détails, consultez Etat paramétré.
• La propriété NomSource utilisée dans le code de l'état permet de connaître et de changer le nom de la requête associée à l'état.

Imprimer un état basé sur une requête sans paramètre

Pour imprimer une requête sans paramètre, il suffit de :

1. Paramétrer la destination de l'impression de l'état :
   Pour plus de détails, consultez Modes d'impression d'un état.
2. Préciser le nom de l'état à imprimer grâce à la fonction iImprimeEtat.
   Par exemple :

Imprimer un état basé sur une requête avec paramètres

Pour imprimer une requête avec paramètres, il suffit de :

1. Paramétrer la destination de l'impression de l'état :
   Pour plus de détails, consultez Modes d'impression d'un état.
2. Passer les paramètres à la requête grâce à la fonction iInitRequêteEtat.
3. Préciser le nom de l'état à imprimer grâce à la fonction iImprimeEtat.

Remarque : Si certains paramètres attendus par la requête ne sont pas précisés (valeur correspondant à NULL par exemple), les conditions de sélection correspondant à ces paramètres seront ignorées.