Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Welcome3 Beleptetorendszer Programozói kézikönyv
beks Kommunikációs Technika Kft 4024, Debrecen, Rákóczi utca 21 www.beks.hu www.welcome3.hu
2013. március 7.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Tartalomjegyzék Rendszer telepítési folyamatábra.................................................................................................................. 6 Welcome3 szoftver telepítés PC-re ........................................................................................................... 7 Beléptető rendszerhez tartozó adatbázis létrehozása .............................................................................. 9 Első bejelentkezés ................................................................................................................................... 12 Beléptetés logikai alkotóelemeinek felvétele ......................................................................................... 13 Mozgási szabályrendszerek rögzítése ..................................................................................................... 15 Személyek rögzítése ................................................................................................................................ 19 Hardverek szoftverrel felismertetése ...................................................................................................... 20 Alap setupolási funkciók.......................................................................................................................... 21 Alap monitorozási funkciók ..................................................................................................................... 21 PC-s olvasó csatlakoztatása ..................................................................................................................... 21 Hatókör és modul licencek betöltése ...................................................................................................... 22 Beléptető pontok és hardver eszközök összekapcsolása ........................................................................ 24 Hardverek beállítása ................................................................................................................................ 25 Konfigurálás ......................................................................................................................................... 25 Programozás ........................................................................................................................................ 25 Állapot megtekintése .......................................................................................................................... 25 Zónariasztás beállítása ........................................................................................................................ 25 Hatókörbe tétel ................................................................................................................................... 25 Hibaszámlálók kiolvasása .................................................................................................................... 25 Események kiolvasása ......................................................................................................................... 25 Mozgási szabályrendszerrel ellátott belépőkártya rögzítése .................................................................. 25 Licenc kezelés .............................................................................................................................................. 26 Licenc politika .......................................................................................................................................... 26 Kliens keretrendszer ................................................................................................................................ 26 Setup modul ............................................................................................................................................ 26 Monitor modul ........................................................................................................................................ 26 Porta modul ............................................................................................................................................. 26 Szoftver funkciók ......................................................................................................................................... 27 Új verzió frissítés ..................................................................................................................................... 27 Főablak .................................................................................................................................................... 27
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Gyorsindító .......................................................................................................................................... 27 Menü ................................................................................................................................................... 27 Felugró üzenetek ................................................................................................................................. 27 Beállítások ............................................................................................................................................... 27 Rendszer beállítások ............................................................................................................................ 27 Licenc ....................................................................................................................................................... 27 Licenc kezelő........................................................................................................................................ 27 Áthaladás ................................................................................................................................................. 28 Áthaladás lista ..................................................................................................................................... 28 Áthaladás karbantartó ......................................................................................................................... 29 Anti-passback zóna .................................................................................................................................. 30 Anti-passback zóna lista ...................................................................................................................... 30 Anti-passback zóna karbantartó.......................................................................................................... 31 Helyiség ................................................................................................................................................... 32 Helyiség lista ........................................................................................................................................ 32 Helyiség karbantartó ........................................................................................................................... 33 Helyiségcsoport ....................................................................................................................................... 34 Helyiségcsoport lista............................................................................................................................ 34 Beléptető pont ........................................................................................................................................ 35 Beléptetőpont lista .............................................................................................................................. 35 Beléptetőpont karbantartó ................................................................................................................. 36 Személy.................................................................................................................................................... 37 Személy lista ........................................................................................................................................ 37 Személy karbantartó ........................................................................................................................... 38 Személycsoport ................................................................................................................................... 39 Belépőkártya ........................................................................................................................................... 41 Belépőkártya lista ................................................................................................................................ 41 Belépőkártya karbantartó ................................................................................................................... 42 Próbakártya írás ...................................................................................................................................... 43 Mozgási szabályrendszer ......................................................................................................................... 43 Mozgási szabályrendszer lista ............................................................................................................. 43 Egyszerű............................................................................................................................................... 45 beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Összetett.............................................................................................................................................. 45 Speciális napok beállítása ........................................................................................................................ 46 Speciális napok beállítása .................................................................................................................... 46 Elérés ................................................................................................................................................... 46 Jogkör ...................................................................................................................................................... 46 Jogkör lista ........................................................................................................................................... 46 Jogkör karbantartó .............................................................................................................................. 47 Menü ................................................................................................................................................... 48 Adatbázis ................................................................................................................................................. 49 Generálás............................................................................................................................................. 49 Létező hozzáadás................................................................................................................................. 49 Biztonsági mentés készítés .................................................................................................................. 49 Hardver .................................................................................................................................................... 49 Hardvereszköz lista .............................................................................................................................. 49 Hardverkarbantartó............................................................................................................................. 53 Hardver setup ...................................................................................................................................... 54 Betöltés az eszközmemóriából ............................................................................................................ 55 Aktuális állapot .................................................................................................................................... 55 Állapot történet ................................................................................................................................... 56 Események........................................................................................................................................... 57 Hibaszámláló történet ......................................................................................................................... 58 Aktuális hibaszámláló .......................................................................................................................... 59 Kártyakövetés .......................................................................................................................................... 60 Elérés ................................................................................................................................................... 61 Tartózkodási hely..................................................................................................................................... 61 Elérés ................................................................................................................................................... 62 Munkaidő nyilvántartás........................................................................................................................... 63 Jogcím .................................................................................................................................................. 63 Személy besorolás munkaidő nyilvántartás alá................................................................................... 65 Visszajelzés .............................................................................................................................................. 66 Elérés ................................................................................................................................................... 66 Információs terminál ................................................................................................................................... 68 beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Működés .................................................................................................................................................. 68 Üzemeltetés ............................................................................................................................................ 68 Szoftver frissítés adatbázis séma módosulás esetén .......................................................................... 68 Szoftver frissítés adatbázis séma változatlansága esetén ................................................................... 68 Webes felület .......................................................................................................................................... 69 Szoftver frissítés .................................................................................................................................. 69 Logok megtekintése ............................................................................................................................ 70 Alapfogalmak ............................................................................................................................................... 71 Hatókör .................................................................................................................................................... 71 Gyakran ismételt kérdések .......................................................................................................................... 72 Adatbázis ................................................................................................................................................. 72 SQL Express 2008 szerver megosztása hálózaton ............................................................................... 72
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Rendszer telepítési folyamatábra Welcome3 szoftver telepítése PC-re
Beléptető rendszerhez tartozó adatbázis létrehozása
Welcome hardverek telepítése
Anti-passback zónák, helyiségek, beléptető pontok logikai tulajdonságainak felvétele
Személyek rögzítése, teszt kártyák osztása
Mozgási szabályrendszerek rögzítése
Hardverek használata hatókör nélkül teszt kártyával
Hatókör és modul licencek betöltése
Hardverek szoftverrel felismertetése
Hardverek alap konfigurálása?
Logikai beléptető pontok és fizikai hardvereszközök összekapcsolása
Hardverek hatókörbe helyezése, konfigurálása, programozása
Mozgási szabályrendszerrel ellátott belépőkártyák osztása
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Welcome3 szoftver telepítés PC-re A Welcome szoftver telepítéséhez Windows operációs rendszer (XP, Vista, 7) és rendszergazdai jogosultságok szükségesek. A letöltött Welcome3Setup.exe futtatása után a következő varázsló lépésein kell végigmenni:
A kliens szoftver futásához Microsoft .NET Framework 4.0 keretrendszerre és Microsoft SQL Express 2008 adatbázisszerverre van szükség. Amennyiben ezek korábban nem voltak a gépen megtalálhatóak, most néhány perc alatt automatikusan letöltésre és telepítésre kerülnek.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Első telepítés után újra kell indítani a számítógépet, következő új verziók telepítés után már nincs erre szükség. Az asztalon és a Start menüben a következő ikon kerül elhelyezésre
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A program elindítása után az alábbi bejelentkező képernyő fogad.
A szoftver működéséhez szükséges adatok egy adatbázisban tárolódnak, ezért a szoftver telepítése utáni első feladat az induló adatbázis létrehozása. Ehhez az Adatbázis lenyitható lista melletti tallózó … gombot kell megnyomni.
Beléptető rendszerhez tartozó adatbázis létrehozása A szoftver több adatbázisra is képes csatlakozni, de egyszerre csak egyre. A képernyőn található listában a bejelentkező ablakban felajánlott adatbázisok adatai találhatóak meg. Kezdetben ez a lista üres.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Az induló adatbázis létrehozása egy varázsló segítségével lépésről lépésre történik, ehhez az Új adatbázist generál gombra kell kattintania.
Első lépésben adja meg az adatbázis nevét, valamint a Boss és Adminisztrátor felhasználó jelszavát. A boss felhasználó maximális jogosultságokkal rendelkezik, mindenhez van joga, ezért csak alkalmankénti használata ajánlott. Az adminisztrátor felhasználó a rendszer első valódi felhasználója, ő fog először bejelentkezni. Később több adminisztrátor jogokkal rendelkező felhasználó is létrehozható.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A következő lépésben ki kell választani, hogy a felajánlott listából melyik Mifare Desfire EV1 kártyatípust szeretné támogatni. Ez a döntés később szabadon megváltoztatható. Az utolsó lépésben a Kész gombra kattintás után néhány másodperc alatt létrejön a gépén az új adatbázis és megjelenik a listában.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A Mentés gombot megnyomva visszakapjuk a főablakot, ahol már ki van választva az új adatbázis
A Felhasználói név és jelszó megadása után a Belépés gombra kattintva bejelentkezhetünk.
Első bejelentkezés Első munkaállomás hozzáadása
MAC cím kiválasztása, majd mentés. Főablak fogad:
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Gyorsindító, menü
Beléptetés logikai alkotóelemeinek felvétele Anti-passback zóna felvétele
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Helyiség felvétele
Új helyiség felvétele
Adatok kitöltése, mentés.
Beléptető pont lista
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Új beléptető pont rögzítése
Mozgási szabályrendszerek rögzítése Mozgási szabályrendszerek listája
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A teljes engedély mindenhova korlátozás nélkül beenged. Új egyszerű szabályrendszer hozzáadása.
Az adott beléptető pontokon minden nap minden órájában beenged.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Összetett mozgási szabályrendszer hozzáadása
Több mozgási szabály prioritásos sorrendje. Új mozgási szabály
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Megjelennek a mozgási szabályrendszer listában Licenc kezelés
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Személyek rögzítése Személy listában
Új személy rögzítése
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Teszt kártya osztása Hatókör nélkül csak tesztkártya osztható. Eddigi kártyák listája üres. Új tesztkártya kiosztása A telepített olvasók korlátlanul nyithatók
Hardverek szoftverrel felismertetése Hardver eszköz lista megtekinthető még Setup modul licenc nélkül, ebben csak az induláskor felvett munkaállomás van.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Az új hardverek felvehetők Setup modul licenc nélkül Detektált eszközök jelzése: Autonóm ajtónyitó felvétele: Buszvezérlő felvétele detektálással: Buszvezérlő felvétele IP megadással: Hibás eszközök jelzése: Szakértő mód
Alap setupolási funkciók Jobb kattintós menü részletezése
Alap monitorozási funkciók PC-s olvasó csatlakoztatása A driverek automatikusan települnek a szoftverrel. USB-14-MIF PC-s olvasó első csatlakoztatása során el kell fogadni a felajánlott drivert.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A hardver csatlakoztatásáról a főablak felugró ablakban értesít.
Hatókör és modul licencek betöltése A rendszer hatókörrel ellátása PC-s olvasót kell csatlakoztatni, különben hiba:
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A következő felirat jelenik meg:
A hardver telepítése funkciók eléréséhez SETUP modult kell telepíteni. Modul licencek telepítése Megjelennek a licenc listában a telepített modul licencek. Licencek betöltése után újra be kell jelentkezni azok használatához.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Beléptető pontok és hardver eszközök összekapcsolása A beléptető pontok beüzemeléséhez WACM_ACP licencekre van szükség, ezek rendelkezésre álló mennyisége a képernyő alján található. SCREENSHOT Telepítés után a korábban már rögzített beléptető pontokhoz hardver kapcsolható a licencek erejéig.
Kevés beléptető pont licenc esetén a következő hibaüzenettel szembesül:
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
SCREENSHOT Innentől kezdve ez a beléptető pont hardver eszközzel rendelkezik, így konfigurálható.
Hardverek beállítása Konfigurálás Programozás Állapot megtekintése Zónariasztás beállítása Hatókörbe tétel Hibaszámlálók kiolvasása Események kiolvasása
Mozgási szabályrendszerrel ellátott belépőkártya rögzítése Hatókörbe helyezett rendszerben a tesztkártyák és telepítői kártyák tovább már nem használhatók Drag and drop
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Licenc kezelés Licenc politika Kliens keretrendszer
beléptetés logikai fogalmainak rögzítése o anti-passback zóna o helyiség o beléptető pont személyek rögzítése mozgási szabályrendszerek rögzítése alap setup funkciók o hardver paraméterek beállítása korlátozott keretek között alap monitoring funkciók o hardver pillanatnyi állapotának megtekintése
Setup modul
hardver paraméterek programozása mozgási sémafájlok áttöltése hardver események felolvasása, értelmezése
Monitor modul
kártya követés IP vezérlő szintjén hardver állapotok, események, hibaszámlálók letárolása adatbázisba visszakövethető módon
Porta modul
áthaladási adatok alapján személyek tartózkodás helyének megjelenítése bármely időpontban
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Szoftver funkciók Új verzió frissítés Az új kliens szoftver verzióról a következő RSS címen is értesülhet: http://upgrade.beks.hu/welcome3/desktop/rss.xml
Főablak Gyorsindító Menü Felugró üzenetek
Beállítások Rendszer beállítások IP keresési tartomány kezdete-vége
Licenc Licenc kezelő A rendszerbe telepített licencek, illetve a hatókörrel kapcsolatos információk tekinthetők meg. A rendszerbe licenc csak akkor telepíthető, ha már hatókörben van. A hatókör telepítését csak egyszer lehet megtenni, ezek után csak licenceket lehet hozzáadni.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Hatókör hozzáadása A „Hatókör hozzáadása” gomb megnyomása után tartsuk a csatlakoztatott PC olvasóhoz a hatókör kártyát! Ekkor az adatbázis élesítésre kerül a hatókörrel. A hatókör kártya további adatbázis élesítéséhez nem használható. A rendszer használt hatókörkártyát nem fogad el! Licenc hozzáadása A „Licenc hozzáadása” gomb megnyomása után tartsuk a csatlakoztatott PC olvasóhoz a licenc kártyát! Ekkora rendszerben lévő licencekhez hozzáadódik az új licenc. A licenckártya másik rendszerben nem használható fel. A rendszer használt licenckártyát nem fogad el! Licenc lista A rendszerben lebegő licenc kezelés van, így ha egy felhasználó használatba vesz egy licencet, amíg a kilépéssel le nem mond róla, más nem használhatja. A listában szerepel a licenc neve, illetve azon személy adatai aki éppen a licencet használja. Beléptetőpont licenc információ A rendszerben a hardverrel ellátható beléptetőpontok számát a meglévő beléptetőpont licencek határozzák meg. Amennyiben a beléptetőpontok száma elérte a licencek által megengedettet, új beléptetőpont nem hozható létre. A szabad beléptetőpont licencekre vonatkozó információt a beléptetpont licenc információ táblázatban láthatjuk. Elérés Törzsadatok -> Licenc -> Licenc kezelő
Áthaladás Áthaladás lista Az áthaladás listában a rendszerben szereplő áthaladások szerepelnek. Ha egy személy megpróbál átjutni egy beléptető ponton egyik helyiségből a másikba egy áthaladás bejegyzés születik róla. Ezekből a bejegyzésekből épül fel az áthaladás lista.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A lista tartalmazza, hogy mikor történt az áthaladás, az áthaladó személy nevét, a beléptető pontot melyen áthaladt, a helyiséget ahová bement, valamint hogy sikerült-e az áthaladás, vagy esetleg lépett-e fel valamilyen hiba. A listában lehetőségünk van másodperc pontos időintervallumra szűrni. A lista további szűkítését a bal és jobb oldalon található dokkolható füleken állíthatjuk be, hogy csak a számunkra fontos információk jelenjenek meg. A lista alapértelmezetten a mai napon történt az érvényes áthaladásokat listázza. Gombok A lista alatt szereplő gombokra kattintva lehetőségünk van új áthaladást létrehozni, meglévő áthaladást módosítani, illetve áthaladást törölni. Az alapállapot feliratú gomb visszaállítja a szűrőket az alap értékekre. Virtuális áthaladás: Olyan áthaladás, melyet az áthaladás karbantartóval rögzítünk be. Csak a virtuális áthaladások módosíthatók! Áthaladás lista helyi menü A listán jobb egérgombbal kattintva felugró helyi menü segítségével módosíthatjuk az áthaladó személy adatait. Elérés Beléptetés -> Áthaladás lista Áthaladás karbantartó Az áthaladás karbantartó segítségével jegyezhetünk be új áthaladást, vagy módosíthatunk egy meglévőt.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Az áthaladás karbantartó az áthaladás lista alján, a „Létrehoz” feliratú gomb megnyomása után válik elérhetővé. Elérés Beléptetés -> Áthaladás lista -> Létrehoz / Módosít
Anti-passback zóna Anti-passback zóna lista Az anti-passback zóna listában a rendszerben szereplő anti-passback zónák és színeik szerepelnek, valamint, hogy a zónák riasztó által felügyeltek-e.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Beléptetőpont -> Anti-passback zóna lista Gombok A lista alatt szereplő gombokra kattintva lehetőségünk van új anti-passback zónát létrehozni, meglévő anti-passback zónát módosítani, illetve törölni. A „Töröltek is” feliratú jelölőnégyzet segítségével megjeleníthetők a rendszerben korábban létezett, ám törlésre került anti-passback zónák is. A Külvilág anti-passback zóna nem módosítható! Olyan anti-passback zóna nem törölhető, melybe helyiség van besorolva! Ha mégis törölni szeretnénk egy ilyen zónát, a hozzá tartozó helyiségeket módosítanunk kell a helyiség karbantartó segítségével. Mégpedig olyan módon, hogy átállítjuk a törölni kívánt anti-passback zónát a megfelelő helyiségeken. Ezt a helyiséglistán tudjuk megtenni. Anti-passback zóna lista helyi menü A listán jobb egérgombbal kattintva felugró helyi menü segítségével megtekinthetjük a kijelölt zónában történt áthaladások listáját illetve, hogy milyen beléptető pontok és helyiségek tartoznak ebbe a zónába. Anti-passback zóna karbantartó Az anti-passback zóna karbantartó segítségével hozhatunk létre új anti-passback zónát, vagy módosíthatunk egy meglévőt. Az anti-passback zónának megadható a neve (ez nem egyezhet meg a rendszerben tárolt másik anti-passback zóna nevével!), hogy melyik színt szeretnénk hozzárendelni, és hogy a zóna riasztó által felügyelt-e.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Az anti-passback zóna karbantartó az anti-passback zóna lista alján, a „Létrehoz” feliratú gomb megnyomása után válik elérhetővé. Elérés Törzsadatok -> Beléptetőpont -> Anti-passback zóna lista -> Létrehoz / Módosít
Helyiség Helyiség lista A helyiség listában a rendszerben szereplő helyiségek szerepelnek, valamint, hogy milyen anti-passback zónába vannak besorolva, és hány bejáratuk van.
Gombok A lista alatt szereplő gombokra kattintva lehetőségünk van új helyiséget létrehozni, meglévő helyisége módosítani, illetve helyiséget törölni. A „Töröltek is” feliratú jelölőnégyzet segítségével megjeleníthetők a rendszerben korábban létezett, ám törlésre került helyiségek is. beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Külvilág: Külvilágnak hívjuk azt a helyiséget, melyben a rendszerben szereplő személyek akkor tartózkodnak, ha épp nincsenek az épületben. Ez a helyiség mindig létezik a rendszerben alapértelmezetten. A Külvilág, mint helyiség nem módosítható, illetve nem törölhető! Helyiség lista helyi menü A listán jobb egérgombbal kattintva felugró helyi menü segítségével módosíthatjuk a helyiség antipassback zónáját, illetve megtekinthetjük, hogy a kijelölt helyiség bejáratain milyen áthaladások történtek, valamint mely beléptetőpontokon keresztül mozoghatunk a helyiségből ki és be. Elérés Törzsadatok -> Beléptetőpont -> Helyiség lista Helyiség karbantartó A helyiség karbantartó segítségével hozhatunk létre új helyiséget, vagy módosíthatunk egy meglévőt. A helyiségnek megadható a neve (ez nem egyezhet meg a rendszerben tárolt másik helyiség nevével!), hogy melyik anti-passback zónába akarjuk besorolni, illetve egy megjegyzés mező.
A helyiség karbantartó a helyiség lista alján, a „Létrehoz” feliratú gomb megnyomása után válik elérhetővé. Elérés Törzsadatok -> Beléptetőpont -> Helyiség lista -> Létrehoz / Módosít
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Helyiségcsoport Helyiségcsoport lista A rendszerben szereplő helyiségek a könnyebb kezelhetőség kedvéért helyiségcsoportokba sorolhatók. A helyiségcsoport lista segítségével tarthatjuk karban ezeket a csoportokat. A képernyőn megjelenő táblázat soraiban az egyes helyiségcsoportok szerepelnek. Az első oszlop a helyiségcsoport neve, az ezt követő oszlopok a helyiségeke t jelölik. Egy adott cellában szereplő érték attól függ, hogy az oszlopához tartozó helyiség tagja-e a sorához tartozó helyiségcsoportnak. Amennyiben az adott helyiség az adott helyiségcsoporthoz tartozik, a megfelelő cellában, a jelölőnégyzetben pipa szerepel. Az összerendelés módosítása a megfelelő cellába történő kattintással módosítható. A helyiségcsoport neve a név oszlopba történő kattintással szerkeszthetővé válik. Amennyiben egy helyiség sem tartozik, a csoporthoz nem kerül mentésre.
Gombok A lista alatt található gombokkal létrehozhatunk, klónozhatunk illetve törölhetünk helyiségcsoportokat. A létrehozáskor a táblázatban megjelenik egy új helyiségcsoport. Klónozáskor a kiválasztott helyiségcsoportot tudjuk lemásolni, mégpedig olyan formában hogy az újonnan létrejövő helyiségcsoport helyiségei megegyeznek a kiválasztott helyiségcsoportéval. A változtatások csak a „Változtatások mentése” feliratú gombra történő kattintással menthetők. Helyi menü A jobbgombos helyi menüben lehetőségünk van megtekinteni az adott helyiségcsoporthoz tartozó helyiségek illetve beléptető pontok listáját.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Beléptetőpont -> Helyiségcsoport lista
Beléptető pont Beléptetőpont lista A beléptetőpont lista a rendszerben szereplő beléptetőpontokat listázza. Beléptetőpontnak nevezzük azokat az objektumokat, melyeken keresztül a személyek a beléptetőrendszert használva egyik helyiségből a másikba juthatnak át ellenőrzött keretek között (pl. ajtó, forgóvilla, sorompó, stb.).
Gombok A lista alatt szereplő gombokra kattintva lehetőségünk van új beléptetőpontot létrehozni, meglévőt módosítani, illetve törölni. A „Töröltek is” feliratú jelölőnégyzet segítségével megjeleníthetők a rendszerben korábban létezett, ám törlésre került beléptetőpontok is. Helyiség lista helyi menü A listán jobb egérgombbal kattintva felugró helyi menü segítségével megtekinthetjük a kiválasztott beléptetőponton történt áthaladások listáját. Elérés Törzsadatok -> Beléptetőpont -> Beléptetőpont lista
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Beléptetőpont karbantartó A beléptetőpont karbantartó segítségével hozhatunk létre új beléptetőpontot, vagy módosíthatunk egy meglévőt. Lehetőségünk van megadni a beléptetőpontunk nevét (ez nem egyezhet meg más rendszerben tárolt beléptetőpont nevével), típusát, valamint, hogy menekülési útvonal-e. Kiválaszthatjuk, hogy beléptetőpontunk melyik helyiségek között biztosítson átjárást, és milyen rendszerben tárolt nyitóeszközzel legyen felszerelve. A helyiségek és nyitóeszközök közötti feliratú gombok segítségével egyszerűen és gyorsan megcserélhetjük beléptetőpontunk két oldalához tartozó helyiségeket és hardvereszközöket.
Elérés Törzsadatok -> Beléptetőpont -> Beléptetőpont lista -> Lértehoz / Módosít
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Személy Személy lista A személylistában a rendszerben szereplő személyeket lehet megtekinteni.
Gombok Frissít Az idő közben bekövetkezett esetleges változások miatt ezzel a gombbal lehet a lista tartalmát aktualizálni. Létrehoz Új személyt lehet létrehozni, megnyomása után megnyitja a személykarbantartót. Módosít A behozza az adott személyhez karbantartó felületet. Töröl A kiválasztott személyt lehet törölni. Törlés előtt rákérdez. Keres Belépőkártya alapján is lehet személyt keresni. Elérés Törzsadatok -> Személy -> Személy lista
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Személy karbantartó A személykarbantartó segítségével hozhatunk létre új személyeket, illetve módosíthatjuk a meglévők adatait,valamint a személyhez tartozó belépőkártyákat.
Személyes adatok A személy neve kötelezően töltendő mező. A többi személyes adat megadása opcionális. Ahhoz hogy a személy a Welcome rendszerben is felhasználó legyen, meg kell adni egy egyedi felhasználói nevet, illetve egy jelszót. Jelszó megadása esetén a régi jelszó felülíródik. Jogkör Egy személy egy időben csak egy jogkörhöz tartozhat. Ezen jogkör kiválasztását a „Jogkör” feliratú legördülő lista segítségével tehetjük meg. Személycsoport Egy személy egy időben több személycsoportba is tartozhat. A személycsoportba sorolást a „Személycsoportok” feliratú legördülő lista segítségével tehetjük meg. Kártya adatok A személyhez tartozó belépőkártyákat a „Kártya adatok” fülön lehet karbantartani. A személyhez egy időben több kártya tartozhat, de egy kártya egy időben csak egy személyhez. A megjelenő táblázatban
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
láthatjuk a kártya érvényességének kezdetét - végét, a kártyán található mozgási szabályrendszereket, a kódkártya típust illetve azonosítót, valamint a kártya státuszát. A kártya 3 státuszban lehet:
Aktív Törölve Feketelistás
Ezen állapotok közül csak az aktív állapot jogosít belépésre a rendszerben. Új kártya felvétele Az adott személyhez csak olyan kártyát vehetünk fel, amely éppen nem tartozik egyetlen személyhez sem. Amennyiben jelenleg az adott személyhez tartozik, módosításra kerül. Az „Új kártya…” feliratú gombra történő kattintás után megjelenik a belépőkártya karbantartó, ahol megadható a kártya érvényessége illetve a kártyára írandó mozgási szabályrendszerek. Kártya törlése Amennyiben törlünk egy kártyát, a kártyáról a beléptetésre jogosító mozgási szabályrendszereket is törölni kell, így a törléshez a gomb megnyomása után a PC-s olvasóhoz kell tartani a kártyát. Ezek után a kártya más személyhez rendelhető. Elérés Törzsadatok -> Személy -> Személy lista -> Létrehoz / Módosít Személycsoport Személycsoport lista A listában a rendszerben szereplő személycsoportok szerepelnek a hozzájuk tartozó tulajdonos személlyel. A lista alatti gombok segítségével lehet személycsoportot létrehozni, módosítani illetve törölni.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Személy -> Személycsoport lista Személycsoport karbantartó A személycsoport karbantartó segítségével tudjuk a személycsoportjaink nevét megváltoztatni, illetve, hogy globálisak-e. Globális személycsoport: Minden felhasználó számára publikus.
Elérés Törzsadatok -> Személy -> Személycsoport lista -> Létrehoz vagy Módosít
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Belépőkártya Belépőkártya lista A belépőkártya listán tekinthetjük meg a rendszerben valaha kiadott belépőkártyákat. Amennyiben egy fizikai kártya az idők folyamán több személy tulajdonában is volt, minden összerendelésről születi bejegyzés. A belépőkártyákról az alábbi információk állnak rendelkezésre: Érvényesség kezdete, vége Azon időszak kezdete, amelyen belül a kártya érvényes. Amennyiben az aktuális idő ezen időszakon kívül esik, a kártya áthaladásra nem jogosít, annak ellenére, hogy rendelkezik olyan mozgási szabállyal, amely túlmutat az érvényességen. Mozgási szabályrendszerek Azon szabályok melyek a kártya áthaladásra jogosít. Belépőkártya azonosítók, Kódkártya altípusok A belépőkártyához tartozhat több fizikai azonosító amelyek lehetnek proxy kártyák,vonalkódok, ujjlenyomatok. Ezen fizikai azonosítók egyedi kódjai, illetve ezek típusai. Tulajdonos A belépőkártya tulajdonosa az adott időpontban. Típus A kártyáknak 3 típusa létezik, telepítői kártya, próbakártya, illetve belépőkártya. Státusz A kártyák 3 állapotban létezhet, törölt, feketelistás, illetve aktív.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Beléptetés -> Belépőkártya lista Belépőkártya karbantartó
A belépőkártya karbantartón állítható be a kártya érvényessége, illetve az hogy milyen mozgási szabályrendszerek tartoznak a kártyához. A bal oldali, „Kiválasztott” feliratú listában láthatók a kártyán már szereplő mozgási szabályok, a jobb oldali „Kiválasztható” feliratúban pedig a rendszerben igen de a kártyán még nem szereplő szabályrendszerek. A jobb oldali listáról fogd és vidd módszerrel lehet a kártyára tenni a mozgási szabályrendszereket. A kártyára csak a Kártyaírás gombra történő kattintás után fog kerülni. A módosítások adatbázisba is mentődnek.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Személy -> Létrehoz / Módosít -> Kártya adatok fül
Próbakártya írás Mozgási szabályrendszer Mozgási szabályrendszer lista A mozgási szabályrendszer lista a rendszerben lévő mozgási szabályrendszereket listázza. Egy mozgási szabályrendszer mozgási szabályokból áll. Ezek határozzák meg, hogy az egyes személyek, személycsoportok mikor és hol közlekedhetnek.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Gombok A lista alatt szereplő gombokra kattintva lehetőségünk van létrehozni új mozgási szabályrendszereket: A létrehoz gomb jobb oldalán lévő nyílra kattintva a legördülő menüből kiválaszthatjuk, hogy egyszerű vagy összetett mozgási szabályrendszert akarunk létrehozni. Egyszerű mozgási szabályrendszer: Az ilyen szabályrendszer csak egy darab mindig engedő mozgási szabályt tartalmaz. Továbbá módosíthatunk meglévőket, klónozhatunk illetve törölhetünk szabályrendszereket. Elérés Törzsadatok -> Mozgási szabályrendszer -> Mozgási szabályrendszer lista
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Egyszerű Egyszerű mozgási szabályrendszer karbantartó
Elérés Törzsadatok -> Mozgási szabályrendszer -> Mozgási szabályrendszer lista -> (Létrehoz -> Egyszerű) / (Módosít -> Egyszerű) Összetett Összetett mozgási szabályrendszer karbantartó
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Mozgási szabályrendszer -> Mozgási szabályrendszer lista -> (Létrehoz -> Összetett) vagy (Módosít -> Összetett)
Speciális napok beállítása Speciális napok beállítása A speciális nap karbantartón lehetőségünk van megjelölni egy naptárban a munkaszüneti napokat, valamint a hétvégi munkanapokat. Ezt a bal oldali panelek segítségével tehetjük meg. Ha felveszünk, egy speciális napot az automatikusan megjelölésre kerül a naptárban.
A változásokat a Ment feliratú gomb segítségével hagyhatjuk jóvá. Elérés Törzsadatok -> Beállítások -> Speciális napok beállítása
Jogkör Jogkör lista A jogkör listán tekinthetőek meg az adatbázisban szereplő jogkörök. A táblázat oszlopaiban szerepel a jogkörbe sorolt személyek száma, illetve a jogkörhöz tartozó menüpontok illetve jogosultságok száma is. beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Boss: A Boss a legmagasabb jogosultságú felhasználó, mindenhez van joga. Csak alkalmankénti használata javasolt! Felhasználói neve mindig Boss, a jelszavát helyezze biztonságba! A napi rutinfeladatok elvégzéséhez használja az Adminisztrátor felhasználót! Adminisztrátor: Az Adminisztrátor felhasználó a rendszer karbantartói funkcióját látja el. Mindennapi rendszergazdai feladatok ellátására javasolt felhasználó. A telepített rendszerben ezek az adatok megváltoztathatók, akár másik Adminisztrátor is rögzítheti. Gombok A lista alatt található gombok segítségével lehet létrehozni, klónozni, módosítani, illetve törölni jogköröket. A Boss jogkör nem módosítható vagy törölhető. Helyi menü A jobb egérgombos helyi menü segítségével megtekinthető az adott jogkörbe tartozó személyek listája. Elérés Törzsadatok -> Személy -> Felhasználói beállítások -> Jogkör lista Jogkör karbantartó A jogkör karbantartó segítségével hozhatunk létre új jogkört, vagy módosíthatunk egy meglévőt. A jogkörnek megadható a neve (ez nem egyezhet meg a rendszerben tárolt másik jogkör nevével!).
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Az jogkör karbantartó a jogkör lista alján, a „Létrehoz” feliratú gomb megnyomása után válik elérhetővé. Elérés Törzsadatok -> Személy -> Felhasználói beállítások -> Jogkör lista -> Létrehoz / Módosít Menü Menüpontok jogkör szerinti láthatósága A Welcome rendszerben az adminisztrátor a menüpontok láthatóságát jogkörökhöz tudja rendelni. Ez azt jelenti, hogy bizonyos menüpontok csak olyan felhasználók számára jelennek meg akik tagjai az adott jogkörnek. A listában alábonthatóan látszik a menü, illetve a rendszerben szereplő jogkörök oszlopokként. A láthatóságot a megfelelő jelölőcellába történő pipa elhelyezéssel lehet szabályozni. Egy menüpont egy adott jogkör számára akkor látható, ha a menüpont sorának, a jogkör szerinti oszlop metszéspontjában lévő cellában pipa található. A módosítások a „Mentés” gombra történő kattintáskor kerülnek az adatbázisba.
Elérés Törzsadatok -> Személy -> Felhasználói beállítások -> Menüpontok jogkör szerint
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Adatbázis Generálás Létező hozzáadás Biztonsági mentés készítés
Hardver Hardvereszköz lista A hardver eszköz lista a rendszerbe illesztett hardvereszközökből (beleértendők a Welcome Klienst futtató munkaállomások is), illetve a lokális géphez csatlakoztatott lokális eszközökből állnak. A lista elemei a hierarchikus viszonynak megfelelően egymás alatt jelennek meg. PL: A buszvezérlőn található Ajtónyitó olvasók a buszvezérlő alatt jelennek meg.
Hardverszint szűrő A listában szereplő elemeket, a lista alatt található választó mező segítségével a hardvernek megfelelő szint szerint lehet szűrni. Ez azt jelenti hogy a listában csak azok a hardverek jelennek meg amelyek legalább a kiválasztott szinten állnak. pl.: ha a kiválasztott szint aktív hardver akkor eltűnnek az egyszerű illetve passzív hardverek, de megmaradnak az aktív, Ip hardverek illetve munkaállomások.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Oszlopok A különböző szintű hardvereknek különböző tulajdonságai vannak, így az oszlopok a kiválasztott szinttől függően változnak. Kapcsolat A kapcsolat oszlop lehetséges értékei:
Kapcsolódva Az eszközzel kommunikációt lehetett létesíteni. Nincs kapcsolat Az eszköz nem érhető el.
Állapot Az állapot oszlop lehetséges értékei:
OK A hardverrel minden rendben. Hardware hiba A hardver vagy nem érhető el, vagy az általa szolgáltatott információk nem egyeznek meg az adatbázisban szereplő értékekkel. (pl címzési hiba) Adatbázis hiba Az adatbázisban még nem létezik a hardver
Hardver információk Hardvernév Hardverszint DeviceID HW Verzió SW Verzió Sorozatszám IP-cím MAC-cím Beléptetőpont információk Honnan helyiség Hova Helyiség Beléptetőpont Csatlakozasigény Logikai érték, van e valamilyen elvégzendő művelet, amely a hardver csatlakoztatni kell.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Szakértői mód esetén megjelenő oszlopok Alapértelmezés szerint nem látszik minden oszlop, ezek rejtett oszlopokat a „szakértői mód” jelölőnégyzetbe történő pipa elhelyezésével jeleníthetjük meg. Ezek az oszlopok a következők:
Csatlakoztatási igények Azon beavatkozást igénylő műveletek, melyeket a hardver csatlakoztatásakor el kell végezni WelcomeAddress A hardver welcome rendszerben kioszott címe WelcomeID A hardver welcome rendszerben kiosztott ID ja StreamServer A hardverkommunikáciért felelős objektum állapota.
Jobb gombos menü A lista elemein történő kattintáskor a helyi menüben a következő menüpontok szerepelnek: Gyermek hardver hozzáadása A hardver hierarchiában alárendelt hardver hozzáadása. (pl.: Buszvezérlőhöz ajtónyitó-olvasó rendelése) Hardver illesztése a rendszerbe A csatlakoztatott, de a rendszerben még nem szereplő hardvereket lehet a rendszerbe illeszteni. Ez a menüpont csak olyan hardveren aktív, ami még nincs a rendszerbe illesztve. Törlés Az illesztett hardvereket el lehet távolítani a rendszerből. A menüpont csak rendszerbe illesztett hardverek esetén aktív. Módosítás Az illesztett hardverek tulajdonságait lehet módosítani.
A következő menüpontok csak a megfelelő hardverek esetén érhetők el.
Hardver kommunikáció Ezen almenüben találhatóak azok a felületeket amelyek a legalább aktívhardver szinten lévő eszközök vezérléséhez kapcsolódnak. Az alábbi menüpontok a főmenüből is elérhető felületeket nyitja meg fülön a kiválasztott hardverrel előtöltve
Esemény Aktuális állapot
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Állapot történet Aktuális hibaszámláló Hibaszámláló történet
Egyszerűsített hardver kommunikáció Ezen almenü menüpontjai segítségével gyorsan lehet a legalább aktívhardver szinten lévő eszközök vezérlését megoldani, a tipikus beállításokkal. Felületeket nem jelenít meg. Egyszerűsített programozás Az egyszerűsített programozás a következő beállításokat tölti az eszközre:
A rendszer hatóköre Az adatbázisban szereplő welcomeID –welcomeAddress pár Az adott beléptetőponthoz tartozó antipassback zóna információ A rendszer kártyabeállításai (elfogadott belépőkártya típusa, kulcsa stb)
Sémafájl frissítés A rendszerben található mozgási szabályrendszereket leképezi az eszközök által értelmezhető formába, és az eszközre tölti. Hardver eseményfájl kiolvasás A hardver az eseményekről listát vezet az SD kártyáján, a parancs hatására ezek a bejegyzések bekerülnek az adatbázisba. Hibaszámláló kiolvasás A hardver a hibaszámlálói állapotát a parancs hatására felolvassa, majd bekerülnek az adatbázisba. Zónariasztás frissítés Az IPvezérlő által támogatott parancs, az antipassback zóna riasztófelügyeleti beállításait küldi az eszközre. Idő szinkronizálálás Az adatbázisidőhöz szinkronizálja az eszköz óráját. Hatókör eszközre töltés Az eszközt hatókörbe teszi. Csak egyszer lehet megtenni! Beléptetőpont karbantartása Az eszközhöz tartozó beléptetőpont karbantartóját nyitja meg. Gombok Új hardver hozzáadása A hardverkarbantartó segítségével új szülő nélküli hardvert vehetünk fel.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Frissítés A lista hardver csatlakoztatásakor azonnal egyébként előre beállított időközönként t frissül, azonnali frissítés a „Frissítés” gombbal érhető el. Elérés Hardver -> Hardvereszköz lista Hardverkarbantartó Ezen a felületen lehet hardvereket lehet a rendszerben szerelő hardvereket módosítani, újakat hozzáadni egyszerű hardvertől szintűtől, a munkaállomás szintűig. A különböző szintű hardverek különböző tulajdonságokkal rendelkeznek, így attól függően hogy milyen hardvert kívánunk létrehozni vagy módosítani, különböző mezőket fogunk látni.
Hardver eszköz A kiválasztott hardver pontos típusa. Csak létrehozáskor módosítható, meglévő eszköz esetében nem Név A hardvernek egyedi névvel kell rendelkeznie, kitöltése kötelező. Ip cím IP-hardvert, vagy munkaállomás módosítása/létrehozása esetén egyedi IP címet kötelező megadni. Mac cím Munkaállomás létrehozása módosítása esetén kötelező egyedi MAC címet megadni Beléptetőpont Az eszközhöz rendelhető beléptetőpont, amennyiben van szabad licenc. Szakértői mód Amennyiben létező hardvert nyitunk meg módosításra, a szakértői módban megtekinthető az eszköz információi, amennyiben rendelkezik ilyennel :
Hardver verzió
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Szoftver verzió Sorozatszám WelcomeID WelcomeAddress Buszcím
Elérés Hardver -> Hardvereszköz lista -> Új hardver
Hardver setup A hardversetup felület a rendszerbe illesztendő eszközök működési paramétereinek eszközre töltését szolgálja. Ezen paraméterek listája eszközönként eltérő. A paraméterek egy része csak olvasható, ezeket közvetlenül módosítani nem lehet. (pl Antipassback zóna információ) Amennyiben az egyes beállítás értékek módosításra kerülnek, a színük pirosra vált.
Hardver kiválasztása Bal oldalon található azon hardvereszközök listája, amelyek a rendszerben telepítve vannak, vagy nincsenek telepítve, de csatlakoztatva vannak. Azon telepített eszközök beállítás értékei melyek nincsenek csatlakoztatva, az adatbázisból történnek felolvasásra. Ezen értékek megegyeznek a legutóbbi beállítás során az eszközre töltött értékekkel.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Betöltés az eszközmemóriából Segítségével az eszközben lévő beállításértékeket lehet felolvasni. Alapértelmezett értékek Az összes beállítás a gyári alapértelmezett értékre vált. Beállítások mentése fájlba Az aktuális beállításokat ki lehet exportálni XML fájlba hibakeresési célból. Letöltés az eszközmemóriába Az aktuális beállítások letöltésre kerülnek az eszközmemóriába. Ekkor az eszköz működése ezen beállításoknak megfelelően módosul. Amennyiben nem kerülnek SD kártyára mentésre, ezen módosítások újraindítás után elvesznek. SD Kártyára mentés Az eszközmemóriából a beállítás értékek SD kártyára mentődnek, így újraindítás után sem vesznek el. Újraindítás Bizonyos esetekben a beállítások érvénybe léptetéséhez újra kell indítani az eszközt. Ilyen pl a buszvezérlő esetében az IP cím beállítása. Elérés Hardver -> Hardver setup Aktuális állapot A rendszerbe illesztett hardverek állapotát lehet figyelni. Ilyenkor az eszköz bizonyos időközönként információt küld az állapotáról.(Hőmérséklet, pánik státusz, stb.). Ezen értékek adatbázisba is letárolásra kerülnek, később visszakereshető.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Hardver kiválasztása A bal oldali hardver listából lehet a rendszerbe illesztett eszközöket lehet kiválasztani. Monitorozni csak kommunikálni képes hardvert lehet. Állapot tulajdonságok A jobb oldali táblázatban kerülnek megjelenítésre a kiválasztott eszközök aktuális állapota. A különféle eszközök különböző információkat biztosítanak, így amennyiben különféle tulajdonságokkal rendelkező eszközök kerülnek kiválasztásra, minden tulajdonság megjelenik, egy oszlopként. Amennyiben az adott eszköz nem biztosít ilyen információt az adott cella értéke üres. Elérés Hardver -> Állapot -> Aktuális állapot Állapot történet A rendszerbe illesztett hardvereket monitoring állapotait lehet lekérdezni adott idő intervallumra szűkítve. A lekérés az adatbázisból történik. A Bal oldalon szerepel a hardverlista egyszeres kiválasztó módban. Egyszerre csak 1 eszköz monitoring történetét lehet megtekinteni. A jobb oldalon a táblázatban-időrendben szerepelnek az ok a monitoring bejegyzések, amelyek az eszközre vonatkoznak.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Hardver -> Állapot -> Állapot történet Események A hardver log listán bal oldalon szerepel az hardver lista, melyen ki lehet választani azokat a hardvereket amelyek eseményeire kíváncsiak vagyunk. A listán több hardvert is ki lehet választani. A bejegyzések a kiválaszott időintervallumra szűkíthetők, két dátumkiválasztó segítségével. Lehetőség van a kiválaszott hardverek bejegyzéseinek aktualizálására is. Ekkor is mint minden esetben azonnal mentjük adatbázisba a bejegyzéseket.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Törzsadatok -> Hardver -> Esemény Hibaszámláló történet A rendszerbe illesztett hardvereket hibaszámlálók korábbi értékeit lehet lekérdezni adott idő intervallumra szűkítve. A Bal oldalon szerepel a hardverlista egyszeres kiválasztó módban. Egyszerre csak 1 eszköz hibaszámláló történetét lehet megtekinteni. A jobb oldalon a táblázatban-időrendben szerepelnek a hibaszámláló bejegyzések, amelyek az eszközre vonatkoznak. Lehetőség van az aktualizálásra is.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Hardver -> Hibaszámláló -> Hibaszámláló történet Aktuális hibaszámláló A rendszerbe illesztett hardverek hibaszámláló állását lehet megtekinteni. Jobb oldalt az eszközök listája van, melyből ki lehet választani azon eszközöket (multiselect) melyek hibaszámláló állására kíváncsiak vagyunk. A listában azok a hardverek szerepelnek csak, amelyek képesek ilyen információt adni.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A jobb oldali táblázatban szerepelnek a kiválasztott hardverek, hibaszámláló értékei, egy kiválasztott időpontra vetítve. Alapértelmezésként a legutóbbi időpont. A dátum megadását a dátumkiválasztóval tehetjük meg. Technikai megjegyzés: Lenne értelme a hibaszámláló esetében is az „Aktuális állapot megjelenítése” pipának, de mivel a lista felhúzása eszközről sok idő, és minket csak az utolsó hibaszámláló állás érdekel, egyelőre ötlet marad. Helyett egy gomb az aktualizálására, amely felolvassa az eszközök hibaszámlálóit, és bementi adatbázisba, frissíti a táblázat értékeit a legutolsó soréra. Ennek csak akkor van értelme ha az eszköz csatlakoztatva van. Elérés Hardver -> Hibaszámláló -> Aktuális hibaszámláló
Kártyakövetés Az épületben tartózkodó személyek tartózkodási helyét lehet megtekinteni anti-passback zónával együtt. Az aktuális számláló a törlés paranccsal törölhető.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Beléptetés -> Kártyakövetés
Tartózkodási hely Az épületben tartózkodó személyek tartózkodási helyét lehet megtekinteni és, hogy melyik anti-passback zónában tartózkodnak. A listát szűrhetjük személycsoportokra és helyiségekre.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Elérés Beléptetés -> Tartózkodási hely
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Munkaidő nyilvántartás A munkaidő nyilvántartásba vett dolgozók a különböző terminálokon munkaidő váltó bejegyzéseket tudnak tenni. Minden bejegyzés automatikusan lezárja az előző intervallumot és újat nyit. A munkaidő intervallum elszámolásának alapja a terminálon kiválasztott jogcím. 00:00 - 07:52 Távollét 07:52 - 11:58 Irodai munkavégzés
00:00
14:27 - 16:37 Irodai munkavégzés
11:58 - 12:32 Ebédszünet
07:52
12:32 - 14:27 Megbeszélés
11:58
12:32
14:27
16:37 - 00:00 Távollét
16:37
00:00
Jogcím A jogcím az egyes munkaidő intervallumok elszámolásának minősítésére szolgál. Minden jogcímről megmondható, hogy az alatta töltött idő munkaidőnek számít-e vagy sem. Egyszerűbb lekérdezések esetén elegendő lehet csak a munkával töltött idő lekérdezése, annak részletezése már felesleges. Elképzelhető, hogy a dolgozó nem szakítja meg a munkavégzést, de ezután másik feladattal foglalkozik. A terminálon a kártyáját újra lehúzva ilyenkor nem csak a munkaidő befejező, hanem egyes munkaidő folytató jogcímek is felajánlásra kerülnek. Pl. a fenti példán 14:27-kor nem szakítja meg a munkaidejét, hanem másik jogcímen folytatja. Ezért a Munkaidő kezdetén felajánlott és Munkaidő végén felajánlott tulajdonságokkal szabályozható, hogy mikor ajánlja fel a jogcímet. Pl. a fenti példán az Iroda munkavégzés Munkaidő végén felajánlott tulajdonsága be van jelölve. Ezért amikor a Megbeszélés munkaidejét befejezi, az Irodai munkavégzés szerepelni fog a felajánlott jogcímek között. Elérés A Főmenü -> Munkaidő -> Jogcímek menüpontban érhető el.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
A megnyitáskor a rendszerben lévő jogcímek rendezhető és szűrhető listáját látjuk, a táblázat alatt négy gomb található, lista frissítése, új jogcím létrehozása, meglévő jogcím módosítása és jogcím törlése. Új jogcím
Új jogcím létrehozásánál meg kell adni a jogcím nevét (minimum 1, maximum 100 karakter), és el kell dönteni, hogy munkaidőbe tartozik-e az adott jogcímre bejegyzett tevékenység, illetve munkaidő kezdetén és/vagy végén ajánljuk fel. Nem minden kombináció lehetséges, a hibásakról értesít a felület. Az értelmezhető kombinációk a következő táblázatban láthatóak: Munkaidő +
Munkaidő kezdetén felajánlja +
Munkaidő végén felajánlja +
+ -
+ -
+
-
+
+
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Karbantartás Jogcím módosításakor ugyanez az ablak ugrik fel, csak a kiválasztott jogcím adatai lesznek módosítva. Ekkor szintén értesít a felület a hibás kombinációkról. Két jogcímnek nem lehet azonos a neve, erről szintén kapunk értesítést. Törlés
Jogcímet csak akkor törölhetünk, ha nem rendszer szintű jogcím (pl. Munkaidő, Munkaidőn kívül). Ha a törlendő jogcímre létezik hivatkozó munkaidő bejegyzés, akkor hibaüzenetet kapunk róla, de saját felelősségre törölhetjük. Személy besorolás munkaidő nyilvántartás alá Csak azok a személyek tudnak terminálon munkaidő bejegyzést rögzíteni, akik tulajdonságára be van állítva, hogy munkaidő nyilvántartás alá tartoznak. A munkaidő nyilvántartás alá tartozó személyek száma korlátozva van, lásd a licenc kezelés alatt. Személy karbantartó oldalon
A Személy karbantartó oldalon a személy egyéb adatai mellett van lehetőség a munkaidő nyilvántartásba vételre. Ha van még szabad személyes munkaidő licenc, akkor új személy esetén a Munkaidő nyilvántartás mező alapértelmezetten bejelölésre kerül. Természetesen személy adatlapjának utólagos módosítása esetén is van joga munkaidő nyilvántartás alá venni. A személyes munkaidő licencek esetleges túllépése esetén hibaüzenettel találkozik, nem tud több licencet rögzíteni.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Ha egy személy most kapta meg a munkaidő nyilvántartás besorolást és korábban már volt kiosztott belépőkártyája, akkor figyelmeztetést kap, hogy a belépőkártyákat újra kell programozni. Ezt a belépőkártya karbantartó oldalon teheti meg. Személy listában
A Személy listában automatikusan megjelenik a Munkaidő nyilvántartás alatt oszlop. A kiválasztott személyen jobbal kattintva a felugró menüben megjelenik a Munkaidő nyilvántartás alá vesz vagy a Munkaidő nyilvántartás alól kivesz felirat az oszlop értékétől függően. A feliratra kattintva a személy tulajdonsága ugyanúgy megváltozik, mintha a személy karbantartó oldalon módosította volna,amennyiben nem ütközik licenc korlátba.
Visszajelzés Bármilyen észrevétele, javaslata, problémája van a szoftverrel kapcsolatban küldjön üzenetet a beks Kft. munkatársainak!
Elérés Segítség -> Visszajelzés
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
beks Kft, Debrecen, Rákóczi utca 21
Programozói kézikönyv
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Információs terminál Működés Az információs terminál bekapcsolás után automatikusan megpróbál bejelentkezni a központi vezérlőre. A központi vezérlő elérhetetlensége esetén a képernyőn hibajelzés található, amely a központi vezérlő újbóli elérhetősége esetén automatikusan megszűnik.
Üzemeltetés A Welcome3 beléptetőrendszer folyamatosan fejlődik. Időnként új szoftver verzió jelenik meg a kliens szoftverből és az információs terminál szoftveréből is. A szoftver fejlődésében mérföldkövet jelent, amikor a központi vezérlőn lévő adatbázis sémája megváltozik. A precíz működéshez a beléptetőrendszer összes elemének az adott adatbázis séma verziót kell támogatnia. Az információs terminál óráként ellenőrzi az új szoftververzió létezését, ez villogással jelzi. Az új infoterminál szoftver verzióról az üzemeltető a következő RSS csatornán is értesülhet: http://upgrade.beks.hu/welcome3/infoterminal/rss.xml Szoftver frissítés adatbázis séma módosulás esetén Kötött sorrend: 1. Kliens PC-n új szoftver verzió letöltése, telepítése 2. Kliens PC-n adatbázis séma átalakítása 3. Információs terminálokon szoftver verzió frissítése A központi vezérlőn található adatbázist csak a kliens PC-n található Welcome szoftver képes új sémára alakítani. Ezért a 2. pont után az információs terminálok inkompatibilissé válhatnak. Az üzemeltető feladata, hogy megtalálja azt az időpontot, amikor a 2. és 3. pontok a lehető legrövidebb időn belül végrehajthatók legyenek. Szoftver frissítés adatbázis séma változatlansága esetén Tetszőleges sorrend:
Kliens PC-n új szoftver verzió letöltése, telepítése Információs terminálokon szoftver verzió frissítése
A kliens PC-k és információs terminálok szoftverének frissítése ebben az esetben tetszőleges sorrendben végrehajtható.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Webes felület
Az információs terminál IP címét a böngészőbe beírva működési információk jeleníthetők meg. Szoftver frissítés
Csak a boss jelszó ismeretében lehet a szoftver frissítést végrehajtani. A boss jelszót beírva, megerősítve, majd a Frissít gombra kattintva a terminálon automatikusan végbemegy az új verzió ellenőrzése, letöltése és telepítése, majd az infoterminál újraindulása. Ne szakítsa félbe a telepítést! Az új verzió letöltése a hálózati kapcsolat sebességétől függ (kb. 20 Mb kerül letöltésre), utána a telepítés és újraindítás ideje kb. 2 perc. Ha nem található új verzió vagy a letöltés sikertelen, akkor a képernyőn nem történik semmi, a hiba bejegyzések között megtalálható a pontos indok.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Logok megtekintése
Az információs terminál működése közben log bejegyzéseket tesz, amelyre hiba jelzése esetén szükség lehet.
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Alapfogalmak Hatókör
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu
Welcome3 Beléptetőrendszer v3.0
Programozói kézikönyv
Gyakran ismételt kérdések Adatbázis SQL Express 2008 szerver megosztása hálózaton http://support.webecs.com/KB/a375/how-do-i-configure-sql-server-express-to-allow-remote.aspx
beks Kft, Debrecen, Rákóczi utca 21
www.welcome3.hu