Développement de votre requête de rapport

Dans cette section :

Lors de la création d'un rapport, la seule condition requise est l'identification d'une source de données. En outre, la structure de la requête de rapport est très souple et vous ne devez inclure que les éléments de rapport dont vous avez besoin. Par exemple, il n'est nécessaire d'y inclure des instructions de tri que si vous souhaitez obtenir un rapport trié. De même, vous ne devez inclure dans la requête des critères de sélection que si vous souhaitez créer un rapport utilisant seulement un sous-ensemble de données.

Une requête de rapport commence par la commande TABLE FILE et se termine par la commande END. Les commandes et les phrases situées entre le début et la fin de la requête définissent le contenu et le format du rapport. Ces éléments de la requête sont facultatifs ; vous ne devez inclure dans la requête que les commandes et phrases qui produisent les fonctionnalités de rapport dont vous avez besoin.

Les fonctionnalités décrites ci-après constituent les options les plus fréquemment utilisées dans la création d'une requête de rapport.

Sauf indication contraire, consultez la rubrique Aspects fondamentaux de Report Painter dans le manuel Créer des rapports à l'aide de Report Painter pour plus de détails sur cette fonctionnalité et d'autres encore.)

Une fois la requête de rapport terminée, vous pouvez la lancer comme une interrogation ad-hoc ou la sauvegarder en tant que procédure. Si vous sauvegardez la requête de rapport en tant que procédure, vous pouvez la lancer ou la modifier à tout moment.
Haut de page
x
Commencement d'une requête de rapport

Comment :

La première étape dans la création d'une requête de rapport consiste à désigner une source de données. Une fois cela fait, vous pouvez spécifier les détails de votre requête de rapport. Pour spécifier une source de données, vous pouvez utiliser :

x
Syntaxe : Commencer une requête de rapport

Pour commencer une requête de rapport, utilisez la commande 

TABLE FILE filename

où :

filename

est la source de données du rapport.
Haut de page
x
Achèvement d'une requête de rapport

Pour achever une requête de rapport, utilisez la commande END ou RUN. Ces commandes doivent être saisies sur une ligne toutes seules. Pour annuler une requête de rapport sans l'exécuter, saisissez la commande QUIT.

Si, au cours d'une session, vous comptez lancer des requêtes de rapport consécutives utilisant la même source de données, vous avez l'option d'utiliser la commande RUN. La commande RUN fait en sorte que l'utilitaire TABLE et la source de données restent actifs pendant toute la durée de la session TABLE. Après avoir affiché un rapport, il n'est pas nécessaire de répéter la commande TABLE pour produire un autre rapport. Pour terminer la session TABLE, il suffit de lancer la commande END après la dernière requête de rapport.

Remarque : dans Developer Studio, les commandes QUIT et RUN ne sont prises en charge que si vous les saisissez dans la console de commande.

Haut de page
x
Création d'un exemple de rapport

L'exemple présenté dans cette rubrique est une requête de rapport simple qui illustre quelques fonctionnalités de base de WebFOCUS. De nombreuses autres fonctionnalités existent et vous pouvez trouver des informations sur ce sujet dans l'ensemble de cette documentation.

Exemple : Création d'un rapport simple

L'exemple annoté suivant illustre quelques fonctionnalités de base de WebFOCUS. L'explication numérotée dans cet exemple correspond au code de cette requête. Cette requête peut être générée à l'aide des outils graphiques de Developer Studio, ou en saisissant les commandes dans un éditeur de texte. 

1.  JOIN PIN IN EMPDATA TO ALL PIN IN TRAINING AS J1 
2.  DEFINE FILE EMPDATA
    YEAR/YY=COURSESTART; 
3.  END
  
4.  TABLE FILE EMPDATA 
5.  HEADING CENTER
    "Education Cost vs. Salary" 
6.  SUM EXPENSES AS 'Education,Cost' SALARY AS 'Current,Salary' 
7.  AND COMPUTE PERCENT/D8.2=EXPENSES/SALARY * 100; AS 'Percent' 
8.  BY DIV
    BY DEPT 
9.  WHERE YEAR EQ 1991 
10. ON TABLE SUMMARIZE 
11. ON TABLE SET STYLE *
    TYPE=HEADING, STYLE=BOLD, COLOR=BLUE,$
    TYPE=REPORT, FONT=TIMES, SIZE=8,$
    TYPE=REPORT, GRID=OFF,$
    ENDSTYLE 
12. END

La sortie est :

Créer un exemple de sortie de rapport simple

La requête de rapport présentée ci-dessus effectue le traitement du rapport comme ce qui suit :

  1. La commande JOIN relie les sources de données EMPDATA et TRAINING, permettant à la requête d'accéder aux informations dans les deux sources de données comme si elles étaient une structure unique.
  2. La commande DEFINE crée un champ virtuel qui extrait l'année du champ COURSESTART dans la source de données TRAINING.
  3. La commande END met fin à la commande DEFINE.
  4. La commande TABLE commence la requête de rapport.
  5. La commande HEADING ajoute l'en-tête Education Cost vs. Salary à la sortie de rapport.
  6. La commande SUM totalise les valeurs dans les champs EXPENSES et SALARY. La phrase AS change le nom des en-têtes de colonne.
  7. La commande COMPUTE crée une valeur calculée en utilisant les valeurs qui ont été agrégées dans la commande SUM et triées avec la commande BY.
  8. La phrase BY trie les données dans le rapport selon le champ DIV, puis selon le champ DEPT.
  9. La commande WHERE inclut dans le rapport uniquement les données relevant de l'an 1991.
  10. La commande ON TABLE SUMMARIZE totalise toutes les valeurs dans les colonnes EXPENSES et SALARY et recalcule la colonne de pourcentage (Percent).
  11. La syntaxe de feuille de style formate l'en-tête et le contenu du rapport.
  12. La commande END met fin à la commande DEFINE.
WebFOCUS