Definiera enkel rapportmall

Detta ämne beskriver de objekt som måste definieras för att skapa en giltig mall. Exempelmallen Enkel rapport (EX_RT101), som är en enkel rapportmall med endast ett blad och ett område, används för att illustrera processen. Mer komplexa mallar beskrivs i följande kapitel.

Grundläggande begrepp för en inmatnings- eller rapportmall:

• blad: Excel-arbetsbokens blad

• område: del av ett blad där en specifik uppsättning data visas

• definitionskolumn: kolumner som anger vilka data som visas på raden, till exempel kontokod, enhetsnamn

• datakolumn: kolumner som visar faktauppgifter, till exempel euro, stycken eller procentsatser

• dimension: dataklassificeringsfaktorer som används för att begränsa de data som hämtas (till en rad, kolumn eller hela mallen)

Det första du måste göra när du skapar en ny mall är att planera datainnehållet och layouten. Exempelmallen visar faktiska siffror för två månader och förändringen mellan månaderna. Följande illustration visar hur detta ser ut när det öppnas i Clausion.

Arbetsbok

Arbetsboken ser ut på följande vis:

Den har följande namngivna celldefinitioner:

Färgläggningen i arbetsboken visas endast för tydlighetens skull och påverkar inte mallens funktionalitet.

I exempelmallen Enkel rapport (EX_RT101) matas rapporthuvudet (i cell A1) in i arbetsboken med hjälp av inmatnings- och rapportmallvariabler som får sina värden från användarens val när rapporten öppnas. Cellerna A1:E1 slås samman för att centrera texten över rapportens bredd.

Kolumnrubriker definieras i XML-filen och det är därför vi inte anger kolumnrubriker i definitionskolumnerna A och B.

I datakolumnerna C till E anger vi kolumnrubrikerna "1", "2" och "3" för tydlighetens skull. De kommer att skrivas över av de rubriker som definieras i XML-filen när rapporten öppnas i Clausion.

Definitionskolumner, datakolumner, område och ACCCODE-definitioner

Arbetsboken måste innehålla de blad och områden som definieras i XML-filen och de måste ha samma namn som används i XML-filen. Ytterligare blad och områden i arbetsboken kommer att ignoreras.

För att arbetsboken och XML-filen ska fungera tillsammans måste kolumn A i dataområdet namnges med samma namn som områdesnamnet i XML-filen.

Använd inte skandinaviska tecken i namnet. Detta kommer att orsaka ett fel när mallen öppnas.

På grund av stödet för ett ökat antal rader och kolumner i .xlsx-formatet är vissa namn ogiltiga för områden. Till exempel är TO1 en giltig cellreferens i .xlsx-formatet och därför ogiltig som ett namn för ett område.

Cellen på den första raden i Area1 efter den sista datakolumnen måste heta ACCCODE1 (observera tre C i ACCCODE1).

Det definierade området måste innehålla kolumner som motsvarar de definitions- och datakolumner som specificeras i XML-filen. Kolumnerna A och B är definitionskolumner som visar kontokod respektive namn. Kolumnerna CE är datakolumner som visar siffrorna för december och november och differensen mellan dem.

Exempelmallen Enkel rapport (EX_RT101) dataområdet, kallat Area1, består av cellerna A3:E6.

Även om området sträcker sig över flera kolumner i arbetsboken definieras det i namnhanteraren som A3:A6.

De specificerade dimensionerna:

• konto för definitionskolumnerna AB

• år, månad, datatyp och dokumentserier för datakolumnerna CD

År, månad, datatyp, dokumentserier och enhet väljs av användaren när rapporten öppnas. Kolumn E begränsas inte direkt av dimensionsval utan beräknas från de andra datakolumnerna.

Raduppsättningar

Raduppsättningar är deluppsättningar av inmatnings- eller rapportmallsrader. De kan användas för att visa en fördefinierad kombination av rader i inmatnings- eller rapportmallen. Raduppsättningar är bladspecifika. Om inmatnings- eller rapportmallen innehåller flera blad måste du definiera raduppsättningar separat för alla blad som du vill använda dem på.

I exempelmallen Enkel rapport (EX_RT101) finns tre raduppsättningar. Kolumnerna omedelbart efter ACCCODE-kolumnen är för raduppsättningar (kolumnerna G till I).

1. Lägg till så många kolumner som du behöver. Raduppsättningar måste namnges på den första raden i området (Items, Sum och All). Detta namn visas som raduppsättningsnamn i rullgardinsmenyn Raduppsättning i inmatnings- eller rapportmallen. Samma namn används på alla språk.

2. Nästa tomma kolumn markerar slutet på raduppsättningskolumner.

3. Skriv ett tecken (till exempel X) på de rader som du vill inkludera i raduppsättningen. Alla tecken utom specialtecken är tillåtna. Samma rad kan ingå i flera raduppsättningar.

   Du kan också definiera raduppsättningar med formler, inklusive IF-formler som gör det möjligt att skapa raduppsättningar dynamiskt i genererade mallar. I genererade mallar kopieras raduppsättningar till alla genererade block. I mallar av typen retrievefromdata måste formeln kopieras till så många rader som du förväntar dig ska vara det maximala antal datarader som hämtas på mallen. 

När du definierar en raduppsättning för ett blad lägger programmet till alternativet Grundraduppsättning i rullgardinsmenyn. Den innehåller alla rader och är standardraduppsättningen. Du kan ändra standardraduppsättningen i användargränssnittets uppgiftsinställningar. Det är också möjligt att definiera om användare ska kunna ändra raduppsättningen.

• Raduppsättningar kan inte användas i inmatningsmallar för 20 000- och 70 000-dokumentserier, mallar med ökad detaljnivå, TR-mallar, anpassade mallar eller externa arbetsböcker.

• Funktionen "Dölj nollrader" fungerar i kombination med raduppsättningar. Om"Dölj nollrader" är inställt för bladet döljs alla nollrader även om de ingår i den markerade raduppsättningen.

• Rubrikrader för områdena visas alltid.

• Rader som inte finns med i något område (inklusive tomma rader) påverkas inte av raduppsättingsinställningarna.

• Raduppsättningar med formler baserade på en genererad datakolumn fungerar inte.

• ACCCODE-namngivningen i mallen måste följa bladens ordning: ACCCCODE1 i första bladet, ACCCODE2 i andra bladet och så vidare.

• Om det finns flera områden på bladet måste de innehålla samma antal kolumner (summan av definitionskolumner och datakolumner). Annars fungerar inte raduppsättningar för områdena.

Språkversioner

Du kan lägga till språkversioner för alla definitionskolumner, samt titelrader som ingår i områden som definieras i inmatnings- och rapportmallar.

Språkversioner kan endast användas i mallar av typ "predefined", inte i mallar av typ "retrievefromdata" (kontogenerering). Observera dock att språkversioner inte kan användas i kontogenereringsmallar, eftersom de kontorader som genereras för att mata in kontogenereringsdata ("delområden") är av typen "retrievefromdata" även om mallen i sig är av typen "predefined". För mer information, se beskrivningen av parametern presentationtype i Clausion Input and Report Template Parameters. Det språk som används i mallen beror på användarens aktiva språk.

1. Efter den sista raduppsättningskolumnen lämnar du minst en tom kolumn före översättningskolumnerna. Om raduppsättningar inte används, lämna en tom kolumn efter ACCCODE-kolumnen. Du kan lägga till så många översättningskolumner som du behöver.

2. I den första översättningskolumnen läggs namnet TRANSLATIONS1 till i cellen på samma rad som ACCCODE1-definitionen:

   I menyn Formler i Excel, använd funktionen Definiera namn och lägg till namnet TRANSLATIONS1 i cellen. Mer information om hur du använder funktionen finns i Microsoft Excel-dokumentationen.

3. För alla översättningskolumner lägger du till följande definition på rubrikraden: <språkkod som används i systemet>_(understreck)<bokstav i destinationskolumnen för översättningen> (den definitionskolumn för vilken översättningen görs). Till exempel: EN_B.

   I detta fall visas de texter som lagts till i en kolumn som definieras som EN_B i kolumn B (den andra kolumnen i bladet) när applikationens aktiva språk är engelska.

Observera följande:

• Om en översättning ingår i ett blad åsidosätter den all annan befintlig text i motsvarande definitionskolumn i bladet.

• Om ingen översättning har lagts till men motsvarande definitionskolumn innehåller text, visas definitionskolumnens text i inmatnings- eller rapportmallen.

• Om ingen översättning har lagts till och motsvarande definitionskolumn inte innehåller text hämtas kontonamnen från kontoplanen baserat på kontokoden. För dimensioner hämtas dimensionsenhetsnamnet från systemet baserat på enhets-ID.

• Om rubriker definieras i XML-definitionsfilen åsidosätter de översättningar som definieras i Excel-filen.

• Endast de rader som ingår i de områden som definieras på bladet översätts.

Kolumnerna (K:L) i exempelmall Enkel rapport (EX_RT101) definieras för språkversioner ("EN_B" och "FI_B") även om inga översättningar har angetts. Användningen av språkversioner illustreras i exempelmallen Språkversioner (EX_RT102) som skiljer sig från Enkel rapport endast genom att språkversioner är inskrivna i arbetsboken.

I Språkversioner (EX_RT102) har språkversioner för kontonamnen lagts till i mallarbetsboken i kolumnerna K och L.

Språkversioner som matas in i arbetsboken kommer att visas i kolumn B i den öppnade mallen.

Formler i arbetsbok

Formler kan definieras i arbetsboken eller i XML-definitionsfilen. Om du definierar en formel i arbetsboken måste du också lägga till vissa inställningar i XML-definitionsfilen som indikerar att kolumnen är beräknad. Se följande exempel.

Om du definierar formler både i XML och i arbetsboken för samma kolumn åsidosätter formeln i arbetsboken formeln i XML-definitionsfilen.

Exempel XML-definitioner

Om du vill att data ska sparas med formeln måste du ställa in värdet för elementet <datacolumn><settings><save> till "yes".

Exempel: Rapporteringskolumn med en formel i arbetsboken

Exempel: Inmatningskolumn med en formel i XML

Om du vill att data ska sparas med formeln måste du ställa in värdet för elementet <datacolumn><settings><save> till "yes".

Exempel: Rapporteringskolumn med en formel i XML

För mer information om XML-struktur, element och attribut, se Clausion Input and Report Template Parameters.

I exempelmallen Enkel rapport(EX_RT101) kan formler till kolumn E matas in för att beräkna ändringen från en månad till en annan, men genom att definiera formeln i XML-filen behöver de bara matas in en gång.

Låsta och olåsta celler

För att förhindra datainmatning i andra celler än de som avses i en inmatningsmall, lås upp inmatningscellerna och lås de andra cellerna i området. Att skydda bladet är inte nödvändigt eftersom Clausion skyddar det när mallen öppnas.

XML-fil

Innehållet i XML-definitionsfilen kan karakteriseras som lådor i lådor. Den yttre lådan definieras först, och inom den finns mindre lådor, som i sin tur kan innehålla egna mindre lådor. På XML-språket kallas dessa "lådor" element.

Följande illustration visar XML-filens "lådor" som definierar ett område på en mall.

• Area: Området namnges, ett id anges och dess typ anges. Områdesnamnet måste vara detsamma som i Excel-arbetsboken.

  • Settings: definitioner för hela området görs

    • Basicareasettings: definitioner som främst påverkar områdets utseende

    • Customareasettings: endast i anpassade mallar

    • Subtotals: kan användas med radgenerering

  • Definitioncolumns: definitioner av vilka data som visas på rader, till exempel konton och/eller enheter

    • Definitioncolumn: vilket attribut för innehållet som visas i den här kolumnen, till exempel kontokod, enhetsnamn

    • Generates: anger hur radinnehåll skapas i radgenererande mallar

  • Datacolumns: kolumner där faktauppgifter visas, till exempel euro, stycken eller procentsatser

    • Generates: anger hur kolumninnehåll skapas i kolumngenereringsmallar

    • Headers: definierar datakolumnrubriker

    • Settings: detaljer om hämtning av data i vissa speciella fall

    • Datacolumn: datainnehåll i en kolumn

I Clausion kan till exempel en del av en XML-definitionsfil som definierar ett område se ut som i följande illustration.

Utöver definitionerna av områden och deras underelement finns det definitioner som ska göras för blad, arbetsbok och för mallen i allmänhet.

Följande illustration visar XML-filens 'lådor' som omger områdeslådorna.

• FPM: standardinnehåll för mallens tekniska funktionalitet, innehåll som inte visas i XML-redigeraren

  • Document: standardinnehåll för mallens tekniska funktionalitet, innehåll som inte visas i XML-redigeraren

    • Settings: definitioner i vissa speciella fall av mallar

      • Data: endast i anpassade mallar

      • Transparentreportsettings: endast i TR-mallar

    • Workbooks: standardinnehåll för mallens tekniska funktionalitet, innehåll som inte visas i XML-redigeraren

      • Workbook: standardinnehåll

        • Settings: specifikationer som påverkar hela arbetsboken (det vill säga alla blad och områden i mallen)

        • Sheets: "låda" som omger definitioner av enstaka blad, om det gäller en mall för flera blad kan det finnas vissa definitioner här

          • Sheet: ett id ges till bladet

            • Settings: bladet namnges, dess typ specificeras och inställningar görs som huvudsakligen påverkar bladets utseende. Bladnamnet måste vara detsamma som i Excel-arbetsboken.

            • Areas:"låda" som omger definitioner av enskilda områden, i vilken ordning områden visas på bladet specificeras här

I inmatnings- och rapportmallsuppgiften kan till exempel en del av en XML-definitionsfil som omsluter områdeselement se ut som i följande illustration.

När den öppnas i en redigerare utanför Clausion skulle en del av XML-definitionsfilen se ut som i följande illustration.

Arbetsboks-, arbetsblads- och områdesinställningar

Detta ämne beskriver grundläggande XML-definitioner som behövs i de flesta mallar. XML-utdragen är från exempelmallen Enkel rapport(EX_RT101).

De första elementen i XML-filen är alltid desamma. Det första elementet att uppmärksamma är drilldowndefinition. Denna definition anger hur fönstret ska se ut när du ökar detaljnivå för siffror i rapportkolumner. Specifikationerna lagras i en separat mall och namnet på den här mallen är vad som sägs i drilldowndefinition-inställningen. Vi använder en standarddefinitionsfil BW_DT101 för ökad detaljnivå. Type-attributet är alltid file.

Därefter definieras bladets ID och inställningarna. ID:t används för att referera till bladen i en arbetsbok om det finns flera bladmallar. I exempelmallen Enkel rapport(EX_RT101) finns endast ett blad men av tekniska skäl måste id ändå anges.

Bladnamnet måste vara detsamma som bladnamnet i arbetsboken. Bladtypen (type) är report eftersom den här mallen är en rapport (och inte till exempel en inmatningsmall eller en anpassad mall).

Attributen pageorientation och fittopages är valfria och har lagts till här som exempel på vanliga inställningar.

När det gäller bladet måste även området ha id, typ (type) och namn (name) Namnet måste vara samma som områdesnamnet i arbetsboken. Areaorder anger i vilken ordning områden beräknas på blad med flera områden. I exempelmallen Enkel rapport(EX_RT101) finns endast ett område men av tekniska skäl måste områdesordningen (area order) specificeras. Detta görs genom att ange områdena i beräkningsordning med hjälp av parametern listitem.

Presentationtype anger om innehållet i definitionskolumner är definierat i arbetsboken (predefined) eller konstrueras när mallen öppnas (retrievefromdata).

Basicareasettings styr hur valutakonvertering utförs och hur positiva och negativa siffror visas för olika kontotyper.

Tecken med debet- och kreditsiffror

Varje konto är antingen ett debetkonto eller ett kreditkonto. Utseendet på debet- och kreditsiffror på inmatnings- och rapportmallar beror på användningen av show_dk-parametrar i malldefinitionerna. Olika show_dk-parametrar används för resultatkonton, balanskonton och andra konton.

Nedan visas ett exempel på standardfallet när parametern show_dk inte används i inmatnings- eller rapportmalldefinitionsfilen. För mer information och exempel på parameteranvändning, se Clausion Input and Report Template Parameters.

Standardfall

Som standard (om parametern show_dk inte används i inmatnings- eller rapportmalldefinitionsfilen) visas siffror på inmatnings- och rapportmallar så som de visas i databasen multiplicerat med kontots D/C-kod (debet +1 eller kredit -1).

Dokumentserietyper och konton

Standardtecken på mallar

*Koncerninterna objekt multipliceras med -1 när de sparas till databasen. Koncerninterna objekt multipliceras också med -1 när de hämtas från databasen till en inmatningskolumn (till en kolumn med definitionen type=input), men inte när de hämtas från databasen till en rapportkolumn (till en kolumn med definitionen type=report).

Definitionskolumner

Under definitioncolumns (pluralis) specificeras innehållet i de enskilda definitionskolumnerna (parametern definitioncolumn (singularis)) i den ordning som dessa kolumner visas på arbetsbladet.

I exempelmallen Enkel rapport (EX_RT101) finns två kolumner, den första för kontokod och den andra för kontonamn. Kolumn-ID kan vara vilket alfanumeriskt värde som helst. För tydlighetens skull har förklarande ID givits i Enkel rapport eftersom kolumnerna till skillnad från tabeller och områden saknar parametern name. Kolumnrubriken som ska visas i mallen och dimensionen i fråga specificeras för varje kolumn. Dimensionen anges med parametern dimensiontype. För att få kontokoden i den första kolumnen specificerar vi presentationproperty som udid och för kontonamn i den andra kolumnen ställs presentationproperty in på name. udid är koden som talar om vilken post (till exempel konto och enhet) i dimensionen (till exempel konton, dim00-dim09 och dokumentserier) som ska hanteras.

Datakolumner

Under datacolumns (pluralis) specificeras innehållet i de enskilda datakolumnerna (parametern datacolumn (singularis)) i den ordning som dessa kolumner visas på arbetsbladet. Kolumn-ID kan vara vilket alfanumeriskt värde som helst.

För varje datakolumn definieras följande:

• headers: rubriker att visa på den öppnade mallen

• dimensions: dimensioner med vilka data i kolumnerna begränsas

• settings och datafield: inställningar och datafältparametrar som specificerar hur data hanteras

 Om det finns parenteser i värdet datacolumn ID (datakolumnidentifiering) kommer värdet type för elementet dimension inte att visas i mallhanteringen även om det har definierats korrekt och är synligt på nästa nivå i XML-trädet.

När parenteserna tas bort från värdet datacolumn ID visas värdet dimension type som vanligt.

Definitionerna för dimensions specificerar att data som hämtas till de första datakolumnerna begränsas av fyra dimensioner i enlighet med följande:

• Data kommer att vara från den månad (finper) som användaren väljer när hen öppnar mallen (%PERIOD CODE%). För mer information om alla tillgängliga inmatnings- och rapportmallsvariabler, se Clausion Input and Report Template Parameters.

• Data kommer att komma från den datatyp som användaren väljer när hen öppnar mallen (%DATA TYPE CODE%).

• Data kommer att vara från det år (finyr) som användaren väljer när hen öppnar mallen (%YEAR CODE%).

• Data kommer att komma från dokumentserien som användaren väljer när hen öppnar mallen (%DOCUMENT ADVANCED CODES%).

Andra definitioner:

• headers: kolumnrubriken kommer att vara namnet följt av månadsnummer inom parentes

• settings

  • save = no: data i denna kolumn kommer inte att sparas till databasen. I en rapportmall är denna parameter inte nödvändig men i en inmatningsmall är det relevant att ange vilka kolumner som ska sparas och vilka som endast visas som referens.

  • scaling: data från databasen divideras med den faktor som användaren väljer när mallen öppnas (%USERSCALINGFACTOR%).

  • datafield: den här kolumnen är numerisk (inte en kommentarskolumn till exempel) och för rapportering (inte för att mata in data).

  • numeric:

    • amount: definierar om beloppen i kolumnen är i enhets- eller koncernvaluta.

    • period: definierar huruvida uppgifterna i kolumnen är periodiska eller kumulativa. I detta fall avgörs detta av användaren när rapporten öppnas (%PERIOD REPRESENTATION%).

Den andra datakolumnen definieras på liknande sätt som den första, endast definitionen finper skiljer sig åt. Variabeln %PERIOD CODE-1% används här för att indikera att data kommer att vara från månaden före den som användaren väljer när mallen öppnas.

Variabler med ett minustecken (eller plustecken) och en siffra är endast i begränsad omfattning giltiga i definitioner. För mer information, se Clausion Input and Report Template Parameters.

Den sista datakolumnen beräknas som differensen mellan de två andra kolumnerna:

• datafield

  • type: formulas visar att detta är en beräknad kolumn

  • formulas: innehåller definitionerna av formler i datakolumnen

    • formula: definierar en beräkningsregel. Hänvisning till andra kolumner görs med deras ID (id).

      • type: denna parameter måste ha värdet all

  • numeric parametern behövs inte i kolumnen formula