E-postformat för Alliance-larm

Det här dokumentet beskriver det exakta e-postformat som krävs för larmkällor av typen Alliance för att accepteras. Om ett inkommande e-postmeddelande inte följer detta format exakt avvisas det.

Obligatorisk ämnesrad (Subject)

Subject: Priority: <nummer> <Active|Inactive>

Ämnesraden måste börja med den exakta texten Priority: (skiftlägesokänsligt). Om den inte gör det avvisas mailet direkt - brödtexten läses inte ens.
Efter Priority: ska det finnas exakt två ytterligare ord, separerade med mellanslag:
1. Ett prioritetsnummer (t.ex. 2)
2. Ett statusord - måste vara exakt Active eller Inactive (skiftlägesokänsligt). Alla andra ord (t.ex. "Kvarstår", "Larm", "Cleared", "Reminder" osv.) känns inte igen och mailet avvisas.

Giltiga exempel:

Priority: 2 Active
Priority: 2 Inactive
Priority: 1 Active

Ogiltiga exempel (avvisas som "Decoding Failure"):

B-Larm Kvarstår          <- börjar inte med "Priority:"
Priority 2 Active        <- kolon efter "Priority" saknas
Priority: 2 Kvarstår     <- statusordet är inte Active/Inactive
Priority: Active         <- prioritetsnumret saknas

Obs: det finns inget "påminnelse"-format / "kvarstår"-format. Vissa larmpaneler skickar ett återkommande uppföljningsmail medan ett larm fortfarande är okvitterat (på svenska ofta formulerat som "... Kvarstår"). Alliance-formatet har ingen motsvarighet till detta - det finns inget tredje statusord för "kvarstår", "påminnelse" eller liknande. Om den sändande panelen/relän genererar den här typen av påminnelsemeddelande måste det antingen stoppas innan det når larmmottagaren, eller formateras om så att det återanvänder någon av de två statusar som stöds (Active / Inactive) innan det skickas.

Teckenkodning i ämnesraden

Håll ämnesraden i rent ASCII (Priority: 2 Active) - den behöver aldrig icke-ASCII-tecken och bör därför aldrig skickas som ett MIME-kodat ord.
Om ert mailsystem ändå kodar ämnesraden (t.ex. för att samma "mall" återanvänds för andra, icke-ASCII-ämnesrader) är det bara dessa två kodade format som förstås och avkodas automatiskt:
- =?ISO-8859-1?Q?...?=
- =?UTF-8?B?...?= (Base64)
=?UTF-8?Q?...?= (UTF-8 quoted-printable) avkodas inte. Om ämnesraden kommer in i det formatet jämförs den som den råa, kodade strängen, kommer aldrig börja med Priority:, och mailet avvisas. Det här är det vanligaste sättet som en till synes "korrekt" ämnesrad ändå misslyckas, så undvik icke-ASCII-tecken i ämnesraden helt och hållet.

Obligatorisk brödtext

Första raden i brödtexten (som ren text) måste vara:

<Larmpunkt>/<Beskrivning>

Allt före det första /-tecknet blir larmets Larmpunkt (punkt-/objekt-ID).
Allt efter det första /-tecknet blir larmets Beskrivning.
Bara första raden i brödtexten läses in - eventuella ytterligare rader ignoreras.
larmpunkten städas upp automatiskt: mellanslag, kolon, kommatecken, punkter, *, ? och ' ersätts med _, och inledande/avslutande understreck tas bort. Ni behöver inte städa larmpunkten i förväg, men undvik att förlita er på att dessa tecken ska betyda något särskilt i larmpunktnamnet.

Giltigt exempel:

FLK2/Larm GT21

Ger: Larmpunkt: FLK2, Beskrivning: Larm GT21

Också giltigt (flera snedstreck - bara det första delar upp fälten):

1269_01_TA301_GT81_L/Frysskydd utlöst

Ger: Larmpunkt: 1269_01_TA301_GT81_L, Beskrivning: Frysskydd utlöst

Ogiltigt (snedstrecket saknas):

LB06-Filter Larm

Här finns inget /, så hela raden tolkas som larmpunkten och beskrivningen blir tom (eller tvärtom, beroende på innehåll) - inkludera alltid /-tecknet.

Teckenkodning i brödtexten

Content-Type bör ange den faktiska teckenkodningen som används, t.ex.:
```
Content-Type: text/plain; charset=UTF-8
```
Överföringskodningar (Content-Transfer-Encoding) som stöds:
- Vanlig text (ingen Content-Transfer-Encoding-header, eller 7bit/8bit)
- Base64
quoted-printable som överföringskodning packas inte upp för brödtexten - specialtecken (å, ä, ö, é med flera) kan komma igenom som bokstavliga =XX-sekvenser i beskrivningen istället för det riktiga tecknet. Om ert mailsystem stödjer det, föredra att skicka brödtexten som ren 8-bitars UTF-8 istället för quoted-printable, så blir beskrivningarna läsbara.

Komplett exempel (accepteras)

From: Testhuset <larmkalla@exempel.se>
To: driftlarm@exempel.se
Subject: Priority: 2 Inactive
Date: Mon, 29 Jun 2026 22:59:33 GMT
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-transfer-encoding: quoted-printable

FLK2/Larm GT21

Resultat: Larmpunkt FLK2, Beskrivning Larm GT21, Prioritet 2, Status Inactive (larmet återställt). Accepteras.

Komplett exempel (avvisas, verklig incident)

From: Testhuset <larmkalla@exempel.se>
To: driftlarm@exempel.se
Subject: =?UTF-8?Q?B-Larm_Kvarst=C3=A5r?=
Date: Wed, 05 Aug 2026 09:15:46 GMT
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-transfer-encoding: quoted-printable

LB06-Filter/Larm

Resultat: Decoding Failure. Ämnesraden börjar inte med Priority: (och skickas dessutom som ett =?UTF-8?Q?...?=-kodat ord som inte stöds), så mailet slängs innan brödtexten ens läses in - inget larm skapas för punkten LB06-Filter, och ingen får veta att ett B-larm fortfarande kvarstår.