Ylä- ja alatunnisteiden tunnisteet

Voit määrittää raporttimallipohjan ylä- ja alatunnisteet käyttämällä tunnisteita fp:header ja fp:footer.
Ylä- ja alatunnisteiden tunnisteilla on samankaltaisia toimintoja, ja molemmissa tunnisteissa käytetään korkeusmääritettä: Ylä- ja alatunnistejoukkojen on vastattava toisiaan. Jos esimerkiksi fp:header-määritteen sivun arvoksi asetetaan left (vasen), fp:footer-määritteen sivun arvoksi on asetettava left (vasen).

Ylätunnisteiden tunnisteet

Jos mallipohjassa ei ole fp:header-tunnisteita, ylätunniste ei näy raportissa. Ylätunniste on taulukko, joka sisältää joukon soluja. Ylätunnisteiden tunnisteiden määrän on oltava sarakkeiden määrän kerrannainen. Jos cols-määrite määrittää, että sarakkeita on kolme, fp:header-määritteen tunnisteiden määrän on oltava 3, 6, 9, 12 ja niin edelleen.
Jokainen fp:header-tunniste määrittää ylätunnisteen solun:
  • fp:cell tai fp:textcell: Sisältää pelkkää tekstiä. Nämä tunnisteet voivat luoda solun, joka sisältää tekstin "Hello world": <fp:textcell>Hello world</fp:textcell>
  • fp:imagecell: Sisältää kuvan. Kuva luetaan tiedostosta, joka on sijoitettava kansioon .../Program Files/Focal Point/tool/images. Kuvat voivat olla joko GIF- tai JPG-muodossa, esimerkiksi <fp:imagecell filename="myimage.jpg" />. Jos fp:imagecell-tunniste on ylätunnisteen ensimmäisellä rivillä tai ensimmäisessä sarakkeessa, se ei ehkä näy kunnolla.
  • fp:complexcell: Sisältää joukon tekstejä. Teksti voi sisältää pelkkää tekstiä tai stringParam-parametrin avulla määritetyn merkkijonoparametrin, jonka laji on type="template/runtime/never/fetch". Tämä tunniste on ainoa fp:*-solutunniste, jolla on omat tunnisteet. Lisätietoja tästä tunnisteesta on fp:complexcell-tunnistetaulukon kuvauksessa.

Solutunnisteilla fp:* on seuraavat määritteet:

Taulukko 1. Ylätunnisteiden tunnisteiden määritteet
Nimi Kuvaus Soveltuva tunniste
filename Pakollinen määrite, joka määrittää kuvan sisältävän tiedoston nimen. fp:imagecell
align Valinnainen määrite, joka määrittää vaakatasauksen. Arvo voi olla left (vasen), right (oikea) tai center (keskitys). Oletusarvo on left (vasen). fp:textcell ja fp:complexcell
border Valinnainen määrite, joka määrittää solun reunuksen. Reunuksen arvon kokonaissumma on kaikkien reunusten arvojen summa. Oletusarvo on 0.
Solun reunuksilla voi olla esimerkiksi seuraavat arvot:
  • Yläreunus: 1
  • Alareunus: 2
  • Vasen reunus: 4
  • Oikea reunus: 8
Jos haluat piirtää soluun yläreunuksen sekä vasemman ja oikean reunuksen, aseta reunuksen arvo seuraavasti: 1+4+8=13:border="13"
Kaikki fp*-solutunnisteet
colspan Valinnainen määrite, joka määrittää, kuinka moneen taulukon sarakkeeseen solu ulottuu. Kun käytetään colspan-määritettä, tarvittavien solujen määrää koskevat tiedot eivät ole oikeita. Esimerkiksi määrite colspan="2" tarkoittaa kahta solua. Oletusarvo on 1. Kaikki fp*-solutunnisteet
headingstyle Valinnainen määrite, joka määrittää solussa käytettävät otsikkotyylit. Oletusarvo on Normal. Kaikki fp*-solutunnisteet
scalepercent Valinnainen määrite, joka määrittää kuvan mittakaavan. Oletusarvo on 100. Saavutat parhaimman tuloksen, kun luot kuvan, joka on noin viisinkertainen lopulliseen kuvaan verrattuna. Pienennä kuva sen jälkeen lopulliseen kokoon. Paperille tulostetut kuvat ovat usein laadukkaampia kuin näytössä näkyvät kuvat. Käytä normaalikokoisessa näytössä asetusta scalepercent="100". fp:imagecell
Tunnisteella fp:complexcell on seuraavat tunnisteet.
Taulukko 2. Tunnisteet fp:complexcell
Nimi Kuvaus
fp:newline Lisää rivinvaihdon
fp:stringParam

fp:intParam

fp:checkboxParam

Lisää tavallisen tekstin, joka on tuloksena fp:*Param-tunnisteen arvioimisesta
fp:text Lisää tavallisen tekstin

Ylätunnisteiden määritteet

Ylätunnisteiden tunnisteilla on kaksi pakollista ja kaksi valinnaista määritettä.
Taulukko 3. Tunnisteen fp:header määritteet
Määrite Kuvaus
cols Pakollinen määrite, joka määrittää sarakkeiden määrän ja koon. Jos haluat luoda esimerkiksi kolmisarakkeisen taulukon, jonka kolmas sarake on muita sarakkeita suurempi, anna arvot cols="30,30,40"
height Pakollinen määrite, joka määrittää ylätunnisteen korkeuden. Tämä määrite vaikuttaa vain PDF-raportteihin. Jos haluat, että ylätunnisteen korkeus on esimerkiksi kolme senttimetriä, anna arvo height="100"
page Tämä valinnainen määrite määrittää sivun, jolla ylätunnistetta käytetään. Tällä määritteellä on seuraavat arvot:
  • all: Ylätunnistetta käytetään kaikilla sivuilla (oletusarvo)
  • first: Ylätunnistetta käytetään vain ensimmäisellä sivulla
  • left: Ylätunnistetta käytetään kaikilla vasemmanpuoleisilla sivuilla
  • right: Ylätunnistetta käytetään kaikilla oikeanpuoleisilla sivuilla
Seuraavat säännöt koskevat sivumääritteen asettamista:
  • Käytä ensimmäisellä sivulla määritettä page="first". Käytä muutoin määritettä page="right" tai page="all". Jos näitä sivuja ei ole, älä käytä ylätunnistetta.
  • Käytä vasemmanpuoleisilla sivuilla määritettä page="left". Käytä muutoin määritettä page="all". Jos näitä sivuja ei ole, älä käytä ylätunnistetta.
  • Käytä muilla oikeanpuoleisilla sivuilla kuin ensimmäisellä sivulla määritettä page="right". Käytä muutoin määritettä page="all". Jos näitä sivuja ei ole, älä käytä ylätunnistetta.
Oletusarvo on all.
percentwidth Valinnainen määrite, joka vaikuttaa taulukon ylätunnisteen leveyteen. Oletusarvo on 100.
Tämä ylätunniste on luotu PDF-asiakirjaan fp:header-mallitunnisteen avulla.
<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>

Palaute