Gå till innehållet

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

  1. I projektträdet, högerklicka på noden Mail och välj Egenskaper....
  2. Ange serveruppgifterna.

Mail properties dialog

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.

Edit mail settings

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():

writeMail() function in scAlarmSender script — before
msg += "| | " + Language.translate("Translations.klib", "Larmklass") + ": " + alarm.severity + "\n"

Och ändra den till:

writeMail() function in scAlarmSender script — after
msg += "| | Priority: " + alarm.severity + "\n"

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:

writeMail() function in scAlarmSender script
msg += "| Sent from WideQuick\n"

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.

GSM modem settings

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():

writeSMS() function in scAlarmSender script — before
msg += Language.translate("Translations.klib", "Namn") + ": " + Language.translate("Translations.klib", alarm.name) + "\n"

Och ändra den till:

writeSMS() function in scAlarmSender script — after
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.