Tag di intestazione e piè di pagina

È possibile definire intestazioni e piè di pagina in un template di report utilizzando i tag fp:header e fp:footer.
I tag di intestazione e piè di pagina hanno funzioni simili ed entrambi utilizzano l'attributo dell'altezza (height): Gli insiemi di intestazioni e piè di pagina devono corrispondere. Ad esempio, se il valore di pagina di fp:header è impostato a sinistra, il valore di pagina di fp:footer deve essere impostato a sinistra.

Tag di intestazione

In assenza di tag fp:header in un template, l'intestazione non viene visualizzata nel report. Un'intestazione è una tabella contenente un insieme di celle. Il numero di tag di intestazione deve essere un multiplo del numero di colonne. Se cols specifica che sono presenti tre colonne, il numero di tag di fp:header deve essere 3, 6, 9, 12 e così via.
Ogni tag fp:header definisce una cella in un'intestazione:
  • fp:cell o fp:textcell: contiene un testo semplice. Queste tag creano una cella contenente il testo "Hello world": <fp:textcell>Hello world</fp:textcell>
  • fp:imagecell: Contiene un'immagine. L'immagine viene letta da un file e il file deve essere inserito nella cartella .../Program Files/Focal Point/tool/images. Le immagini possono essere in formato GIF o JPG; ad esempio, <fp:imagecell filename="myimage.jpg" />. Se un tag fp:imagecell si trova nella prima riga o colonna di un'intestazione, è possibile che non venga visualizzata correttamente.
  • fp:complexcell: contiene un numero di testi. Il testo può essere semplice o uno stringParam con type="template/runtime/never/fetch". Tale tag è l'unico tag fp:*cell che dispone di tag personalizzate. Per ulteriori informazioni su tale tag, vedere la tabella di tag fp:complexcell.

I tag fp:*cell hanno i seguenti attributi:

Tabella 1. Attributi per tag di intestazione
Nome Descrizione Tag applicabile
filename Un attributo obbligatorio che specifica il nome del file contenente l'immagine. fp:imagecell
align Un attributo facoltativo che determina l'allineamento orizzontale (a sinistra, a destra o al centro). Il valore predefinito è left. fp:textcell e fp:complexcell
border Un attributo facoltativo che determina il bordo della cella. Il valore del bordo totale è la somma dei valori di ciascuno dei bordi. Il valore predefinito è 0.
Ad esempio, i bordi di una cella hanno i seguenti valori:
  • Superiore: 1
  • Inferiore: 2
  • Sinistro: 4
  • Destro: 8
Per tracciare il bordo superiore, sinistro e destro, impostare il valore del bordo su 1+4+8=13:border="13"
Tutti i tag fp*cell
colspan Un attributo facoltativo che determina il numero di colonne della tabella occupate da una cella. Quando si utilizza l'attributo colspan, le informazioni che riguardano il numero di celle richieste sono errate. Ad esempio, colspan="2" viene contato come due celle. Il valore predefinito è 1. Tutti i tag fp*cell
headingstyle Un attributo facoltativo che determina gli stili di intestazione da utilizzare nella cella. Il valore predefinito è Normale. Tutti i tag fp*cell
scalepercent Un attributo facoltativo che determina l'adattamento in scala dell'immagine. Il valore predefinito è 100. Per creare l'immagine della migliore qualità, crearla cinque volte più grande della dimensione prevista. Quindi adattarla in scala fino a tale dimensione. Spesso, le immagini sono di migliore qualità sulla carta rispetto che sullo schermo. Per una dimensione standard su schermo, scalepercent="100". fp:imagecell
Il tag fp:complexcell ha i seguenti tag.
Tabella 2. Tag fp:complexcell
Nome Descrizione
fp:newline Inserisce un'interruzione di riga
fp:stringParam

fp:intParam

fp:checkboxParam

Inserisce il testo semplice che è il risultato della valutazione del tag fp:*Param
fp:text Inserisce un testo semplice

Attributi di intestazione

I tag di intestazione contengono due attributi obbligatori e due facoltativi.
Tabella 3. Attributi per fp:header
Attributo Descrizione
cols Un attributo obbligatorio che determina il numero e la dimensione delle colonne. Ad esempio, per creare una tabella con tre colonne in cui la terza è maggiore delle altre, immettere cols="30,30,40"
height Un attributo obbligatorio che determina l'altezza dell'intestazione. Questo attributo si applica soltanto a report PDF. Ad esempio, per specificare un'altezza di 3 cm, immettere height="100"
page Un attributo facoltativo che determina le pagine per cui viene utilizzata l'intestazione. Tale attributo ha i seguenti valori possibili:
  • all: l'intestazione viene utilizzata in tutte le pagine (valore predefinito)
  • first: l'intestazione viene utilizzata solo nella prima pagina
  • left: l'intestazione viene utilizzata in tutte le pagine a sinistra
  • right: l'intestazione viene utilizzata in tutte le pagine a destra
Le seguenti regole si applicano all'impostazione dell'attributo di pagina:
  • Per la prima pagina, utilizzare page="first". Altrimenti, utilizzare page="right" o page="all". Se nessuna di tali pagine esiste, non utilizzare un'intestazione.
  • Per le pagine a sinistra, utilizzare page="left". Altrimenti, utilizzare page="all". Se nessuna di tali pagine esiste, non utilizzare un'intestazione.
  • Per le pagine a destra eccetto la prima, utilizzare page="right". Altrimenti, utilizzare page="all". Se nessuna di tali pagine esiste, non utilizzare un'intestazione.
Il valore predefinito è all.
percentwidth Un attributo facoltativo che influisce sulla larghezza dell'intestazione di tabella. Il valore predefinito è 100.
Questa intestazione è stata generata in un documento PDF utilizzando il tag fp:header di esempio.
<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>

Feedback