DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Logiciel Etats & Requêtes
  • Présentation
  • Diffuser le logiciel Etats & Requêtes avec votre application WINDEV
  • Traduire les noms des fichiers de données et des rubriques
  • Les étapes en détail
  • Étape 1 : Paramétrage du projet
  • Étape 2 : Paramétrage de l'analyse : Fichiers de données et rubriques visibles
  • Étape 2 bis : Paramétrage de l'analyse : Traduction des noms de fichiers et de rubriques
  • Étape 3 : Paramétrage des états
  • Étape 3 bis : Paramétrage des requêtes
  • Étape 4 : Création de l'exécutable et diffusion de l'application
  • Étape 5 : Installation de l'application WINDEV chez vos utilisateurs finaux
  • Personnaliser l'adresse de téléchargement
  • Utiliser le logiciel Etats & Requêtes
  • Lancement du logiciel Etats & Requêtes
  • Paramétrage des options des fichiers de données
  • Principe d'utilisation des états
  • Modification d'un état
  • Utilisation d'un état modifié
  • Utilisation d'un nouvel état
  • Noms de rubriques et de fichiers multilingues
  • Principe d'utilisation des requêtes
  • Modification d'une requête de l'application
  • Utilisation d'une nouvelle requête
  • Noms de rubriques et de fichiers multilingues
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Cette page présente les différentes manipulations à effectuer pour qu'une application WINDEV puisse être manipulée avec le logiciel Etats & Requêtes.
Le logiciel "Etats & Requêtes" est gratuit et librement redistribuable avec vos applications WINDEV. Consultez la licence pour les conditions d'utilisation et de redistribution de ce logiciel.
Remarque : Cette page d'aide est réservée au développeur de l'application WINDEV.
Diffuser le logiciel Etats & Requêtes avec votre application WINDEV
Pour diffuser le logiciel Etats & Requêtes avec votre propre application WINDEV, le fournisseur de l'application WINDEV doit :
  • Indiquer au niveau du projet que l'application autorise le lancement du logiciel Etats & Requêtes.
  • Définir dans l'analyse les fichiers de données et les rubriques manipulables avec le logiciel Etats & Requêtes, et si nécessaire les noms des fichiers de données et des rubriques disponibles dans les différentes langues.
  • Définir les états modifiables sous le logiciel Etats & Requêtes.
  • Définir les requêtes visibles sous le logiciel Etats & Requêtes.
  • Créer l'exécutable et le programme d'installation de l'application WINDEV.
  • Installer l'application WINDEV chez les utilisateurs finaux.
Remarque : Afin de diminuer la taille du programme d'installation, le logiciel "Etats & Requêtes" peut être téléchargé directement depuis votre application :

Traduire les noms des fichiers de données et des rubriques

Vous diffusez le logiciel "Etats & Requêtes" dans des pays différents (il existe en français et en anglais). Les langues utilisées sont différentes : espagnol, roumain, chinois, suédois, etc.
Si l'utilisateur final souhaite créer des états ou des requêtes, il doit manipuler les noms des fichiers de données et des rubriques. Ces noms sont utilisés dans l'analyse par le concepteur de l'application. Ces noms sont bien souvent en français, ce qui n'est pas pratique pour l'utilisateur chinois ou roumain.
Il est possible d'indiquer une traduction pour les noms des fichiers de données et des rubriques dans l'analyse.
Les étapes en détail

Étape 1 : Paramétrage du projet

Pour utiliser le logiciel Etats & Requêtes à partir de votre application WINDEV, il est nécessaire de configurer le projet de votre application.
  1. Affichez la fenêtre de 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.
Remarques :
  • Par défaut, les projets WINDEV autorisent le lancement du logiciel Etats & Requêtes.
  • Le code d'initialisation du projet est exécuté lors d'un test d'un état ou d'une requête depuis le logiciel Etats & Requêtes. Dans ce cas, la fonction EnModeTest renvoie Faux.

Étape 2 : Paramétrage de l'analyse : Fichiers de données et rubriques visibles

Par défaut, tous les fichiers de données et leurs rubriques sont manipulables sous le logiciel Etats & Requêtes. L'utilisateur final peut utiliser ces données dans ses états et ses requêtes personnalisées.
Pour limiter les données manipulables sous le logiciel Etats & Requêtes (par exemple si votre application contient des données sensibles), il est nécessaire de modifier l'analyse WINDEV : il suffit de rendre les fichiers de données et/ou les rubriques voulues "invisibles" sous le logiciel Etats & Requêtes.
Remarque : Les états et les requêtes créés directement depuis WINDEV et basés sur des fichiers de données et/ou des rubriques invisibles peuvent être exécutés et/ou modifiés depuis le logiciel Etats & Requêtes.
Pour définir un fichier de données invisible sous le logiciel Etats & Requêtes :
  1. Sous l'éditeur d'analyses de WINDEV, sélectionnez le fichier de données voulu.
  2. Affichez la fenêtre de description des rubriques 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 "États et Requêtes"".
  4. Validez.
Remarque : Toutes les rubriques du fichier de données seront automatiquement rendues invisibles.
Pour définir une rubrique de fichier de données invisible sous le logiciel Etats & Requêtes :
  1. Sous l'éditeur d'analyses de WINDEV, sélectionnez le fichier de données contenant la rubrique voulue.
  2. Affichez la fenêtre de description du fichier (option "Description des rubriques" du menu contextuel).
  3. Sélectionnez 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.
Remarque : La propriété VisibleUtilisateurFinal permet également de connaître ou de modifier la visibilité d'une rubrique sous le logiciel Etats & Requêtes.
Attention : Pour prendre en compte les modifications effectuées dans l'analyse WINDEV, il est bien entendu nécessaire de générer l'analyse WINDEV : sous le volet "Analyse", dans le groupe "Analyse", déroulez "Génération" et sélectionnez "Génération".

Étape 2 bis : Paramétrage de l'analyse : Traduction des noms de fichiers et de rubriques

Par défaut, lorsque l'utilisateur final manipule les fichiers de données et les rubriques lors de la création d'un état ou d'une requête, tous les noms utilisés correspondent à ceux définis par le développeur dans l'analyse. Ces noms ne sont bien souvent pas dans la langue de l'utilisateur. Il est possible de proposer une traduction pour les éléments suivants directement dans l'analyse WINDEV :
  • Nom du fichier de données,
  • Libellé du fichier de données,
  • Nom de la rubrique,
  • Libellé de la rubrique.
Remarque : Si votre projet doit être traduit, pensez à traduire ces informations. WDMSG extrait et ré-intègre automatiquement ces informations.
Pour définir les paramètres multilingues d'un fichier de données sous le logiciel Etats & Requêtes :
  1. Sous l'éditeur d'analyses de WINDEV, sélectionnez le fichier de données voulu.
  2. Affichez la fenêtre de description des rubriques du fichier (option "Description du fichier de données" du menu contextuel).
  3. Dans l'onglet "Etats et Requêtes", indiquez le nom du fichier de données et son libellé dans les différentes langues gérées par l'analyse.
    Remarque : Le nom utilisé ne doit pas correspondre à un nom de fichier de données existant dans l'analyse.
  4. Validez.
Pour définir les paramètres multilingues d'une rubrique de fichier sous le logiciel Etats & Requêtes :
  1. Sous l'éditeur d'analyses de WINDEV, sélectionnez le fichier de données contenant la rubrique voulue.
  2. Affichez la fenêtre de description du fichier (option "Description des rubriques" du menu contextuel).
  3. Sélectionnez la rubrique voulue.
  4. Dans l'onglet "Etats et Requêtes", indiquez le nom de la rubrique et son libellé dans les différentes langues gérées par l'analyse.
  5. Validez.
Attention : Pour prendre en compte les modifications effectuées dans l'analyse WINDEV, il est bien entendu nécessaire de générer l'analyse WINDEV : sous le volet "Analyse", dans le groupe "Analyse", déroulez "Génération" et cliquez sur "Génération".

Étape 3 : Paramétrage des états

Pour rendre un état de votre application modifiable sous le logiciel Etats & Requêtes :
  1. Ouvrez l'état sous l'éditeur d'états.
  2. Affichez la fenêtre de description de l'état (option "Description de l'état" du menu contextuel de l'état).
  3. Dans l'onglet "Options", cochez l'option "État modifiable sous États et Requêtes".
  4. Cochez :
    • l'option "Interface modifiable uniquement" pour que l'interface de l'état uniquement soit modifiable sous Etats & Requêtes.
    • l'option "Tout modifiable (interface et code)" pour que l'état soit entièrement modifiable sous Etats & Requêtes.
  5. Validez et enregistrez l'état.
Remarques :

Étape 3 bis : Paramétrage des requêtes

Par défaut, une requête n'est ni visible ni modifiable sous le logiciel Etats & Requêtes. Il est uniquement possible de la rendre visible sous le logiciel Etats & Requêtes. Il n'est pas possible de la rendre modifiable.
Pour rendre une requête de votre application visible sous le logiciel Etats & Requêtes :
  1. Ouvrez la requête sous l'éditeur de requêtes.
  2. Affichez la fenêtre de description de la requête (option "Description de la requête" du menu contextuel de la requête).
  3. Cliquez sur le bouton "Avancé".
  4. Dans l'onglet "Etats & Requêtes", cochez l'option "Visible sous 'Etats Requêtes'".
  5. Validez et enregistrez la requête.
Remarque : Les requêtes sont uniquement visibles sous le logiciel Etats & Requêtes. Elles ne sont pas modifiables. Le logiciel Etats & Requêtes permet de faire les manipulations suivantes sur une requête :
  • exécuter et visualiser le résultat de la requête.
  • utiliser la requête comme base pour la construction d'autres requêtes.
  • réaliser une copie de la requête (option "Enregistrer sous").
  • utiliser la requête comme source de données d'un état.

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

La création et la diffusion d'une application WINDEV utilisant le logiciel Etats & Requêtes se fait de la même façon que pour une application classique. C'est lors de la création de la procédure d'installation, que vous pouvez indiquer les paramètres spécifiques au logiciel Etats & Requêtes.
Lorsque votre application WINDEV est entièrement décrite (fenêtres, états, requêtes, etc.), créez l'exécutable correspondant. Pour plus de détails, consultez Création d'un exécutable.
Créez ensuite le programme d'installation (pour plus de détails, consultez Programme d'installation). Dans l'assistant de création du programme d'installation, dans l'étape "Modules complémentaires" :
  1. Cochez l'option "Intégrer l'installation de Etats et Requêtes". Le package d'installation du logiciel Etats et Requêtes est automatiquement recherché. Ce pack d'installation est présent dans le sous-répertoire "Install\Reports And Queries" du répertoire d'installation de WINDEV.
    Attention : Incorporer le logiciel Etats et Requêtes augmente la taille de votre installation de façon non négligeable (environ 160 Mo).
    Il est également possible de distribuer le pack d'installation Etats et Requêtes séparément. Si le logiciel Etats et Requêtes n'est pas inclus dans l'installation, il pourra être téléchargé directement depuis l'application (soit par le menu automatique, soit depuis le visualisateur de rapports d'un état, soit par la fonction LanceEtatsEtRequêtes). Par défaut, le logiciel est téléchargé sur un site FTP de PC SOFT. Il est possible de personnaliser l'adresse de téléchargement du logiciel (par exemple site d'une société, etc.). Pour plus de détails, consultez le paragraphe "Personnaliser l'adresse de téléchargement".
  2. 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.
  3. Autorisez ou non la modification de ces répertoires lors de l'installation de l'application.
Remarque : La fonction fRepEtatsEtRequêtes permet de connaître le répertoire des états et requêtes personnels et/ou partagés.

Étape 5 : Installation de l'application WINDEV chez vos utilisateurs finaux

L'installation d'une application utilisant le logiciel Etats & Requêtes est identique à l'installation d'une application classique.
Lors de l'installation, si vous avez inclus le logiciel "Etats & Requêtes" dans le programme d'installation, l'utilisateur devra simplement indiquer s'il souhaite installer le logiciel Etats & Requêtes.
Si le logiciel Etats & Requêtes n'a pas été inclus dans le programme d'installation, le téléchargement de ce logiciel sera automatiquement proposé lors de l'utilisation du menu automatique, lors de la visualisation d'un état, ou lors du lancement du logiciel.
Fenêtre proposant le téléchargement

Personnaliser l'adresse de téléchargement

Si le logiciel Etats & Requêtes n'a pas été inclus dans le programme d'installation, le téléchargement de ce logiciel sera automatiquement proposé lors de l'utilisation du menu automatique, lors de la visualisation d'un état, ou lors du lancement du logiciel.
Par défaut l'adresse de téléchargement correspond à un site FTP de PC SOFT.
Pour utiliser un autre site :
  1. Créez un fichier texte LoginFTP.INI. Ce fichier doit être placé dans le même répertoire que l'exécutable de l'application.
  2. Ce fichier doit contenir les éléments suivants :
    [FTP]
    Login = Login de l'utilisateur sur le serveur FTP
    PSW = Mot de passe de l'utilisateur sur le serveur FTP
    Serv = Serveur FTP (par exemple ftp.pcsoft.fr)
    Dir = Répertoire de téléchargement (par exemple WX28/latest)
Remarques :
  • Si le pack de téléchargement est à la racine, il faut mettre uniquement "." dans l'entrée Dir.
  • Le nom du fichier à télécharger est "WD2024PACKER.exe".
Utiliser le logiciel Etats & Requêtes

Lancement du logiciel Etats & 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 & Requêtes.
Pour permettre à vos utilisateurs finaux de lancer le logiciel Etats & Requêtes :
  • soit affichez vos états dans le visualisateur de rapports. Les utilisateurs finaux pourront lancer le logiciel Etats & Requêtes en cliquant l'icône .
  • soit ajoutez le menu "?" 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 "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.
Si le logiciel "Etats et requêtes" n'est pas installé, une fenêtre s'affichera permettant de télécharger le logiciel.

Paramétrage des options des fichiers de données

Les utilisateurs finaux peuvent paramétrer les fichiers de données manipulés par le projet ouvert sous le logiciel "Etats & Requêtes". Il est possible de paramétrer :
  • le répertoire des fichiers de données utilisé pour test.
  • le live data (qui permet de voir les données lors de la manipulation de l'état sous l'éditeur).
Pour paramétrer les options des fichiers de données :
  • Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  • Sélectionnez l'onglet "Fichiers".
Principe d'utilisation des états

Modification d'un état

Lors de la modification d'un état, le fichier correspondant (fichier ".WDE") est automatiquement extrait de la bibliothèque de l'application et copié dans le répertoire des "Etats et requêtes personnels" (défini lors de la création de la procédure d'installation de l'application WINDEV).
C'est cet état que l'utilisateur final modifie.

Utilisation d'un état modifié

L'état modifié peut être testé directement sous le logiciel "Etats & Requêtes". Dans ce cas, le traitement d'initialisation du projet sera exécuté.
Par défaut, seul l'utilisateur ayant réalisé des modifications sur un état utilisera cet état modifié dans l'application WINDEV.
Pour qu'un état modifié soit utilisé par tous les autres utilisateurs de l'application, l'utilisateur final doit sélectionner l'option "Fichier .. Partager l'élément avec les autres utilisateurs". Le fichier correspondant à l'état modifié (fichier " .WDE") sera alors automatiquement supprimé du répertoire des "Etats et requêtes personnels" et copié dans le répertoire des "Etats et requêtes partagés".
Lors de l'exécution d'un état depuis l'application WINDEV, le fichier de l'état est recherché :
  • tout d'abord, dans le répertoire des "Etats et requêtes personnels".
  • puis, dans le répertoire des "Etats et requêtes partagés".
  • enfin, dans la bibliothèque de l'application WINDEV.
Remarque : Une indication présente dans le titre de la fenêtre du visualisateur de rapports informe les utilisateurs que l'état utilisé correspond à un état modifié.
Pour utiliser à nouveau l'état dans sa version originale, il suffit à vos utilisateurs finaux de supprimer physiquement le fichier de l'état modifié (fichier ".WDE") dans le répertoire des "Etats et requêtes personnels" et/ou dans le répertoire des "Etats et requêtes partagés".

Utilisation d'un nouvel état

Vos utilisateurs finaux pourront imprimer leurs nouveaux états directement depuis le logiciel Etats & Requêtes :
  • soit en lançant une impression (icône ).
  • soit en testant l'état (icône ).
    Dans ce cas, le traitement d'initialisation du projet est exécuté.
Il n'est donc pas nécessaire de programmer l'impression de l'état.
Pour que l'impression d'états réalisés avec le logiciel Etats & Requêtes soit possible directement à partir d'une application WINDEV, vous devez prévoir cette fonctionnalité dans votre application.
Vous pouvez par exemple intégrer une fenêtre permettant à l'utilisateur final de :
  • sélectionner un état réalisé avec le logiciel Etats & Requêtes.
  • lancer l'exécution de cet état.

Noms de rubriques et de fichiers multilingues

Vous avez définis des noms et des libellés multilingues pour vos fichiers de données et vos rubriques : lors de la modification ou de la création d'un état, l'utilisateur aura accès aux noms et libellés correspondant à la langue en cours.
Par exemple, l'application est utilisée en espagnol. L'utilisateur demande à modifier un des états affichés. Lorsque la source de l'état sera éditée, les noms des fichiers de données et des rubriques seront visualisés en espagnol.
Remarque : Si l'état est inclus dans l'exécutable, les libellés et les noms des rubriques et des fichiers de données seront affichés dans la langue originale.
Principe d'utilisation des requêtes

Modification d'une requête de l'application

Les requêtes de l'application peuvent être uniquement visibles sous le logiciel Etats & Requêtes. Elles ne sont pas modifiables. Le logiciel Etats & Requêtes permet de faire les manipulations suivantes sur une requête :
  • exécuter et visualiser le résultat de la requête.
  • utiliser la requête comme base pour la construction d'autres requêtes.
  • réaliser une copie de la requête (option "Enregistrer sous"). Une nouvelle requête sera alors créée.
  • utiliser la requête comme source de données d'un état.

Utilisation d'une nouvelle requête

Vos utilisateurs finaux pourront exécuter leurs nouvelles requêtes :
  • soit directement depuis le logiciel Etats & Requêtes en cliquant sur l'icône .
    Dans ce cas, le traitement d'initialisation du projet sera exécuté.
  • soit depuis l'application WINDEV.
Pour que l'exécution de requêtes réalisées avec le logiciel Etats & Requêtes soit possible directement à partir d'une application WINDEV, vous devez prévoir cette fonctionnalité dans votre application.
Vous pouvez par exemple intégrer une fenêtre permettant à l'utilisateur final de :
  • sélectionner une requête avec le logiciel Etats & Requêtes.
  • lancer l'exécution de cette requête et afficher son résultat dans une table (en utilisant par exemple la fonction ConstruitTableFichier).

Noms de rubriques et de fichiers multilingues

Vous avez défini des noms et des libellés multilingues pour vos fichiers de données et vos rubriques : lors de la création d'une requête, l'utilisateur aura accès aux noms et libellés correspondant à la langue en cours.
Par exemple, l'application est utilisée en espagnol. L'utilisateur demande à créer une requête. Lors de la création de la requête, les noms des fichiers de données et des rubriques seront visualisés en espagnol.
Remarques :
  • Si la requête est incluse dans l'exécutable, les libellés et les noms des rubriques et des fichiers de données seront affichés dans la langue originale.
  • Le code SQL de la requête reste dans la langue originale.
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 08/09/2023

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