Pomoc dla uytkownikw systemu Asix 8

www.asix.com.pl

Modu AsAlert

System powiadamiania o wanych zdarzeniach

Dok. Nr PLP8076
Wersja: 2015-01-20

AsAlert

ASKOM i Asix to zastrzeone znaki firmy ASKOM Sp. z o. o., Gliwice. Inne wystpujce w tekcie znaki
firmowe bd towarowe s zastrzeonymi znakami ich wacicieli.
Wszelkie prawa zastrzeone. Nieautoryzowane rozpowszechnianie caoci lub fragmentu niniejszej publikacji
w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metod kserograficzn, fotograficzn lub inn
powoduje naruszenie praw autorskich niniejszej publikacji.
ASKOM Sp. z o. o. nie bierze adnej odpowiedzialnoci za jakiekolwiek szkody wynike z wykorzystywania
zawartych w publikacji treci.
Copyright 2015, ASKOM Sp. z o. o., Gliwice

ASKOM Sp. z o. o., ul. Jzefa Sowiskiego 13, 44-121 Gliwice,

tel. +48 (32) 3018100, fax +48 (32) 3018101,
http://www.askom.com.pl, e-mail: biuro@askom.com.pl

Spis treci
1 AsAlert - system powiadamiania o wanych zdarzeniach.......................................... 2
1.1 Wsppraca AsAlert z systemem alarmowo-telefonicznym firmy Ascom ................. 3
2 Struktura moduu AsAlert ................................................................................... 8
3 Konfiguracja moduu AsAlert ............................................................................. 10
3.1 Autoryzacja dostpu do AsAlerta ................................................................... 12
3.2 Konfiguracja baz danych .............................................................................. 13
3.3 Parametryzacja moduw komunikacyjnych .................................................... 22
3.3.1 Modu komunikacji poczty elektronicznej (SMTP) ........................................ 24
3.3.2 Modu komunikacji OAP .......................................................................... 25
3.3.3 Modu komunikacji SMS (GSM) ................................................................ 26
3.4 Konfiguracja do pracy sieciowej .................................................................... 27
4 Uruchamianie i zatrzymanie AsAlerta .................................................................. 28
5 Wysyanie alertw ........................................................................................... 29
6 Przegldanie wysanych alertw ......................................................................... 30
7 Sprzenie AsAlerta z systemem alarmw Asix.Evo .............................................. 32
8 Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa .......................... 34
8.1 Format alertu ............................................................................................. 34
8.2 Parametryzacja sprzgu .............................................................................. 34
8.3 Program konfiguracyjny ............................................................................... 36
8.4 Wysyanie alertw sprzonych ..................................................................... 38
9 Programowy dostp do funkcji AsAlert ................................................................ 46
9.1 AsAlert jako system Automation ................................................................... 46
9.2 Obiekt Alerter ............................................................................................ 46
9.3 Obiekt alert ............................................................................................... 47

1 AsAlert - system powiadamiania o wanych

zdarzeniach
Zadaniem systemu alertowania jest zdalne powiadamianie wybranych osb o wanych
zdarzeniach. Komunikaty mog dociera do adresatw jako poczta elektroniczna
(email) lub jako komunikat SMS sieci GSM. Oba rodzaje przesyek mog by
przekazywane z wy korzystaniem rnych metod przesyu - zarwno p oprzez In ternet,
jak i sie komrkow GSM. Sprzenie systemu wysyania alertw z mechanizmem
generowania alarmw Asixa pozwala na automatyczne wysyanie alertw w reakcji na
wykrycie zmiany stanu wybranych alarmw.
Do wysyki alertw z zastosowaniem rnych mediw i metod transmisji su moduy
komunikacyjne. Ich zakres funkcjonalny obejmuje midzy innymi:

wysyk alertw w postaci poczty elektronicznej poprzez Internet i protok

SMTP,

wysyk alertw w postaci komunikatw SMS do urzdze odbiorczych sieci

komrkowej (np. telefony komrkowe) poprzez sie GSM,

wysyk alertw z wykorzystaniem protokou OAP lub dedykowanego protokou

firmy Kontel dla urzdze Ascom.

System alterowania funkcjonuje w strukturze klient - serwer. Aplikacje klienckie

dajce wysyki alertw mog pracowa na stacjach sieciowych. Poczenie z
AsAlertem uzyskuj po pomylnym zweryfikowaniu przez system AsAlert ich praw
dostpu (w tym celu AsAlert utrzymuje list nazw uytkownikw wraz z ich hasami).
Wszelkie informacje dotyczce uytkownikw, adresatw oraz wysyanych informacji
przechowywane s w relacyjnych bazach danych. Standardowo obsugiwane s bazy
Microsoft Jet (pliki MDB) i Microsoft SQL.

1. AsAlert - system powiadamiania o wanych zdarzeniach

1.1 Wsppraca AsAlert z systemem alarmowo-telefonicznym

firmy Ascom
Modu AsAlert moe by wykorzystywany do rozsyania alertw za
porednictwem systemu alarmowo-telefonicznego firmy Ascom. System ten daje
moliwo przesyania alarmw na telefony uytkownikw z dowolnych systemw
w zakadzie. Dziki systemowi automatycznej eskalacji Ascom daje 100%
pewno, e alarm dotrze do waciwej osoby w najkrtszym moliwym czasie
oraz e osoba odbierze alarm i podejmie odpowiednie dziaania. Jeeli pracownik
nie zareaguje na alarm, system automatycznie przesya wiadomo do kolejnych
pracownikw
lub
informuje
przeoonego.
System
daje
moliwo
zaprogramowania dowolnych scenariuszy powiadomie, w zalenoci od
problemu.
Komunikacja pomidzy moduem AsAlert a systemem Ascom odbywa si za
porednictwem protokou OAP (1 wariant) lub dedykowanego protokou firmy
Kontel (2 wariant).
W przypadku 1 wariantu (AsAlert - OAP - Ascom) komunikacja odbywa si na
sieci LAN za pomoc TCP i znacznikw XML, gdzie serwer OAP znajduje si po
stronie systemu Ascom a system zewntrzny jest klientem. Do jednego serwera
OAP moe by podpitych do 50 klientw. Poniej schemat komunikacji dla
wariantu A sAlert - OAP - Ascom. AsAlert posiada zaimplementowany protok
OAP umoliwiajcy komunikacj z telefonami bezprzewodowymi systemu Ascom.
Serwer OAP przekazuje wiadomo wysan przez aplikacj klienck (AsAlert) do
protokou uywanego przez system alarmowo-telefoniczny (Ascom IP-DECT
system).
Wariant AsAlert - OAP - Ascom wymaga: serwera OAP oraz systemu Ascom IPDECT, dostarczanych przez firm Kontel.

AsAlert

Rys. Komunikacja pomidzy moduem AsAlert a bezprzewodowym systemem

alarmowo-telefonicznym Ascomm (wariant z OAP).
rdo: Opracowane na podstawie materiaw Ascom/Kontel.

W pr zypadku 2 wariantu (AsAlert - protok Kontel - Ascom) komunikacja

odbywa si w sieci LAN za pomoc TCP i znacznikw XML, gdzie serwer Unite
znajduje si po stronie systemu Ascom, a system zewntrzny jest klientem. Do
jednego serwera Unite moe by podpitych do 5 klientw.
Poniej schemat komunikacji dla wariantu AsAlert - protok Kontel - Ascom.

1. AsAlert - system powiadamiania o wanych zdarzeniach

Rys. Komunikacja pomidzy moduem AsAlert a bezprzewodowym systemem

przywoawczym Ascomm (wariant bez OAP).
rdo: Opracowane na podstawie materiaw Ascom/Kontel.

AsAlert posiada zaimplementowany protok XML umoliwiajcy komunikacj z

telefonami bezprzewodowymi systemu Ascom.
Serwer UNITE przekazuje wiadomo wysan przez aplikacj klienck (AsAlert)
do uytkownikw systemu alarmowego Ascom przy pomocy przemysowej
radiowej technologii IP-DECT.
Wariant AsAlert - protok Kontel - Ascom wymaga: serwera UNITE oraz systemu
Ascom IP-DECT, dostarczanych przez firm Kontel.
***
Rnica pomidzy wariantem 1 a 2 polega na moliwoci przesyania alarmw na
telefony uytkownikw kocowych.
W wariancie 1 o scenariuszu powiadomie decyduje klient (AsAlert). Serwer OAP
przekazuje jedynie alarm na telefon pracownika, ktrego wybra AsAlert.
Informacja moe zosta wysana do pojedynczej osoby lub grupy osb, ale jest to
informacja jednokierunkowa. Nie ma moliwoci weryfikacji, czy alarm zosta
przyjty. Nie ma rwnie moliwoci eskalacji alarmu do kolejnych osb. Wariant
1 nie zapewnia 100% pewnoci, e informacja zostanie odebrana.
W wariancie 2 o scenariusz powiadomie decyduje serwer Unite. Na serwerze
Unite mona uoy dowolny scenariusz powiadomie w zalenoci od zaistniaego

AsAlert

problemu. Klient (AsAlert) przesya tylko informacj o kodzie al armu, a s erwer

Unite na tej podstawie oraz na podstawie zaprogramowanego scenariusza
przesya informacj do waciwych osb. Poniewa jest to komunikacja
dwustronna mona sprawdzi, czy dana osoba przyja alarm. Jeeli alarm nie
zostanie od ebrany w okrelonym czasie, jest eskalowany do kolejnych
pracownikw, a do skutecznego powiadomienia o zaistniaym problemie. W
wariancie tym serwer Unite automatycznie kontroluje przepyw informacji i dziki
temu zapewnia, e kady alarm zostanie odebrany przez waciwe osoby.
***
System alarmowo-telefoniczny IP-DECT firmy Ascom stanowi poczenie
sprawdzonego standardu DECT z VoIP, umoliwiajc zarwno przesyanie pakietu
danych jak i wysokiej jakoci pocze gosowych - w tej samej sieci. Elementami
skadowymi systemu s:
-

stacje bazowe IP-DECT,

bramy (gateway) IP-DECT,
UNITE lub IMS,
bramy (gateway) VoIP (cyfrowe lub analogowe),
istniejce "stare" stacje bazowe.

System IP-DECT firmy Ascom posiada w peni modularn budow, konfigurowan

indywidualnie do potrzeb klienta. System moe liczy do 2.000 stacji bazowych
IP-DECT i 10.000 telefonw. Kada stacja bazowa IP-DECT obsuguje 8 rozmw
naraz i jest wpita bezporednio w sie LAN. Mona te zainstalowa IP-DECT
tam, gdzie nie ma sieci IP: brama IP-DECT pozwala na podczenie 16
'tradycyjnych' stacji bazowych DECT (na kablach do 1,5 km) i razem z bazami IPDECT t worzy jed en s ystem. A scom IP-DECT integruje si z niemal dowoln
central telefoniczn, stanowic alternatyw dla telefonii WLAN, szczeglnie tam
gdzie wdroenie WiFi sprawia problemy techniczne. Dystrybutorem systemu IPDECT jest firma Kontel.

1. AsAlert - system powiadamiania o wanych zdarzeniach

Rys. Schemat konfiguracji systemu alarmowo-telefonicznego IP-DECT firmy

Ascom.
rdo: Opracowane na podstawie materiaw Ascom/Kontel.

2 Struktura moduu AsAlert

Modu AsAlert skada si z nastpujcych czci:

serwer AsAlert obsugujcy podstawowe funkcje

wysyaniem komunikatw i obsug bazy danych,

moduy transmisji komunikatw,

aplikacja kliencka pozwalajca na konfigurowanie AsAlerta oraz

przegld historii zdarze (historii wysanych komunikatw). Aplikacja
ta bdzie dalej nazywana - Konfiguratorem.

zwizane

Serwer moduu AsAlert

Serwer moduu AsAlert jest serwerem Automation, w zwizku z czym udostpnia
on interfejsy umoliwiajce innym aplikacjom klienckim (w tym skryptom)
realizacj funkcji zwizanych z:

nadawaniem alertw,

konfigurowaniem AsAlerta.

Klientem moe by dowolny program, ktry potrafi wywoa funkcje Serwera

poprzez mechanizm Automation. Technologie, moliwe do wykorzystania:

kompilowany program EXE napisany w Visual Basic, C++, C, Delhi,

itd.,

skrytp w jzyku JScript lub VBScript,

skrytp wbudowany w stron ASP pozwalajcy na wysyanie alertw

za porednictwem aplikacji internetowej.

Aplikacja kliencka moe korzysta ze wszystkich interfejsw udostpnianych

przez serwer, jednak najczciej s to funkcje zwizane z nadawaniem alertw.
Szczeglnym przypadkiem aplikacji klienckiej jest Konfigurator, ktry
wykorzystuje wszystkie funkcje udostpniane przez serwer Automation.
Serwer nie posiada wasnego graficznego interfejsu uytkownika poza
wywietlaniem komunikatw o bdach fatalnych (np. bdna konfiguracja).
Graficzny sposb dostpu do funkcji serwera oraz jego konfiguracj zapewnia w
systemie Asix - Konfigurator.
Zadaniem serwera moduu AsAlert jest:

obsuga baz danych adresatw, komunikatw wysanych,

wysyka komunikatw.

2. Struktura moduu AsAlert

Moduy transmisji komunikatw

Serwer AsAlert korzysta z nastpujcych moduw transmisji komunikatw (pliki
.DLL):
Modu OAP,
Modu SMS,
Modu SMTP.
Modu OAP
Modu OAP jest wykorzystywany przez program AsAlert do wysyania alertw w
postaci SMSw za pomoc protokou OAP
Modu SMS
Modu SMS jest wykorzystywany przez program AsAlert do wysyania alertw za
pomoc modemw GSM. Alerty s wysyane jako komunikaty SMS.
Modu SMTP
Modu SMTP jest wykorzystywany przez program AsAlert do wysyania alertw za
pomoc protokou poczty elektronicznej SMTP.
Konfigurator
Zadaniem
tego
moduu
jest
udostpnienie
graficznego
interfejsu,
umoliwiajcego uytkownikowi konfiguracj oraz podgld pracy serwera.
Konfigurator moe komunikowa si z serwerem lokalnym lub pracujcym na
zdalnej stacji.
Zadania moduu:

wywietlanie oglnych informacji o serwerze: numer wersji, ilo

wysanych komunikatw, ilo komunikatw w kolejce,

dostp do bazy danych komunikatw wysanych,

"rczne" wysyanie komunikatw,

konfiguracja serwera i moduw transmisji komunikatw,

zatrzymywanie i wznawianie pracy serwera,

definiowanie listy uytkownikw

serwera oraz hase dostpu.

uprawnionych

do

korzystania

3 Konfiguracja moduu AsAlert

Do konfiguracji AsAlerta suy program AlerterCfg (Kofigurator). Program
pozwala konfigurowa AsAlerta pracujcego na stanowisku lokalnym oraz na
stacjach sieciowych. Ponadto umoliwia rwnie:

wysyk alertw,

zatrzymywanie i uruchamianie moduu AsAlert,

podgld zawartoci bazy

wyszukiwanie alertw.

danych

alertw

oraz

sortowanie

Gwne okno programu AlerterCfg zostao przedstawione na poniszym rysunku.

Rysunek: Gwne okno programu AlerterCfg.

Gwne menu programu Konfigurator zawiera pozycje:

Alerter

Pocz z...
Uruchom
Zatrzymaj
Wylij alert...
Zakocz

- pozwala wprowadzi nazw stacji, ktra

zostaa zdefiniowana w ustawieniach
sieciowych;
- uruchamia serwer;
- zatrzymuje serwer;
- suy do edycji i wysania wiadomoci;
- zamyka program Konfigurator;

Widok

Odwie

- funkcja odwieania;

10

3. Konfiguracja moduu AsAlert

Poka
Znajd...
Znajd nastpny
Kolumny...

Ustawienia

Bazy danych...
Logowanie...
Uytkownicy...
Adresaci...
Komunikacja...

- powoduje otwarcie okna pokazujcego pen

zawarto komunikatu (bez moliwoci
wprowadzania zmian);
- pozwala zdefiniowa kryterium wyszukiwania
oraz znajduje pierwszy komunikat speniajcy to
kryterium;
- wyszukuje nastpny komunikat speniajcy
kryteria wyszukiwania;
- pozwala zdefiniowa, ktre pola (kolumny)
komunikatw bd pokazywane w panelu
komunikatw;

- pozwala zdefiniowa lokalizacj baz danych;

- logowanie do funkcji AsAlert;
- definiuje uytkownikw (w tym uytkownikw z
uprawnieniami do konfiguracji);
- definiuje adresatw i grupy adresatw;
- pozwala wybra modu transmisji komunikatw
SMS i poczty elektronicznej oraz dokona ich
parametryzacji;

Pomoc

Dolny panel gwnego okna zawiera list komunikatw - zawarto bazy

komunikatw. Komunikaty s wstpnie uporzdkowane wg czasu ich
wygenerowania. Kliknicie w obszarze nagwka danej kolumny powoduje
uporzdkowanie komunikatw wg zawartoci tej kolumny. Wybranie z menu
Widok pozycji Znajd... pozwala zdefiniowa kryterium wyszukiwania
komunikatw w postaci acucha znakw. Wyszukiwane s komunikaty
zawierajce zdefiniowany acuch znakw w: treci, temacie, nazwie nadawcy
lub w licie adresatw.
Konfiguracja
rozdziaach:

obejmuje

nastpujce

zagadnienia

omwione

kolejnych

1. Autoryzacja dostpu do AsAlerta.

2. Konfiguracja baz danych:

konfiguracja bazy
komunikatw.

danych

adresatw

bazy

danych

3. Parametryzacja moduw komunikacyjnych.

4. Konfiguracja do pracy sieciowej.
5. Sprzenie AsAlerta z systemem alarmw Asixa (dla Asixa w wersji Evo i
w wersji klasycznej).

11

AsAlert

3.1 Autoryzacja dostpu do AsAlerta

Konfigurator uzyskuje dostp do funkcji AsAlerta na podstawie ustawie
zdefiniowanych w oknie danych autoryzacyjnych, otwieranym po wybraniu
pozycji Ustawienia > Logowanie. O kno p ozwala n a podanie i dentyfikatora
(nazwy) uytkownika oraz hasa. Zmiana konfiguracji AsAlerta, a take jego
uruchamianie i zatrzymywanie za pomoc Konfiguratora jest moliwe tylko
wtedy, gdy podany identyfikator okrela uytkownika z uprawnieniami
konfiguracyjnymi. Informacje autoryzacyjne mona zmieni take w czasie
trwania poczenia.
Dostp do funkcji AsAlerta maj tylko zdefiniowani uytkownicy. Wyjtkiem od
tej reguy jest sytuacja, gdy po zainstalowaniu moduu AsAlert nie jest jeszcze
zdefiniowany aden uytkownik - wwczas dostp do moduu nie jest w aden
sposb ograniczony.
Do definiowania uytkownikw suy okno Uytkownicy, wywoywane po
wybraniu opcji Ustawienia > Uytkownicy. Okno pozwala na okrelenie zbioru
uytkownikw mogcych korzysta z usug AsAlerta. Ponadto umoliwia
zdefiniowanie uytkownikw, ktrzy posiadaj uprawnienia do zmiany
konfiguracji AsAlerta, w tym do modyfikacji danych o uytkownikach. Okno
uytkownikw posiada rwnie pole przeznaczone do zdefiniowania maksymalnej
iloci alertw, jak pojedynczy uytkownik moe wysa w cigu jednej minuty.
Zerowa warto tego ograniczenia powoduje wyczenie kontroli czstoci
wysyania alertw.
Przycisk Dodaj wywouje okno Informacje o uytkowniku, suce do
definiowania uytkownika identyfikowanego po nazwie i hale z lub bez opcji
Uprawnienia do konfiguracji.

Rysunek: Okno umoliwiajce okrelenie zbioru uytkownikw mogcych

korzysta z usug AsAlerta. Okno definiowania uytkownika.

12

3. Konfiguracja moduu AsAlert

Okno identyfikacji uytkownika uruchamiane jest poleceniem Ustawienia >

Logowanie:

Rysunek: Oko identyfikacji uytkownika.

3.2 Konfiguracja baz danych

Konfiguracja bazy danych adresatw i bazy danych komunikatw

Parametryzacja bazy danych adresatw

Konfiguracja bazy danych adresatw i bazy danych komunikatw

Serwer AsAlert pracuje w oparciu o dwie bazy danych:

baz adresatw,

baz komunikatw wysanych.

Do parametryzacji baz danych suy okno 'Bazy danych alertera, otwierane za

pomoc pozycji Ustawienia/Bazy danych w menu gwnym Konfiguratora.
Obie bazy danych konfigurowane s w ten sam sposb. Okno selekcji baz danych
zawiera pola edycyjne po jednym dla kadej bazy. Pola te powinny zawiera
acuch poczenia do bazy danych (ang. Connection string). Do pl tych mona
rwnie wprowadzi ciek do pliku bazy danych Microsoft Jet lub nazw bazy
Microsoft SQL. Jeeli wprowadzony tekst zawiera znak "\" l ub ". .", t o j est o n
interpretowany jako cieka pliku danych bazy Microsoft Jet, w przeciwnym
wypadku - jako nazwa bazy danych SQL na stanowisku lokalnym.

13

AsAlert

Rysunek: Okno parametryzacji baz danych programu AsAlert.

Obok pl edycyjnych znajduj si przyciski Wybierz. Wybranie j ednego z t ych
przyciskw powoduje otwarcie okna umoliwiajcego wybr metody selekcji:

za pomoc pliku UDL (ang. Universal Data Link),

za pomoc acucha poczenia (ang. Connection string).

Rysunek: Okno umoliwiajce wybr metody selekcji bazy danych.

Konfigurator umoliwia rwnie tworzenie nowych baz danych. W tym celu w
oknie 'Bazy danych alertera naley wybra przycisk Utwrz, ktry uruchamia
okno 'Typ bazy danych.

14

3. Konfiguracja moduu AsAlert

Rysunek: Okno wyboru typu bazy danych.

Standardowo tworzone s bazy danych Microsoft Jet oraz SQL.
W przypadku tworzenia bazy SQL naley poda nazw bazy danych oraz
opcjonalnie nazw stacji sieciowej, na ktrej ma zosta utworzona. Przycinicie
przycisku Ustawienia zaawansowane powoduje otwarcie okna pozwalajcego na
peniejsz parametryzacj nowej bazy danych.

Rysunek: Okno tworzenia baz danych SQL.

15

AsAlert

Rysunek: Okno ustawie zaawansowanych parametryzowanej bazy SQL.

W celu utworzenia bazy Microsoft Jet naley poda pen ciek i nazw nowego
pliku bazy danych. Przycinicie przycisku Ustawienia zaawansowane powoduje
otwarcie okna pozwalajcego na peniejsz parametryzacj nowej bazy danych.

Rysunek: Okno tworzenia baz danych Jet.

16

3. Konfiguracja moduu AsAlert

Rysunek: Okno ustawie zaawansowanych parametryzowanej bazy Jet.

W obu przypadkach mona zaznaczy pozycj Usu poprzedni zawarto

bazy, co spowoduje usunicie poprzedniej bazy danych o tej samej nazwie.
Pozycja Maksymalna ilo alertw w oknie 'Bazy danych alertera pozwala
okreli maksymaln ilo zapisw w bazie danych alertw. Po przekroczeniu tej
iloci, AsAlert usunie 10% najstarszych alertw. Jeli zostanie wprowadzona
warto 0, to alerty nie bd usuwane z bazy danych.

Parametryzacja bazy danych adresatw

AsAlert wysya alerty tylko do adresatw zawartych w bazie danych adresatw.
Istniej trzy rodzaje adresatw:

osoby,

grupy,

harmonogramy.

Osoby to adresaci indywidualni posiadajcy

elektronicznej lub numer telefonii komrkowej.

swj

wasny

adres

poczty

17

AsAlert

Grupy to zbir adresatw. Wysanie alertu do adresata, ktry jest grup,

powoduje wysanie alertw do wszystkich adresatw indywidualnych zawartych w
grupie.
Harmonogram to rwnie grupa adresatw - z tym e, alert wysyany jest do
rnych czonkw tej grupy w zalenoci od czasu wysyki alertu. Harmonogram
definiuje sekwencje odcinkw czasu i powizan z kadym odcinkiem grup
adresatw wiadomoci. Rozrniane s dwa rodzaje harmonogramw:

harmonogramy cykliczne,

harmonogramy absolutne.

Harmonogramy c ykliczne nie posiadaj okrelonego koca wanoci.

Ostatnia pozycja takiego harmonogramu okrela pocztek odcinka
czasu, ktrego koniec okrelony jest przez pierwsz pozycj
harmonogramu. Harmonogramy cykliczne skadaj si z pozycji,
ktrych czas rozpoczcia zdefiniowany jest jedynie przez czas bez daty.

Przykad 1 parametryzacji harmonogramu cyklicznego:

Harmonogram skadajcy si z nastpujcych pozycji:

06:00:00 - zbir adresatw nr 1
14:00:00 - zbir adresatw nr 2
22:00:00 - zbir adresatw nr 3
oznacza, e:
- alert wysany pomidzy godzin 6 i 14 kadego dnia zostanie
wysany do zbioru adresatw nr 1;
- alert wysany pomidzy godzin 14 i 22 kadego dnia zostanie
wysany do zbioru adresatw nr 2;
- alert wysany pomidzy godzin 22 i 6 nastpnego dnia zostanie
wysany do zbioru adresatw nr 3;
- itd.
Dopuszcza si przypadek, w ktrym pierwsza pozycja harmonogramu
cyklicznego okrelana jest zarwno przez czas i dat. Wwczas
pierwsza pozycja okrela jednoczenie moment rozpoczcia pierwszego
cyklu.

Przykad 2 parametryzacji harmonogramu cyklicznego:

13-07-2003 06:00:00 - zbir adresatw nr 1

14:00:00 - zbir adresatw nr 2
22:00:00 - zbir adresatw nr 3

18

3. Konfiguracja moduu AsAlert

06:00:00 - zbir adresatw nr 4

14:00:00 - zbir adresatw nr 5
22:00:00 - zbir adresatw nr 6
Harmonogram absolutny zawiera pozycje okrelone zarwno przez dat
jak i czas. Ostatnia pozycja takiego harmonogramu definiuje pocztek
nieskoczonego odcinka czasu.

Do parametryzacji baz danych suy okno adresatw. Jest ono otwierane po

wybraniu pozycji Ustawienia/Adresaci w menu gwnym Konfiguratora.

Rysunek: Okno do parametryzacji bazy danych adresatw.

Okno adresatw skada si z dwch czci. Po jego lewej stronie wywietlana
jest w postaci drzewa zawarto bazy adresatw. Gwne "gazie" tego drzewa
to os oby, grupy i harmonogramy. Zaznaczenie okrelonej osoby lub
harmonogramu spowoduje, e po prawej stronie okna adresatw wywietlane s
szczegowe informacje o wybranym adresacie.

Okno adresatw pozwala wykona nastpujce zadania:

Tworzenie nowego adresata
Na drzewie adresatw naley zaznaczy pozycj Osoby, Grupy lub
Harmonogramy i przycisn przycisk Dodaj lub wybra pozycj Dodaj z menu
kontekstowego. Zostanie wwczas utworzony nowy adresat o nazwie
odpowiednio: 'Nowa osoba', 'Nowa grupa' lub 'Nowy harmonogram' oraz
wczony tryb edycji nowej nazwy. Jednoczenie po prawej stronie okna
Adresaci pojawi si panel pozwalajcy na wprowadzanie szczegowych
informacji na temat nowego adresata (tylko dla osb i harmonogramw).

19

AsAlert

Usunicie istniejcego adresata

Na drzewie adresatw naley zaznaczy wybranego adresata oraz przycisn
przycisk Usu, wybra pozycj Usu z menu kontekstowego lub przycisn
klawisz Del.
Zmiana nazwy adresata
Na drzewie adresatw naley zaznaczy wybranego adresata oraz przycisn
przycisk F2 lub klikn lewym klawiszem myszy. Zostanie
wwczas
uruchomiony tryb edycji nazwy. Zmian nazwy osoby lub harmonogramu mona
take przeprowadzi poprzez edycj pola nazwy znajdujcego si po prawej
stronie okna adresatw.
Dodanie nowego czonka grupy adresatw
Na drzewie adresatw naley zaznaczy wybran grup, a nastpnie przycisn
przycisk Dodaj lub wybra pozycj Dodaj z m enu kontekstowego. Z ostanie
wtedy otwarte okno pozwalajce na wybr dodawanego adresata. Dodanie
nowego czonka grupy mona rwnie przeprowadzi poprzez przecigniecie
myszk nowego czonka grupy z odpowiedniej pozycji drzewa adresatw do
pozycji okrelonej grupy (lewy klawisz myszki). Ten sam efekt mona osign
wykorzystujc przycisk Dodaj do grupy lub przecigajc odpowiedni pozycj
grupy z drzewa adresatw (prawy klawisz myszki) w obszar pola Przynaleno
do grup panelu szczegowych informacji dotyczcych danego adresata
indywidualnego.
Usunicie czonka grupy adresatw
Na drzewie adresatw naley zaznaczy czonka grupy i przycisn przycisk
Usu, wybra pozycj Usu z menu kontekstowego lub przycisn klawisz Del.
To samo mona wykona w panelu informacji szczegowych osoby po prawej
stronie okna.
Edycja danych osoby
Naley wybra osob w drzewie adresatw. Po prawej stronie
wywietlone informacje szczegowe na temat wybranej osoby:

zostan

nazwa adresata (np. nazwisko i imi),

adres poczty elektronicznej,

numer telefonu komrkowego,

pole wyboru okrelajce, czy alert powinien zosta wysany na

adres p oczty e lektronicznej, czy j ako komunikat S MS (w
przypadku, gdy wysyka moe zosta zrealizowana przy
wykorzystaniu obu tych metod),

przynaleno do grup &endash; lista nazw grup, do ktrych

naley wybrana osoba.

Przycisk Dodaj do grupy spowoduje wywietlenie okna pozwalajcego na wybr

grupy adresatw. To samo mona wykona przecigajc myszk wybran grup
w drzewie adresatw i upuszczajc j na list grup, do ktrych naley adresat.
Przeciganie naley zrealizowa za pomoc prawego klawisza myszki.
Zaznaczenie pozycji w licie grup, do ktrych naley adresat oraz przyciniecie
przycisku Usu z grupy lub klawisza Del spowoduje usunicie osoby z wybranej
grupy adresatw.

20

3. Konfiguracja moduu AsAlert

Edycja danych harmonogramu

Naley wybra harmonogram na drzewie adresatw. Po prawej stronie zostan
wywietlone informacje szczegowe na temat wybranego harmonogramu:

nazwa harmonogramu,

lista pozycji harmonogramu.

Rysunek: Okno umoliwiajce edycj danych harmonogramu.

Przycisk Dodaj suy do dodania nowej pozycji harmonogramu. To samo mona

uzyska przecigajc wybranego adresata prawym klawiszem myszki w miejsce
pustej pozycji harmonogramu. Upuszczenie adresata do istniejcej pozycji
harmonogramu spowoduje dodanie go do grupy adresatw danego odcinka
czasu.
Przycisk Usu usuwa wybran pozycj harmonogramu. Ten sam efekt mona
uzyska klawiszem Del.
Przycisk Edycja umoliwia edycj danych wybranej pozycji harmonogramu.
Okno edycji pozycji harmonogramu pozwala na okrelenie czasu pocztku
odcinka czasu oraz listy adresatw zwizanych z tym odcinkiem czasu. Pole daty
zawiera zaznaczenie decydujce o tym, czy pocztek odcinka czasu jest
okrelony jedynie jako punkt doby, czy te poprzez dat i czas.

21

AsAlert

3.3 Parametryzacja moduw komunikacyjnych

Realizacja wysyki alertw przez modu AsAlert odbywa si przy wykorzystaniu
moduw komunikacyjnych. W zalenoci od sposobu otrzymywania przez
adresatw alertw moduy komunikacyjne dziel si na dwa rodzaje:

moduy umoliwiajce odbir alertw w postaci poczty elektronicznej

(email),

moduy umoliwiajce odbir alertw w postaci komunikatw SMS.

Do parametryzacji moduw komunikacyjnych suy okno otwierane po wybraniu

pozycji Ustawienia/Komunikacja menu gwnego AsAlert. Okno pozwala na
wybr okrelonego moduu dla poczty elektronicznej oraz komunikatw SMS.
Lista dostpnych moduw zaley od tego, jakie moduy zostay zainstalowane.
Przycisk "..." obok wybranego moduu suy do dalszej parametryzacji moduu
komunikacyjnego.

Okno Moduy komunikacyjne:

Rysunek: Okno wyboru moduw komunikacyjnych do parametryzacji.

22

3. Konfiguracja moduu AsAlert

Przykadowa parametryzacja moduu SMTP do wysyania

alertw za pomoc protokou poczty elektronicznej
1. Uruchom konfiguratora moduw komunikacyjnych:
Ustawienia > Moduy komunikacyjne...

2. Z listy moduw poczty elektronicznej

komunikacyjny poczty elektronicznej (SMTP)':

wyselekcjonuj

pozycj

'Modu

3. W oknie parametrw moduu SMTP okrel adres serwera poczty elektronicznej,

numer portu wykorzystywanego przez serwer do obsugi protokou SMTP oraz
adres i nazw nadawcy (bez okrelania maksymalnego czasu oczekiwania na
odpowied serwera SMTP oraz uwierzytelnienia uytkownika przez serwer SMTP):

Rysunek: Okno parametrw moduu SMTP.

23

AsAlert

3.3.1 Modu komunikacji poczty elektronicznej (SMTP)

Modu SMTP jest wykorzystywany przez program AsAlert do wysyania alertw za
pomoc protokou poczty elektronicznej SMTP.

Rysunek: Okno parametryzacji moduu wysyania komunikatw za pomoc

protokou poczty elektronicznej SMTP.

Parametry konfiguracyjne
Serwer

Port

Nazwa nadawcy

Adres nadawcy
Timeout

24

- parametr okrela adres serwera poczty

elektronicznej. Adres ten naley uzyska od
dostawcy usug internetowych lub od
administratora sieci lokalnej.
- parametr okrela numer portu wykorzystywany
przez serwer do obsugi protokou SMTP. Jeli
parametr jest pominity, przyjmowana jest
warto 25. Warto parametru naley uzyska
od dostawcy usug internetowych lub od
administratora sieci lokalnej.
- dowolny tekst okrelajcy nadawc alertu. Jeli
pole jest pominite, to nazwa nadawcy bdzie
taka sama jak Adres nadawcy (chyba e w
oknie edycyjnym do wysyania alertw
zdefiniowana zostanie inna nazwa nadawcy).
- adres pocztowy email nadawcy alertu.
- maksymalny czas oczekiwania na odpowied
serwera SMTP. Podanie wartoci 0 spowoduje
nieograniczony okres oczekiwania na odpowied.

3. Konfiguracja moduu AsAlert

Serwer wymaga uwierzytelnienia - w przypadku gdy serwer SMTP

wymaga uwierzytelnienia uytkownika konta,
naley opcj zaczy i wpisa nazw i haso
uytkownika konta.

3.3.2 Modu komunikacji OAP

Modu OAP jest wykorzystywany przez program AsAlert do wysyania alertw za
pomoc protokow dla urzdze Ascom:
- protokou OAP (1 wariant);
- lub dedykowanego protokou firmy Kontel (2 wariant).
Szczegy na temat komunikacji z urzadzeniami firmy Ascom znajduja si w
rozdziale
1.1 Wsppraca AsAlert z systemem alarmowo-telefonicznym firmy Ascom.

Rysunek: Okno parametryzacji moduu wysyania komunikatw za pomoc

protokou OAP/Kontel.

Parametry konfiguracyjne
Serwer
Port
Uyj protokou OAP

- parametr okrela adres serwera moduu OAP.

- parametr okrela numer portu wykorzystywany
przez serwer do obsugi protokou OAP.
- parametr zacza wykorzystanie protokou OAP
do wysyania alertw; gdy opcja nie jest
zaznaczona, uyty zostanie dedykowany
urzdzeniom Ascom protok firmy Kontel.

25

AsAlert

3.3.3 Modu komunikacji SMS (GSM)

Modu komunikacji SMS jest wykorzystywany przez program AsAlert

wysyania alertw za pomoc modemw GSM.

do

Rysunek: Okno parametryzacji moduu wysyania komunikatw za pomoc

modemw GSM.

Parametry konfiguracyjne
Port szeregowy

Szybko
Bity danych
Parzysto
Bity stopu
Numer Centrum SMS

26

- parametr definiuje port szeregowy, do ktrego

przyczony jest modem GSM. Mona poda
numer portu lub pen nazw portu szeregowego
np. '2" lub "COM2". Jest to jedyny obowizkowy
parametr moduu komunikacji GSM.
- parametr okrela szybko komunikacji z
modemem GSM w bitach na sekund.
- parametr okrela dugo sowa danych w
czasie komunikacji z modemem GSM.
- parametr okrela typ kontroli parzystoci.
- parametr okrela ilo bitw stopu.
- numer telefoniczny Centrum Wiadomoci SMS
wykorzystywany do wysyania wiadomoci SMS.
Numer ten uzyskuje si od operatora sieci GSM.
Parametr mona pomin, jeli jest on zawarty
w konfiguracji sprztowej modemu GSM. Jeli
jako modem GSM jest wykorzystywany telefon

3. Konfiguracja moduu AsAlert

komrkowy, to zazwyczaj jest on ju

odpowiednio skonfigurowany.
Zawarto komunikatu SMS - parametr okrela sposb tworzenia tekstu
komunikatu SMS na podstawie zawartoci alertu.
Tekst komunikatu SMS moe skada si z
tematu alertu, jego treci lub obu tych
elementw.
Maksymalna dugo SMS - parametr okrela maksymaln dugo
komunikatu SMS. Jeli dugo ta jest
przekroczona, to nadmiarowe znaki s
odrzucane.
Dodatkowe polecenia inicjalizujce - parametr okrela dodatkowe
polecenia (komendy AT), ktre zostan wysane
do modemu GSM w chwili jego inicjalizacji.
acuch okrelajcy dodatkowe komendy nie
powinien rozpoczyna si od znakw AT.

3.4 Konfiguracja do pracy sieciowej

AsAlert jest serwerem COM (ang. Component Object Model) i aby by moliwy
dostp do jego funkcji z odlegych stacji, naley odpowiednio skonfigurowa
"usugi skadowe" systemu operacyjnego. Sposb uruchamiania konfiguratora
usug skadowych zaley od systemu operacyjnego, zazwyczaj jednak wystarczy
uruchomi program dcomcnfg.exe. Po jego uruchomieniu naley odszuka i
otworzy pozycj Alerter application, po czym skonfigurowa tosamo serwera
AsAlert. Zaleca si wybra pozycj Ten uytkownik i odpowiednie konto
uytkownika, pod jakim bdzie uruchamiany AsAlert. Naley przy tym pamita,
e AsAlert musi posiada uprawnienia administracyjne. Po ustaleniu tosamoci,
stosownie do potrzeb naley skonfigurowa uprawnienia uruchamiania i
uprawnienia dostpu. Jeli wbudowany w AsAlert mechanizm kontroli dostpu w
oparciu o zdefiniowanych uytkownikw (Patrz: Autoryzacja dostpu do Alertera)
jest wystarczajcy, uprawnienia do uruchamiania i dostpu do funkcji AsAlert
mona przypisa do grupy uytkownikw Wszyscy.

27

4 Uruchamianie i zatrzymanie AsAlerta

W celu uruchomienia AsAlerta wybra pozycj Alerter > Uruchom menu
gwnego Konfiguratora. Uruchomienie jest moliwe tylko w przypadku
poprawnej parametryzacji AsAlerta:

musi by poprawnie zdefiniowana baza danych alertw,

musi by poprawnie zdefiniowana baza danych adresatw oraz musi

ona zawiera przynajmniej jednego adresata,

musi by zdefiniowany oraz poprawnie s konfigurowany p rzynajmniej

jeden modu komunikacyjny.

W celu zatrzymania AsAlerta naley wybra pozycj Alerter > Zatrzymaj menu
gwnego Konfiguratora.

28

5 Wysyanie alertw
Wybranie p ozycji Alerter > Wylij alert... powoduje ot warcie okna
pozwalajcego na wysanie alertu. Adresaci wybierani s za pomoc okna selekcji
adresatw otwieranego przyciskiem Adresaci.

Rysunek: Okno umoliwiajce wysyanie alertu.

Wysany alert pojawia si na licie komunikatw okna 'Alerter Konfiguratora.

Rysunek: Lista wysanych alertw w oknie 'Alerter Konfiguratora.

W przypadku sprzenia systemu wysyania alertw z systemem alarmw Asixa,
alerty wysyane s automatycznie w momencie w ykrycia al armu, dla k trego
ustawione zostao danie wysania powiadomienia.

29

6 Przegldanie wysanych alertw

Doln cz gwnego okna Konfiguratora zajmuje lista wysanych alertw.

Rysunek: AsAlert - lista wysanych alertw.

Zakres wywietlanych informacji mona zmieni za pomoc pozycji Widok >
Kolumny... menu gwnego, ktra uruchamia okno 'Widoczne pola alertu'.

Rysunek: Okno definiujce zakres wywietlanych informacji.

Pozycja Widok > Znajd... suy do wyszukania pierwszego alertu
zawierajcego okrelony cig znakw. Pozycja Widok/Znajd nastpny powoduje
wyszukanie kolejnego alertu speniajcego kryterium wyszukiwania.

Rysunek: Okno do wyszukiwania pierwszego alertu zawierajcego okrelony cig

znakw.

30

6. Przegldanie wysanych alertw

Pozycja Widok > Poka powoduje otwarcie okna pokazujcego szczegy

dotyczce alertu - w tym informacje o bdach, ktre wystpiy w trakcie wysyki
alertu. Pozycja ta jest aktywna tylko wtedy, gdy na licie alertw jest wybrany
jaki element. To samo mona uzyska klikajc podwjnie myszk na wybranym
alercie.

Rysunek: Okno informacyjne na temat alerta.

31

7 Sprzenie AsAlerta z systemem alarmw Asix.Evo

Program AsAlert moe wsppracowa z systemem alarmw Asix.Evo, co pozwala
na automatyczne wysyanie alertw w reakcji na wykrycie zmiany stanu
wybranych alarmw. Parametryzacja sprzgu wykonywana jest dwustopniowo w
programie AsixEvo.exe. W pierwszym kroku deklarowane s podstawowe
parametry komunikacyjne. Suy do tego pokazany poniej fragment zakadki
Ustawienia.

Rysunek: Konfiguracja sprzgu AsAlert - AsixEvo. Okno AsixEvo.exe >

Ustawienia systemu alarmw.

Rysunek: AsixEvo.exe > ustawienia AsAlerta.

32

7. Sprzenie AsAlerta z systemem alarmw asixa

Znaczenie parametrw jest nastpujce:

Stanowisko
Okrelenie stanowiska aplikacji Asix.Evo, ktre bdzie inicjowao wysanie
powiadomienia. Moe to by nazwa dowolnego stanowiska uczestniczcego w
pracy domeny. Mona te wybra opcj, w ktrej powiadomienia wysya zawsze
aktywny kontroler. Waciwy wybr zaley od konfiguracji systemu. W kadym
przypadku stanowisko powinno by wczone przez cay czas. Dlatego zazwyczaj
alerty wysyane s ze stanowisk kontrolerw. Jeeli AsAlert jest zainstalowany na
komputerze jednego z kontrolerw, to z reguy powiadomienia powinno wysya
to stanowisko. W przeciwnym wypadku z reguy lepsza jest opcja aktywnego
kontrolera.
Lokalizacja
Systemowa nazwa komputera, na ktrym zainstalowany jest program AsAlert. W
przypadku korzystania z lokalnej instalacji naley parametr pozostawi pusty.
Uytkownik
Nazwa uytkownika programu AsAlert na konto, ktrego bd wysyane
powiadomienia.
Haso
Haso uytkownika
powiadomienia.

programu

AsAlert

na

konto,

ktrego

bd

wysyane

Nazwa rda
Dowolny tekst, ktry w wysanym alercie zostanie uyty jako nadawca
wiadomoci.
Nagwek
Dowolny tekst, ktry w wysanym alercie zostanie uyty jako tytu wiadomoci.

Drugim krokiem w parametryzacji sprzgu jest odpowiednie zdefiniowanie

atrybutw TrybAlertw i Adresaci Alertw w definicji kadego alarmu, dla ktrego
maj by wysyane alerty. Tryb alertw pozwala wybra - kiedy alerty s
wysyane: moliwe jest wysyanie w momentach pocztku i/lub kocu alarmu. W
atrybucie AdresaciAlertw naley poda nazwy adresatw zdefiniowanych w
programie AsAlert, do ktrych powiadomienie ma by wysane.

33

8 Sprzenie AsAlerta z systemem alarmw klasycznej

wersji Asixa
Program AsAlert moe wsppracowa z systemem alarmw k lasycznej w ersji
Asix, co pozwala na automatyczne wysyanie alertw w reakcji na wykrycie
zmiany stanu wybranych alarmw. Szczegy dotyczce parametryzacji sprzgu
omwiono w kolejnych rozdziaach.

8.1 Format alertu

Kady wysyany alert skada si z nagwka(tytuu) i treci. Nagwek ma
nastpujc posta:
Alert nazwa_rda
Zawarto pola nazwa_rda jest podawana przez projektanta w pliku
konfiguracyjnym sprzgu.

Tre alertu ma nastpujc posta:

rodzaj_zdarzenia data_czas tekst_alarmu
Pole rodzaj_zdarzenia jest t ekstem Start lub Koniec w zalenoci od stanu
alarmu, ktry spowodowa wysanie alertu. Pole data_czas zawiera czas
zdarzenia alarmowego. Pole tekst_alarmu zawiera tre komunikatu
alarmowego, ktra jest identyczna z tekstem alarmu w aplikacji Asixa.

8.2 Parametryzacja sprzgu

Wczenie moduu sprzgu wymaga zadeklarowania opcji AsAlert w programie
Architekt:
Architekt > System alarmw > zakadka Sygnalizacja / Alerty:
opcja AsAlert - naley opcj zaczy i zadeklarowa nazw pliku
konfigurujcego sprzg pomidzy AsAlertem i Asixem

Sprzg jest uruchamiany tylko w trybie operatorskim systemu alarmw.

34

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

Plik konfiguracyjny sprzgu tworzony jest w formacie XML za pomoc

konfiguratora pakietu Asix (patrz: 8.3. Program konfiguracyjny) i okrela
wszystkie parametry pracy. Struktura pliku jest nastpujca:
<?xml version="1.0"?>
<asixalerts name="nazwa" host="xxxx" user="xxxx"
trace="yes" inifile="plik_ini">
<on>
<alarm>numery_alarmw</alarm>
<group>identyfikatory_grup</group>
<addressee>nazwy_adresatw</addressee>
</on>
<off>
&ldots;.
</off>
<onoff>
&ldots;.
</onoff>
</asixalerts>

password="xxxx"

Atrybuty wza asixalerts maj nastpujce znaczenie:

name
host
user
password
trace
inifile

- suy do podania nazwy rda pochodzenia alertw. Nazwa

jest przesyana w nagwku kadego alertu.
- nazwa komputera, na ktrym zainstalowany jest AsAlert.
Brak parametru oznacza uruchomienie AsAlerta na
komputerze lokalnym.
- nazwa uytkownika AsAlerta, pod ktrego ktem bdzie
pracowa modu sprzgu.
- haso uytkownika AsAlerta.
- jeeli atrybut jest uyty i jest rwny tekstowi yes, to do
pliku logu Asixa wysyane s dodatkowe komunikaty
rejestrujce prac moduu sprzgu.
- nazwa pliku konfiguracyjnego aplikacji Asixa, atrybut
uywany jest wycznie przez program konfiguracyjny.

Wzy on, off i onoff su do definiowania grup alertw rozsyanych w reakcji na

zdarzenie - odpowiednio: pojawienia, zaniku, pojawienia i zaniku alarmu. Wzy
mog wystpi wielokrotnie.
Wze alarm suy do podania numerw kontrolowanych alarmw. Mog to by
oddzielone przecinkami numery alarmw lub zakresy od-do alarmw.
Wze group suy do podania nazw grup kontrolowanych alarmw. Naley poda
oddzielone przecinkami identyfikatory grup alarmw z aplikacji Asixa.
Mona jednoczenie stosowa wybr alarmw przez grupy i numery.
Wze addresses suy do podania nazw adresatw, do ktrych naley wysa
alert. Jest to lista oddzielonych przecinkiem nazw adresatw, grup adresatw lub
nazw harmonogramw zdefiniowanych w bazie AsAlerta.
Monitorowane s zmiany pliku konfiguracyjnego. Jeeli plik zostanie zmieniony,
modu sprzgu podlega automatycznemu przekonfigurowaniu. Nie s
uwzgldniane tylko parametry host, user i password, k trych z miana w ymaga
restartowania aplikacji.

35

AsAlert

8.3 Program konfiguracyjny

Plik konfiguracyjny sprzgu moe by tworzony przy pomocy interaktywnego

programu AsixAlertConfig. Poniej pokazane jest gwne okno tego programu.
Konfigurator dostpny jest z poziomu menu Start > Programy > Asix >
Konfigurator alertw

Rysunek: Okno gwne programu AsixAlertConfig.

Znaczenie parametrw w sekcji Parametry oglne jest nastpujce:

Plik inicjacyjny aplikacji - parametr ma znaczenie tylko dla pracy programu
konfiguracyjnego. Pozwala on okrelenie nazw grup
alarmw i tekstw alarmw uywanych w aplikacji
Asixa. Informacje te s uywane w innych oknach
programu konfiguracyjnego.
Nazwa rda alertw - informacyjny tekst wysyany w nagwku kadego
alertu, identyfikujcy rdo alertu.
Lokalizacja Alertera
- nazwa komputera, na ktrym jest zainstalowany
AsAlert. Puste pole oznacza korzystanie z AsAlert
zainstalowanego na lokalnym komputerze.
Nazwa uytkownika i Haso - nazwa i haso uytkownika zdefiniowanego w
bazie AsAlert, na ktrego konto bd wykonywane
wszystkie operacje moduu sprzgajcego.
Wczone ledzenie
- ustawienie tej opcji powoduje, e bdzie wykonywana
rozszerzona diagnostyka pracy moduu sprzgajcego.
Poniej sekcji Parametry oglne znajduje si lista kontrolowanych alarmw.
Poszczeglne kolumny maj nastpujce znaczenie:
Tryb
- okrela typ kontrolowanego zdarzenia. Moliwe jest
wysyanie alertu w momencie wykrycia alarmu, jego
zaniku lub obu tych zdarze.

36

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

Numery
Grupy

Adresaci

- podaje numery kontrolowanych alarmw.

- podaje nazwy grup kontrolowanych alarmw. Uycie
nazwy grupy powoduje, e alert jest rozsyany dla
kadego alarmu nalecego do grupy. Informacje z
kolumn Numery i Grupy s stosowane jako suma
logiczna.
- nazwy adresatw zdefiniowanych w bazie AsAlert, do
ktrych naley wysa alert.

Operacje dodawania, m odyfikowania i u

suwania p ozycji z l isty a lertw
wykonywane s poprzez polecenia z menu Alert lub menu kontekstowego.
Dodanie lub modyfikacja linii na licie alertw powoduje otwarcie kolejno okien:
'Wybierz nazw komputera', a nastpnie 'Parametry alertu'.

Rysunek: Okno 'Wybierz nazw alertu'.

Rysunek: Okno &rsquor;Parametry alertu.

W oknie 'Wybierz nazw komputera' naley wskaza nazw stacji (zdefiniowanej
w p liku ko nfiguracyjnym a plikacji a sixa w k ategorii ' Obszary i ko mputery'), na
ktrej u ruchomiona jest aplikacja Asixa z zaczonym sprzgiem z moduem
AsAlert.
W grupie opcji Tryb i polach edycyjnych okna 'Parametry alertu' naley
wprowadzi parametry alertw. W przypadku pl edycyjnych mona skorzysta
ze skojarzonych okien dialogowych, ktre pozwalaj interakcyjnie okreli
parametry alertu poprzez wybr z list obiektw zdefiniowanych w aplikacji Asixa
lub bazie AsAlert.
Dla dziaania wspomnianych okien konieczne jest okrelenie nazwy pliku
konfiguracyjnego aplikacji Asixa i parametrw dostpu do AsAlert.

37

AsAlert

8.4 Wysyanie alertw sprzonych

Przykad konfiguracji mechanizmu wysyania alertw w

odpowiedzi na zmiany stanu alarmw systemu Asix

Konfiguracja dotyczy sprzenia moduu AsAlert z systemem alarmw

testowej a plikacji Fabryka (standardowo doczanej do pakietu Asix)
dla s tacji op eratorskiej o n azwie ' StacjaSO1'. Zarw no a plikacja j ak i
AsAlert zainstalowane zostay na tym samym komputerze. Alerty
przewidziano jako wiadomoci rozsyane poczt elektroniczn. Poniszy
przykad zrealizowano na wersji 6 Asixa.
1. W pierwszej kolejnoci skonfiguruj modu AsAlert, definiujc
uytkownikw moduu AsAlert, baz danych alertw i adresatw oraz
ustawienia moduu komunikacyjnego, za pomoc ktrego bd
rozsyane alerty:
1a. Uytkownicy
Wybierz konfigurator moduu AsAlert > menu Ustawienia > p olecenie
Uzytkownicy...
W oknie 'Uytkownicy' dodaj uytkownika:
Nazwa: Operator1 (z uprawnieniami do konfiguracji)
Haso: askom

Rysunek: Konfiguracja uytkownika moduu AsAlert.

38

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

1b. Baza danych alertw

Wybierz konfigurator moduu AsAlert > menu Ustawienia > polecenie
Bazy danych...
W oknie 'Bazy danych alertera' utwrz bazy danych dla alertw (typ
bazy danych: Microsoft SQL):
- kliknij przycisk Utwrz;
- wybierz typ bazy: Microsoft SQL;
- w oknie 'Baza danych SQL' zdefiniuj parametry bazy:
Nazwa bazy danych: BazaAlertow1
Nazwa serwera: <nazwa komputera, na ktrym zainstalowany jest
AsAlert>

Rysunek: Konfiguracja bazy danych alertw.

1c. Baza danych adresatw
Wybierz konfigurator moduu AsAlert > menu Ustawienia > polecenie
Bazy danych...
W oknie 'Bazy danych alertera' utwrz bazy danych dla adresatw (typ
bazy danych: Microsoft SQL):
- kliknij przycisk Utwrz;
- wybierz typ bazy: Microsoft SQL;
- w oknie 'Baza danych SQL' zdefiniuj parametry bazy:
Nazwa bazy danych: BazaAdresatowAlertow1
Nazwa serwera: <nazwa komputera, na ktrym zainstalowany jest
AsAlert>

39

AsAlert

Rysunek: Konfiguracja bazy danych adresatw.

1d. Adresat alertw
Wybierz konfigurator moduu AsAlert > menu Ustawienia > polecenie
Adresaci...
W oknie 'Adresaci' dodaj nowego adresata:
Nazwa: Rozdzielnia1
E-mail: <dla przykadu wpisz swj adres e-mailowy>

Rysunek: Konfiguracja adresata alertw.

1e. Ustawienia moduu komunikacyjnego
Wybierz konfigurator moduu AsAlert > menu Ustawienia > polecenie
Moduy komunikacyjne...

40

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

W oknie 'Moduy komunikacyjne' skonfiguruj modu komunikacyjny

poczty elektronicznej [SMTP]:
- w polu Modu poczty elektronicznej wybierz pozycj 'Modu
komunikacyjny poczty elektronicznej [SMTP]';
- w oknie parametrw moduu SMTP uruchamianym przyciskiem '...'
zdefiniuj nastpujce parametry konta e-mailowego, ktre
wykorzystywane bdzie do rozsyania alertw (dla przykadu wpisz
parametry swojego konta e-mailowego):
Serwer: <adres serwera poczty wychodzcej (SMTP)>
Port: <numer portu serwera wychodzcego (SMTP)>
Nazwa nadawcy: Operator1
Adres nadawcy: <adres pocztowy email nadawcy alertu>
Jeli serwer poczty wychodzcej wymaga uwierzytelnienia, naley
poda nazw i haso uytkownika konta.

Rysunek: Konfiguracja moduu komunikacyjnego.

1e. Test konfiguracji moduu AsAlert
Uruchom modu AsAlert. W tym celu wybierz polecenie Start z m enu
Alerter konfiguratora.
Zaloguj sie jako uytkownik 'Operator1':
- z menu Ustawienia wybierz polecenie Logowanie... i zaloguj si
zgodnie z utworzon przez siebie nazw i hasem uytkownika;
Nazwa: Operator1
Haso: askom
Wylij testowego alerta do uytkownika 'Rozdzielnia1';

41

AsAlert

- z menu Alerter wybierz polecenie Wylij alert...;

- w oknie edycyjnym alerta wybierz z bazy nazw adresata
'Rozdzielnia1', wpisz temat i tre alertu (np. test); w polu Nadawca
automatycznie powinien pojawi si 'Operator1' - zgodnie z
ustawieniami moduu komunikacyjnego;
- klinik przycisk Wylij;
Sprawd w swojej skrzynce mailowej, czy otrzymae maila od
nadawcy Operator1. Jeli tak, oznacza to, e modu AsAlert zosta
prawidowo skonfigurowany.

2. W kolejnym kroku skonfiguruj sprzg pomidzy moduem

AsAlert a systemem alarmw aplikacji (w przykadzie jest to
testowa aplikacja Fabryka):
Uruchom konfigurator sprzegu AsAlert - Alarmy.
Skonfiguruj poczenie, deklarujc w odpowiednich polach nastpujce
parametry:
- Plik inicjalizacyjny aplikacji: C:\Asix\Aplikacje\Fabryka\Fabryka.xml
(podaj swoj ciek instalacyjn do pakietu Asix);
- Nazwa rda alertw: FabrykaDemo; jeeli w tym miejscu nie podasz
adnej nazwy - jako nadawca wiadomoci (alertu) bdzie podawana
nazwa nadawcy zadeklarowanego w module komunikacyjnym
wykorzystywanym do rozsyania alertw;
- Lokalizacja Alertera: (pozostaw pole puste - domylnie oznacza to
bdzie korzystanie z AsAlert zainstalowanego na lokalnym
komputerze);
- Nazwa uytkownika: Operator1 Haso: askom
- Zapisz konfiguracj w pliku o nazwie asalert_sprzeg.XML w katalogu
aplikacji Fabryka, uywajc polecenia Zapisz jako... z menu Plik.

Rysunek: Konfiguracja sprzgu AsAlert - Alarmy.

42

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

3. Zadeklaruj sprzg z moduem AsAlert w pliku

konfiguracyjnym aplikacji:
Uruchom program Architekt z zaadowanym plikiem konfiguracyjnym
aplikacji Fabryka.
Przejd do wariantu aplikacji dla stacji 'StacjaSO1':
- kliknij na pozycj 'Stacja_SO1' w polu Obszary i komputery okna
Architekt.
W kategorii parametrw System alarmw, na zakadce Sygnalizacja /
Alerty zacz opcj AsAlert z podaniem nazwy pliku konfigurujcego
sprzg asalert_sprzeg.xml, utworzonego w poprzednim punkcie.
Zapisz zmiany w pliku konfiguracyjnym aplikacji.

Rysunek: Doczenie sprzgu

konfigurujcych prac aplikacji.

AsAlert-

Aalrmy

do

parametrw

4. Zdefiniuj alert:
Uruchom konfigurator sprzegu AsAlert - Alarmy. Otwrz plik
konfigurujcy sprzg AsAlert - alarmy 'asalert_sprzeg.xml'.
Wybierz polecenie Dodaj... z menu Alert.

43

AsAlert

W oknie 'Wybierz nazw komputera' wybierz nazw zestawu

parametrw aplikacji Fabryka, przewidzianego dla komputera
'StacjaSO1' - nazwa 'Stacja_SO1' z pola Obszary i komputery
programu Architekt. Zatwierd wybr przyciskiem OK.

Rysunek: Wybr komputera, ktrego aplikacja sprzona zostaa z

moduem AsAlert.
W oknie 'Parametry alertu' zdefiniuj nastpujce parametry:
-

Tryb: Start i Koniec;

Numery: 217;
Adresaci: 'Rozdzielnia1'.
Kliknij przycisk OK.

Zapisz wprowadzone zmiany za pomoc polecenia Zapisz w menu Plik.

Rysunek: Parametry alertu sprzonego z systemem alarmw aplikacji

asix.

5. Przetestuj wysyanie alertw w odpowiedzi na zamian stanu

alarmu sprzonego z moduem AsAlert:
Uruchom modu AsAlert i zaloguj si jako uytkownik 'Operator1':
- w tym celu wybierz polecenie Start z menu Alerter konfiguratora
moduu AsAlert.
- z menu Ustawienia wybierz polecenie Logowanie... i zaloguj si
zgodnie z utworzon przez siebie nazw i hasem uytkownika;

44

8. Sprzenie AsAlerta z systemem alarmw klasycznej wersji Asixa

Nazwa: Operator1
Haso: askom
Uruchom aplikacj Fabryka dla stacji 'StacjaSO1':
-

uruchom Architekta;
otwrz plik Fabryka.xml;
kliknij na pozycj 'Stacja_SO1' w polu Obszary i komputery;
uruchom aplikacj poleceniem Uruchom system Asix z menu Plik.

Wygeneruj alarm 217:

- w tym celu kliknij na przycisk 'GENERACJA ALARMU ZA POMOC
SKRYPTU', znajdujcy si na gwnej masce aplikacji Fabryka. Po chwili
wycz alarm poniszym przyciskiem 'Kasowanie'.
Sprawd w swojej skrzynce mailowej, czy otrzymae 2 maile od
nadawcy 'FabrykaDemo': jeden informujcy o zaczeniu alarmu,
drugi- o dezaktywacji alarmu. Jeli tak, oznacza to, e system
wysyania alertw sprzony z systemem alarmw Asixa dziaa
prawidowo.

Rysunek: Alerty w postaci e-maili.

45

9 Programowy dostp do funkcji AsAlert

9.1 AsAlert jako system Automation
AsAlert jest serwerem Automation i udostpnia interfejs pozwalajcy innym
aplikacjom, w tym skryptom, na wysyk Alertw. Poniej podano przykad
skryptu w jzyku VBScript realizujcego wysyk alertu do adresata o nazwie
AKP:
Dim Alerter, Alert
Set Alerter = CreateObject("Alerter.Alerter")
Alerter.User = "Kocio"
Set Alert = Alerter.NewAlert
Alert.To = "AKP"
Alert.Subject = "Przekroczona maksymalna warto temperatury"
Alert.Body = "Temperatura wynosi 120 stopni"
Alerter.Send Alert
Naley pamita, e realizacja funkcji AsAlerta moe powodowa generacj
wyjtkw (bdw) np.: "brak autoryzacji", "niekompletna posta alertu", itp. Do
obsugi tych sytuacji naley wykorzysta stosowne mechanizmy uytego jzyka
programowania (np. instrukcja On error i obiekt Err jzyka VBScript).

9.2 Obiekt Alerter

Podstawowym udostpnianym obiektem Automation jest obiekt Alerter o
identyfikatorze p rogramowym Alerter.Alerter. Przed uyciem metod i wasnoci
tego obiektu naley poda nazw i haso uytkownika (ustawienie wasnoci User
oraz Password stosownie do parametryzacji AsAlerta - patrz: Autoryzacja
dostpu do AsAlerta). Poniej podano wasnoci oraz metody obiektu Alerter.
Authorized
MajorVersion
MinorVersion
NewAlert
Password
Send

User

- wasno posiada warto True, gdy wasnoci User oraz

Password zostay poprawnie ustawione oraz warto False w
przeciwnym wypadku. (Tylko do odczytu).
- wasno posiada warto rwn gwnemu skadnikowi
numeru wersji AsAlert. (Tylko do odczytu).
- wasno posiada warto rwn pomocniczemu
skadnikowi numeru wersji AsAlert. (Tylko do odczytu).
- metoda powoduje utworzenie i zwrcenie obiektu Alert.
Metoda nie wymaga podania adnych parametrw.
- wasno - haso dostpu do AsAlert dla uytkownika
okrelonego wasnoci User. (Odczyt/zapis).
- metoda powoduje weryfikacj uprawnie uytkownika
oraz poprawnoci alertu, a nastpnie zainicjowanie wysyki
alertu. Parametrem tej metody jest obiekt Alert zwrcony
przez metod NewAlert. Pomylne zakoczenie wywoania
tej metody nie oznacza fizycznego wysania alertu, a
jedynie zainicjowanie procesu wysyki.
- wasno - nazwa uytkownika. (Odczyt/zapis).

46

9. Programowy dostp do funkcji AsAlert

9.3 Obiekt alert

Obiekt Alert zwracany jest przez metod NewAlert obiektu Alerter. Reprezentuje
on pojedynczy alert. Obiekt posiada nastpujce wasnoci i metody.
Body
- wartoci wasnoci jest tekst stanowicy tre alertu.
Tre alertu moe skada si z wielu linii. Poszczeglne linie
naley oddziela znakiem o kodzie 13 (w kodzie
dziesitnym). Np.:"Temperatura wody = 150" & Chr(13) &
"Temperatura powietrza=90".(Odczyt/zapis).
From
- wartoci wasnoci jest tekst okrelajcy nadawc Alertu.
(Odczyt/zapis).
Subject
- wartoci alertu jest tekst okrelajcy temat alertu.
(Odczyt/zapis).
To
- wasno okrelajca adresatw alertu. Wartoci
wasnoci jest tekst zawierajcy nazwy poszczeglnych
adresatw oddzielone rednikami. Mona podawa tylko
nazwy adresatw wystpujce w bazie danych adresatw.
(Odczyt/zapis).

47