Document toolboxDocument toolbox

(sv) Objektsrapporter & Mallar

Owned by Maciej Zabielski
Last updated: Sept 12, 2024
5 min read

Since v3.7

Introduktion

Objektsrapporter kan användas för att exportera ett valt set med objekt. Objektsrapporter kan genereras i flera olika versioner.

  1. Generisk kalkylarksrapport - kan innehålla flera blad, ett per klass.

  2. Kalkylbladsrapport baserad på mall - designad för en viss objektklass och tillgänglig som "MS Excel" eller "Open Document" format. 

  3. PDF rapport baserad på kalkylarksmall (Baseras antingen på MS Excel eller Open Document).

  4. MS Word baserad på Word mall.


Rapporter från Sökning

Sökresultat kan exporteras som en rapport i ett av de tillgängliga formaten:

Rapporter från Grid View

Grid View flikar kan exporteras som vald rapporttyp:

Beroende på rapporttyp:

  1. Nuvarande flik kommer att ha XLS och PDF tillgängliga - båda kommer antingen vara generisk eller mall baserade, om mall definierats av systemadministratör.

  2. Alla flikar kommer bara att tillåta en generisk XLS rapport, då varje klass kräver olika blad att hålla dess metadata

  3. Valda poster - det här valet aktiveras när det finns några kontrollerade poster i gridvyn. Endast applicerbart på nuvarande fliken.

Mallar

En rapportmall kan användas för att skapa ett mer visuellt tilltalande resultat från objektsexporten. Vilket kalkylark som helst kan användas som mall. 

Format som kan användas som mallar:

  • Office Open XML Kalkylark (*.xlsx)

  • Open Document Format - Kalkylark (*.ods)

  • Office Open XML Document (*.docx)

Filen kan förberedas igenom att använda 3:dje parts mjukvara som

  • Microsoft Office

  • LibreOffice suite (gratis) som kan laddas ner här: https://www.libreoffice.org/

  • Annan mjukvara som kan producera kompatibla *.xlsx / *.ods / *.docx filer

Mallstruktur

Du kan designa din mall efter behov så länge du minns några viktiga regler:

  • Kalkylarket ska passa bra på en sida om du tänker skriva ut den eller använda den som bas i en PDF rapport.

  • I MS Excel, var vänlig använd Visa - Sidlayout för att bekräfta att innehållet inte går utanför valt sidformat.

  • Du kan lägga till vilken footer, header, logo eller annat som du vill ha.

  • För MS Word mallar, kan endast en tabell användas i bodyn. Extra tabeller kan användas i header/footer sektionerna.

  • För ODS stylesheets, finns det en till rad att fylla i: 'sample data row' (mer om denna rad i sista sektionen i paragrafen: Identyfing sample data row).Denna Prov Data rad, som är raden under header raden  ('header index + 1' row) ska innehålla datastil formatering med exempeltext. Om denna rad inte fylls i eller inte innehåller text med fyllnad och formatering, då kommer formateringen från header raden att ärvas. Detta kan leda till förvirring, så man måste komma ihåg att fylla i exempeldata raden celler med exempelformaterad text och fyllnad. För XLSX stylesheet behöver inte denna rad fyllas i. Det här valet rör ej MS Word mallar.

  • Nästa rad i mallen efter 'exempeldata raden' representerar Footer raden. Denna rads celler kan inkludera stylesheet funktions referenser (För ODS och XLSX stylesheets endast). Mer om den här raden i sista sektionen i paragrafen Identyfing sample footer row.

Lägga till datatabell:

  1. På någon plats i kalkylarket så kommer en datatabellen som fylls automatiskt att starta. Var god notera startindex då det måste matas in när man lägger in mallen i systemet.

  2. Skapa en header rad, du kan använda valfria färger eller formatera efter behov.

  3. Som kolumn headers, lägg in fältnamn som är tillgängliga för objektklassen som ska rapporteras, som visa nedan med "fi2space_name" och "fi2space_class".

  4. Sätt önskad bredd på kolumnen.

Rapporten kommer att genereras enligt den här layouten, endast valda kolumner kommer att användas. 

Special kolumner

För tillfället finns det en special kolumn i headern som kan användas, för att lägga in objektets sökväg.

För att lägga in sökvägskolumnen, i headern lägg till $path som header värde. 



Exempelmall för MS Excel:

Exempelmall för MS Word:

Begränsningar

Kalkylark / Excel

För Excel rapporter finns det inga kända begränsningar i mallkompatibiliteten.

Det finns en stor mängd alternativ och kombinationer som kan göras i XLS kalkylark, så vi kan inte garantera att alla möjligheter kommer att fungera som det skall.

Vid tveksamheter, börja med en enkel mall och bygg sedan på den gradvis till önskad effekt blir uppnådd.

PDF

PDF outputen har några kompatibilitetsproblem baserad på Office Open XML kalkylark (*.xlsx).

Ett av de kända problemen relaterar till bilder som finns i header sektionerna, som inte kommer vara synliga på PDF outputen om mallen var i *.xlsx format.

Om denna funktion önskas användas, skapa mallen som en Open Office fil. 

MS Word

Endast en tabell kan användas i mallens body. 

Mallhanterare

Mallhanteraren är ett verktyg tillgänglig för Systemadministratörer. Gå till administrationspanelen och välj Rapportmallar:



En mall kan laddas upp per klass och exporttyp. För att ladda upp en mall, använd "Ny" knappen och välj lämpliga alternativ:

  • Klass: en objektklass där den här mallen kommer användas

  • Typ: exporttyp för mallen. 

  • Header Index: ett radindex som indikerar var datatabellen börjar. Den här raden ska innehålla kolumner med klassfältnamnen.
    Header index för MS Word template, är ett radnummer i tabellen som innehåller data headern. Headern kommer att skapas på den här raden. Data kommer att sättas in i nästa rad.

  • Report Template: en mallfil att ladda upp



Identifiera header index:

Xlsx:

Docx:



Exempeldataraden

Nästa rad efter headerraden ska behandlas som en tom datarad. 

För ODF format ska denna rad innehålla datastil formatering med exempeltext. Om ingen stil anges, kommer formatering från headerraden att användas.

Det här kan skapa förvirring, så man måste komma ihåg att fylla den här radens celler med exempel formaterad text och fyllnadsval.



Sidfot

Raden under exempeldata raden kommer användas som sidfot. Den kan innehålla antingen enkel text eller en av de tillgängliga formlerna.

Var vänlig notera, mallar stödjer endast enkla, fördefinierade formler och inte vanliga stylesheed formler!



Mallformler måste anges i följande format: 

HDC prefix  ($HDC_) + 'function name'

Tillåtna funktioner är: COUNT, SUM och AVERAGE, så deras motsvarande referenser kommer att vara följande texter.

  • $HDC_COUNT

  • $HDC_SUM

  • $HDC_AVERAGE

 Formler kommer inte att lösas ut när dokumentet öppnas i endast läs läge. Redigering måste aktiveras innan beräkning sker.