DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Sources de données
  • Présentation
  • Créer un état sur une vue HFSQL
  • Imprimer un état sur une vue HFSQL
  • Pour imprimer un état sur une vue HFSQL
  • Exemple WINDEV
  • Exemple WEBDEV
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
Etat sur une vue HFSQL
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Présentation
Un état sur une vue HFSQL permet d'imprimer des enregistrements provenant d'une vue HFSQL Classic ou Client/Serveur.
Rappel : Une vue HFSQL correspond à une "image mémoire" de tout ou partie d'un fichier de données. Une vue est stockée en mémoire, ce qui la rend insensible aux modifications effectuées sur le fichier de données associé. Une fois créée, une vue se manipule comme un fichier de données HFSQL. Pour plus de détails, consultez Les vues HFSQL.
Caractéristiques d'un état sur une vue HFSQL :
  • un état sur une vue HFSQL est lié au fichier de base de cette vue HFSQL. L'état permet d'imprimer les enregistrements provenant de ce fichier de base.
  • l' ordre d'impression des enregistrements correspond à l'ordre des enregistrements présents dans la vue HFSQL (défini lors de la création de la vue ou avec la fonction HTrieVue).
La création d'un état sur une vue HFSQL s'effectue grâce à l'assistant de création d'un état.
Lorsque l'état sur une vue HFSQL est créé, il est possible à tout moment de :
  • modifier la source de données de l'état (onglet "Données" de la description de l'état).
  • ajouter ou supprimer des champs Rubriques liés à la vue HFSQL associée à l'état.
Le logiciel Etats & Requêtes ne permet pas de créer des états sur une vue HFSQL. Cependant, il est possible de personnaliser des états sur une vue HFSQL créés sous l'éditeur d'états intégré (couleur, polices, taille, ...).
Créer un état sur une vue HFSQL
Pour créer un état sur une vue HFSQL :
  1. Cliquez sur parmi les boutons d'accès rapide.
    • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
    • L'assistant de création d'un état s'affiche.
  2. Choisissez la présentation de votre état (tableau, fiche, étiquette, ...). Pour plus de détails, consultez Les différents types d'états.
  3. Sélectionnez si nécessaire le modèle d'états à utiliser. Un modèle d'états permet de respecter une mise en page spécifique. Pour plus de détails sur les modèles d'états, consultez Les modèles d'états.
  4. Sélectionnez la source de données de l'état (option "Autre (programmation, fichier texte, zone mémoire, vue HFSQL, ...").
  5. Sélectionnez le type de la source de données de l'état (option "d'une vue HFSQL").
  6. Sélectionnez le fichier de données de base de la vue HFSQL associée à l'état.
  7. Sélectionnez les rubriques affichées dans l'état. Seuls les champs reliés aux rubriques de la vue HFSQL seront renseignés.
    Pour chaque rubrique affichée dans l'état :
    • saisissez le libellé correspondant. Ce libellé sera affiché :
      • soit avant la rubrique. Par exemple :
      • soit dans l'entête de la colonne (cas des états Tableau). Par exemple :
        Ce libellé pourra être modifié directement sous l'éditeur d'états.
    • sélectionnez le bloc dans lequel le champ associé à la rubrique doit être imprimé. La position des différents champs pourra être modifiée directement sous l'éditeur d'états. Pour plus de détails sur les différents blocs et sur leur position dans un état, consultez Blocs d'un état.
  8. Modifiez si nécessaire l'ordre d'affichage des différents champs dans l'état à l'aide des boutons fléchés à droite du tableau.
  9. Si la vue HFSQL associée à l'état contient au moins une rubrique de type numérique, il est possible de réaliser des calculs sur ces rubriques. Spécifiez le calcul réalisé pour chaque rubrique (somme, moyenne, ...). Deux types de calcul sont possibles :
    • calcul général : un champ Calculé sera créé dans le bloc Fin de document.
    • calcul sur rupture (inutile dans ce type d'état).
  10. Selon le type d'état en cours de création, indiquez les options spécifiques correspondantes.
    Type d'étatOptions spécifiques
    État sur formulaireImage du formulaire, impression de l'image du formulaire, ...
    Options détaillées dans la page Etat sur formulaire
    État ÉtiquetteFormat des étiquettes, nombre d'exemplaires identiques, ...
    Options détaillées dans la page Etat Étiquette
  11. Spécifiez le format de la feuille sur laquelle l'état va être imprimé. Par défaut, l'état est imprimé sur une feuille au format A4.
    Remarque : Par défaut, les champs de l'état sont disposés sur une seule colonne. Pour réaliser un état multicolonne, il suffit de spécifier le nombre de colonnes voulues dans l'onglet "Format" de la fenêtre de description de l'état.
  12. Sélectionnez le gabarit de l'état si nécessaire.
  13. Saisissez le nom et le titre de l'état (nom du fichier ".WDE" correspondant à l'état). Ce nom permettra d'identifier l'état dans vos programmes.
    WINDEV Il est également possible d'indiquer si l'état peut être modifié par l'utilisateur final sous le logiciel "Etats & Requêtes".
  14. Validez la création de l'état.
  15. L'éditeur d'états propose automatiquement de changer le format de l'état utilisé si les conditions suivantes sont réunies :
    • l'état en cours de création comporte un tableau.
    • le format de l'état ne permet pas d'afficher l'ensemble des colonnes du tableau.
  16. Si nécessaire, indiquez le mode de réduction de l'état :
    • Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
    • Utiliser le mode paysage.
    • Réduire l'état par rapport à l'original. Attention : selon le pourcentage de réduction choisi, l'état imprimé pourra devenir illisible.
  17. L'état en cours de création s'affiche sous l'éditeur d'états.
Imprimer un état sur une vue HFSQL

Pour imprimer un état sur une vue HFSQL

  1. Créer la vue HFSQL avec la fonction HCréeVue (ou la fonction HFusionneVue).
  2. Paramétrer la destination de l'impression de l'état :
    • WINDEV En WINDEV, grâce à la fonction iDestination (visualisateur de rapports, impression dans un fichier HTML, ...).
    • WEBDEV - Code Serveur En WEBDEV, grâce à la fonction iDestination (impression dans un fichier HTML, ...).
    Pour plus de détails, consultez Modes d'impression d'un état.
  3. Préciser les paramètres suivants grâce à la fonction iImprimeEtat :
    • le nom de l'état à imprimer.
    • le nom de la vue HFSQL Classic utilisée.
Remarques :
  • La vue HFSQL doit avoir été créée et initialisée avant de lancer l'impression de l'état. Seule une vue HFSQL Classic ou Client/Serveur peut être utilisée.
  • Si des paramètres supplémentaires doivent être passés à l'état, ces paramètres doivent être indiqués dans la fonction iImprimeEtat, après le nom de la vue HFSQL utilisée. Pour plus de détails, consultez Etat paramétré.
  • La propriété NomVue utilisée dans le code de l'état permet de connaître et de changer la vue HFSQL associée à l'état.
  • La propriété NomSource utilisée dans le code de l'état permet de connaître et de changer le fichier de données de base de la vue HFSQL associée à l'état.
Sous le logiciel Etats & Requêtes, il est possible d'imprimer un état :
  • soit en lançant une impression (icône ).
  • soit en testant l'état (icône ).
Il n'est donc pas nécessaire de programmer l'impression de l'état.
WINDEVEtats et Requêtes

Exemple WINDEV

L'utilisateur sélectionne la référence d'une commande dans une liste. Le champ Bouton "BTN_Imprimer" permet de :
  • créer la vue HFSQL "VueCommande" contenant les lignes de la commande sélectionnée (fonction HCréeVue).
  • ouvrir la fenêtre du visualisateur de rapports (fonction iDestination).
  • imprimer l'état "ETAT_Vue" (fonction iImprimeEtat).
Dans cet exemple, le code de clic du champ Bouton "BTN_Imprimer" est le suivant :
// Créer la vue
SI HCréeVue("VueCommande", LigneCde, "*", "Référence", "", "", hVueExclusive + hVueInterruptible) = Faux ALORS
Erreur(HErreurInfo())
SINON
// Ouvrir le visualisateur de rapports
iDestination(iVisualisateur)
// Imprimer l'état ETAT_Vue
iImprimeEtat(ETAT_Vue, "VueCommande")
FIN
WEBDEV - Code Serveur

Exemple WEBDEV

L'internaute sélectionne la référence d'une commande dans une liste. Le champ Bouton "BTN_Imprimer" permet de :
  • créer la vue HFSQL "VueCommande" contenant les lignes de la commande sélectionnée (fonction HCréeVue).
  • imprimer l'état "ETAT_Vue" dans un fichier PDF (fonction iImprimeEtat).
Dans cet exemple, le code de clic du champ Bouton "BTN_Imprimer" est le suivant :
// Créer la vue
SI HCréeVue("VueCommande", LigneCde, "*", "Référence", "", "", hVueExclusive + hVueInterruptible) = Faux ALORS
Erreur(HErreurInfo())
SINON
// Générer un nom de fichier unique
NomFicUnique est une chaîne = fRepWeb() + "\" + "ETAT_Vue_" + DateSys() + HeureSys() + ".pdf"
// Paramétrer la destination de l'impression
iDestination(iPDF, NomFicUnique)
// Imprimer l'état ETAT_Vue
iImprimeEtat(ETAT_Vue, "VueCommande")
// Envoyer le fichier dans le navigateur
FichierAffiche(NomFicUnique, "application/pdf")
FIN
Liste des exemples associés :
WD Etats Exemples didactiques (WINDEV) : WD Etats
[ + ] Cet exemple montre les différentes méthodes pour réaliser un état :

- impressions basées sur différentes sources de données (requêtes, variables, ...)
- impressions basées sur des champs (Table, Tableur, TCD, ...)
- impression d'états composés
- impressions spécifiques (portrait / paysage, état avec filigrane, état avec code-barres, ...)
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/06/2023

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