Balises d'en-tête et de bas de page

Vous pouvez définir des en-têtes et des bas de page dans un canevas de rapport à l'aide des balises fp:header et fp:footer.
Les balises d'en-tête et de bas de page ont des fonctions similaires et utilisent l'attribut hauteur. Les ensembles d'en-têtes et de bas de page doivent correspondre. Par exemple, si la valeur de fp:header pour la page définie sur la gauche, la valeur de fp:footer pour la page doit également être définie sur la gauche.

Balises d'en-tête

Si aucune balise fp:header ne figure dans un canevas, l'en-tête ne s'affiche pas dans le rapport. Un en-tête est un tableau qui contient un ensemble de cellules. Le nombre de balises d'en-tête doit être un multiple du nombre de colonnes. Si cols indique qu'il existe trois colonnes, le nombre de balises de fp:header doit être 3, 6, 9, 12, etc.
Chaque balise fp:header définit une cellule dans un en-tête :
  • fp:cell ou fp:textcell : Contient un texte simple. Ces balises peuvent créer une cellule qui contient le texte "Hello world" : <fp:textcell>Hello world</fp:textcell>
  • fp:imagecell : Contient une image. L'image est lue à partir d'un fichier et celui-ci doit être placé dans le dossier .../Program Files/Focal Point/tool/images. Les images peuvent être au format GIF ou JPG ; par exemple, <fp:imagecell filename="myimage.jpg" />. Si une balise fp:imagecell est placée dans la première ligne ou colonne d'un en-tête, elle risque de ne pas s'afficher correctement.
  • fp:complexcell : Contient un certain nombre de textes. Il peut s'agir d'un texte en clair ou d'un stringParam avec type="template/runtime/never/fetch". Cette balise est la seule balise fp:*cell qui possède ses propres balises. Pour plus d'informations sur cette balise, reportez-vous au tableau relatif aux balises fp:complexcell.

Les balises fp:*cell comportent les attributs suivants :

Tableau 1. Attributs des balises d'en-tête
Nom Description Balise applicable
filename Attribut obligatoire indiquant le nom du fichier qui contient l'image. fp:imagecell
align Attribut facultatif déterminant l'alignement horizontal (left [gauche], right [droite] ou center [centré]). La valeur par défaut est left. fp:textcell et fp:complexcell
border Attribut facultatif déterminant le bordure de la cellule. La valeur de bordure totale est la somme des valeurs de chacune des bordures. La valeur par défaut est 0.
Par exemple, les bordures d'une cellule ont les valeurs suivantes :
  • Supérieure : 1
  • Inférieure : 2
  • Gauche : 4
  • Droite : 8
Pour tracer les bordures supérieure, gauche et droite, indiquez la valeur suivante : 1+4+8=13:border="13"
Toutes les balises fp*cell
colspan Attribut facultatif déterminant le nombre de colonnes d'un tableau occupé par une cellule. Lorsque l'attribut colspan est utilisé, les informations sur le nombre de cellules requises sont incorrectes. Par exemple, colspan="2" correspond à deux cellules. La valeur par défaut est 1. Toutes les balises fp*cell
headingstyle Attribut facultatif déterminant les styles d'en-tête à utiliser dans la cellule. La valeur par défaut est Normal. Toutes les balises fp*cell
scalepercent Attribut facultatif déterminant la mise à l'échelle de l'image. La valeur par défaut est 100. Pour créer une image avec une qualité optimale, indiquez une taille environ cinq fois supérieure à la taille voulue. Réduisez ensuite l'image en la mettant à l'échelle à la taille souhaitée. Les images ont généralement une meilleure qualité sur papier qu'à l'écran. Pour une taille d'écran standard, scalepercent="100". fp:imagecell
La balise fp:complexcell comporte les balises suivantes :
Tableau 2. Balises fp:complexcell
Nom Description
fp:newline Insère un retour à la ligne
fp:stringParam

fp:intParam

fp:checkboxParam

Insère un texte en clair qui est le résultat de l'évaluation de la balise fp:*Param
fp:text Insère un texte en clair

Attributs d'en-tête

Les balises d'en-tête comportent deux attributs obligatoires et deux attributs facultatifs.
Tableau 3. Attributs de fp:header
Attribut Description
cols Attribut obligatoire déterminant le nombre et la taille des colonnes. Par exemple, pour créer un tableau comportant trois colonnes, la troisième colonne étant plus large que les autres, indiquez cols="30,30,40".
height Attribut obligatoire déterminant la hauteur de l'en-tête. Cet attribut affecte uniquement les rapports PDF. Par exemple, pour indiquer une hauteur de 3 cm, entrez height="100".
page Attribut facultatif déterminant les pages pour lesquelles l'en-tête est utilisé. Cet attribut peut prendre les valeurs suivantes :
  • all : L'en-tête est utilisé sur toutes les pages (valeur par défaut).
  • first : L'en-tête est utilisé sur la première page uniquement.
  • left : L'en-tête est utilisé sur toutes les pages de gauche.
  • right : L'en-tête est utilisé sur toutes les pages de droite.
Les règles suivantes s'appliquent lors de la définition de l'attribut page :
  • Pour la première page, utilisez page="first". Sinon, indiquez page="right" ou page="all". Si aucune de ces pages n'existe, n'employez pas d'en-tête.
  • Pour les pages de gauche, indiquez page="left". Sinon, indiquez page="all". Si aucune de ces pages n'existe, n'employez pas d'en-tête.
  • Pour les pages de droite, à l'exception de la première page, indiquez page="right". Sinon, indiquez page="all". Si aucune de ces pages n'existe, n'employez pas d'en-tête.
La valeur par défaut est all.
percentwidth Attribut facultatif qui affecte la largeur de l'en-tête du tableau. La valeur par défaut est 100.
Cet en-tête a été généré dans un document PDF avec la balise exemple fp:header.
<fp:header cols="16,47,63,23,24" height="70" percentwidth="123">
		<fp:cell border="0" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="0" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="2" headingstyle="NormalMiddle"></fp:cell>
		<fp:cell border="0" headingstyle="NormalMini"></fp:cell>
		<fp:imagecell align="center" colspan="1" border="8"
            filename="logo.jpg" scalepercent="12" 
            style="NormalMini" />
    <fp:complexcell border="15">
            <fp:text style="NormalMiniLeft"> Uppgjord -</fp:text>
            <fp:textstyle="NormalMiniLeftItalic">Prepared</fp:text>
            <fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
            <fp:stringparam name="Uppgjord" descr="Uppgjord" changeable="runtime" id="1" defaultvalue="" />
    </fp:complexcell>
    <fp:complexcell border="15">
            <fp:text style="NormalMini"> Datum -</fp:text>
                <fp:textstyle="NormalMiniItalic">Date</fp:text>
                <fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
                <fp:stringparam name="currentdate" descr="Datum" changeable="fetch" id="2" defaultvalue=""/>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMini"> Sida -</fp:text>
							<fp:textstyle="NormalMiniItalic">Page</fp:text>
							<fp:newline style="Normal" /><fp:text style="Normal"> </fp:text>
							<fp:intParam name="pageno" descr="Sidnummer" changeable="fetch" defaultvalue="" id="3"/>
							<fp:	text>(</fp:text>
							<fp:intParam name="numpages" descr="Antal sidor"changeable="fetch" defaultvalue="" id="4"/>
							<fp:text>)</fp:text>
		</fp:complexcell>
							<fp:cell border="0" headingstyle="NormalMini"></fp:cell>
							<fp:complexcell border="8" headingstyle="NormalMiddle"align="left">
							<fp:text style="NormalMiddle">Stockholm</fp:text>
							<fp:newline />
							<fp:text style="NormalMiddle">Sweden</fp:text>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMiniLeft"> Godkänd -</fp:text><fp:textstyle="NormalMiniLeftItalic">Approved</fp:text>
							<fp:newline style="Normal" />
						 	<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Godkänd"descr="Godkänd av" changeable="runtime" id="5" defaultvalue=""/>
		</fp:complexcell>
		<fp:complexcell border="15">
							<fp:text style="NormalMini"> Dok nr -</fp:text>
							<fp:text style="NormalMiniItalic">DocNo</fp:text>
							<fp:newline style="Normal" />
							<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Dok Nr" descr="Dokumentnummer" changeable="runtime" id="6" defaultvalue="" />
							</fp:complexcell>
							<fp:complexcell border="15">
							<fp:text style="NormalMini"> Revision -</fp:text>
							<fp:textstyle="NormalMiniItalic">Revision</fp:text>
							<fp:newline style="Normal" />
							<fp:text style="Normal"> </fp:text>
							<fp:stringparam name="Revision" descr="Revision" changeable="runtime" id="7" defaultvalue=""/>
		</fp:complexcell>
							<fp:cell border="0" headingstyle="Normal"></fp:cell>
							<fp:cell border="0" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
							<fp:cell border="1" headingstyle="Normal"></fp:cell>
</fp:header>

Retour d'informations