DB2 Web Query

Pour utiliser DB2 Web Query, lancez votre navigateur (il y a certaines restrictions avec Firefox) et saisissez l'URL suivante :

http://<votre-as400>:11331/webquery/, puis signez vous :

Cliquez sur Sélection de la langue et choisissez "Français", si cet écran vous est affiché en Anglais.

Les différents rapports sont enregistrés dans des DOMAINES (ici BASEVINS par exemple) ces derniers pouvant contenir des sous dossiers à volonté.

Cliquez sur le sous dossier de création et choisissez "Générateur de rapports", qui lance un assistant.

• La liste des champs disponibles est à gauche
• le tri vertical représente le critère de tri des lignes :
        
  • Si vous optez pour un rapport détaillé (icône Détail) les lignes sont triées
  • Si vous optez pour un rapport récapitulatif (icône Somme) les lignes sont regroupées
    
       
    
• Dans la cadre Somme/Détail, glissez les champs à traiter :
  • Option détail, les champs sont affichées tel que.
  • Option Somme,
    • les champs sont cumulés, s'il sont numériques
    • la dernière valeur du groupe est affichée dans le cas contraire
      
      Demandons le total commandé par type de produit
  

Sauvegardez le rapport par ,

puis lancez le

Pour voir le détail,

Allez, éventuellement, dans l'onglet "Options" et limitez le nombre de lignes affichées (ici 100)

puis cliquez sur Détail , ce qui donne

Vous pouvez aussi

• retravailler la présentation des colonnes
  
  Faite apparaître les options du champs
  
  
  
  pour les valeurs numériques, "Formater... en tant que"

cliquez ensuite sur le bouton ... à droite de P22.2

Ne modifiez PAS le type de format, mais jouez sur les options

Vous pouvez faire des choix multiples,
    par exemple CM (C=Edition des séparateurs + M=symbole monétaire à gauche)

• redéfinir les entêtes d'impression

• Enfin vous pourrez utiliser d'autres fonctions que la somme
  
  Par exemples, ajoutons le N° de commande et comptons les commandes (fonction Décompte)

Remarquons les fonctions suivantes :

résultat :

Autres fonctionnalités :

• Création de nouveaux champs

Le bouton , affiche la liste des zones

vous pouvez jouer sur la notion de format pour retravailler une zone, particulièrement les dates :

• D : affichage du jour (1 à 31)
• M affichage du mois (1 à 12)
• Y affichage de l'année (01 à 99)
• YY affichage de l'année (0001 à 9999)
• T associé au mois (TM ou MT) affichage le mois sur 3 lettres en majuscules
• t associé au mois (tM ou Mt) affichage le mois sur 3 lettres la première en majuscule
• TR , comme T, mais le mois est entier
• tr, comme t mais le mois est en entier
• Q, affiche le n° de trimestre (1 à 4)
• W, seul : affiche le N° du jour de la semaine
    avec un format de date affiche le Nom du jour en Majuscule
• w, idem W, mais seules la première lettre est en majuscule
• WR, idem W mais le nom est en entier
• wr, idem WR, seules la première lettre est en majuscule
• JUL, format julien (N° de jour dans l'année)
• YYJUL, format julien avec l'année sur 4 positions
  
  
  Vous pouvez combiner plusieurs options :
  • DMY, affiche par exemple 08/08/07
  • WDMTRY , affiche WED, 8 AUGUST 07
  • YQ, affiche 07Q2 (Quarter en Anglais)
    
• le séparateur par défaut est le /, mais vous pouvez en préciser un autre
  • D.M.Y, affiche par exemple 08.08.07
    
• les formats I6YMD et surtout I8YYMD permettent de représenter un date numérique en zone DATE
• Vous pouvez alors définir une zone calculée sur cette nouvelle zone (la zone intermédiaire, pouvant ne pas être affichée)

Mais vous pouvez aussi saisir un calcul et/ou une fonction afin de calculer une nouvelle valeur :

• les opérateurs + , - , / , * sont admis (QTE * PRIX, par exemple) , ainsi que ** pour l'élévation à la puissance
  
• fonctions de chaînes
  • LENGTH(chaîne) , donne la longueur d'une chaîne ou d'une variable
  • SUBSTR(chaine, depart, lg) , extrait une chaîne de caractères
  • LOWER(chaîne) , conversion en minuscules
  • UPCASE(chaîne) , conversion en majuscules
  • LCWORD(chaîne) , passe le premier caractère de chaque mot en majuscules, le reste en minuscules
  • RJUST(chaîne) , cadrage à droite
  • LJUST(chaîne) , cadrage à gauche
  • TRIM(chaîne), retrait des blancs aux deux extrémités
  • EDIT(zone, 'masque') transforme la variable avec le masque indiqué
      Le masque pouvant contenir
    • 9 : le caractère à cette position est répercuté tel que.
    • $ : le caractère à cette position est supprimé.
    • (autre), ce caractère est ajouté.
• fonctions numériques
  • ABS() valeur absolue
  • SQRT() racine carrée
  • MAX(zone1 , zone2) , retourne le plus grand des deux
  • MIN(zone1 , zone2) , retourne le plus petit des deux
    
• fonctions dates
  • AYM(datenum, nb , 'FORMAT') , ajoute à une date numérique i4YM ou I6YYM un nombre de mois au format demandé
  • AYMD(datenum, nb , 'FORMAT') , ajoute à une date numérique i6YMD ou I8YYMD un nombre de jours au format demandé
    par exemple AYMD(datcmd , 90 , 'I8YYMD'), si datcmd est numérique 8,0
  • DATEADD(date, 'code' , nb), ajoute nb jours|mois|années (suivant code) à date (de type DATE)
    • Y on ajouté des années
    • M on ajoute des mois
    • D on ajoute des jours
    • WD on ajoute des jours dans la semaine (si la date est un samedi ou dimanche, on passe au lundi suivant)
    • BD on ajoute des jours travaillés
  • DATEDIFF(date1 , date2, 'code') fait la différence entre deux dates
    • mêmes codes que DATEADD
  • DATEMOV(date , 'destination'), passe la date à la destination demandée
    • EOM : fin de mois (End Of Month)
    • BOM : début de mois
    • EOQ : fin de trimestre
    • BOQ : début de trimestre
    • EOY : fin d'année
    • BOY : début d'année
    • EOW : fin de semaine
    • BOW : début de semaine
    • NWD : prochain jour de semaine
    • NBD : prochain jour travaillé
    • PWD : précédent jour de semaine
    • PBD : précédent jour travaillé
    • WD- : jour en cours ou précédent jour de la semaine (si Week-End)
    • BD- : jour en cours ou précédent jour travaillé
    • WD+ : jour en cours ou jour suivant de la semaine (si Été)
    • BD- : jour en cours ou jour travaillé suivant
      
  • les mots-réservés suivants peuvent être utilisés
    • &TOD : heure de lancement
    • &DATE : date du jour (format américain M/D/Y)
    • &DMY : date du jour, année sur 2
    • &DMYY : date du jour, année sur 4
    • &YMD et &YYMD sur le même principe
• Fonction particulière
  • DECODE zone (code1 remplacement1 code2 remplacement2 ELSE par-défaut)
    remplace des codes par des libellés, par exemple :
      DECODE status ('Mr' 'Monsieur' 'Mme' 'Madame' 'Mlle' 'Mademoiselle' ELSE 'non précisé')

Pour voir la liste complète des fonctions , allez sur le site de WebFocus : http://documentation.informationbuilders.com/masterindex/html/html_wf_761/wf761func/index.htm
(la documentation générale de Webfocus est là : http://documentation.informationbuilders.com/masterindex/html/search_wf761.asp )

• Sélection d'enregistrement
  

Créons à l'identique la zone Année (AN) , basée sur ORDERDATE, puis cliquons sur l'onglet "critères de sélection"

Faites glisser le champ sur lequel porte la sélection (ici la nouvelle zone AN)

Choisissez le critère WHERE (WHERETOTAL permet de tester une somme, une moyenne, etc, une fois cette dernière calculée par DB2 Web Query)

Puis l'opérateur de comparaison (égal à , supérieur, dans une liste de valeurs, etc...) et cliquez sur "Sélectionner une valeur"

vous entrez ici, une (ou plusieurs valeurs)

1. constante permet la saisie d'une valeur
2. paramètre indique un paramètre en entrée (vu plus tard dans ce cours)
3. champ compare avec une autre zone extraite
4. valeurs affiche la liste des valeurs actuellement disponibles dans la base

Saisissez 2007 ou affichez les valeurs et sélectez 2007

• tableaux croisés

Dernier point, nous pouvons afficher des tableaux croisés ou à double entrée

Pour cela, nous allons ajouter le trimestre dans la partie "Tri horizontal"

résultat

• Style conditionné

Créons un rapport trié par type de produit et catégorie (PRODUCTTYPE / PRODUCTCATEGORY)
qui affiche le montant et les prix de revient (LINETOTAL / COSTOFGOODSOLD) et la différence entre les deux (zone calculée LINETOTAL - COSTFOGOODSOLD) :
n'oubliez pas le bouton pour faire apparaître la liste des zones.

Cliquez sur le bouton "Style conditionnel" et ajoutez une condition par l'icone suivante :

Renseignez les paramètres :

Attachez la condition à la zone en cours (une même condition peut être réutilisée)

et choisissez "Police", indiquez vos caractéristiques d'affichage

et voilà

Vous pouvez afficher des sous totaux

Sélectez (dans la colonne Tri vertical), la zone de rupture concernée

et cochez Sous total

cliquez ensuite sur le nouvel onglet Sous total

Indiquez ici, les colonnes dont il faut faire le total (par défaut, toutes les sommes)

puis le texte à associer aux sous totaux

Vous pouvez définir un critère de tri qui ne soit pas un critère de rupture

1. Ajoutez la zone dans les tri
   
   
2. Définissez, votre critère de tri (croissant/décroissant) et l'option TOTAL, afin de trier sur la somme
   (cela doit ne pas changer les ruptures, uniquement définies pour PRODUCTTYPE et PRODUCTCATEGORY)
   
3. Indiquez, pour terminer, que vous ne souhaitez pas voir la zone une deuxième fois (les zones de tri sont affichées)
   
   
   
   
4. Vous pouvez en profiter pour afficher le rang, sur chaque ligne
   
   
   Et voilà

Enfin, vous pouvez aussi paramétrer l'affichage en indiquant entête et pied de page (onglet "Entêtes du rapport")
   (ici, nous avons utilisé &DMY et &TOD)

• Paramètres en entrée

Allez dans la sélection d'enregistrements, ajoutez une condition (ici le type de produit), Cliquez"Sélectionner une valeur"'

Sur cet écran, choisissez Paramètre et cliquez sur l'icone indiquée

Si vous choisissez Statiques, vous fournissez les valeurs saisissables
Avec Dynamiques, vous faites référence aux valeurs présentes dans la base de données

Dans tous les cas, "sélection multiple" permettra le choix de plusieurs valeurs (touche ctrl du clavier)

 

Premier affichage

Après un choix

Remarquez que nous avons placé le contenu de la zone ProductType dans l'entête

(cliquez à gauche pour afficher la liste des zones)

Nous pouvons alors, lier deux rapports entre eux :

Modifions le premier rapport créé :

L'option "Zoom en profondeur" permet de réaliser une action complexe

cochez Exécuter la procédure

Indiquez le rapport à lancer

En face de "Avec paramètres", utilisez le bouton "Ajouter"

Le choix initial de la zone PRODUCTTYPE, indique la colonne sur laquelle sera le lien

indiquez ici

• Le nom du paramètre en entrée dans le rapport à lancer
• la valeur à transmettre en choisissant une colonne (normalement la même que le choix de départ)
  

Divers

• Jointure
  
  
  Dans l'onglet "Options de Jointure" , cliquez sur Nouveau, choisissez un fichier base de données
  
  Puis indiquez
  • le type de jointure
    • Interne : uniquement les enregistrements en correspondance
    • Externe Gauche, tous les enregistrements de gauche, même si la correspondance n'est pas possible
  • les zones de jointure (l'information commune) dans les deux fichiers
    
    Du coup, la liste des zones disponibles est modifiée en conséquence
    
    
    
    NB : il est possible que l'administrateur est prévu pour vous des données déja mises en relation
    • Soit en créant des vues regroupant logiquement les données
    • Soit en mettant en place l'intégrité référentielle, qui est automatiquement analysée lors de la création des méta-données
      (liste des zones et des caractéristiques, interne au produit Web Query)
      
  
  
• Options de sortie (Onglet "Options de rapport")
  
  
  
  • HTML, page WEB (notez l'option de pagination sur demande)
  • HTML avec grille (chaque cellule est encadrée)
  • PDF, format Acrobat Reader
  • Excel (97/2000) et Excel avec formule, dans le dernier cas, les cumuls contiennent la formule SOMME(--:--) d'Excel
  • AHTML page HTML active, utilisable en mode autonome
    
    • chaque colonne peut être un critère de tri (Sort) , de sélection (Filter), la base d'un calcul (Calculate)
      
      
    • Vous pouvez créer des tableaux croisés dynamique (Pivot)
    • et des graphes (Chart)
      
      
      
      

• En choisissant les formats "unstyled", vous trouvez des formats de sortie plus simples, comme "délimité avec tabulation" ou Xml
  
  
  
• Enfin l'option Database formats propose une sortie dans un fichier OS/400 (le seul choix possible)
  
  
  Vous devez alors indiquer, la bibliothèque, le fichier et son éventuel remplacement.