Création des en-têtes et pieds de page

Dans cette section :

Il y a plusieurs types d'en-têtes et de pieds de page :



x
Limitations des en-têtes et pieds de page

Les limitations suivantes s'appliquent aux en-têtes et pieds de page de rapport, aux en-têtes de page et pieds de page et aux en-tête et pieds de page de tri :


Haut de page

x
Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête

Comment :

Un code d'en-tête ou de pied de page à ligne unique, entre guillemets double, peut avoir jusqu'à 32k de caractères. Cependant, dans certains éditeurs, la longueur maximale d'une ligne de code dans une procédure est 80 caractères. Dans un tel cas, vous pouvez utiliser le signe de localisation <0X pour continuer votre en-tête sur la prochaine ligne. Le contenu de l'en-tête ou du pied de page et l'espacement s'affichent exactement comme si vous les avez saisis sur une seule ligne.

Même si vous n'avez pas besoin d'étendre votre code au-delà de 80 caractères, cette technique est très commode, car des lignes plus courtes peuvent être plus faciles à lire à l'écran et à imprimer.



x
Comment : Etendre le code d'en-tête et de pied de page aux lignes multiples dans une requête

Pour étendre la longueur d'un en-tête ou d'un pied de page à ligne unique au-delà de 80 caractères :

  1. Commencez l'en-tête ou le pied de page par des guillemets double (").
  2. Divisez le contenu de l'en-tête ou du pied de page en lignes multiples comptant jusqu'à 76 caractères chacune, en utilisant le signe de localisation <0X à tout point avant le 76ième caractère afin de continuer l'en-tête sur la prochaine ligne. (Les quatre espaces qui restent sont requis pour le signe de localisation lui-même, ainsi que pour un blanc qui le précède).
  3. La ligne d'en-tête ou de pied de page peut comprende jusqu'à 410 caractères, où chaque ligne se termine par un signe de localisation <0X.
  4. Mettez les guillemets double de fin à la fin de la dernière ligne de code d'en-tête ou de pied de page.

Cette technique s'emploie pour créer un en-tête ou pied de page de rapport, un en-tête de page ou pied de page ou un en-tête ou pied de page de tri comptant jusqu'à 410 caractères. Pour consulter une illustration, consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.



Exemple : Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête

Cette requête crée un en-tête de tri codé sur deux lignes. Le signe de localisation <0X positionne le premier caractère sur la linge suite juste à droite du dernier caractère sur la ligne précédente. (Aucun espace n'est inséré entre le signe de localisation et le début de la ligne suite).

SET ONLINE-FMT = HTML
SET PAGE-NUM = OFF
JOIN STORE_CODE IN CENTCOMP TO STORE_CODE IN CENTORD
TABLE FILE CENTCOMP
HEADING
"Century Corporation Orders Report"
PRINT PROD_NUM QUANTITY LINEPRICE
BY STORE_CODE NOPRINT
BY ORDER_NUM
ON STORE_CODE SUBHEAD
"Century Corporation orders for store <STORENAME <0X
    (store # <STORE_CODE|) in <STATE|."
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
TYPE=HEADING, FONT='ARIAL', STYLE=BOLD, $
TYPE=SUBHEAD, OBJECT=FIELD, ITEM=2, STYLE=ITALIC, $
TYPE=SUBHEAD, OBJECT=FIELD, ITEM=3, STYLE=BOLD, $
ENDSTYLE
END

La sortie partielle est :

Conseil : vous pouvez employer cette technique pour créer des rapports comptant jusqu'à 410 caractères. Bien qu'elle soit démontrée ici pour un en-tête de tri, cette technique peut être utilisée pour toute ligne d'en-tête ou de pied de page.


Haut de page

x
Création d'un rapport personnalisé ou d'un titre de feuille de calcul

Comment :

Vous pouvez créer un titre de rapport qui :

Les noms des onglets du classeur pour une Table des matières Excel sont les valeurs des champs BY qui correspondent aux données du classeur actuel. Si l'utilisateur spécifie le mot-clé TITLETEXT dans la feuille de calcul, celui-ci sera ignoré.



x
Syntaxe : Créer un titre de rapport personnalisé

Ajoutez la déclaration suivante à votre feuille de style WebFOCUS :

TYPE=REPORT, TITLETEXT='title', $

où :

titre

Est le texte de votre titre.

Le nombre de caractères maximal pour :

  • Le nom de balise de feuille de calcul dans un rapport EXL2K est 31. Tout texte dépassant 31 caractères sera tronqué.
  • Le titre de navigateur pour en rapport ou graphique HTML est 95. C'est le navigateur qui impose cette limite.

    Le texte spécifié dans le titre est mis dans le fichier tel quel, sans codage. Les caractères spéciaux comme <, >, et & ne doivent pas être utilisés car ils ont une signification particulière dans HTML et peuvent entraîner des résultats imprévus. Remarque : les mots « Microsoft Internet Explorer » sont toujours ajoutés à tout titre de rapport HTML.



Exemple : Création d'un titre de rapport personnalisé dans un rapport HTML

Ce qui suit illustre la façon de remplacer le titre par défaut dans un rapport HTML en utilisant l'attribut TITLETEXT dans votre feuille de style.

TABLE FILE SHORT
SUM PROJECTED REGION
BY REGION
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE * 
TYPE=REPORT, TITLETEXT='1999 Sales Report', $ 
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

La sortie est :



Exemple : Création d'un titre de rapport personnalisé dans un rapport EXL2K

Ce qui suit illustre la façon de remplacer le nom de balise de feuille de calcul par défaut dans un rapport EXL2K en utilisant l'attribut TITLETEXT dans votre feuille de style.

TABLE FILE SHORT
SUM PROJECTED_RETURN
BY REGION
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE * 
TYPE=REPORT, TITLETEXT='1999 Sales Report', $ 
ENDSTYLE
END

La sortie est :


Haut de page

x
Création d'un en-tête ou d'un pied de page de rapport

Comment :

Un en-tête de rapport s'affiche avant la première page et fait partie des composants les plus importants d'un rapport. Il donne au rapport un nom unique tout en identifiant son but ou son contenu. Un court en-tête de rapport à ligne unique peut suffire à répondre aux besoins de votre utilisateur, sinon vous pouvez inclure des lignes multiples d'informations appropriées.

Un pied de page de rapport s'affiche après la dernière page d'un rapport. Vous pouvez ajouter un pied de page de rapport pour signaler la fin des données afin que l'utilisateur comprenne que le rapport est terminé. Un pied de page de rapport peut aussi fournir d'autres informations, telles que l'auteur du rapport.

Un en-tête ou pied de page de rapport peut inclure du texte, des champs, des variables du Gestionnaire de dialogue, des images et des signes de localisation.



x
Syntaxe : Créer un en-tête de rapport

Utilisez la syntaxe suivante dans une requête. Chaque ligne d'en-tête ou de pied de page doit commencer et se terminer par des guillemets doubles.

ON TABLE [PAGE-BREAK AND] SUBHEAD
 "content ... "
["content ... "]
.
.
.
["content ... "]

où :

PAGE-BREAK
Est une commande facultative qui crée l'en-tête de rapport sur la première page tout seul, suivi de la ou les page(s) de données. Si vous n'utilisez pas PAGE-BREAK, l'en-tête de rapport s'affiche sur la première page du rapport, suivi de l'en-tête de page, s'il y en a un, et les titres de colonne. Pour plus d'informations, consultez Positionnement d'un en-tête ou d'un pied de page de rapport sur sa propre page.
SUBHEAD
Est la commande nécessaire pour désigner un en-tête de rapport.
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de clôture est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie de l'en-tête de rapport.)
text
Est du texte qui s'affiche sur la première page d'un rapport. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit commencer sur une ligne tout seul, suivi de la commande SUBHEAD.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être un élément ou une combinaison des éléments suivant(s) :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de certains éditeure de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).


Exemple : Création d'un en-tête de rapport à ligne unique

Cette requête crée un en-tête de rapport à ligne unique qui identifie le contenu du rapport :

TABLE FILE GGSALES
PRINT BUDDOLLARS DOLLARS
BY STCD
WHERE STCD EQ 'R1019' 
ON TABLE SUBHEAD
"Sales Report for Store Code R1019" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET WEBVIEWER ON
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END

La sortie illustre l'emplacement d'un en-tête de rapport dans un rapport HTML multi-pages. L'en-tête de rapport se trouve en haut de la première page :

Il n'y a pas d'en-têtes sur les autres pages.

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



x
Syntaxe : Créer un pied de page de rapport

Utilisez la syntaxe suivante dans une requête. Chaque ligne d'en-tête ou de pied de page doit commencer et se terminer par des guillemets doubles.

ON TABLE [PAGE-BREAK AND] SUBFOOT
 "content ... "
["content ... "]
.
.
.
["content ... "]

où :

PAGE-BREAK
Est une commande facultative qui crée le pied de page de rapport après la dernière page tout seul. Si vous n'incluez pas PAGE-BREAK, le pied de page de rapport s'affiche comme la dernière ligne du rapport. Pour plus d'informations, consultez Positionnement d'un en-tête ou d'un pied de page de rapport sur sa propre page.
SUBFOOT
Est la commande nécessaire pour désigner un pied de page de rapport.
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de fin est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie du pied de page de rapport, à moins que vous utilisiez le signe de localisation <0X).
text
Est du texte qui s'affiche sur la dernière page d'un rapport. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit commencer sur une ligne tout seul, suivi de la commande SUBFOOT.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être un élément ou une combinaison des éléments suivant(s) :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de l'éditeur de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).


Exemple : Création d'un pied de page de rapport à ligne unique

Cette requête crée un pied de page de rapport à ligne unique identifiant l'auteur du rapport :

TABLE FILE GGSALES
PRINT UNITS
WHERE UNITS GE 1400
BY STCD BY REGION
WHERE REGION EQ 'Northeast' 
ON TABLE SUBFOOT
"AUTHOR: MARY SMITH" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET WEBVIEWER ON
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END

La sortie illustre l'emplacement d'un pied de page de rapport sur un rapport HTML multi-pages. Le pied de page de rapport suit les données sur la dernière page :

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


Haut de page

x
Création d'un en-tête de page ou d'un pied de page

Comment :

Référence :

Un en-tête de page s'affiche en haut de chaque page d'un rapport, et un pied de page s'affiche en bas de chaque page.

Ajoutez un en-tête de page pour identifier et renforcer le contenu et le but du rapport, ou incluez une variable pour personnaliser l'en-tête sur chaque page. Prenez, par exemple, un rapport comprenant des informations relatives aux comptes bancaires des employés, organisé par département. Des informations pour chaque département s'affichent sur une page différente. L'en-tête de page de ce rapport identifie le département traité sur chaque page, (par exemple, ACCOUNT REPORT FOR PRODUCTION DEPARTMENT).

Ajoutez un pied de page pour fournir des informations qui méritent d'être répétées sur chaque page, telles que la date du rapport, ou un rappel confidentiel. Un pied de page sert également à fournir des informations descriptives sur un rapport, par exemple, PRELIMINARY ou DRAFT COPY.

Les en-têtes et pieds de page peuvent comprendre du texte, des champs, des variables du Gestionnaire de dialogue, des images et des signes de localisation.

En plus, vous pouvez utiliser la syntaxe d'en-tête et de pied de page afin de créer un rapport au format libre (non-tabulaire), dans lequel vous positionnez les données sur une page en utilisant votre propre mise en page. Consultez Création d'un rapport au format libre pour plus de détails.

Une requête TABLE peut avoir plusieurs en-têtes ou pieds de page. Pour chaque en-tête ou pied de page, une clause WHEN contre les données récupérées peut déterminer ce que l'en-tête ou le pied de page affiche dans la sortie de rapport.

Dans un en-tête, les données pour la clause WHEN et les valeurs du champ de données affichées dans l'en-tête sont basées sur la première ligne de la page. Dans un pied de page, les données pour la clause WHEN et les valeurs du champ de données affichées dans le pied de page sont basées sur la dernière ligne de la page.

L'attribut feuille de style CONDITION vous permet d'identifier une clause WHEN spécifique pour que vous définissiez séparément le style de chaque en-tête ou pied de page. Pour plus de détails, consultez Désigner un en-tête ou un pied de page .



x
Syntaxe : Créer un en-tête de page

Utilisez la syntaxe suivante dans une requête. Chaque ligne d'en-tête ou de pied de page doit commencer et se terminer par des guillemets doubles.

[HEADING [CENTER]]
 "content ... "
["content ... "]
.
.
.
["content ... "]

où :

TITRE
Est une commande facultative si vous positionnez le texte avant la première commande d'affichage (par exemple, PRINT ou SUM) ; sinon, elle est obligatoire pour identifier le texte comme un en-tête de page.
CENTRE
Est une commande facultative qui centre l'en-tête de page au-dessus des données de rapport. Pour plus de détails, consultez centrer un en-tête ou pied de page à l'aide du formatage patrimonial.
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de fin est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie de l'en-tête de rapport).
text
Est du texte pour l'en-tête de page. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit commencer sur une ligne tout seul, suivi de la commande HEADING.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être un élément ou une combinaison des éléments suivant(s) :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de l'éditeur de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).


Exemple : Création d'un en-tête de page à ligne unique

Cette requête omet la commande HEADING car le texte de l'en-tête de page précède l'affichage de la commande PRINT. L'en-tête de page comprend du texte et un champ intégré.

TABLE FILE EMPLOYEE 
"ACCOUNT REPORT FOR DEPARTMENT <DEPARTMENT" 
PRINT CURR_SAL BY DEPARTMENT BY HIGHEST BANK_ACCT
BY EMP_ID
ON DEPARTMENT PAGE-BREAK
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END

La sortie illustre l'emplacement d'un en-tête de page dans un rapport HTML multi-pages. L'en-tête de page s'affiche sur les deux pages du rapport, identifiant le département auquel les données s'appliquent. Consultez Inclure une valeur de champ dans un en-tête ou pied de page. La première page de données se rapporte au service MIS.

La deuxième page de données se rapporte au service PRODUCTION :



x
Syntaxe : Créer un pied de page

Utilisez la syntaxe suivante dans une requête. Chaque ligne d'en-tête ou de pied de page doit commencer et se terminer par des guillemets doubles.

FOOTING [CENTER] [BOTTOM]
  "content ... "
["content ... "]
.
.
.
["content ... "]

où :

FOOTING
Est la commande requise pour identifier certaines données comme un pied de page.
CENTRE
Est une commande facultative qui centre le pied de page au-dessus des données de rapport. Pour plus de détails sur CENTER, consultez centrer un en-tête ou pied de page à l'aide du formatage patrimonial.
BAS
Est une commande facultative qui met le pied de page en bas de la page. Si vous souhaitez omettre BOTTOM, le pied de page s'affiche à deux lignes au-dessous des données de rapport. Pour plus de détails sur BOTTOM, consultez Positionner un pied de page en bas d'une page.
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de fin est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie du pied de page de rapport, à moins que vous utilisiez le signe de localisation <0X).
text
Est du texte pour le pied de page. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit se commencer tout seul sur une ligne, suivi de la commande FOOTING.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être une ou une combinaison des éléments suivants :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de l'éditeur de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).


Exemple : Création d'un pied de page à ligne unique

Cette requête crée un pied de page à deux lignes identifiant les données comme préliminaires et indique quand le rapport final sera disponible.

TABLE FILE GGSALES
PRINT UNITS DOLLARS
BY CATEGORY BY STCD
WHERE TOTAL DOLLARS GE 25000 
FOOTING
"PRELIMINARY SALES FIGURES"
"FINAL TO COME END OF MONTH" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET WEBVIEWER ON
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END

La sortie partielle illustre l'emplacement des pieds de page dans un rapport HTML multi-pages. Le pied de page s'affiche sur les deux pages du rapport :

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



x
Syntaxe : Spécifier un en-tête ou un pied de page avec une clause WHEN
{HEADING [CENTER]|FOOTING}
"text_and_data1"
   .
   .
   .
"text_and_datan"
WHEN expression						

où :

text_and_data1, text_and_datan
est le texte et les données pour chaque ligne d'en-tête ou de pied de page.
expression
est une expression qui est résolu en TRUE ou FALSE (1 ou 0). Si sa valeur est résolue en TRUE, l'en-tête ou le pied de page est affiché. Si l'expression est résolue en FALSE, l'en-tête ou le pied de page n'est pas affiché.


x
Référence : Notes d'utilisation pour les en-têtes multiples

Haut de page

x
Figer des en-têtes HTML, pieds de page et colonnes de titres

Comment :

Référence :

Il serait utile de faire défiler les données dans un rapport tout en gelant les en-têtes, titres de colonne, et pieds de page de façon à afficher le contexte de la sortie du rapport en faisant défiler.

Avec les attributs de Feuille de style, vous pouvez mettre de côté une zone de défilement pour la sortie de rapport HTML.

La fonctionnalité de reporting HTML HFREEZE est prise en charge pour les versions de navigateur listé dans Matrice de support navigateur WebFOCUS Mise à jour 8.0.x. La fonctionnalité HFREEZE est listée dans la Matrice de compatibilité des navigateurs sur la ligne Composants JavaScript de la rubrique Fonctionnalité de reporting HTML.



x
Syntaxe : Créer une zone de défilement dans un rapport HTML
TYPE=REPORT, HFREEZE={ON|TOP|BOTTOM|OFF}, [ SCROLLHEIGHT={4|nn[.n]}], $

où :

HFREEZE=ON
Gèle l'en-tête, les titres de colonne, totaux généraux, et le pied de page.
HFREEZE=TOP
Fige les titres des en-têtes et de colonnes.
HFREEZE=BOTTOM
Gèle les totaux généraux et le pied de page.
nn[.n]
Est la hauteur, en pouces, de la zone de défilement. La valeur par défaut est de 4 pouces.


x
Référence : HFREEZE avec des titres de colonnes vides

La fonctionnalité de reporting HTML HFREEZE prend en charge les titres de colonnes vides. La barre de défilement verticale HFREEZE sera alignée avec la première ligne de données du rapport.



x
Référence : Notes d'utilisation sur le gèle des zones de la sortie de rapport HTML

Haut de page

x
Création d'un en-tête ou d'un pied de page de tri

Comment :

Référence :

Un en-tête de tri est du texte qui précède tout changement à une valeur de champ de tri, identifiant le début d'un ensemble de données liées. Un pied de page de tri est du texte qui suit tout changement à une valeur de champ de tri, identifiant la fin d'un ensemble de donngées liées.

Un en-tête ou pied de page de tri, qui s'affiche dans le corps d'un rapport, vous aide à identifier différents secteurs de détail dans un rapport. Les en-têtes et pieds de page de rapport peuvent inclure du texte, des champs, des variables du Gestionnaire de dialogue, des images et des signes de localisation.

En employant une phrase WHEN dans une requête, vous pouvez générer un message, implémenté comme un en-tête ou pied de page de tri, pour les données correspondantes aux critères que vous définissez. Pour plus de détails sur le formatage conditionnel, consultez Contrôle du formatage de rapports. Pour consulter une illustration sur cette technique, consultez Création d'un pied de page de tri conditionnel avec des options de tri multiples.

Si vous utilisez une commande RECAP pour créer des valeurs de sous-total dans un calcul, vous pouvez remplacer l'étiquette par défaut RECAP par un pied de page plus significatif en suivant la commande RECAP pour un champ avec une commande SUBFOOT. Pour plus de détails sur la commande RECAP, consultez Inclusion de totaux et de sous-totaux.

Si un ou plusieurs champs de données sont incorporés dans un pied de page de tri, vous pouvez omettre une commande d'affichage de la requête de rapport car, par défaut, les champs de données dans les en-têtes et pieds de page sont additionnés). Si, par contre, une requête ne comprend pas une commande SUM et qu'un champ d'affichage est aussi spécifié dans le pied de page de tri, le champ dans le pied de page de tri est additionné. Pour voir une illustration, consultez Omission d'une commande d'affichage dans un pied de page de tri. Vous pouvez aussi omettre la commande d'affichage des autres types d'en-têtes et de pieds de page. Notez que les données des en-têtes sont prises du premier groupe de tri et que les données des pieds de page sont prises du dernier groupe de tri. Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

Par défaut, WebFOCUS génère une ligne vierge avant un sous-en-tête ou un sous-pied de page. Vous pouvez éliminer ces lignes vierges automatiques en lançant la commande SET DROPBLNKLINE=ON.



x
Référence : Alignement d'en-têtes secondaires et de pieds de page secondaires

Par défaut, avec SQUEEZE=ON, la marge de droite utilisée pour les bordures et la couleur d'arrière-plan des en-têtes secondaires et des pieds de page secondaires est définie selon la largeur maximale de toutes les lignes d'en-tête, de pied de page, d'en-tête secondaire, et de pied de page secondaire. La longueur des lignes d'en-tête secondaire et de pied de page secondaire est liée aux longueurs de l'en-tête et du pied page, non pas à la taille des colonnes de données dans le corps du rapport. L'attribut ALIGN-BORDERS=BODY dans une feuille de style vous permet d'aligner les en-têtes et les pieds de page secondaires avec le corps de données ou du rapport dans la sortie de rapport PDF plutôt que d'autres éléments d'en-tête.



x
Syntaxe : Créer un en-tête de tri

Chaque ligne d'en-tête ou de pied de page doit commencer et terminer par des guillemets double, à moins que vous utilisez le signe de localisation de ligne de suite (<ox).

BY fieldname SUBHEAD [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]
BY fieldname 
ON fieldname SUBHEAD [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]

OU

BY fieldname 
ON fieldname SUBHEAD [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]

où :

fieldname
Est le champ de tri avant lequel le texte d'en-tête s'affiche.
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de fin est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie de l'en-tête).
text
Est du texte pour l'en-tête de tri. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit commencer sur une ligne tout seul, suivi de la commande SUBHEAD.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être une ou une combinaison des éléments suivants :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de l'éditeur de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

WHEN expression
spécifie une condition sous laquelle un en-tête de tri s'affiche, comme le détermine une expression logique. Vous devez positionner la phrase WHEN sur une ligne suivant le texte. .

Pour plus de détails sur le formatage conditionnel, consultez Contrôle du formatage de rapports. Pour plus d'informations, consultez Utilisation d'expressions.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).

NEWPAGE
Insère une nouvelle page après l'en-tête de tri. Les titres de colonne s'affiche sur chaque page.

Vous pouvez utiliser NEWPAGE avec les rapports PDF.Dans les rapports HTML, un espace vide est ajouté au lieu d'une nouvelle page.



Exemple : Création d'un en-tête de tri lors du changement d'une description de produit

Cette requête s'affiche un en-tête de tri chaque fois que la description de produit change. L'en-tête de tri comprend du texte et un champ intégré.

TABLE FILE GGPRODS
PRINT PACKAGE_TYPE AND UNIT_PRICE
WHERE UNIT_PRICE GT 50
BY PRODUCT_DESCRIPTION NOPRINT BY PRODUCT_ID 
ON PRODUCT_DESCRIPTION SUBHEAD
"Summary for <PRODUCT_DESCRIPTION" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

L'en-tête de tri identifie le produit auquel la prochaine ligne de données s'applique :

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



Exemple : Création d'un en-tête de tri conditionnel

Cette requête n'affiche un en-tête de tri pour une catégorie que si le chiffre d'affaires passe en dessous de $17 000 000 :

TABLE FILE GGSALES
SUM DOLLARS 
BY CATEGORY SUBHEAD
"<CATEGORY ALERT: SALES FALL BELOW $17,000,000"
WHEN DOLLARS LT 17000000; 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Le chiffre d'affaires pour la catégorie Gifts passe en dessous de la somme spécifiée, comme l'avertit l'en-tête de tri. Aucune autre catégorie n'est précédée d'un en-tête de tri :

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



x
Syntaxe : Créer un pied de page de tri

Chaque ligne d'en-tête ou de pied de page doit commencer et se terminer par des guillemets doubles.

Pour un champ de tri unique, utilisez la syntaxe :

BY fieldname SUBFOOT [WITHIN] [MULTILINES] [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]
BY fieldname 
ON fieldname SUBFOOT [WITHIN] [MULTILINES] [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]

Pour les champs de tri multiples, utilisez la syntaxe :

BY fieldname 
ON fieldname SUBFOOT [MULTILINES] [NEWPAGE]
 "content ... "
["content ... "]
.
.
.
["content ... "]
[WHEN expression;]

où :

fieldname
Est le champ de tri après lequel le texte de pied de page s'affiche.
WITHIN
Les champs dans le SUBFOOT sont calculés au sein de chaque valeur de fieldname. Sans cette option, un champ dans SUBFOOT est extrait de la dernière ligne de la sortie de rapport au-dessus du pied de page.
MULTILINES
Supprime le pied de page de tri lorsqu'il n'y a qu'une ligne de données pour une valeur de champ de tri. (MULTI-LINES est un synonyme de MULTILINES).
content
Le contenu des en-tête et pieds de page peut comprendre les éléments suivants, entre guillemets. (Si le guillemet de fin est omis, toutes les lignes subséquentes de la requête sont traitées comme faisant partie du pied de page de tri).
text
Est du texte qui s'affiche sur la première page d'un rapport. Vous pouvez spécifier des lignes de texte multiples.

Le texte doit commencer sur une ligne tout seul, suivi de la commande SUBFOOT.

Le texte peut être combiné avec des variables et des signes de localisation.

Pour des informations connexes, consultez Limitations des en-têtes et pieds de page.

variable
Peut être un élément ou une combinaison des éléments suivant(s) :

Champs (des champs de sources de données réelles, des champs virtuels créés avec la commande DEFINE dans un fichier Master ou une requête de rapport, des valeurs calculées créées avec la commande COMPUTE dans une requête, ou un champ de système tel que TABPAGENO). Vous pouvez qualifier des champs de sources de données avec certains opérateurs préfixes.

Dialogue Manager variables.

Images. Vous pouvez inclure des images dans un en-tête ou pied de page.

Pour plus de détails, consultez Inclure un élément dans un en-tête ou pied de page.

signe de localisation
Vous permet de positionner des éléments, d'identifier des éléments à formater et d'étendre le code au-delà de la limite de 80 caractères de l'éditeur de texte.

<+0> divise un en-tête ou pied de page en éléments à formater. Consultez Désignation d'un en-tête, d'un pied de page, d'un titre ou du texte sans FML.

</n spécifie les lignes sautées. Pour plus de détails, consultez Contrôle du positionnement vertical d'un en-tête ou d'un pied de page.

<-n positionne le prochain caractère sur la ligne. Consultez Utilisation des signes de localisation pour affiner le positionnement.

<0X continue la spécification d'un en-tête ou d'un pied de page sur la prochaine ligne de la requête. Consultez Extension du code d'en-tête et de pied de page aux lignes multiples dans une requête.

Remarque : lorsqu'une balise de fin est suivie immédiatement par une balise de début (><), un élément de texte est placé entre les deux signes de localisation (> <). Veuillez prendre cela en considération lors du formatage.

WHEN expression
spécifie une condition sous laquelle un pied de page de tri s'affiche, comme le détermine une expression logique. Vous devez positionner la phrase WHEN sur une ligne suivant le texte. .

Pour plus de détails sur le formatage conditionnel, consultez Contrôle du formatage de rapports. Pour plus d'informations, consultez Utilisation d'expressions.

Lignes vierges
Si vous omettez tout(e) texte, variable et signe de localisation, vous avez une ligne d'en-tête ou de pied de page vierge (par exemple '' ''), que vous pouvez utiliser pour sauter une ligne dans l'en-tête ou le pied de page. (Vous pouvez aussi sauter une ligne en utilisant un signe de localisation vertical, tel que </1).
NEWPAGE
Insère une nouvelle page avant le pied de page de tri.


Exemple : Création d'un pied de page de tri lors du changement d'une description de produit

Cette requête s'affiche un pied de page de tri chaque fois que la description de produit change.

TABLE FILE GGPRODS
PRINT PACKAGE_TYPE AND UNIT_PRICE
WHERE UNIT_PRICE GT 50
BY PRODUCT_DESCRIPTION NOPRINT BY PRODUCT_ID 
ON PRODUCT_DESCRIPTION SUBFOOT
"Summary for <PRODUCT_DESCRIPTION" 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

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



Exemple : Création d'un pied de page de tri conditionnel avec des options de tri multiples

Ce rapport liste des commandes, des dates de commande et des totaux de commande pour la société Century Corporation. Il utilise des pieds de page conditionnels pour distinguer entre les commandes dont le total est supérieur à 200 000$ est celles dont le total est inférieur à 200 000$.

Notez qu'une phrase de tri (ON ORDER_NUM) spécifie plusieurs options de tri (deux phrases SUBFOOT différentes) et que chaque option comprend sa propre phrase WHEN.

TABLE FILE CENTORD
HEADING
"Order Revenue"
" "
SUM ORDER_DATE LINEPRICE AS 'Order,Total:'
BY HIGHEST 5 ORDER_NUM 
ON ORDER_NUM 
   SUBFOOT
      "--- Order total is less than $200,000 ---"
      " "
      WHEN LINEPRICE LT 200000;    
   SUBFOOT
      "+++ Order total is greater than or equal to $200,000 +++"
      " "
      WHEN LINEPRICE GE 200000; 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Le rapport suivant s'affiche :



Exemple : Suppression d'un pied de page de tri

Cette requête supprime le pied de page de tri de tout produit ayant seulement une ligne de données (c-à-d, un produit qui n'a été commandé qu'une fois, le premier janvier 1996) :

TABLE FILE GGORDER
PRINT QUANTITY
BY PRODUCT_CODE NOPRINT BY PRODUCT_DESCRIPTION
WHERE ORDER_DATE EQ '01/01/96'
WHERE STORE_CODE EQ 'R1019'
WHERE PRODUCT_DESCRIPTION EQ 'Hazelnut' OR 'Biscotti' OR 'Croissant' 
ON PRODUCT_CODE SUBFOOT MULTILINES
"<PRODUCT_DESCRIPTION has multiple orders." 
ON TABLE SET PAGE-NUM OFF
ON TABLE SET ONLINE-FMT HTML
ON TABLE SET STYLESHEET *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Dans la sortie, le pied de page de tri de Biscotti est supprimé :



Exemple : Remplacement de l'étiquette par défaut RECAP par un pied de page de tri

Dans cette requête, une commande SUBFOOT pour le champ DEPARTMENT suit une commande RECAP pour ce champ. La commande RECAP crée des valeurs de sous-total pour le calcul.

TABLE FILE SHORT
SUM BALANCE AS 'Dollars' ENGLAND_POUND AS 'Sterling'
BY REGION
WHERE REGION EQ 'FAR EAST' OR 'CENTRAL AMERICA' OR 'WESTERN EUROPE';
BY COUNTRY NOPRINT
RECAP EURO/D16=BALANCE * 1.03;
SUBFOOT
" "
"Balance of investments for <COUNTRY> in Euros is <EURO>."
" "
END

Le texte de pied de page de tri (par exemple, « Balance of investments for FRANCE in Euros is 87,336,971. ») remplace l'étiquette par défaut pour la valeur RECAP (** EURO 87,336,971) :



Exemple : Omission d'une commande d'affichage dans un pied de page de tri

Cette requête crée un rapport complet comme un pied de page de tri. Elle n'exige pas de commande d'affichage parce que le contenu du pied de page comprend les champs de données DEPARTMENT et SALARY. Par défaut, le champ SALARY est totalisé dans le pied de page de tri.

TABLE FILE EMPLOYEE 
BY DEPARTMENT NOPRINT 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

La sortie est :



x
Référence : Notes d'utilisation pour les pieds de page secondaires

WebFOCUS