Excel enligt kommunens profil

Excel enligt kommunens profil

kh-excel

Bygger kalkylbladet i kommunens profil, med räknande formler.

När något ska lämnas som Excel-fil eller kalkylblad, till exempel när användaren ber om Excel eller xlsx, eller när en kalkyl, budgetuppställning, nyttokalkyl, sammanställning av nyckeltal, uppföljningslista eller handlingsplan ska gå att räkna eller arbeta vidare i. Skillen innehåller byggskriptet som ger kommunens typsnitt, färger, talformat och räknande formler. Den behövs därför för varje Excel-fil, även när en annan instruktion bestämmer innehållet.

# Excel enligt kommunens grafiska profil

Du bygger Excel-arbetsböcker med byggskriptet i den här skillen. Filen är ett kalkylblad (.xlsx), inte en tabell i chatten eller en text- eller markdown-artefakt. Kommunen har ingen Excel-mall, så skriptet följer den grafiska profilen på samma sätt som kommunens Word-mall: rubriken i kommunens typsnitt och färg, och neutrala tabeller.

Skillen bestämmer bara utseendet. Vad arbetsboken innehåller bestäms av uppgiften, av användarens underlag eller av en annan skill som gäller för uppgiften.

## 1. Skriv innehållet

Innehållet skrivs som en Python-ordlista i `INNEHALL`, i det här formatet:

```python
{
  "verksamhet": "Förvaltningens namn om det framgår, annars tom",
  "blad": [
    {
      "namn": "Nyttokalkyl",
      "titel": "Nyttokalkyl – namnet på satsningen",
      "undertitel": "Vad kalkylen avser och vilken period",
      "kolumner": [
        {"namn": "Post", "format": "text"},
        {"namn": "Timmar per år", "format": "tal"},
        {"namn": "Timkostnad", "format": "kr"},
        {"namn": "Belopp per år", "format": "kr"},
        {"namn": "Källa", "format": "text"}
      ],
      "rader": [
        ["Frigjord tid", 1200, 430, "=B7*C7", "Antagande"],
        ["Färre resor", 0, 0, 85000, "Underlag från enhetschef"]
      ],
      "summera": ["Timmar per år", "Belopp per år"],
      "noter": ["Förklaring av antaganden och beräkningssätt."]
    }
  ]
}
```

Regler för innehållet:
- Ett blad per tabell. Bladnamnet får vara högst 31 tecken.
- `format` är `text`, `tal`, `decimal`, `kr`, `kr2` (med ören), `procent` eller `datum`. Procent skrivs som decimaltal, 0,25 för 25 procent.
- Skriv tal som tal, inte som text, så att Excel kan räkna med dem.
- En cell som börjar med `=` blir en formel. Använd formler för allt som räknas fram ur andra celler, så att användaren kan ändra ett antagande och se resultatet. Rubrikraden hamnar på rad 5 när bladet saknar undertitel och på rad 6 när det har en, och första dataraden är raden efter. Formler skrivs på engelska med komma mellan argumenten, till exempel `=SUM(D7:D9)`.
- `summera` lägger till en summarad för de kolumner du anger.
- `noter` hamnar under tabellen. Skriv antaganden, källor och beräkningssätt där.
- Siffror som inte finns i underlaget hittar du inte på. Lämna cellen tom och skriv i noterna vad som saknas.

## 2. Så byggs filen

Gör alltid så här, i den här ordningen:

1. Läs filen `referens/byggskript_excel.py` i den här skillen. Det är ett färdigt byggskript. Kör det inte i sandlådan: det fungerar bara som innehåll i en artefakt, där filen som ska skapas finns.
2. Skapa en artefakt med mime_type `application/vnd.intric.spreadsheet`. Artefaktens innehåll är byggskriptet, kopierat i sin helhet.
3. Byt bara ut värdet på `INNEHALL` överst i skriptet mot det verkliga innehållet. Ändra ingenting under linjen "Ändra ingenting under den här linjen". Koden där sätter typsnitt, färger, talformat, sidhuvud och utskriftsformat.
4. Ge artefakten en titel som beskriver innehållet.

Överst på varje blad står "Katrineholms kommun" och, om du har angett den, verksamheten. Förhandsvisningen i Intric visar inte talformaten och kan visa "[object Object]" i celler där en formel blir 0. Den nedladdade filen räknar och visar rätt i Excel. Säg det om användaren undrar.

Skriv aldrig ett eget byggskript och bygg aldrig filen på något annat sätt. Misslyckas bygget visar du felmeddelandet och lämnar innehållet som tabell i chatten. Skapa inte en fil i ett annat utseende som ersättning.

Skillbiblioteket ai-hubben.se · kh-excel v1.0 · 2026-10-20