Introduction au Générateur de Rapports
Quelques extraits significatifs du Manuel © phdconsultant Développeurs DB2 Web Query :
Note: les manuels étant constamment améliorés, leur contenu peut être significativement différent des extraits ci-dessous (extraits qui remontent à 2008).
Le Générateur de Rapport est le module principal de Web Query, module qui remplace à lui seul Query/400.
Il s’ouvre depuis une session Web Query.
En création la marche à suivre ci-dessous est proposée :
à Positionner les premiers paramètres dans l’onglet Sélection des champs (cf A faire en premier)
à Positionner les premiers paramètres dans l’onglet Options de rapport (cf A faire en premier)
à Définir les jointures (Onglet Options de jointure)
à Repasser dans l'onglet Sélection des champs et sélectionner un premier champs pour pouvoir enregistrer une première fois
(en effet il est impossible d'enregistrer le Rapport tant qu'aucun champ n'a été sélectionné.
à Définir les critères de tri en premier et tester
à Définir les champs DEFINE (nouvelles colonnes), et sélectionner les autres champs
à Saisir les critères de sélection puis déplafonner le nombre de lectures
à Paufiner la présentation (champs, formats, entêtes)
à Lorsque le résultat est satisfaisant en page HTML (par défaut) choisir et paramétrer un autre format de sortie si nécessaire.
A toutes les étapes tester et enregistrer son travail.
Ouverture du Générateur de Rapports
Passez dans la session Web Query un Clic droit / Générateur de Rapports :
Sur la requête à ouvrir passer un clic-droit / Ouvrir :
Avant de cliquer Ouvrir, noter la disponibilité de l’option Power Painter,
ce qui signifie que la requête n’est pas un Power Painter, mais un Rapport ou un Graphique,
et qu’en cliquant Ouvrir on ouvrira le Générateur de Rapports ou le Générateur de Graphiques.
Donc cliquer Ouvrir.
Si la requête était un Power Painter, l’option Power Painter ne serait pas affichée car inutile
et Ouvrir appelerait Power Painter.
En création, la Liste des Masters propose toutes les métadonnées existantes :
Vérifier que dans cette liste figurent TOUS les fichiers dont vous aurez besoin dans le rapport
sinon ce n’est pas la peine d’aller plus loin : cliquer Annuler et créer les métadonnées manquantes.
Si le fichier est trouvé dans la liste de Masters, le sélectionner d’un double-clic.
L’ouverture du Générateur de Rapports s’effectue dans une fenêtre de l’Explorer à part.
Elle se superpose donc à la fenêtre de session Web Query et peut parfois être cachée par cette dernière :
il est donc recommandé de réduire la fenêtre de session Web Query dans la barre des tâches pour éviter cet inconvénient.
Inversement, le travail dans la fenêtre Générateur de Rapports agrandie au maximum sera plus pratique :
2) ONGLET SELECTION DE CHAMPS
à Noter que le bouton ? Somme est enfoncé par défaut, ce qui correspond à un rapport récapitulatif.
Pour un rapport détaillé, cliquer le bouton Détail.
à Cliquer les options d’affichage pour les champs sélectionnés :
Cocher l’option Ajouter le nom de segment comme préfixe, qui va s’avérer très pratique.
à Passer ensuite aux Options de rapport, où il est nécessaire de positionner certains paramètres en préambule.
L’onglet Sélection des champs est l’onglet sur lequel s’ouvre en premier la fenêtre du Générateur de Rapports, qui est une fenêtre de l'Explorer à part.
On distingue les volets principaux suivants:
à A gauche s’affichent les champs du fichier sélectionné.
à Au milieu le volet Tri vertical permet de spécifier les critères de tri (par glissement de zone à la souris).
à En bas à droite le volet S Somme / Détail permet de choisir les autres champs du résultat
(qui ne sont pas des critères de tri).
à En haut à droite le volet Tri latéral permet de développer horizontalement les colonnes
(technique inconnue de Query/400) : Exemple une présentation sur 4 trimestres.
On ne peut pas élargir individuellement les volets.
La seule solution est d’agrandir la fenêtre Windows (sur le bord) ce qui a pour effet d’ajuster les volets à l’intérieur.
à On note en haut une barre classique de boutons permanents :
Exécuter (pour exécuter le rapport dans une fenêtre à part).
 Aide (pour accéder aux pages html d’aide détaillée complète).
Noter aussi en bas à gauche le point d’interrogation bleu pour avoir de l’aide contextuelle :
cliquer le ? puis cliquer une zone quelconque du menu.
Quitter pour fermer proprement le Générateur de Rapports.
à Juste en dessous la barre des onglets :
En bas 2 petits menus peuvent s’ouvrir en cliquant le triangle.
La présentation des champs sous forme d’arborescence est de peu d’intérêt :
La présentation sous forme de liste fournit plus d’informations,
surtout si l’on sélectionne les colonnes les plus intéressantes comme ci-contre
(cliquer le triangle noir à droite du bouton  ):
Le segment (tout comme le nom de fichier) n’est autre que le nom du synomyme.
De plus le tri sur la colonne Segment permet de grouper en haut les champs Define (nouvelles colonnes)
Par défaut la liste est triée sur le nom mais on peut changer de colonne comme critère de tri
en cliquant simplement son entête (avec possibilité de demander un tri descendant par un second clic) comme dans l’Explorateur.
(Il s'agit bien ici de la présentation des colonnes du fichier, rien à voir avec les critères de tri du résultat).
à Aide générale
Cliquer le bouton Point d’interrogation noir (dans la barre d’outils en haut)
pour accéder à l’aide générale DB2 Web Query. 
La tête de chapitre affichée correspond à l’onglet ouvert lors de la demande :
Exemple : si l’onglet Sélection de champs était à l’affichage, le chapitre ouvert est celui correspondant.
Dans le volet gauche un navigateur permet d’afficher n’importe quel chapitre.
à Aide contextuelle
 Pour obtenir de l’aide contextuelle cliquer le point d’interrogation bleu en bas à gauche de la fenêtre, puis cliquer la zone à problème : on se trouve dans la même arborescence d’écrans d’aide mais sans navigateur à gauche.
Glisser un à un les critères de tri depuis le volets Champs vers Tri vertical.
Autre technique : cliquer le critère puis le bouton Ajouter 
Les critères de tri seront automatiquement présentés à partir de la première colonne à gauche du résultat (qui est le critère majeur) dans l’ordre énoncé de haut en bas lors de leur déclaration dans le Tri vertical.
 Dans le volet Tri vertical, avec les boutons ci-contre il est possible de supprimer un critère
ou de modifier son ordre dans la séquence. Le critère majeur figurant en haut de la liste.
Elle permet de chercher des mots entiers ou partiels dans n’importe quelle colonne du volet Champs.
Cliquer le bouton Afficher - Rechercher :
 
Sélectionner la colonne (Nom par défaut).
Saisir un mot complet
ou partiel avec le joker * (astérisque) : La casse est indifférente.
Appuyer sur Entrer ou cliquer la flèche verte.
Exemple : recherche de tous les champs commençant par ECC.
Plus puissant : recherche de mots-clés dans la colonne Description :
Exemple : recherche de tous les champs dont la description contient POLICE :
 
Pour passer à la recherche suivante il suffit d’écraser la recherche en cours (il n’y a pas d’effet cumulatif).
Pour réafficher tous les champs faire une nouvelle recherche après avoir effacé le critère.
Ne pas oublier cette dernière manip si l’on n’a plus besoin de la recherche,
car sinon, même masquée, elle reste active.
Pour exécuter cliquer le triangle bleu  . Ca correspond à une exécution immédiate (équivalent opt 1 de Query/400).
Noter que le résultat s’affiche dans une fenêtre Explorer à part : il y a donc 3 fenêtres ouvertes pour Web Query présentement :
à La fenêtre session Web Query (de préférence réduite en barre des tâches)
à La fenêtre du Générateur de Rapports
à La fenêtre du résultat.
La mention (Sans titre) dans le bandeau bleu de la fenêtre Explorer indique que le rapport n’a encore jamais été enregistré.
Il n’est pas possible d’enregistrer le rapport si aucun champ n’a été sélectionné (en tri ou hors tri).
 Cliquer le bouton Disquette jaune.
La première fois il ouvre la boîte Enregistrer sous :
Saisir le nom et laisser les options cochées par défaut.
Le rapport sera enregistré à l’intérieur de votre domaine.
Dès lors, comme sous Excel, il sera important d’enregistrer son travail à chaque étape du développement .
Les fois suivantes, cette boîte de dialogue n’apparaîtra que si l’on clique Enr. Sous (Enregistrer sous). Il sera possible de changer le nom pour créer un duplicata.
Options de champs d’un critère de tri
Après avoir sélectionné un critère de tri d’un clic dans Tri vertical,
cliquer en bas le triangle Afficher - Options de champs 
Dans l’onglet Tri on peut spécifier l’ordre (croissant par défaut) sinon décroissant ,
demander un saut de page à chaque changement ou un trait de soulignement.
Dans sa colonne, le critère de tri n’apparaît que s’il change.
Si l’on désire présenter une colonne de tri ailleurs qu’à son emplacement automatique,
il faut la déclarer 2 fois :
Une première fois en tant que colonne de tri rendue invisible :
Sélectionner d’un clic le critère de tri, afficher ses options de champs
et dans le premier onglet cocher la case Rendre ce champ invisible.
Cette action rend l’onglet Titre inaccessible.
Déclarer le champs une seconde fois en tant que colonne normale à son emplacement visible désiré.
Les options de champs d’un critère de Tri proposent l’onglet Classement
qui permet d’insérer une colonne RANK indiquant le n° d’ordre de chaque occurrence dans la colonne de tri.
Cocher Définir un nombre maximal de valeurs pour plafonner le résultat au nombre indiqué dessous.
L’entête de colonne RANK peut être modifié :
Refermer le menu Options de champs en cliquant le triangle à gauche de Masquer.
Contrairement à query/400, les champs ne sont pas tous sélectionnés par défaut.
La technique est donc la même que pour les critères de tri :
Glisser les champs un à un depuis le volet Champs
vers le volet  ou utiliser le bouton Ajouter .
Dans le volet Champs on peut sélectionner plusieurs champs à l’aide de Maj ou Ctrl
(comme classiquement sous l’Explorateur Microsoft) et les ajouter en une fois au volet .
Mais l’utilisation des flèches montante et descendante est peu réactive. 
Comme sous Query/400 la séquence de présentation des colonnes sur le rapport
correspondra à l’ordre des champs sélectionnés de haut en bas.
Dans les Options du champs / Onglet Afficher :
Modifier directement le code de format ou cliquer le bouton à droite pour sélectionner dans le menu déroulant :
Affichage du point séparateur des milliers ; choisir Virgule d’édition -- C :
Affichage du symbole monétaire (préalablement spécifié dans les Options de rapport) :
ajouter le code M ou N (ignorer la mention Dollar, c’est bien la monnaie choisie dans les Options de rapport qui sera utilisée) :
Pour passer de M à N il faut d’abord déselectionner Dollar flottant -- M. :
   
Exemples : P13.2 P13.2C P13.2CM P13.2CN
En sortie HTML, l’Optimisation de la sortie par défaut (Options de Rapport),
ajuste automatiquement la largeur des colonnes en fonction de la largeur de la fenêtre résultat.
Plus la fenêtre est serrée et plus le rapport est développé en hauteur.
En deçà d’une largeur minima le résultat sera tronqué et apparaît en bas un curseur horizontal:
Si la largeur le permet les titres de colonnes (et les valeurs) sont affichés sur toute leur largeur,
sur une seule ligne par défaut tels qu’ils ont été automatiquement définis.
Cela dit il est possible de modifier les titres en imposant leur développement vertical dans tous les cas
(par un saut de ligne (touche Entrée)).
 
Ce genre de modif est conservé dans le titre même en largeur maximale de la fenêtre.
Le bouton Police (Options de champ) permet de modifier l’aspect d’une colonne, même sa couleur.
3) OPTIONS DE RAPPORT: CHOIX DES FORMATS DE SORTIE
à Le format de sortie par défaut HTML - Navigateur Web est le meilleur pendant la phase de développement du rapport, indépendamment du choix du format de sortie définitif.
à Limiter par exemple à 100 ou 200 le nombre de lectures pour tester le résultat avant la spécification de critères de sélection qui tiennent la route.
Cela évite à de gros volumes de données de bloquer l’exécution lors de la phase de développement.
Une fois les critères de sélection définis il ne faudra pas oublier d’effacer cette limite.
Ne pas confondre avec le champs en-dessous Arrêter la récupération…
qui limite le nombres de lignes dans le résultat.
Celui-ci peut être très inférieur au nombre de lecture en cas de sélection et/ou de regroupements.
à Pour une raison de rendement : cocher systématiquement
Utiliser des jointures du moteur SQL...et Pagination sur demande.
Noter qu’il n’y a pas de bouton OK pour valider ces saisies :
le seul fait de les indiquer est suffisant.
On est en effet resté dans la même fenêtre Explorer.
Ne pas cliquer Quitter ni Enregistrer suite au paramétrage ci-dessus.
à Cliquer le bouton Polices et Paramètres pour choisir le symbole monétaire :
Dans la boîte de dialogue, saisir directement le symbole € à la place de par défaut
ou dérouler le petit menu à droite pour sélectionner EUR.
Ici il faut bien valider en cliquant OK puisqu’il s’agit d’une boîte de dialogue de page Web à part entière.
Sous-menu Afficher les formats avec style :
HTML – Navigateur Web :
Aspect du résultat avec HTML avec la Pagination sur demande (recommandé)
et Optimiser la sortie à l’aide de feuilles de style en cascade (cochée par défaut).
Options du Format spécifique à la sortie :
La Pagination sur demande affiche le résultat sous plusieurs pages,
dans une Visionneuse caractérisée par sa barre de pagination.
Elle est recommandée pour un meilleur rendement car seule la page en cours est transmise à la fois.
Le bouton  permet d’atteindre directement la page indiquée à gauche.
 Permet de passer une recherche.
  est un flip-flop indiquant le respect ou non de la casse.
  est un flip-flop indiquant le sens de recherche.
Le bouton  permet de fermer temporairement la visionneuse,
donc de revenir en mode d’affichage d’une seule page :
Cliquer le bouton Retour  pour réafficher en mode visionneuse.
Cliquer le bouton  puis  équivaut à  pour fermer la fenêtre
Option Optimiser la sortie à l’aide de Feuilles de style en cascade :
à C’est un réglage automatique des entêtes et des textes dans les colonnes en fonction de la largeur de fenêtre Explorer:
S’il y a suffisamment de largeur le système essaie de développer les entêtes ainsi que les valeurs sur une seule ligne :
Si la fenêtre Explorer est serrée le système économise en largeur sur les entêtes et les textes :
à Si l’option n’est pas cochée il n’y a pas d’optimisation (noter le quadrillage blanc dans ce cas) :
HTML - Navigateur Web (avec grille)
La différence est purement esthétique. Les options sus nommées fonctionnent pareillement.
AHTML – Rapports actifs :
Un rapport actif est un résultat sous forme de fichier HTML mais très puissant car doté de nombreuses fonctions faisant penser à un mini tableur intégré disponible en mode déconnecté.
Les Rapports Actifs font sur ce site l'objet d'une explication technique détaillée
(cf le menu dans la marge) avec mise en pratique immédiate sur exemples à télécharger.
En choisissant AHTML - Rapports actifs, le cadre Format spécifique à la sortie devient indisponible.
En revanche cliquer le bouton Style de rapport actif :
Demander de Tout afficher (Enregistrements par page) pour tout afficher dans une seule page web
pour le confort de l’utilisateur.
Un Rapport Actif est moins performant qu’un format HTML simple ou avec grille
car la totalité est chargée depuis le serveur même si on limite le nombre d’enregistrements par page.
Par défaut le Rapport Actif sera Tabulaire ce qui permet la pagination à tempérament.
Le menu en cliquant n’importe quelle colonne d’un rapport actif donne un aperçu
des possibilités du fichier HTML déconnecté.
Dans un rapport en Accordéon, la première colonne (définie comme critère de tri lors de la création)
peut être réduite (regroupée) par valeurs : le signe PLUS invite à développer d’un clic telle ou telle valeur :
D’un clic le PLUS se transforme en MOINS et toutes les données de la valeur sont agrandies (développées) :
Un rapport en Accordéon s’affiche obligatoirement dans une seule page.
Contrairement au HTML les résultats PDF ne font pas l’objet d’optimisation automatique des largeurs de colonne.
Si la largeur du résultat ne passe pas dans le format de sortie en largeur
les colonnes excédentaires seront imprimées dans les pages suivantes
(ce qui est peu lisible on l'a déjà expérimenté en Query/400).
Solutions :
à Dans le bouton Police et paramètres affiner les paramètres typiques des sorties PDF
(passer en orientation Paysage et si possible opter pour une Taille supérieure à Lettre (A3, Tabloïd…)
à Réduire la Taille de Police.
 (Paramètres par défaut).
à Réduire une à une la largeur des colonnes en travaillant les entêtes et les longueurs des formats
(Options de champ Onglets Afficher et Titre)
à Réduire le nombre de colonnes…
Pour une sortie PDF élaborée, avec par exemple incrustation à coté des colonnes du logo de l’entreprise, de toute autre image, et d’un graphique, enregistrer le rapport en l’état actuel et l’importer dans Power Painter.
Choisir Excel 97 ou EXL2K – Excel 2000 :
A l’exécution accepter le téléchargement du fichier :
à En cliquant Ouvrir le résultat ne s'ouvre que dans une visionneuse:
à Pour une utilisation du résultat sous Excel, cliquer Enregistrer puis renommer le fichier XLS .
Dans un 2e temps ouvrir le fichier en question.
EXL2KFORMULA – Excel avec formules
Comme Excel 2000. Mais les formules dans le rapport sont transmises à Excel en tant que formules
et non pas en tant que résultat (ex Somme).
Excel 95 (Afficher les formats sans style)
Ce format Excel est apprécié pour son aspect brut de décofrage.
La partie entête sort sur plusieurs lignes.
DOC – Texte brut avec sauts de page :
WP – Texte brut sans saut de page :
Renseigner dans la boîte Sortie de la base de données le nom de la bibliothèque AS/400 (appelée ici Catalogue).
Nom : Nom de la métadonnée du fichier AS400 de sortie.
Ne pas oublier de cocher Remplacer (en principe).
En cas de création de fichier de sortie AS400 :
Limiter le nom du fichier à 10 caractères maximum (contrainte AS400).
Exemple de nom de fichier de sortie : phd_stats
Si le nom fait plus de 10 caractères, le fichier AS400 sera nommé avec les 5 premières lettres du nom suivies d’un n° de séquence sur 5 chiffres commençant par 00001.
Une colonne FOCLIST est automatiquement ajoutée avec un n° de séquence sur 5 dont zéro.
Un synonyme (métadonnée) est créé automatiquement, au nom indiqué dans le champs ci-dessus.
Message suite à l’exécution complète d’un Rapport sur un fichier de sortie AS/400 :
(ce message n’est pas un message d’erreur) :
Il est normal qu’il n’y ait aucune sortie HTML.
Le nombre d’enregistrements générés dans le fichier de sortie est indiqué (ici 254).
Comme il est très facile de copier un rapport,
il ne faut pas se priver dès qu’il y a une modification à pérenniser.
Pour faire un duplicata Passer la commande Enr. sous 
Le nom se saisit dans le premier champ.
Il est possible de passer un Copier / Coller du nom d’origine (extrait des propriétés du rapport).
Le nom peut être assez long et contenir des espaces. Suggestion: indiquer dans le nom quel est le format de sortie (Excel, PDF, AHTML, etc...).
© phdconsultant 2010 - Fin des extraits du Manuel Développeurs Web Query
| 
