Visa sidanHistorikTillbakalänkarTill början av sidan Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan. <markdown> # 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. </markdown> fabrikatspecifikt/alliance.txt Senast uppdaterad: 2026/08/06 08:39av dokuadmin