ヘッダー・タグおよびフッター・タグ

fp:header および fp:footer タグを使用して、レポート・テンプレートにヘッダー・タグとフッター・タグを定義できます。
ヘッダー・タグとフッター・タグは類似した機能を持ち、いずれも高さ属性を使用します。 ヘッダー・セットとフッター・セットは一致する必要があります。例えば、fp:header のページ値が left に設定されている場合は、fp:footer のページ値も left に設定する必要があります。

ヘッダー・タグ

テンプレートに fp:header タグがないと、レポートでヘッダーが表示されません。 ヘッダーは、いくつかのセルで構成されるテーブルです。ヘッダー・タグの数は、列数の倍数でなければなりません。 cols で列数 3 を指定している場合、fp:header のタグの数は、3、6、9、12 などでなければなりません。
fp:header タグはそれぞれ、ヘッダー内にセルを定義します。
  • fp:cell または fp:textcell: 単純なテキストが入ります。次のタグでは、 「Hello world」というテキストを含むセルが作成できます。<fp:textcell>Hello world</fp:textcell>
  • fp:imagecell: イメージが入っています。イメージはファイルから読み取られます。 ファイルは、.../Program Files/Focal Point/tool/images フォルダーに入っている必要があります。イメージは GIF または JPG のいずれかのフォーマットにすることができます。 例えば、<fp:imagecell filename="myimage.jpg" /> のように指定します。 fp:imagecell タグは、ヘッダーの第 1 行または第 1 列にあると、正常に表示されない場合があります。
  • fp:complexcell: 複数のテキストが入ります。テキストはプレーンの場合と、 type="template/runtime/never/fetch" を指定した stringParam の場合があります。このタグは、専用のタグを持つ fp:*cell タグのみです。 このタグについて詳しくは、fp:complexcell タグ・テーブルを参照してください。

fp:*cell タグには以下の属性があります。

表 1. ヘッダー・タグの属性
名前 説明 当該タグ
filename イメージが入っているファイルの名前を指定する必須属性。 fp:imagecell
align 水平位置合わせ (左、右、または中央) を指定するオプション属性。 デフォルト値は左です。 fp:textcell および fp:complexcell
border セルの境界線を決定するオプションの属性。 境界線の合計は、個々の境界線の値の合計です。 デフォルト値は 0 です。
例えば、セルの境界線には以下の値があります。
  • 上: 1
  • 下: 2
  • 左: 4
  • 右: 8
上、左、および右の境界線を描くには、境界線値を 1+4+8=13:border="13" に設定します。
すべての fp*cell タグ
colspan セルが占有するテーブル列数を決定するオプションの属性。 colspan 属性を使用した場合、必要なセル数に関する情報が不正確になります。 例えば、colspan="2" は 2 セルとカウントされます。デフォルト値は 1 です。 すべての fp*cell タグ
headingstyle セルで使用する見出しスタイルを決めるオプションの属性。 デフォルト値は Normal です。 すべての fp*cell タグ
scalepercent イメージのスケーリングを決定するオプションの属性。 デフォルト値は 100 です。最高品質のイメージを作成するには、目的とするサイズの約 5 倍の大きさのイメージを作成してください。 次にそのイメージを目的のサイズまでスケールダウンします。 イメージは多くの場合、画面上よりも紙に印刷した方が品質が高くなります。 標準の画面サイズの場合は scalepercent="100" です。 fp:imagecell
fp:complexcell タグには以下のタグがあります。
表 2. fp:complexcell タグ
名前 説明
fp:newline 改行を挿入します。
fp:stringParam

fp:intParam

fp:checkboxParam

fp:*Param タグを評価した結果のプレーン・テキストを挿入します。
fp:text プレーン・テキストを挿入します。

ヘッダー属性

ヘッダー・タグには、2 つの必須属性と 2 つのオプションの属性があります。
表 3. fp:header の属性
属性 説明
cols 列の数とサイズを指定するための必須属性。例えば、3 番目の列が他の列より大きい 3 つの列を持つテーブルを作成するには、cols="30,30,40" と入力します。
height ヘッダーの高さを決定する必須属性。 この属性は PDF レポートにのみ作用します。 例えば、3 cm の高さを指定するには、height="100" と入力します。
ページ ヘッダーを使用するページを決定するオプションの属性。この属性には以下の値があります。
  • all: すべてのページでヘッダーが使用されます (デフォルト値)。
  • first: 先頭ページでのみヘッダーが使用されます。
  • left: すべての左ページでヘッダーが使用されます。
  • right: すべての右ページでヘッダーが使用されます。
ページ属性の設定には、以下の規則が適用されます。
  • 先頭ページでは page="first" を使用します。 他のページでは page="right" または page="all" を使用します。 これらのページが存在しない場合は、ヘッダーを使用しません。
  • 左ページでは、page="left" を使用します。 他のページでは page="all" を使用します。 これらのページが存在しない場合は、ヘッダーを使用しません。
  • 右ページでは、先頭ページを除き、page="right" を使用します。 他のページでは page="all" を使用します。 これらのページが存在しない場合は、ヘッダーを使用しません。
デフォルト値は all です。
percentwidth テーブル・ヘッダーの幅に作用するオプションの属性。 デフォルト値は 100 です。
このヘッダーは、サンプル fp:header タグを使用して PDF 文書に生成されます。
<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>

フィードバック