Inclure un élément dans un en-tête ou pied de page

Dans cette section :

Vous pouvez personnaliser un en-tête ou pied de page y compris :


Haut de page

x
Inclure une valeur de champ dans un en-tête ou pied de page

Comment :

Vous pouvez inclure un nom de champ dans le texte d'en-tête ou de pied de page. Lorsque une requête est lancée, la sortie comprend la valeur de champ. Cela a pour résultat un en-tête ou pied de page personnalisé avec l'identification de données spécifique de l'utilisateur.

Bien que vous puissiez utiliser cette technique dans tout rapport, il est essentiel si vous créez un rapport au format libre. Pour plus de renseignements, consultez Création d'un rapport au format libre.

Pour des requêtes avec des jeux de champs de tri et d'affichage, les champs dans un en-tête ou pied de page de rapport ou un en-tête ou pied de page sont évalués en tant qu'objets de la première commande d'affichage. Les champs dans un en-tête ou pied de page de tri sont évalués en tant que partie de la première commande d'affichage dans laquelle ils sont référencés. Si un champ n'est pas référencé, il est évalué comme faisant partie de la dernière commande d'affichage.

Vous pouvez utiliser un opérateur de préfixe afin de tirer une valeur de champ dans un en-tête ou pied de page. Pour obtenir la liste des opérations que vous pouvez effectuer avec les opérateurs préfixe, consultez Affichage de données de rapport.

Deux opérateurs sont conçus spécialement pour l'utilisation avec un pied de page de tri :



x
Syntaxe : Inclure une valeur de champ dans un en-tête ou pied de page
<[prefix_operator]fieldname<fieldname[>]

ou

<fieldname[>]

où :

<fieldname
Met la valeur de champ dans l'en-tête ou le pied de page, et supprime les blancs rampants d'un champ alphanumérique pour toutes les valeurs de SET STYLEMODE.
<fieldname>
Met la valeur de champ dans l'en-tête ou le pied de page, et retient les blancs rampants dans un champ alphanumérique si SET STYLEMODE égale FIXED. Supprime les blancs rampants pour toutes les autres valeurs de SET STYLEMODE. La sortie PDF retient des blancs rampants sans tenir compte du réglage de STYLEMODE.
prefix_operator
Fait un calcul directement à la valeur d'un champ. Un opérateur de préfixe est appliqué à un seule champ et n'affecte que ce champ-là.


Exemple : Inclusion du nom de département dans un en-tête ou pied de page

Cette requête comprend le nom de champ DEPARTMENT dans l'en-tête et le pied de page. La commande HEADING n'est pas requise dans la requête parce que texte de l'en-tête apparaît avant la commande PRINT.

TABLE FILE EMPLOYEE 
"<DEPARTMENT : BANK, EMPLOYEES AND SALARIES" 
PRINT CURR_SAL
BY DEPARTMENT NOPRINT BY BANK_ACCT
BY LAST_NAME BY FIRST_NAME
ON DEPARTMENT PAGE-BREAK 
FOOTING
"<DEPARTMENT EMPLOYEES WITH ELECTRONIC TRANSFER ACCOUNTS" 
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET WEBVIEWER ON
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

La sortie affiche la sortie pour un rapport HTML multi-pages. Sur la première page de sortie, la valeur DEPARTMENT dans l'en-tête et le pied de page est MIS :

Sur la deuxième page de sortie, la valeur de DEPARTMENT est PRODUCTION :

Remarque : Si vous ne voyez pas les flèches de navigation, cliquez sur le bouton d'agrandissement.



Exemple : Retenu des blancs rampants dans un champ alphanumérique

Les blancs rampants ne sont pas retenus dans la sortie HTML standard. Lorsque le type de sortie est HTML, STYLEMODE est mis à FULL par défaut. Afin de retenir les blancs rampants dans le champ alphanumérique DEPARTMENT, le réglage STYLEMODE est mis à FIXED dans cette requête et les délimiteurs < et > se trouvent autour du nom de champ dans le texte de pied de page de tri.

SET STYLEMODE = FIXED
TABLE FILE EMPLOYEE
SUM SALARY 
BY DEPARTMENT SUBFOOT
"<DEPARTMENT> DEPARTMENT TOTAL SALARY IS <SALARY" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Les valeurs de DEPARTMENT s'affichent dans le pied de page de tri comme MIS et PRODUCTION :

Remarque : SET STYLEMODE=FIXED désactive le formatage HTML de votre navigateur pour ce rapport. Le rapport résultant s'affiche dans une police fixe sans couleurs ou d'autres capacités Web.



Exemple : Utilisation de l'opérateur préfixe TOT dans un en-tête de page

Cette requête utilise l'opérateur préfixe TOT afin de générer les totaux généraux pour trois champs.

DEFINE FILE SALES
ACTUAL_SALES/D8.2 = UNIT_SOLD - RETURNS;
SALES/F5.1 = 100 * ACTUAL_SALES / UNIT_SOLD;
END
TABLE FILE SALES 
"SUMMARY OF ACTUAL SALES"
"UNITS SOLD <TOT.UNIT_SOLD"
"RETURNS <TOT.RETURNS"
"TOTAL SOLD <TOT.ACTUAL_SALES"
" " 
"BREAKDOWN BY PRODUCT"
PRINT UNIT_SOLD AND RETURNS AND ACTUAL_SALES
BY PROD_CODE
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT PDF
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Les totaux s'affichent dans l'en-tête de page.



Exemple : Utilisation d'opérateurs de préfixe multiples dans un en-tête de page

Cette requête utilise les opérateurs préfixe MAX, MIN, AVE et TOT. Elle n'exige pas une commande d'affichage car le texte d'en-tête de page contient des champs de données.

TABLE FILE SALES 
"MOST UNITS SOLD WERE <MAX.UNIT_SOLD"
"LEAST UNITS SOLD WERE <MIN.UNIT_SOLD"
"AVERAGE UNITS SOLD WERE <AVE.UNIT_SOLD"
"TOTAL UNITS SOLD WERE <TOT.UNIT_SOLD" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Les opérateurs préfixe génèrent des données récapitulatives dans l'en-tête de page :



Exemple : Utilisation d'opérateurs de préfixe multiples dans un pied de page de tri

Cette requête utilise les opérateurs de préfixe CNT et AVE dans un pied de page de tri. La sortie ne contient pas de colonnes de données. Toutes les données se trouvent dans le pied de page de tri.

TABLE FILE EMPLOYEE 
BY DEPARTMENT NOPRINT SUBFOOT
"NUMBER OF EMPLOYEES IN DEPARTMENT <DEPARTMENT = <CNT.LAST_NAME"
"WITH AVERAGE SALARY OF <AVE.CURR_SAL" 
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Le pied de page de tri est un rapport de synthèse relatif au nombre d'employés dans un service et leurs salaires moyens :

Les opérateurs préfixe génèrent des données récapitulatives dans l'en-tête de page :

NUMBER OF EMPLOYEES IN DEPARTMENT MIS = 6
WITH AVERAGE SALARY OF $18,000.33
NUMBER OF EMPLOYEES IN DEPARTMENT PRODUCTION = 6
WITH AVERAGE SALARY OF $19,047.00

Haut de page

x
Inclure un champ de texte dans un en-tête ou pied de page

Comment :

Référence :

Vous pouvez inclure un ou plusieurs champs de texte dans un en-tête ou pied de page. Un champ de texte a l'attribut FORMAT=TX n dans un fichier maître.



x
Référence : Limitations des champs de texte dans un en-tête ou pied de page


x
Syntaxe : Inclure un champ de texte dans un en-tête ou pied de page
<TEXTFLD


Exemple : Inclure un champ de texte dans un pied de page de tri

Dans cet exemple, vous créez un fichier principal appelé TXTFLD.MAS ainsi qu'une source de données FOCUS correspondante appelée TXTFLD.FOC. Vous pouvez utiliser les outils de développement graphique de Developer Studio pour créer cet exemple. Pour plus de détails, consultez la documentation Developer Studio.

  1. Création et sauvegarde du fichier principal.
    FILENAME = TXTFLD, SUFFIX = FOC,$
    SEGNAME=TXTSEG, SEGTYPE = S1,$
       FIELDNAME = CATALOG, FORMAT = A10, $
       FIELDNAME = TEXTFLD,     FORMAT = TX50,$
  2. Création et sauvegarde de la procédure MODIFY suivante. Cette procédure crée et charge la source de données dans un environnement Windows.
    CREATE FILE TXTFLD
    MODIFY FILE TXTFLD
    FIXFORM CATALOG/10 TEXTFLD
    DATA
    COURSE100 This course provides the junior programmer
    with the skills needed to code simple reports.%$
    COURSE200 This course provides the advanced programmer with
    techniques helpful in developing complex
    applications.%$
    END
  3. Exécution de la procédure MODIFY afin de peupler la source de données.
  4. Création et sauvegarde de la requête de rapport suivant.
    TABLE FILE TXTFLD 
    BY CATALOG SUBFOOT
    "<TEXTFLD" 
    ON TABLE SET PAGE-NUM OFF
    ON TABLE SET ONLINE-FMT HTML
    ON TABLE SET STYLESHEET *
    TYPE=REPORT, GRID=OFF,$
    ENDSTYLE
    END
  5. Exécution de la requête de rapport.

    La sortie est :

    									CATALOGCOURSE 100
    This course provides the junior programmer with
    the skills needed to code simple reports
    COURSE 200
    This course provides the advanced programmer with
    techniques helpful in developing complex 
    applications.

    L'espace horizontal occupé par le champ de texte est déterminé en fonction du nombre de caractères spécifié dans l'attribut FORMAT du fichier principal. Dans le fichier principal exemple, TX50 signifie 50 caractères de large.

Conseil : comme l'en-tête de cet exemple contient un seul champ de texte incorporé, l'alignement par défaut est satisfaisant. Pourtant, pour inclure du texte afin d'introduire le champ intégré ou ajouter un autre champ intégré, vous pouvez aligner les éléments de votre sortie et améliorer ainsi la lisibilité. Pour consulter des illustrations, consultez Alignement d'un champ de texte sur une colonne dans un pied de page de tri et Alignement et définition du style d'un champ de texte dans un pied de page de tri.


Haut de page

x
Inclure un numéro de page dans un en-tête ou pied de page

Vous pouvez inclure un numéro de page généré par le système dans un en-tête ou pied de page. Pour plus de détails, consultez Mise en page de la page de rapport.


Haut de page

x
Inclure une variable de gestionnaire de dialogue dans un en-tête ou pied de page

Comment :

Vous pouvez inclure une variable dont les valeurs sont inconnues jusqu'à l'exécution dans un en-tête ou un pied de page. Cette technique vous permet de personnaliser l'en-tête ou le pied de page en fournissant une valeur différente chaque fois que la procédure s'exécute.

Les variables se répartissent entre deux catégories :

Pour plus de details sur les variables Dialogue Manager, reportez-vous au manuel Développement d'applications de reporting .



x
Syntaxe : Inclure une variable de gestionnaire de dialogue dans un en-tête ou pied de page
&[&]variable						

où :

&
Introduit une variable de gestionnaire de dialogue locale.
&&
Introduit une variable de gestionnaire de dialogue globale.
variable
est une variable dont la valeur est fournie par le système ou l'utilisateur au moment de l'exécution.


Exemple : Inclusion des données actuelles dans un en-tête de rapport

Cette requête comprend la date d'aujourd'hui sur la deuxième ligne de l'en-tête du rapport, mise en évidence avec des caractères gras.

TABLE FILE GGSALES
PRINT BUDDOLLARS DOLLARS
BY STCD
WHERE STCD EQ 'R1019'
ON TABLE SUBHEAD
"Sales Report for Store Code R1019" 
"&DATE" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF,$ 
TYPE=TABHEADING, LINE=1, FONT='TIMES', SIZE=10, STYLE=BOLD, $
TYPE=TABHEADING, LINE=2, COLOR=BLUE, $ 
ENDSTYLE
END

La sortie est :

Remarque : vous pouvez modifier le format de la date. Voici quelques formats :

Variable

Format d'affichage

&DATEtrMMDYY

2002, December 11

&DATEMDYY

12/11/2002

&DATEtrMDYY

December 11, 2002

&DATEQYY

Q4 2002



x
Inclure une image dans un en-tête ou pied de page

Une feuille de style permet d'inclure une image dans un en-tête ou pied de page. Une image, telle qu'un logo, donne une identité visuelle de l'entreprise à un rapport, ou améliore son aspect visuel.

Pour en savoir plus au sujet de l'ajout d'images de positionnement, consultez Mise en page de la page de rapport.


WebFOCUS