SQL Analytics - Hur man skapar egna widgets i Kleer

Hur man skapar egna widgets i Kleer

Introduktion

Denna guide är ett komplement till databasdokumentationen och produktbladet.

För att kunna skapa widgets i Kleer behöver du som användare ha behörigheten “Ekonomiansvarig”. För behörighetsfrågor, prata med din ansvariga redovisningskonsult.

Widgets-gränssnittet i Kleer använder i grunden samma databas som SQL-Analytics. Widgets är ett sätt att visualisera tabeller som är genererade från SQL-frågor. Widgets-gränssnittet i Kleer har därför en massa inbyggd funktionalitet för att styra på vilket sätt tabellen visualiseras, och syftet med denna guide är att förklara hur dessa funktioner fungerar.

Uppsättning

Sätt upp en egen miljö för att testa

Om man vill testa att skapa widgets så rekommenderar vi att man skapar en ny “Dashboard” på vilken man kan lägga sina widgets. På så sätt kan man behörighetsstyra vem som ska kunna se de widgets som man bygger. En dashboard kan behörighetsstyras till en eller fler behörigheter i Kleer.

För att skapa en ny dashboard så klickar man på de tre punkterna, längst upp i högra hörnet på framsidan i Kleer.

När man ska skapa egna widgets så kan man välja mellan två olika typer:

Graf – använder widget-gränssnittets funktionalitet för att visualisera en tabell
Tabell – visar rådata från tabellen så som den är

“Behörighet för att se widgeten” och “Visas på följande dashboards” används för att styra vem som ska kunna se widgeten och vart (på vilken dashboard) den ska synas. Om man vill utgå från en existerande widget så kan man välja denna under “Utgå från mall”.

Det finns tre olika typer av grafer:

Diagram
Tårtdiagram
Pivotdiagram

Diagram visualiseras som grafer med en X- och en Y-axel. Tårtdiagram visualiseras som ett cirkeldiagram och pivottabeller använder etiketter och olika dataserier för att jämföra och visualisera data.

Första kolumnen i resultatet används som etikett för värdena som väljs i följande kolumner och kan vara av valfri datatyp. I ett diagram innebär detta i praktiken att första kolumnen blir X-axeln och följande kolumner blir dataserier som kan användas för att visualisera staplar, linjer eller area.

Följande kolumner som väljs används som värden för de dataserier som visas i grafen. Dessa kolumner/dataserier måste vara numeriska. Kolumnens valda namn visas som namn på dataserien i grafen. Ju fler kolumner som resultatet innehåller, desto fler dataserier visas i grafen.

Dataserier och enhet

Typ av dataserie kan läggas till under “Typ av dataserier”. I ett diagram innebär det att den andra kolumnen får den första typen av dataserie som läggs till. Efter det kan man lägga till en ny dataserie för den tredje kolumnen och så vidare.

Enhet deklarerar vilken typ av data som varje dataserie innehåller. Logiken för deklareringen är densamma som för dataserier — den andra kolumnen får den första enheten, den tredje kolumnen får den andra enheten och så vidare.

Enhet	Beskrivning
Numerisk	Visar värdena från SQL-datan obearbetade. Ex: `120` visas som `120`.
Valuta	Visar alla värden från SQL-datan dividerat med 100. Anledningen är att monetära siffror sparas i ören i databasen. Ex: `12000` visas som `120 SEK`.
Procent	Multiplicerar alla värden från SQL-datan med 100, vilket omvandlar en decimalform till procentform. Ex: `0,15` visas som `15 %`.

Färg följer samma logik som “Typ av graf” och enhet: den första färgen tilldelas data i andra kolumnen, den andra färgen tilldelas kolumn tre och så vidare. “Grupperade serier” innebär att data i samma etikett visas ovanpå varandra — om etiketten (X-axeln) är månader kommer alla staplar som har samma månad visas ovanpå varandra.

Dynamiska parametrar

För att underlätta byggandet av widgets finns ett antal fördefinierade parametrar som kan användas för att skapa dynamiska widgets. En lista på alla parametrar återfinns på informationssymbolen vid “Typ”.

Följande konventioner behöver följas för att SQL-frågan ska kunna användas för att hämta data till widgeten:

Första kolumnen i resultatet används som etikett för värdena som väljs i följande kolumner och kan vara av valfri datatyp, t.ex. datum eller sträng.
Följande kolumner som väljs används som värden för de dataserier som visas i grafen och måste vara av numerisk datatyp. Kolumnens valda namn visas som namn på dataserien i grafen. Ju fler kolumner som resultatet innehåller, desto fler dataserier visas i grafen.

I övrigt finns ett antal parametrar som kan användas i SQL-frågan:

Parameter	Beskrivning
`startOfYear`	Första dagen i kalenderåret
`endOfYear`	Sista dagen i kalenderåret
`startOfAccountingYear`	Första dagen i valt räkenskapsår
`endOfAccountingYear`	Sista dagen i valt räkenskapsår
`startOfMonth`	Första dagen i innevarande månad
`endOfMonth`	Sista dagen i innevarande månad
`endOfMonthOrAccountingYear`	Sista dagen i innevarande månad eller valt räkenskapsår, det som är först
`startOfTwelveMonthsAgo`	Första dagen i månaden för 12 månader sedan
`startOfSixMonthsAgo`	Första dagen i månaden för 6 månader sedan
`sessionUserId`	Id för användaren som kör frågan

Begränsningar

Widgets i Kleer kan inte direkt exporteras till PDF, Excel eller externt system för vidare bearbetning. En widget är menad att visas i webbgränssnittet när man är inloggad i Kleer.

Inte all data i Kleer är exponerad. Anledningen är att den tillgängliga databasen ska vara användarvänlig och inte bli för komplex. Vid behov kan ytterligare exponeringar göras.

Saknas data i databasen? Kontakta din ansvariga konsult på Kleer.