PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Ce que vous allez apprendre dans cette leçon
  • Présentation du logiciel "Etats et Requêtes"
  • Lancement du logiciel "Etats et Requêtes"
  • Diffuser le logiciel "Etats et Requêtes" avec votre application
  • Paramétrage du projet
  • Paramétrage de l'analyse
  • Paramétrage des états
  • Paramétrage des requêtes
  • 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
Leçon 4.15. Diffusez "Etats et Requêtes" avec vos applications
Ce que vous allez apprendre dans cette leçon
  • 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.


Leçon précédenteSommaireLeçon suivante
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 de vos applications.
Un utilisateur trouve qu'il manque une information sur l'état fourni en standard ? Avec le logiciel "Etat et Requêtes", il peut ajouter l'information directement depuis l'aperçu avant impression. Cette modification peut être intéressante pour d'autres utilisateurs ? L'état peut être mis à disposition de tous les utilisateurs utilisant l'application en réseau. De même pour les requêtes.

Note

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.
Lancement du logiciel "Etats et Requêtes"
Pour que les utilisateurs finaux personnalisent les états de votre application ou créent leurs propres états et leurs propres requêtes, il suffit de lancer le logiciel "Etats et Requêtes".
Pour permettre à vos utilisateurs finaux de lancer le logiciel "Etats et Requêtes" :
  • soit affichez vos états sous la fenêtre d'aperçu avant impression. 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.
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 de :
  • 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".
Nous allons détailler ces différentes étapes en manipulant le projet "WD Application Complète".

Corrigé

Si vous n'avez pas réalisé les manipulations des leçons précédentes, vous pouvez suivre cette leçon en ouvrant un projet corrigé : sous le volet "Accueil", dans le groupe "Aide en ligne", déroulez "Guide d'Auto-formation" puis sélectionnez "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. Si nécessaire, ouvrez le projet exemple "WD Application Complète" : sous le volet "Accueil", dans le groupe "Aide en ligne", déroulez "Guide d'Auto-formation" puis sélectionnez l'option "Application Complète (Exercice)". Le projet se charge.

      Note

      Si vous n'avez pas réalisé les états dans le projet "WD Application Complète", ouvrez le projet corrigé de l'application : sous le volet "Accueil", dans le groupe "Aide en ligne", déroulez "Guide d'Auto-formation" puis sélectionnez l'option "Application Complète (Corrigé)".
    2. Affichez la description du projet.
      Rappel : Pour afficher la description du projet, sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    3. Dans l'onglet "Avancé", cochez l'option "Autoriser le lancement de "Etats et Requêtes"".
    4. Validez.

Paramétrage de l'analyse

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 parmi les boutons d'accès rapide du menu de WINDEV.
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, ...) vous pouvez rendre ces fichiers de données ou ces rubriques invisibles sous le logiciel "Etats et Requêtes".

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 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 (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 "Etats 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 du fichier (option "Description des rubriques" du menu contextuel).
    3. Sélectionnez dans la table, la rubrique voulue.
    4. Dans l'onglet "Etats et Requêtes", décochez l'option "Visible par l'utilisateur final dans le logiciel "Etats 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 (option "Génération" dans le volet "Analyse"). Une modification automatique des fichiers de données est proposée pour prendre en compte les modifications effectuées.

Paramétrage des états

Lors de la création d'un état, il est possible de spécifier si cet état est modifiable sous le logiciel "Etats et Requêtes".
  • Pour rendre l'état "ETAT_Table_REQ_RechercheCommandes" présent dans le projet "WD Application Complète" modifiable sous le logiciel "Etats & Requêtes" :
    1. Ouvrez l'état "ETAT_Table_REQ_RechercheCommandes" 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 "Etat modifiable sous Etats et Requêtes".
    4. Cochez :
      • l'option "Interface modifiable uniquement" pour que l'interface de l'état uniquement soit modifiable sous Etats et Requêtes.
      • l'option "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

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 & 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.

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 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 et éditer l'aide". 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" est cochée.
    10. Dans l'écran intitulé "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 290 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".
    11. Cliquez sur l'option "Support" à gauche de l'assistant.
    12. 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.
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".
En suivant les étapes du paragraphe précédent, vous avez généré 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 "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 vous utilisez un système d'exploitation correspondant à Windows Vista ou supérieur, une fenêtre s'affiche demandant l'autorisation d'exécuter le programme. Validez cette fenêtre.
    2. Choisissez la langue du programme d'installation et cliquez sur "OK".
    3. L'assistant d'installation se lance. 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.
    4. Choisissez "Installation personnalisée". L'assistant demande le répertoire d'installation de l'application.
    5. Validez le répertoire d'installation de l'application.
    6. L'écran "Etats et Requêtes" permet d'installer le logiciel "Etats et Requêtes" (uniquement si ce programme n'est pas déjà installé sur le poste en cours).
    7. Passez à l'étape suivante.
    8. L'écran suivant 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).
    9. Passez à l'étape suivante et terminez l'installation de l'application.
    10. L'installation de l'application, puis l'installation du logiciel "Etats et Requêtes" se lancent.

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 l'aperçu avant impression. 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 l'aperçu avant impression.
      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" et sélectionnez la couleur rouge.
    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 "Aperçu avant impression" 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 & Requêtes".
Pour plus de détails, consultez L'éditeur d'états Utilisateur (logiciel Etats & Requêtes).
Conclusion
Toute la phase de développement de notre application est terminée. Les deux prochaines leçons vont vous permettre de découvrir :
  • comment transformer votre application en une application multilingue,
  • comment intégrer votre application dans le Gestionnaire de sources (GDS).
Leçon précédenteSommaireLeçon suivante
Version minimum requise
  • Version 23
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire