Alarm template#

Starting from version 9.95 it is possible to format email and SMS alarms.

Setup:

  • Create template file AlarmTemplate-xx.txt, where xx is 01..10

  • Copy file to Data folder.

  • Select file to alarm device. If none is selected format is same as it used to be.

One file may contain template for email and SMS message. Email message starts after line EMAILDATA and SMS message starts after line SMSDATA

At start of file you can define three settings for email message:

Variable values as described below may be used also in these settings.

Alarm event causes text in file to be sent. It is possible to embed one or more variable parts into text. Variable parts are defined by commands that are located between two # characters.

Max length of email alarm is 1000 and SMS 160.

If alarm is transferred via link substation, formatting is made in station where alarm was created.

All point commands may refer to alarming point or to fixed point. e.g. - command #POINTVALUE=TK01_TE05_M# displays value of TK01_TE05_M. - command #POINTVALUE# displays value of alarming point.

Since versions 11.50.37 and 12.20.13 it has been possible to add data from text file at the end of email message. #ATTACHMENT=Datawatchdog.txt#

Sends watchgod.txt file from data folder.

Commands#

Following commands are available.

Properties of any point type#

POINTNAME

Name of the point If you want to display only part of point name it may done: Use command format POINTNAME:xx:yy Characters between xx and yy ar displayed. If xx is empty everything up to yy is displayed. If yy is empty .everything from xx to end is displayed.

e.g. pointname is 010_AHU01_TE13_M Command POINTNAME:010_:_M displays AHU01_TE13

POINTVALUE

Point value / state If you want to display only part of point name it may done: Use command format POINTNAME:xx xx characters from start of value are displayed.

Version 9.97 has new function If you don’t accept normal state text from point you can define: POINTVALUE:0=text:1=text:default=all other values

Version 9.99 has new function for alarm points If you don’t accept normal state text from point you can define: POINTVALUE:0=normaltext:1=alarmtext:10=normal unacknowledged:11=alarm unacknowledged

Version 10.01 has new function for alarm point POINTVALUE field 100=acknowledge event

Version 10.25 has new function for alarm point POINTVALUE field

value=numeric

Point value is printed as number.

POINTLOCKSTATE

Lockstate of point

POINTTEXT

Text of point

PICTURELINK

Link to picture where point is displayed.

e.g. http://10.10.15.210/Report?File=Fx2020.htm&StartPage=Alarms.htm

e.g. If “domain login” is used in Fx http://10.10.15.214?10.10.15.210&StartPage=Alarms.htm

PICTURENAME

Name of picture where point is displayed. e.g. Alarms.htm

Properties of alarm point only#

ALARMPRIORITY Priority number

ALARMNUMBER Point number

ALARMGROUP Alarm group

ALARMACKSTATE Acknowledged / Unacknowledged

ALARMVALUE Current and previous state of point

Properties of substation#

STATIONNAME Name of substation

IPADDRESS IP address

MAC MAC address of network interface

PUBLICIP

Public IP address of substation - works only if substation can connect to support.fidelix.fi

PUBLICNAME

Public DNS name of substation - works only if substation can connect to support.fidelix.fi - one IP address may have several DNS names and this property shows one of them

Date /Time#

DATETIME Date and time in Finnish format e.g. 24.12.2009 17:31:50

YYYY Year in four digits

YY Year in two digits

MM Month in two digits

M Month in one or two digits

DD Day of month in two digits

D Day of month in one or two digits

TIME Time e.g. 23:55:59

Swedish format 2009/4/28 is #YYYY#/#M#/#D#

Example#

subject=Alarm message from #stationname#
sendername=Fx2025
senderemail=test.name@gmail.com

EMAILDATA
Pointname:     #pointname#
State:         #pointvalue#
Lockstate:     #pointlockstate#
Text:          #pointtext#
Link-1:        #picturelink#
Link-2:        http://10.10.15.214?Fx213&StartPage=#picturename#
Link-3:        http://10.10.15.213/Report?File=Fx2020.htm&StartPage=#picturename#

Priority:      #alarmpriority#
Alarmnumber:   #alarmnumber#
Alarmgroup:    #alarmgroup#
Ackstate:      #alarmackstate#
Alarmstate:    #alarmvalue#

Name of Fx:    #stationname#
IP address:    #ipaddress#
MAC:           #mac#
Public IP:     #publicip#
Public name:   #publicname#

Date:          #datetime#

Temperature:   #pointvalue=HOME_OUTDOORTEMPERATURE_M#

SMSDATA
#pointname#
#alarmvalue#
#ipaddress#