Word i kommunens mall

Word i kommunens mall

kh-word

Bygger Word-filen i kommunens mall med logga och formatmallar.

När något ska lämnas som Word-fil, till exempel när användaren ber om Word, docx eller PDF, säger "gör om det här till Word" eller "lämna det som fil", eller när ett dokument, PM, protokoll, minnesanteckningar, en dagordning, en rapport, en tjänsteskrivelse eller ett brev ska bli en fil. Skillen innehåller byggskriptet som ger kommunens Word-mall med logotyp, sidhuvud och formatmallar, och den mall som passar varje sorts dokument. Den behövs därför för varje Word-fil, även när en annan instruktion bestämmer innehållet.

# Word-fil i kommunens mall

Du bygger Word-filer i kommunens Word-mallar med byggskriptet i den här skillen. Filen är en Word-fil (.docx) byggd på mallen, inte en markdown- eller textartefakt.

Skillen bestämmer bara utseendet. Vad dokumentet innehåller och i vilken ordning bestäms av uppgiften: av användarens underlag, av instruktionerna i övrigt eller av en annan skill som gäller för uppgiften. Skriv innehållet först och för sedan över det oförändrat hit.

## 1. Välj mall

- `enkel` (Enkel wordmall.dotx) är standard. Använd den för PM, minnesanteckningar, protokoll, mötesunderlag, dagordningar, rutiner, riktlinjer, informationsbrev och annan löpande text.
- `rapport` (Rapportmall Katrineholms kommun.dotx) använder du för längre rapporter med försättsblad, till exempel rapporter till en ledningsgrupp eller en nämnd.
- `skrivelse` (Skrivelse.dotx) använder du för tjänsteskrivelser och brev. Den har kommunens brevhuvud med datum, handläggare och mottagare.

## 2. Skriv innehållet

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

```python
{
  "mall": "enkel",
  "verksamhet": "Katrineholms kommun",
  "titel": "Dokumentets rubrik",
  "ingress": "En eller två meningar som sammanfattar dokumentet. Kan utelämnas.",
  "block": [
    {"typ": "rubrik", "niva": 2, "text": "Mellanrubrik"},
    {"typ": "stycke", "text": "Löpande text."},
    {"typ": "punkter", "punkter": ["En punkt", "En punkt till"]},
    {"typ": "numrerad", "punkter": ["Första steget", "Andra steget"]},
    {"typ": "tabell", "kolumner": ["Kolumn 1", "Kolumn 2"], "rader": [["a", "b"], ["c", "d"]]},
    {"typ": "faltlista", "falt": [["Berörd verksamhet", "Alla"], ["Version", "1"]]},
    {"typ": "sidbrytning"}
  ]
}
```

`verksamhet` står i sidhuvudet. Skriv förvaltningens eller verksamhetens namn om det framgår av uppgiften, och annars "Katrineholms kommun".

För mallen `rapport` lägger du till `"underrubrik"`, till exempel "Rapport till ledningsgruppen · 2026-10-20". Titeln och underrubriken hamnar på försättsbladet.

För mallen `skrivelse` lägger du till brevhuvudets uppgifter:

```python
{
  "mall": "skrivelse",
  "datum": "ÅÅÅÅ-MM-DD",
  "handlaggare": "Förnamn Efternamn",
  "telefon": "",
  "epost": "",
  "mottagare": ["Nämnden"],
  "titel": "Ärendets namn",
  "block": []
}
```

Regler för innehållet:
- `titel` blir dokumentets huvudrubrik (formatmallen Heading 1). Mellanrubriker har `niva` 2, 3 eller 4.
- I mallen `rapport` betyder `niva` 1 ett kapitel, som alltid börjar på ny sida. Använd det bara i rapporter längre än ungefär fem sidor. I kortare rapporter är avsnittsrubrikerna nivå 2.
- `faltlista` är en tabell med två kolumner, fältnamn och värde. Använd den för fälten överst i rutiner och riktlinjer och för bakgrundsuppgifter i blanketter.
- En tabell med sex kolumner eller fler lägger hela dokumentet på liggande A4, även försättsbladet i en rapport. Dela inte upp en tabell för att den ska få plats.
- Skriv ren text i alla fält. Använd inte markdown, fetstil med asterisker eller egna radbrytningar.
- Uppgifter som saknas lämnar du tomma eller skriver som [uppgift saknas: vad]. Hitta inte på något för att fylla mallen.

## 3. Så byggs filen

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

1. Läs filen `referens/byggskript_word.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 mallen och filen som ska skapas finns.
2. Skapa en artefakt med mime_type `application/vnd.intric.word`. 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 hämtar mallen, byter ut sidhuvudets platshållare, tar bort mallens exempeltext och kontrollerar resultatet.
4. Ge artefakten en titel som beskriver innehållet.

Mallarna ligger under assistentens Kunskap → Filer, och skriptet hittar dem på filnamnet. Saknas mallen avbryts bygget med ett fel som visar vilka mallar som finns. Säg då vilken mall som behöver laddas upp och lämna innehållet som text i chatten.

Ber användaren om PDF bygger du Word-filen och säger att den sparas som PDF i Word med Arkiv → Spara som. Bygg inte en PDF på annat sätt, eftersom den då inte får kommunens utseende.

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 text i chatten. Skapa inte en fil i ett annat utseende som ersättning.

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