DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV 2024 !
Aide / Tuto WINDEV / Tuto - Etats et Requêtes
  • Diffusez "Etats et Requêtes" avec vos applications
  • Présentation du logiciel "Etats et Requêtes"
  • Comment diffuser le logiciel "Etats et Requêtes" avec votre application ?
  • Etape 1 : Paramétrage du projet
  • Etape 2 : Définir les fichiers de données et les rubriques non visibles dans le logiciel Etats et Requêtes
  • Etape 3 : Définir les états et les requêtes modifiables ou non sous le logiciel "Etats et Requêtes"
  • Etape 4 : Création de l'exécutable et diffusion de l'application
  • Installer et utiliser le logiciel "Etats et Requêtes"
  • Installation de l'application
  • Test de l'application
  • Conclusion

Tuto - Etats et Requêtes

Diffusez "Etats et Requêtes" avec vos applications
Ce que vous allez apprendre :
  • 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 de la leçon 10 mn
Présentation du logiciel "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.
Par exemple, si un utilisateur trouve qu'il manque une information sur l'état fourni dans son application, grâce au logiciel "Etat et Requêtes", il peut ajouter l'information directement depuis le visualisateur de rapports. L'état peut être mis à disposition de tous les utilisateurs utilisant l'application en réseau. De même pour les requêtes.
Le logiciel "Etats et Requêtes" est gratuit et librement redistribuable avec vos applications créées avec WINDEV. Consultez la licence pour plus de détails sur les conditions de redistribution.
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 .
Comment diffuser le logiciel "Etats et Requêtes" avec votre application ?
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".
Nous allons détailler ces différentes étapes en manipulant le projet "WD Application Complète".
Ouverture du projet exemple
  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".
A partir du logiciel "Etats et Requêtes", l'utilisateur ne peut pas ajouter, modifier ou supprimer des enregistrements. Il n'est également pas possible de créer ou de re-créer des fichiers de données.
Nous allons maintenant ouvrir l'analyse pour paramétrer les fichiers et rubriques utilisables sous le logiciel "Etats et Requêtes".
Ouvrez l'analyse de votre projet : cliquez sur Charger l'analyse du projet parmi les boutons d'accès rapide du menu de WINDEV.
Nous allons paramétrer le fichier "ModeRèglement" pour qu'il devienne invisible 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.
Nous allons maintenant rendre la rubrique "Visuel" du fichier "Produit" invisible sous le logiciel "Etats et Requêtes" :
  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.
Pour prendre en compte les modifications effectuées dans l'analyse, nous allons regénérer l'analyse :
  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 les états, seule l'interface des états est modifiable. La création d'un état est détaillée dans la leçon 4 du tuto "Application complète avec données".
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".
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 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.

Pour créer le programme d'installation de l'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.
    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.
Installer et utiliser le logiciel "Etats et Requêtes"

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".
Nous venons de générer le programme d'installation de cette application. Le programme d'installation a été créé dans le sous-répertoire "Install" du projet en cours.
Dans la fenêtre de fin de création de l'installation, cliquez sur le bouton "Installer". 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.
    L'assistant propose de changer la langue de l'installation via une combo en haut à droite de la fenêtre.
    Assistant d'installation

    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).
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, 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).
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.
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 fini notre découverte du logiciel "Etats et Requêtes".
Pour plus de détails, consultez L'éditeur d'états Utilisateur (logiciel Etats et Requêtes).
Conclusion
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.
Il existe d'autres méthodes permettant d'utiliser le logiciel "Etats et Requêtes" depuis votre application. Vous pouvez :
  • 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.
Dans ces deux cas, si le logiciel "Etats et Requêtes" n'est pas installé sur le poste de l'utilisateur, une fenêtre lui permettra de l'installer.
Sommaire
Version minimum requise
  • Version 2024
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/12/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale