• A quoi sert le logiciel "Etats et Requêtes" ?
• Comment diffuser le logiciel "Etats et Requêtes".
• Comment utiliser le logiciel "Etats et Requêtes".

	Durée estimée : 10 mn

	Express	Le logiciel "Etats et Requêtes" n'est pas disponible dans la version Express.

• soit affichez vos états dans le visualisateur de rapports. Les utilisateurs finaux pourront lancer le logiciel "Etats et Requêtes" en cliquant sur l'icône .
• soit ajoutez le menu d'aide automatique ‘?' dans la fenêtre principale de votre application : sous le volet "Fenêtre", dans le groupe "Barres et menus", déroulez "Menu principal" et sélectionnez l'option "Ajouter le menu ‘?'".
  Dans l'assistant de création de ce menu, cochez les options "Créer, modifier un état" et "Créer, modifier une requête".
• soit utilisez la fonction LanceEtatsEtRequêtes dans votre application.

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

• Ré-ouvrez si nécessaire le projet que vous avez manipulé dans la leçon précédente.
  1. Affichez la page d'accueil de WINDEV (Ctrl + <).
  2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Partie 4 - Application complète avec données", double-cliquez sur "Application complète - Exercice".
  3. WINDEV vous propose d'ouvrir le projet que vous avez manipulé dans la leçon précédente. Vous pouvez ouvrir le projet présent sur votre poste ou ouvrir le projet original. Choisissez "Ouvrir la copie locale".

	Corrigé	Un projet corrigé est disponible. Ce projet permet d'effectuer les manipulations de cette leçon (si vous n'avez pas suivi les leçons précédentes). Pour ouvrir le projet corrigé, dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Partie 4 - Application complète avec données", double-cliquez sur "Application complète - Corrigé".

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.

Paramétrage de l'analyse

• Ouvrez l'analyse de votre projet : cliquez sur parmi les boutons d'accès rapide du menu de WINDEV.

	Note	A partir du logiciel "Etats et Requêtes", l'utilisateur ne peut pas ajouter, modifier ou supprimer des enregistrements (les fonctions HAjoute, HModifie et HSupprime sont interdites). Il n'est également pas possible de créer ou de re-créer des fichiers de données (les fonctions HCréation et HCréationSiInexistant sont interdites).

• Pour définir un fichier de données invisible sous le logiciel "Etats et Requêtes" :
  1. Sous l'éditeur d'analyses, sélectionnez le fichier de données voulu.
  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 et Requêtes", décochez l'option "Visible par l'utilisateur final dans le logiciel "États et Requêtes"".
  4. Validez.

• Pour définir une rubrique invisible sous le logiciel "Etats et Requêtes" :
  1. Sous l'éditeur d'analyses, sélectionnez le fichier de données voulu.
  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 voulue.
  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.

• Pour prendre en compte les modifications effectuées dans l'analyse, il est nécessaire de régénérer l'analyse (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.

Paramétrage des états

• Pour rendre l'état "ETAT_Liste_des_clients" présent dans le projet "WD Application Complète" modifiable sous le logiciel "Etats & 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.

Paramétrage des requêtes

• Pour rendre la requête "REQ_BonDeCommande" présente dans le projet "WD Application Complète" 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 & Requêtes'".
  5. Validez et enregistrez la requête.

Création de l'exécutable et diffusion de l'application

• Pour créer le programme d'installation de votre application WD Application Complète :
  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.
     

     	Note	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.
  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 "Etats et Requêtes" 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 550 Mo).
        
      • 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 validez 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

• Dans la fenêtre de fin de création de l'installation, cliquez sur le bouton "Tester". Si vous avez fermé cette fenêtre, lancez directement le programme "Install.exe" présent dans le répertoire du programme d'installation. L'installation de l'application se lance.

• Nous allons suivre les différentes étapes du programme d'installation de 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.
     

     	Note	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

• Pour tester l'application :
  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.

• Nous allons modifier cet é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, ...). 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).

• Dans cet exemple, nous allons mettre la date en rouge. Pour cela :
  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.

• comment transformer votre application en une application multilingue,
• comment intégrer votre application dans le Gestionnaire de sources (GDS).