Hälytysviestit howto

HÄLYTYSVIESTIT

Actiweb osaa lähettää mm. hälytyksistä viestin sähköpostilla, 
joka voidaan kääntää laitteen sisäisesti myös esimerkiksi tekstiviestiksi.

Jos viesti halutaan lähettää sähköpostilla, täytyy tehdä seuraavat asetukset:

	* Luo halutut ja tarvittavat hälytysryhmät
	
	* Jaa hälytyspisteet käyttämään haluttuja hälytysryhmiä
	
	* Asettele hälytysryhmään vastaanottajat

	
System -> email settings sivulla:
	
	* Lähettäjän osoite
	
	* Aseta email hälytykset päälle (enabled)
	* Aseta lähtevän postin palvelin, esimerkiksi: smtp.gmail.com
	
	* Jos palvelin käyttää kirjatumista, aseta käyttäjänimi ja salasana, 
	 sekä käännä "Login required" vipu päälle.
	
	* Jos palvelin käyttää salausta, aseta palvelimen portti 
		TSL 587 (googlen palvelin toimii tällä) 
		SSL 465

	HUOM! Kun käytetään googlen tiliä, n.s. turvattomat laitteet pitää joskus sallia.

Häiriöitä viestien lähettämisessä voi tutkia "Sytem > Log files > E-mail log" sivulla.

Hälytysryhmät:

Parametreilla enableToAlarmEvent, enableToNormalEvent ja enableAckEvent määritellään, 
luodaanko ryhmään kuuluvissa hälytyksissä tapahtumia kun hälytyspiste menee hälytykselle, 
palaa normaalitilaan tai kun se kuitataan.

pv tarkoittaa hälytysryhmän tilaa. Tämä tila määrittää, mitä vastaanottajalistaa ryhmä käyttää hälytysviestejä lähettäessä.

receiverList on lista vastaanottajista. Tämä lista koostuu itse asiassa kahdesta tasosta, 
eli tähän listaan voidaan mahduttaa useampia vastaanottajalistoja, joiden välillä vaihdetaan 
ryhmän pv arvon mukaisesti. 

Hälytysviestien pohjissa voidaan voidaan käyttää "tägejä" eli merkkijonoja jotka korvautuvat 
lähetetyssä viestissä hälytyskohtaisilla tiedoilla.
 
Nämä tägit muistuttavat html tägejä, ja niidem "nimi" on sama kuin hälytyspisteen kentällä, 
eli jos haluat näyttää viestissä hälytyksen kellonajan, lisää viestipohjaan tägi

	<ALARMDATE>

huomaa että tietokantapisteen kenttä on kirjoitettu tägissä aina SUURILLA kirjaimilla.

Mikäli haluat lisätä viestiin jonkin kentän hälytysryhmästä, voit periaate on sama, 
mutta tägiin tulee lisätä eteen "G_", eli hälytysryhmän kuvaustekstin saa 
hälytysviestiin kirjoittamalla tägin

	<G_DESCRIPTION>
	
kun itse hälytyspisteen kuvausteksti on <DESCRIPTION>.

On olemassa kaksi tägiä jotka eivät suoranaisesti ole tiekantapisteen kenttiä:
 
	<ID>			hälytyspisteen nimi
	
	<TRANSITION>	Tila johon hälytyspiste siirtyi
	

Hälytysviestin protokolla: 

Protokolla tai laite jonka kautta hälytysviesti lähetetään, 
määrittyy hälytysryhmässä olevan vastaanottajan osoitteen perusteella.

Tarkemmin sanottuna, kun viestin vastaanottajaa määritetään hälytysryhmässä, 
on osoite (recipientList -> recipients -> address) oikeasti URL. 

sähköpostiosoitteen pitkä muoto:
	email://vastaanottaja@hostname.fi

ja SMS viestin puhelinnumeron pitkämuoto:
	sms://+358231234123
	
..mutta, jos osoite kenttä sisältää vain '+' ja numeroita, se tulkitaan 
puhelinnumeroksi, tai jos se muistuttaa sähköpostiosoitetta 
(sisältää . ja @ merkit) mutta UIRL skeemaan ei ole määritelty, 
se tulkitaan sähköpostiosoitteeksi.

Muita viestinlähetysmuotoja:

	rut://[puh numero]		Teltonikan HTTP/GET tekstiviesti toiminto
							muista tehdä asetukset /sys/settings/smsOverHttp 
							pisteeseen.

                            Operaattori saattaa vaatia puhelinnumeron annettavaksi maakoodin kanssa, esim. +358. 
                            Tällöin asian tekee mielenkiintoiseksi se, että sekä viesti, että 
                            puhelinnumero lähetetään URL enkoodauksen läpi. Tämä tarkoittaa sitä, 
                            että '+' merkki tulkitaan välilyönniksi. 
                            Lisäksi, ennen lähetystä puhelinnumerolle tehdään dekoodaus, 
                            joten + merkki täytyy dekoodata "tuplasti" eli % merkki vielä erikseen: 
                            Näin puhelinnumerosta +358501231234 
                            tulee %252B358501231234 (eli + merkin tilalla %252B) 
                            ja koko vastaanottajasta rut://%252B358503875050

							Huomaa! Tekstiviestin lähetys GET rajapinnan läpi EI TOIMI
							teltonikan ohjelmistoversiossa RUT9XX_R_00.06.05.3

							
	relay://[ipOsoite]		Jatkohälytysten välittäminen CPU yksiköiden välillä.
							Ketjun seuraava laite käsittelee viestin 
							käyttäen samannimisen hälytysryhmän asetuksia kuin 
							viestin alunperin lähettänyt CPU.
							
							URL parametrilla ?group=[ryhmanNImi] voi valita
							mitä hälytysryhmää vastaanottava CPU käyttää
							hälytyksen käsittelyyn.