Tags de Cabeçalho e de Rodapé

É possível definir cabeçalhos e rodapés em um modelo de relatório usando as tags fp:header e fp:footer.
As tags de cabeçalho e de rodapé possuem funções semelhantes e as duas tags usam um atributo de altura. Os conjuntos de cabeçalhos e rodapés devem ser correspondentes. Por exemplo, se houver um valor de página fp:header configurado como à esquerda, um fp:footer com valor de página deverá ser configurado como à esquerda.

Tags de Cabeçalho

Se não houver nenhuma tag fp:header em um modelo, o cabeçalho não será exibido no relatório. Um cabeçalho é uma tabela que contém um conjunto de células. O número de tags de cabeçalho deve ser um múltiplo do número de colunas. Se o atributo cols especificar que existem três colunas, o número de tags do fp:header deverá ser 3, 6, 9, 12 e assim por diante.
Cada tag fp:header define uma célula em um cabeçalho:
  • fp:cell ou fp:textcell: Contém um texto simples. Essa tags podem criar uma célula que contém o texto "Hello world": <fp:textcell>Hello world</fp:textcell>
  • fp:imagecell: Contém uma imagem. A imagem é lida a partir de um arquivo, o qual deve ser colocado na pasta .../Program Files/Focal Point/tool/images. As imagens podem estar no formato GIF ou JPG, por exemplo, <fp:imagecell filename="myimage.jpg" />. Se uma tag fp:imagecell for colocada na primeira linha ou coluna de um cabeçalho, ela poderá não ser exibida corretamente.
  • fp:complexcell: Contém vários textos. O texto pode ser um texto simples ou um stringParam com type="template/runtime/never/fetch". Essa tag é a única tag fp:*cell que possui as próprias tags. Para obter mais informações sobre essa tag, consulte a tabela de tags fp:complexcell.

A tag fp:*cell possui os seguintes atributos:

Tabela 1. Atributos para as Tags de Cabeçalho
Nome Descrição Tag aplicável
filename Um atributo obrigatório que especifica o nome do arquivo que contém a imagem. fp:imagecell
align Um atributo opcional que determina o alinhamento horizontal (esquerdo, direito ou central). O valor-padrão é esquerdo. fp:textcell e fp:complexcell
border Um atributo opcional que determina a borda da célula. O valor total da borda é a soma dos valores de cada uma das bordas. O valor-padrão é 0.
Por exemplo, as bordas de uma célula possuem os seguintes valores:
  • Superior: 1
  • Inferior: 2
  • Esquerda: 4
  • Direita: 8
Para desenhar a borda superior, esquerda e direita, configure o valor da borda para 1+4+8=13:border="13".
Todas as tags fp*cell
colspan Um atributo opcional que determina o número de colunas da tabela que devem ser ocupadas pela célula. Quando o atributo colspan é usado, as informações sobre o número de células necessário estão incorretas. Por exemplo, um colspan="2" é contado como duas células. O valor-padrão é 1. Todas as tags fp*cell
headingstyle Um atributo opcional que determina os estilos de título a serem usados na célula. O valor-padrão é Normal. Todas as tags fp*cell
scalepercent Um atributo opcional que determina a escala de uma imagem. O valor-padrão é 100. Para criar uma imagem de melhor qualidade, crie a imagem aproximadamente cinco vezes maior que o tamanho desejado. Em seguida, diminua a escala da imagem para o tamanho desejado. Geralmente as imagens possuem qualidade melhor no papel do que na tela. Para um tamanho de tela padrão, configure scalepercent="100". fp:imagecell
A tag fp:complexcell possui as seguintes tags.
Tabela 2. tags fp:complexcell
Nome Descrição
fp:newline Insere uma nova quebra de linha.
fp:stringParam

fp:intParam

fp:checkboxParam

Insere o texto simples que é o resultado da avaliação da tag fp:*Param.
fp:text Insere texto simples.

Atributos de Cabeçalho

As tags de cabeçalho contêm dois atributos obrigatórios e dois opcionais.
Tabela 3. Atributos para fp:header
Atributo Descrição
cols Um atributo obrigatório que determina o número e o tamanho das colunas. Por exemplo, para criar uma tabela com três colunas nas quais a terceira coluna é maior que as outras colunas, digite cols="30,30,40"
height Um atributo obrigatório que define a altura do cabeçalho. Esse atributo afeta apenas relatórios PDF. Por exemplo, para especificar uma altura de 3 cm, digite height="100"
page Um atributo opcional que determina as páginas para as quais o cabeçalho é usado. Esse atributo possui os seguintes valores possíveis:
  • all: O cabeçalho é usado em todas as páginas (valor-padrão)
  • first: O cabeçalho é usado apenas na primeira página
  • left: O cabeçalho é usado em todas as páginas esquerdas
  • right: O cabeçalho é usado em todas as páginas direitas
As seguintes regras se aplicam à configuração do atributo de página:
  • Para a primeira página, use page="first". Caso contrário, use page="right" ou page="all". Se nenhuma dessas páginas existir, não use um cabeçalho.
  • Para as páginas esquerdas, use page="left". Caso contrário, use page="all". Se nenhuma dessas páginas existir, não use um cabeçalho.
  • Para as páginas direita, exceto para a primeira página, use page="right". Caso contrário, use page="all". Se nenhuma dessas páginas existir, não use um cabeçalho.
O valor-padrão é all.
percentwidth Um atributo opcional que afeta a largura do cabeçalho da tabela. O valor-padrão é 100.
Esse cabeçalho foi gerado em um documento PDF usando a tag fp:header de amostra.
<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