Tuto - Etats et Requêtes

Le logiciel "Etats et Requêtes" permet aux utilisateurs de modifier et de créer à leur convenance les états et les requêtes des applications WINDEV.Pour lancer le logiciel "Etats et Requêtes", il suffit d'ouvrir un état dans le visualisateur de rapports. Si l'application a été configurée pour utiliser le logiciel "Etats et Requêtes", il suffira de cliquer sur l'icône .

Pour diffuser le logiciel "Etats et Requêtes" avec votre propre application WINDEV, il est nécessaire d'effectuer les modifications suivantes dans votre projet :

• Etape 1 : indiquer au niveau du projet que l'application autorise le lancement du logiciel "Etats et Requêtes".
• Etape 2 : définir si nécessaire au niveau de l'analyse les fichiers et rubriques qui seront utilisables avec le logiciel "Etats et Requêtes".
• Etape 3 : définir les états et les requêtes modifiables sous le logiciel "Etats et Requêtes".
• Etape 4 : créer l'exécutable et le programme d'installation intégrant le logiciel "Etats et Requêtes".

1. Affichez la page d'accueil de WINDEV (Ctrl + <).
2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Application WINDEV : gérer des données", double-cliquez sur "Application complète - Corrigé".

Etape 1 : Paramétrage du projet

Pour utiliser le logiciel "Etats et Requêtes" à partir de votre application, il est nécessaire de configurer le projet associé à votre application.

1. Affichez la description du projet "WDApplication complète".
   Rappel : Pour afficher la description du projet, sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
2. Dans l'onglet "Avancé", cochez l'option "Autoriser le lancement de "Etats et Requêtes"".
   
3. Validez.

Etape 2 : Définir les fichiers de données et les rubriques non visibles dans le logiciel Etats et Requêtes

Par défaut, tous les fichiers de données et toutes leurs rubriques sont visibles et manipulables avec le logiciel "Etats et Requêtes". Si votre application contient des informations sensibles (mots de passe, etc.) vous pouvez rendre ces fichiers de données ou ces rubriques invisibles sous le logiciel "Etats et Requêtes".Nous allons maintenant ouvrir l'analyse pour paramétrer les fichiers et rubriques utilisables sous le logiciel "Etats et Requêtes".

1. Sous l'éditeur d'analyses, cliquez sur le fichier de données "ModeRèglement".
2. Affichez la fenêtre de description du fichier de données (option "Description du fichier de données" du menu contextuel).
3. Dans l'onglet "Etats & Requêtes", décochez l'option "Visible par l'utilisateur final dans le logiciel "États et Requêtes"".
4. Validez.

1. Sous l'éditeur d'analyses, cliquez sur le fichier de données "Produit".
2. Affichez la fenêtre de description des rubriques du fichier (option "Description des rubriques" du menu contextuel).
3. Sélectionnez dans la liste des rubriques, la rubrique "Visuel".
4. Dans l'onglet "Etats et Requêtes", décochez l'option "Visible par l'utilisateur final dans le logiciel "États et Requêtes"".
5. Validez.

1. Sous le volet "Analyse" du ruban, dans le groupe "Analyse", cliquez sur "Génération". Une modification automatique des fichiers de données est proposée pour prendre en compte les modifications effectuées.
2. Validez les différentes étapes de la modification automatique des données en conservant les options par défaut.
3. Fermez l'éditeur d'analyses.

Etape 3 : Définir les états et les requêtes modifiables ou non sous le logiciel "Etats et Requêtes"

Par défaut les requêtes et les états sont modifiables sous le logiciel "Etats et Requêtes". Pour rendre l'état "ETAT_Liste_des_clients" présent dans le projet "WD Application Complète" modifiable sous le logiciel "Etats et Requêtes" :

1. Ouvrez l'état "ETAT_Liste_des_clients" sous l'éditeur d'états.
2. Affichez la description de l'état (option "Description de l'état" du menu contextuel).
3. Dans l'onglet "Options", cochez "État modifiable sous États et Requêtes".
4. Cochez ensuite une des deux options suivantes :
   • "Interface modifiable uniquement" pour que l'interface de l'état uniquement soit modifiable sous Etats et Requêtes.
   • "Tout modifiable (interface et code)" pour que l'état soit entièrement modifiable sous Etats et Requêtes.
     
5. Validez et enregistrez l'état.

Par défaut, une requête est modifiable sous le logiciel "Etats et Requêtes".

1. Ouvrez la requête "REQ_BonDeCommande" sous l'éditeur de requêtes.
2. Affichez la description de la requête (option "Description de la requête" du menu contextuel du graphe de la requête).
3. Cliquez sur le bouton "Avancé" (présent parmi les "Actions").
4. Dans l'onglet "Etats et Requêtes", cochez "Visible sous 'Etats et Requêtes'".
5. Validez et enregistrez la requête.

Etape 4 : Création de l'exécutable et diffusion de l'application

La création et la diffusion d'une application utilisant le logiciel "Etats et Requêtes" se fait de la même façon que pour une application classique. Vous pourrez indiquer les paramètres spécifiques au logiciel "Etats et Requêtes" lors de la création de la procédure d'installation.

1. Sous le volet "Projet", dans le groupe "Génération", cliquez sur "Procédure d'installation". L'assistant de création d'installation se lance. Cliquez sur le lien "Installation" à gauche de l'assistant.
2. Sélectionnez "Créer l'exécutable maintenant". La création de l'exécutable est réalisée.
   Remarque : Si l'assistant propose la création du fichier d'aide, validez les différents messages.
3. L'assistant de création d'installation se lance.
   
   

   La création de l'exécutable et du programme d'installation d'une application est présentée dans le tuto Déployer l'application.
4. Choisissez une "Installation individuelle". Passez à l'étape suivante.
5. Choisissez une "Installation standard". Passez à l'étape suivante.
6. Validez le répertoire d'installation proposé et passez à l'étape suivante.
7. Dans l'écran "Fichiers installés", sélectionnez si nécessaire les fichiers de données (.fic, .mmo et .ndx) présents dans le répertoire de l'exécutable. Pour cela, cliquez sur "Ajouter" et sélectionnez ces fichiers.
   
8. Cliquez à gauche sur le lien "Compléments".
9. Dans l'écran "Modules complémentaires", vérifiez que l'option "Intégrer l'installation de Etats et Requêtes (attention : volumineux)" est cochée.
10. Passez à l'étape suivante.
11. Dans l'étape intitulée "Etats et Requêtes" :
    • Spécifiez si vous voulez incorporer l'installation de "Etats et Requêtes" dans votre programme d'installation.
      Dans ce cas, le package d'installation du logiciel "Etats et Requêtes" (présent dans le sous-répertoire "Install\Reports And Queries" du répertoire d'installation de WINDEV) sera utilisé.
      Il est possible de :
      • Proposer l'installation du logiciel "Etats et Requêtes" en même temps que l'application.
      • Proposer l'installation du logiciel "Etats et Requêtes" lors de sa première utilisation.
      Attention : Incorporer le logiciel "Etats et Requêtes" augmente la taille de votre installation de façon non négligeable (environ 2 Go).
      
    • Spécifiez si nécessaire les répertoires correspondant aux états et requêtes modifiés ou créés par l'utilisateur final :
      • Le répertoire des états et requêtes personnels correspond au répertoire des états et requêtes visibles uniquement par l'utilisateur qui les a créés.
      • Le répertoire des états et requêtes partagés correspond au répertoire des états et requêtes visibles par tous les utilisateurs de l'application.
      Ces répertoires peuvent être modifiés lors de l'installation de l'application : il suffit de cocher l'option "Autoriser la modification de ces répertoires lors de l'installation".
12. Cliquez sur l'option "Support" à gauche de l'assistant. Cette étape permet notamment de sélectionner le support de l'installation, le répertoire de création du programme d'installation si nécessaire et permet également de protégrer l'installation avec un mot de passe.
13. Conservez les options par défaut et terminez l'assistant. Le programme d'installation est généré. Ne fermez pas la fenêtre indiquant la fin de la création de l'installation.

Installation de l'application

Pour tester l'installation et l'utilisation du logiciel "Etats et Requêtes", nous allons installer l'application "WD Application Complète".

1. Si l'UAC est activée, une fenêtre s'affiche demandant l'autorisation d'exécuter le programme. Validez cette fenêtre.
2. L'assistant d'installation se lance.
   
   

   L'assistant propose de changer la langue de l'installation via une combo en haut à droite de la fenêtre.

   
   
   Deux modes d'installation sont disponibles :
   • Installation rapide : L'installation est directement réalisée avec les paramètres spécifiés par le fournisseur de l'application.
   • Installation personnalisée : L'assistant demande à l'utilisateur les paramètres d'installation de l'application.
3. Choisissez "Installation personnalisée". L'assistant demande le répertoire d'installation de l'application.
4. Sélectionnez si nécessaire le répertoire d'installation de l'application puis passez à l'étape suivante.
5. L'étape "Etats et Requêtes" permet d'installer le logiciel "Etats et Requêtes".
   
   Sélectionnez l'option "Installer "Etats et Requêtes"" et indiquez le répertoire d'installation de ce logiciel.
   Remarque : Si une précédente version du logiciel "Etats et Requêtes" est installé sur le poste, il est possible de réaliser une sauvegarde de cette version.
6. Passez à l'étape suivante.
7. L'étape suivante permet de définir les répertoires utilisés pour l'enregistrement des états et des requêtes (si l'option "Autoriser la modification de ces répertoires lors de l'installation" a été cochée dans l'assistant de création du programme d'installation).
   
8. Passez à l'étape suivante et terminez l'installation de l'application.
9. L'installation de l'application, puis l'installation du logiciel "Etats et Requêtes" se lancent.
10. La dernière étape de l'assistant permet de lancer immédiatement l'application et de créer les icônes de l'application.

Test de l'application

Nous allons maintenant nous placer dans la peau de l'utilisateur final de votre application (ce n'est pas évident, mais pourquoi pas).

1. Lancez l'application "WD Application Complète".
2. Sélectionnez l'option "Etats .. Liste des clients". L'état est affiché dans le visualisateur de rapports. Cliquez sur le volet "Aperçu".
   
3. Dans cet écran, deux nouvelles icônes font leur apparition :
   

   	Permet de modifier l'état en cours dans le visualisateur de rapports.
   	Permet de créer un nouvel état.

1. Cliquez sur l'icône .
2. L'état apparaît en édition sous le logiciel "Etats et Requêtes".
   
3. L'utilisateur peut alors faire les modifications qu'il souhaite :
   • sur le style des informations affichées (par exemple changer la couleur d'un champ).
   • sur le contenu de l'état (par exemple ajouter un champ, etc.). Si l'état est lié à une requête, l'utilisateur peut modifier cette requête.
     • Si l'état est lié à une requête intégrée, la modification est effectuée directement dans l'état.
     • Si l'état est lié à une requête indépendante, la requête est également modifiée. La modification sera prise en compte uniquement dans le cadre de l'exécution de l'état (si une fenêtre utilise également cette requête, la modification ne sera pas prise en compte par la fenêtre).

1. Sélectionnez le champ date dans le début de document.
2. Sous le volet "Modification", dans le groupe "Edition rapide", cliquez sur l'icône "Couleur". Dans la fenêtre qui s'affiche, sélectionnez la couleur rouge et validez.
3. Enregistrez votre état. Par défaut, le répertoire proposé est le répertoire d'installation de votre application.
4. Fermez le logiciel "Etats et Requêtes".
5. Sélectionnez l'option "Etats .. Liste des clients" dans l'application. L'état apparaît en mode "Visualisateur de rapports" et la modification réalisée est effective.

Dans cet exemple, l'état que vous avez modifié est disponible pour vous seul. Dans le cas d'une application réseau, l'utilisateur a la possibilité de mettre à disposition de tous les utilisateurs un état modifié.

Nous avons vu dans ce tuto comment préparer une application pour l'utilisation du logiciel "Etats et requêtes". Nous avons également installé cette application et modifié un état en passant par le visualisateur de rapports.

• ajouter le menu d'aide automatique ‘?' dans la fenêtre principale de votre application. Ce menu doit contenir les options "Créer, modifier un état" et "Créer, modifier une requête". Pour plus de détails, consultez Menu "?".
• utiliser la fonction LanceEtatsEtRequêtes dans votre application.