Chapter 4 Gestion d'un rapport


Gestion du format HTML

Vous pouvez personnaliser votre rapport HTML et définir des styles de présentation (couleur, police, arrière plan, en-tête et pied de page) à partir de l'onglet Format HTML de la feuille de propriétés du rapport à l'aide de .

PowerAMC est livré avec un jeu de modèles de présentation HTML, de feuilles de style et d'en-têtes et pieds de pages prédéfinis que vous pouvez utiliser pour générer vos rapports HTML. Les modèles de présentation HTML prédéfinis peuvent être utilisés comme base pour créer vos propres modèles de présentation HTML dans un éditeur de texte. Tous ces fichiers sont stockés dans le dossier Fichiers de ressources\Feuilles de style de rapport HTML.

Modèle de présentation HTML

Un fichier de modèle de présentation HTML est doté d'une extension .HTMLTPL et vous permet de définir les propriétés suivantes :

Lorsque vous appliquez un modèle de présentation HTML à un rapport, toutes les propriétés correspondantes définies dans le modèle de présentation sont affichées dans leur champ respectif dans la feuille de propriétés du rapport. De plus, toutes les options définies auparavant (par exemple les polices) ne sont plus prises en compte et sont remplacées par les styles définis dans le fichier de modèle de présentation.

Note   Rapport enregistré avec une version précédente
Si vous ouvrez un rapport enregistré dans une version précédente, le modèle de présentation comporte les valeurs du modèle de présentation HTML par défaut si ces valeurs sont identiques à celles définies par défaut. Dans le cas contraire, la liste Modèle dans la zone de groupe Modèles de présentation HTML porte la valeur <Aucun>.

Le modèle de présentation HTML peut inclure les variables suivantes :

Variable Description
%DATE% Date du rapport défini dans la feuille de propriétés du rapport.
%TIME% Heure de génération du rapport.
%MODELNAME% Nom du modèle d'une section de rapport.
%MODELCODE% Code du modèle d'une section de rapport.
%MODULE% Nom du module d'une section de rapport.
%APPNAME% Nom de l'application (PowerAMC).
%TITLE% Titre de rapport défini dans la feuille de propriétés du rapport.
%AUTHOR% Auteur du rapport défini dans la feuille de propriétés du rapport.
%VERSION% Version du rapport défini dans la feuille de propriétés du rapport.
%SUMMARY% Résumé du rapport défini dans la feuille de propriétés du rapport.
%NEXT% URL de la page Suivant de la page d'accueil.
%NEXTLABEL% Nom de la page Suivant de la page d'accueil.

Structure des feuilles de style

Le tableau suivant décrit l'utilisation de noms de classes dans la création des feuilles de style de rapport :

Noms de classes Description
BODY Définit les styles de fond d'écran pour toutes les pages de rapport, excepté la page home et la page du cadre de l'explorateur
.BROWSERBODY Définit les styles de fond d'écran pour la page du cadre de l'explorateur
.HOMEBODY Définit les styles de fond d'écran pour la page d'accueil
.TEXT Définit les styles de police par défaut pour les blocs de texte (description, annotation, etc.)
.TITLE Définit les styles de police par défaut pour le titre de la page home
TABLE Définit les styles par défaut pour les tableaux
TD Définit les styles par défaut pour les cellules de tableaux
Table.GRID Définit les styles pour les tableaux de listes d'objets
TABLE.GRID TD.HEADER Définit les styles pour les cellules d'en-tête de tableaux de listes d'objets
TABLE.GRID TD Définit les styles pour les cellules de tableaux de listes d'objets de rangées paires
TABLE.GRID TD TD2 Définit les styles pour les cellules de tableaux de listes d'objets de rangées impaires
Table.FORM Définit les styles de tableaux de fiches d'objets
TABLE.FORM TD.HEADER Définit les styles pour le nom de cellule des tableaux de fiches d'objets
TABLE.FORM TD Définit les styles pour la valeur de cellule des tableaux de fiches d'objets
Table.TEXT Définit les styles pour les tableaux autour des blocs de texte
TABLE.TEXT TD Définit les styles pour les cellules de tableaux autour des blocs de texte
Table.TITLE Définit les styles pour les tableaux autour du titre de la page home
TABLE.TITLE TD Définit les styles pour les cellules de tableaux autour du titre de la page home
Table.GRAPHICS Définit les styles pour les tableaux autour des graphiques
TABLE.GRAPHICS TD Définit les styles pour les cellules de tableaux autour des graphiques
H1 Définit les styles pour les titres de niveau 1
H2 Définit les styles pour les titres de niveau 2
H3 Définit les styles pour les titres de niveau 3
HR Définit les styles pour les lignes de séparation
A:LINK Définit les couleurs par défaut pour les liens hypertexte non visités
A: VISITED Définit les couleurs par défaut pour les liens hypertexte visités
A: HOVER Définit les couleurs par défaut pour les liens hypertexte en surbrillance
.BROWSER Définit les style de police par défaut pour l'explorateur
A.BROWSER:LINK Définit les couleurs par défaut pour les liens hypertexte non visités de l'explorateur
A.BROWSER:VISITED Définit les couleurs par défaut pour les liens hypertexte visités de l'explorateur
A.BROWSER:HOVER Définit les couleurs par défaut pour les liens hypertexte en surbrillance de l'explorateur
TABLE.NAVGROUP Définit les styles pour les tableaux autour des boutons de navigation
TABLE. NAVGROUP TD Définit les styles pour les cellules de tableaux autour des boutons de navigation
.NAVBUTTON Définit les styles de police par défaut pour les boutons de navigation
A.NAVBUTTON:LINK Définit les styles par défaut pour les liens hypertexte non visités des boutons de navigation
A.NAVBUTTON:VISITED Définit les styles par défaut pour les liens hypertexte visités des boutons de navigation
A.NAVBUTTON:HOVER Définit les styles par défaut pour les liens hypertexte en surbrillance des boutons de navigation

Dans une feuille de style, vous pouvez définir la police, la couleur, le fond d'écran, la taille, la marge, et l'alignement de chaque nom de classe.

Propriétés de rapport HTML

La page Format HTML inclut les propriétés suivantes. Chaque propriété est facultative. Si vous ne voulez pas appliquer de modèle de présentation HTML au cours de la génération, sélectionnez <Aucun> dans la liste Modèle :

Propriété Description
Modèle Liste des noms de fichiers de modèles de présentation disponibles dans le dossier Feuilles de style de rapport HTML.

Vous pouvez cliquer sur l'outil Aperçu du modèle de présentation HTML pour visualiser le modèle de présentation HTML courant dans votre navigateur par défaut.

Vous pouvez cliquer sur l'outil Sauvegarde du fichier de modèle de présentation HTML pour enregistrer les modifications que vous avez effectuées dans un modèle de présentation ou pour enregistrer un modèle de présentation que vous avez créé.

Vous pouvez cliquer sur l'outil Suppression du modèle de présentation pour supprimer un modèle de présentation que vous ne souhaitez plus conserver.

Vous pouvez cliquer sur l'outil sélection du répertoire des modèles de présentation HTML pour rechercher un fichier de modèle de présentation HTML dans un dossier d'une autre version de PowerAMC.
Feuille de style Chemin absolu ou relatif de la feuille de style (fichier CSS). Vous pouvez rechercher un fichier local ou partagé (UNC, Universal Naming Convention), ou saisir une URL.

Vous pouvez cliquez sur l'outil Ouverture du fichier de feuille de style du rapport HTML pour ouvrir le fichier CSS dans votre éditeur de texte par défaut.

Vous pouvez cliquez sur l'outil Recherche du fichier de feuille de style pour les rapports HTML pour rechercher un fichier CSS dans le dossier que vous sélectionné pour le modèle de présentation.
En-tête

Emplacement

Hauteur
Chemin absolu ou relatif du fichier d'en-tête (fichier HTML). Vous pouvez rechercher un fichier local ou partagé (UNC), ou saisir une URL

Hauteur en pixels de l'en-tête le plus haut dans la page.

Vous pouvez cliquez sur l'outil Ouverture du fichier d'en-tête pour les rapports HTML pour ouvrir le fichier HTML dans votre éditeur de texte par défaut.

Vous pouvez cliquez sur l'outil Recherche du fichier de d'en-tête pour les rapports HTML pour rechercher un fichier HTML dans le dossier que vous sélectionné pour le modèle de présentation.
Pied de page

Emplacement

Hauteur
Chemin absolu ou relatif du fichier de pied de page (fichier HTML). Vous pouvez rechercher un fichier local ou partagé (UNC), ou saisir une URL.

Hauteur en pixels du pied de page le plus bas dans la page.

Les outils en regard de la zone Pied de page vous permettent d'effectuer les mêmes actions que ceux situés en regard de la zone En-tête.
Page d'accueil Chemin absolu ou relatif du fichier de page d'accueil (fichier HTML). Vous pouvez rechercher un fichier local ou partagé (UNC), ou saisir une URL.

Les outils en regard de la zone Page d'accueil vous permettent d'effectuer les mêmes actions que ceux situés en regard de la zone En-tête.
Sommaire

Niveau

Largeur
Nombre de niveaux de profondeur maximum à afficher dans la table des matières HTML (TOC°. 3 est le niveau de profondeur par défaut

Largeur de la table des matières en pourcentage de la largeur totale de la fenêtre de rapport.
Format d'image

SVG

PNG

JPEG
Format des éléments Graphique associés aux diagrammes. Si votre rapport contient de grands diagrammes, il est conseillé d'opter pour le format SVG qui permet de mieux contrôler les éléments graphiques, voir ci-après pour plus de détails. Lors de la compression, pour réduire la taille du graphique, le format PNG (Portable Network Graphic) réduit la perte de qualité mais est plus long à générer que le format JPEG.
Format de liste

Nombre de lignes par page

Liens vers des résultats supplémentaires
Format des éléments Liste.

Vous pouvez sélectionner le nombre de lignes que vous souhaitez afficher dans la liste de résultats

Vous pouvez également définir le nombre de pages liées affichées sous la liste. Les résultats supplémentaires sont des numéros portant des hyperliens vers d'autres pages contenant la suite de la liste.
Ajouter un saut de page pour les listes et les fiches de premier niveau Création de saut de page pour chaque liste et fiche de premier niveau pour réduire la longueur des pages HTML.

Note   Afficher le contenu dans la table des matières HTML
Vous pouvez également pointer sur un dossier dans le volet Eléments du rapport et cliquer le bouton droit de la souris, puis désélectionner Afficher le contenu dans le sommaire HTML pour n'afficher que le titre de l'élément sans son contenu dans la table des matières.

Fichiers associés aux feuilles de style et aux en-têtes et pieds de pages

Quand vous générez un rapport HTML et que vous voulez conserver les liens associés à vos feuilles de style (CSS) ou vos fichiers d'en-tête et de pied de page (HTML), il est recommandé de réunir les fichiers liés dans un répertoire que vous nommez comme le fichier auquel ils sont associés. Il est préférable que ce répertoire soit situé au même niveau dans l'explorateur.

Par exemple, l'en-tête Entete_Bleu.html utilise des fichiers qui devraient être réunis dans le répertoire Entete_Bleu_fichiers  :


Ceci permet de s'assurer que durant la génération du rapport, le contenu des répertoires associés est aussi copié et que les liens associés à vos feuilles de style et aux en-tête et de pied de page fonctionnent correctement.

Dépendant du type d'emplacement

En fonction du type d'emplacement (chemins local ou UNC, ou URL), les fichiers de feuille de style et les fichiers d'en-tête et de pied de page sont utilisés comme suit :

Emplacement Utilisation
Chemin local ou UNC Le fichier HTML ou CSS est copié dans le répertoire de génération du rapport
URL La référence dans le rapport HTML utilise le fichier HTML ou CSS tel quel

Page de code valide

Par défaut, PowerAMC génère dans la page HTML un jeu de caractères (charset) construit à partir de la page de code valide (active codepage Windows-ACP) du système courant.

Si le jeu de caractères est correct le rapport HTML peut s'afficher sur n'importe quel système.

Si le jeu de caractères n'est pas correct vous devez créer la clé ReportHtmlCharset dans [HKEY_CURRENT_USER\Software\Sybase\PowerAMC 12\General], et lui attribuer la valeur de la page de code qui devrait être générée dans le rapport HTML.

Vous trouverez des exemples de jeu de caractères HTML à l'adresse Internet suivante : http://www.w3.org/International/O-charset-lang.html.

Format d'image SVG

SVG (Scalable Vector Graphics) est un langage XML pour les graphiques Web du W3C (World Wide Web Consortium). Si vous optez pour le format d'image SVG pour la génération des images dans votre rapport HTML, vous devez utiliser un navigateur doté d'une fonctionnalité permettant l'affichage des fichiers SVG.

Vous pouvez installer une visionneuse SVG si votre navigateur n'en est pas pourvu, reportez-vous à la page http://www.w3.org/Graphics/SVG/SVG-Implementations.htm8 pour plus d'informations sur les visionneuses SVG pour Internet Explorer et Netscape.

Vous pouvez également utiliser un navigateur équipé d'une visionneuse SVG incorporée tel qu'Opera ou Firefox, dans ce cas assurez-vous que votre navigateur dispose bien de la version appropriée de la visionneuse SVG.

Une visionneuse SVG fournit les fonctionnalité suivantes :

Steps Pour gérer le format HTML:

  1. Sélectionnez Rapport→Propriétés du rapport à partir de la fenêtre de l'éditeur de rapport et cliquez sur l'onglet Format HTML.
  2. Sélectionnez un modèle de présentation HTML dans la liste Modèle.

    ou

    Sélectionnez un modèle de présentation HTML dans la liste modèle de présentation dans la page Options de présentation de l'Assistant Création de rapport.

    Les options qui suivent ne sont pas disponibles depuis l'Assistant Création de rapport.
  3. <facultatif> Sélectionnez un fichier .CSS ou saisissez une adresse URL dans la zone Feuille de style.
  4. <facultatif> Sélectionnez un fichier HTML local ou partagé ou saisissez une adresse URL dans la zone En-tête.
  5. <facultatif> Sélectionnez un fichier HTML local ou partagé ou saisissez une adresse URL dans la zone Pied de page.
  6. <facultatif> Sélectionnez un fichier HTML local ou partagé ou saisissez une adresse URL dans la zone Page d'accueil.
  7. <facultatif> Saisissez un nombre dans la zone Niveau et un pourcentage dans la zone Largeur de la zone de groupe Sommaire.
  8. <facultatif> Sélectionnez un format d'image et saisissez un nombre pour les formats de liste.
  9. Cochez la case Ajouter un saut de page pour les listes et les fiches de premier niveau.
  10. Cliquez sur OK.

    Lorsque vous générez le rapport HTML, il reflète les propriétés que vous avez définies pour le rapport.

Note   Boutons de navigation Précédent, Suivant, Accueil
Vous pouvez traduire les boutons de navigation (Précédent, Suivant, Accueil) générés par défaut dans votre rapport HTML en utilisant les paramètres HtmlNext, HtmlPrevious and HtmlHome dans la catégorie Report Titles\Common Objects de l'Editeur de langue de rapport. Pour plus d'informations, reportez-vous à la section Utilisation de l'Editeur de langue de rapport dans le chapitre Utilisation des Editeurs de rapport.

Note   Boutons par défaut
Vous pouvez définir les valeurs de propriétés actuelles comme défaut pour votre rapport HTML en cliquant sur le bouton Définir comme défaut. Vous pouvez aussi revenir aux valeurs précédemment enregistrées en cliquant sur le bouton Défaut.

 


Copyright (C) 2005. Sybase Inc. All rights reserved.