Utskrifter

På utskrifterna är det möjligt att lägga in eget sidhuvud samt så kan vissa typsnitt och färger anpassas.

Observera att fo-xml-kod är just fo-xml-kod och inte xsl-kod som ger fo efter en transformation.

Observera också det något märkliga upplägget att XMLen skrivs i en CDATA-tag och att XMLen måste omslutas av en root-tag. Det var tyvärr en liten intern teknisk begränsning tillsammans med en prestandaoptimering som ledde till detta format.

För mer information om hur denna kod skrivs, se http://xmlgraphics.apache.org/fop/

Det finns möjligheter att få in egen fo-kod med logik på godtyckligt ställe i utskrifterna, men detta kräver detaljerad kunskap om Boendekalkylens interna uppbyggnad och tas inte upp i detta dokument.

Exempel

Följande exempel ändrar den gråa bakgrunden under rubriken överst på alla sidor till grön. Den lägger också till en logga längst upp till vänster på sidan. Observera att XML-koden måste ligga i en CDATA och att XML-koden måste ha ett element som heter root.

Sökvägar till bilder med fo:external-graphic

Följande sökvägar hanteras av fo:external-graphics:

• absoluta sökvägar till filer i serverns filsystem, exempel:
  file:///c:/bilder/logga.jpg

• absoluta URLer, exempel:
  http://www.capitex.se/logga.jpg

• via applikationens klassladdare (tex fil inbäddad i en jar, fungerar from v2009.25), exempel:
  embedded:/test/logga.jpg

• fysiskt existerande fil relativt katalogen web-inf (fungerar from v2009.25), exempel:
  bilder/logga.jpg

Använda http-parametrar i fo-koden

I taggen sidhuvud så finns det stöd för att läsa in http-parametrar så att koden dynamiskt anpassas beroende på varifrån anropet kommer. Detta kan alltså användas på samma sätt som när plugins får tillgång till egna parametrar när boendekalkylen anropas via "fjärranrop över http".

Syntax:
<%=Namn på http-parameter%>

Exempel:

Resultat:
Antag att parametern EX.KONTOR skickas med vid anropet med innehållet "10" så kommer koden ovan efter inläsning att bli enligt följande:

På så sätt kan man få olika loggor på utskriften utan att för den skull behöva en egen konfigurationsfil för varje kontor.

Marginaler och sidstorlek (tillgängligt från v2010.1)

Förinställt används marginaler och sidstorlek i fo-koden enligt nedan, detta innebär att man vid anpassning av sidhuvud kan komma åt hela papprets yta. Det kan finnas anledning att ändra dessa marginaler och pappersstorlek, tex om man har en logga som är så stor att den inte får rum i utrymmet där vi lämnat plats för logga eller om man använder RTF-utskrifter och har problem med att skrivardrivrutinen klagar på för små marginaler. En annan anledning kan vara att man har helt egenutvecklade utskrifter på tex liggande A4.

Ovanstående marginaler ser i konfigurationsfilen ut enligt följande:

Om man vill komma runt problem med margina-klagomål när man skriver ut en RTF-variant av dokumenten från Word så kan man använda följande inställningar istället:

Övrigt

Som standard används utskrifter i PDF-format, men även HTML hanteras för kundspecifika utskrifter (beskrivningen ovan för anpassning av sidhuvud och sidfot gäller enbart FO-baserade utskrifter, dvs de utskrifter som genereras som PDF-dokument).

Användargränssnittet kan inte hantera FO/PDF-utskrifter och HTML-baserade utskrifter samtidigt (det kan däremot webservicen). Så ska utskrifter i HTML-format användas från boendekalkylens användargränssnitt så måste detta anges konfigurationsfilen med förljande inställning:

Som standard erbjuder vi inga utskrifter i HTML, så det är enbart då alla utskrifter är kundspecifika som denna inställning är aktuell, eller i testsyfte för att kunna testa de utskrifter som finns i HTML-format (utan att behöva göra webservice-anrop).

Handläggarnamn i Printdialogen

Om gränssnittet för att slå upp användarnamn implementeras så kommer handläggarnamnet att visas i print-dialogen. Om användaren av boendekalkylen inte ska kunna ändra detta handläggarnamn så sätt inställningen printdialog_skrivskydda_handlaggarnamn till true.