Larm — Utöka¶
E-postnotifieringar¶
För att skicka larmnotifieringar via e-post måste en SMTP-server konfigureras. Det kan göras i WideQuick® Designer före driftsättning eller i WideQuick® Runtime på ett körande system.
Konfigurera SMTP i WideQuick® Designer¶
- I projektträdet, högerklicka på noden Mail och välj Egenskaper....
- Ange serveruppgifterna.
Konfigurera SMTP vid körning¶
Klicka på Konfigurera i SMTP-sektionen i statuspanelen Larm - Schema, eller anropa System.mailManager.edit() från ett skript eller en knappåtgärd.
| Fält | Beskrivning |
|---|---|
| Avsändare | Avsändarens e-postadress |
| Avsändarnamn | Visningsnamn för avsändaren |
| Server | SMTP-serveradress eller IP, till exempel smtp.gmail.com |
| Port | Serverport |
| Domän | Serverdomän |
| Användare | Kontots användarnamn |
| Lösenord | Kontots lösenord |
E-postalias¶
Aliassystemet kopplar ett kort nyckelord till en eller flera e-postadresser. Alias kan väljas när mottagare läggs till i ett notifieringsschema, vilket gör det enklare att hantera mottagargrupper centralt.
Alias hanteras i dialogen Redigera e-postinställningar tillsammans med SMTP- konfigurationen.
Anpassa e-post¶
E-postnotifieringen byggs upp som ett rent textmeddelande. Layouten och innehållet kan
anpassas genom att redigera funktionen writeMail() i skriptet scAlarmSender.
Standardformatet för e-post ser ut så här:
---------------------------------------------------------------------------
| Schedule: My Schedule
| Subject: My Subject
| Event: Alarm acknowledged (active)
---------------------------------------------------------------------------
| ------------------------------------------------------------------------
| | Name: AS01.Station1_PV01_IO
| |
| | Timestamp: 2026-05-29 12:00:00
| |
| | Alarm class: 1
| |
| | Alarm text: My alarm text
| |
| | Description: My alarm description
| |
| | Acknowledged by: Operator
| ------------------------------------------------------------------------
|
---------------------------------------------------------------------------
Beskrivning tas bara med när larmet har en beskrivning, och Kvitterad av bara när en användare är känd. När schemat reagerar på alla händelser skrivs raden Händelse för varje larm i stället för i huvudet.
Varje rad i e-posten byggs upp genom att text läggs till en meddelandevariabel med +=.
Det innebär att integratören kan ändra etiketter, lägga till nya rader med ren text eller
ta bort rader som inte behövs. För att till exempel ändra etiketten Larmklass till
Prioritet, lokalisera följande rad i funktionen writeMail():
msg += "| | " + Language.translate("Translations.klib", "Larmklass") + ": " + alarm.severity + "\n"
Och ändra den till:
Etiketterna går genom Language.translate(), så en etikett kan också ändras utan att
skriptet redigeras, genom att dess översättning ändras. Se
Redigera enskilda översättningar.
En översättning gäller överallt där samma källtext används.
De tillgängliga larmfälten som kan inkluderas i meddelandet är:
| Fält | Beskrivning |
|---|---|
alarm.name |
Larmets namn |
alarm.timestamp |
Datum och tid då händelsen behandlades för notifieringen. För en kvittering ligger den nära tiden för kvitteringen, inte när larmet utlöstes |
alarm.severity |
Larmklass |
alarm.text |
Larmtext |
alarm.description |
Larmbeskrivning. Tom om larmet saknar beskrivning |
alarm.eventType |
Händelsen: active, acknowledged, unacknowledged eller inactive |
alarm.username |
Användaren bakom händelsen, om den är känd |
alarm.active |
true om larmet är aktivt |
Ren text kan också läggas till fritt var som helst i meddelandet. För att till exempel lägga till en sidfot, lägg till följande rad före den avslutande avgränsaren:
SMS-notifieringar¶
SMS-notifieringar skickas via ett modem anslutet till WideQuick-värden via en seriell COM-port. Det kan vara ett traditionellt GSM-modem eller en 4G-router. Alla enheter som accepterar AT-kommandon via en seriekoppling är kompatibla.
Alternativt kan SMS skickas via en Teltonika-router med Teltonika-pluginet. Pluginet
kommunicerar med routerns REST API över nätverket i stället för via en seriell anslutning,
och skickar SMS för samma larmnotifieringsscheman. Pluginet kopplar in sig i scAlarmSender,
så att SMS skickas via routern i stället för via GSM-modemet. Det fungerar endast i Windows och
kräver licensen WideQuick Advanced med optionen .NET-plugin, eller en Premium-licens.
Se Skicka SMS med Teltonika.
Konfigurera modemet¶
Modemet konfigureras i WideQuick® Runtime. Navigera till
Inställningar → Avancerade inställningar → GSM Modem och klicka på Ändra GSM inställningar
för att öppna konfigurationsdialogen. De avancerade inställningarna kräver privilegiet Debug.
När GSM är påslaget kan dialogen även öppnas med Konfigurera i avsnittet SMTP och GSM
i Larm - Schema.
Ange anslutningsparametrarna från enhetens datablad:
| Fält | Beskrivning |
|---|---|
| Com port | Seriell port som modemet är anslutet till |
| Baudrate | Kommunikationshastighet |
| Databitar | Antal databitar |
| Stoppbitar | Antal stoppbitar |
| Paritet | Paritetsinställning |
| Flödeskontroll | Flödeskontrollmetod |
| Pin | SIM-kortets PIN, om det krävs |
Klicka på Spara. Om konfigurationen är korrekt lyser indikatorn GSM-modem aktivt grönt. Själva GSM slås på och av med reglaget GSM Modem på samma ruta i Inställningar.
Krav
SMS-notifieringar kräver att scModem körs utöver scAlarmSender.
Anpassa SMS¶
SMS-notifieringen följer samma mönster som e-posten och kan anpassas genom att
redigera funktionen writeSMS() i skriptet scAlarmSender. Samma larmfält är
tillgängliga. Etiketter kan ändras eller ren text läggas till på samma sätt.
Standardformatet för SMS ser ut så här:
Schedule: My Schedule
Title: My Subject
Event: Alarm acknowledged (active)
Name: AS01.Station1_PV01_IO
Timestamp: 2026-05-29 12:00:00
Alarm class: 1
Alarm text: My alarm text
Description: My alarm description
Acknowledged by: Operator
Med Kompakt läge påslaget för schemat innehåller SMS:et bara rubriken och, för varje
händelse, namnen på de larm som matchar. Ett schema vars kolumn sms_truncated är satt
till 1 skickar bara antalet nya larm. Det alternativet har ingen inställning i vyerna.
För att till exempel ändra etiketten Namn till Signal, lokalisera följande rad
i funktionen writeSMS():
msg += Language.translate("Translations.klib", "Namn") + ": " + Language.translate("Translations.klib", alarm.name) + "\n"
Och ändra den till:
msg += "Signal: " + Language.translate("Translations.klib", alarm.name) + "\n"
Note
Håll SMS-meddelanden korta. De flesta GSM-modem har en teckengräns per meddelande, och långa meddelanden kan delas upp i flera delar eller trunkeras.
Fjärrlarmsammanställning¶
Larm från anslutna fjärrsystem kan sammanställas i den lokala larmlistan. Se Fjärrlarm i guiden Fjärrsystem för installationsanvisningar.


