Nedap AEOS dokumentasie
1.Doel
Hierdie dokument is bedoel om stelselbestuurders te leer hoe om 'n XPressEntry-stelsel met die Nedap AEOS-toegangsbeheerstelsel te sinkroniseer.
Algehele orde van bedrywighede
- Stel AEOS SOAP API en SocketInterface (vir gebeure) op
- Dit sluit gewoonlik die skep van 'n gebruikersrekening of geloofsbriewe binne die stelsel in
- Stel lesers / panele / ens op in ander stelsels om gebeure te ontvang indien beskikbaar vir die databestuurder
- Skakel Data Manager Synchronization in vanaf XPressEntry.
- Aanvanklike datasinkronisasie en instel XPressEntry Data
- Stel XPressEntry-handlesers op
- Skandeer data op die kaartleser en bevestig die funksies
2.Die opstel van AEOS om met XPressEntry te sinkroniseer
Daar word aanvaar dat AEOS op 'n bediener geïnstalleer is. XPressEntry is getoets met AEOS Weergawe 2019.1.4. Vir integrasies in ander weergawes van AEOS, kontak Telaeris en Nedap om die versoenbaarheid te bevestig.
Die SOAP-koppelvlak moet op AEOS geïnstalleer wees.
AEOS Blou
1. Kies SOAP WebService tydens die installering van die AEOS-sagteware (instelling) in die venster Kies die gewenste opsies vir die AEOS-toepassing. As die AEOS reeds geïnstalleer is, moet u die opstelling weer uitvoer en geen instellings verander nie, behalwe die keuse van die SOAP WebService.
2. Skakel SOAP in die stelsel-eienskappe in AEOS aan.
a. gaan na Administrasie> Onderhoud> Instellings> Stelsel-eienskappe.
b. Kies die SOAP WebService-blokkie (44.15).
c. Klik op OK.
d. Herbegin die AEOS-toepassingsbedienerdiens (sien 6.2).
AEOS Classic
1. Kooplisensie-opsie 8019223.
2. Aktiveer opsie 8019223 SOAP WebService tydens die installering van die AEOS-sagteware (instelling).
Volg die instruksies van afdeling 1 in die geïnstalleerde “AEOS_WebService_E.pdf” in die AEOS-dokumentgids.
Maak seker dat poort 8443 (standaard instelbaar in aeos.properties) om die API in te skakel en 8035 (standaard instelbaar in aeos.properties) beskikbaar is vanaf die XPressEntry-bediener.
3.Skep gebruikersrekening in AEOS
Skep 'n gebruikersrekening in AEOS vir API-toegang. Hierdie gebruiker moet die minimum vereiste toegang hê om data met XPressEntry te sinchroniseer.
Oor die algemeen moet dit in alle tabelle kan deursoek.
Dit het ook die toestemming nodig: administrasie, integrasies, AEOS WebService, eksterne oproepe.
Daarbenewens moet die gebruikersrol vir gebeure toegang hê tot die volgende funksies:
- Die funksie 'Konfigurasie, Socketconnection, opdragte'stel die gebruiker in staat om via die sokverbinding aan te meld om opdragte na AEOS te stuur.
- Die funksie 'Konfigurasie, Socketconnection, gebeure'stel die gebruiker wat deur die aansluiting aanmeld, in staat om die gebeure van AEOS op te spoor.
4.Stel AEOS-lesers en toegangsvlakke op
Stel die toegang en magtiging in die AEOS-stelsel op. Dit kan gewoonlik tot 'n later datum vertraag word, maar dit is lekker om te hê voordat u data begin sinkroniseer.
5.Aktiveer datahantering-sinchronisasie in XPressEntry
Gaan vanaf die hoofprogram XPressEntry na Tools -> Settings
- Kies Data Manager in die lys aan die linkerkant
- Merk die vinkie "Aktiveer databestuurder"
- Kies NEDAP as die tipe
- Klik op die "Setup Data Manager" -knoppie
BELANGRIKE OPMERKING: Na enige verandering in die NEDAP-instellingsbladsy of die Data Manager-aansig, MOET u Save slaan om dit toe te pas.
Dit neem u na die NEDAP Data Manager-opstelvorm.
AEOS / NEDAP-opstelbladsy
Verduideliking van AEOS-opsies
bediener: Die DNS-naam of IP-adres van die AEOS-stelsel
Port: Dit is gewoonlik 8443
gebruikers: Gebruikersnaam in AEOS vir die SOAP-oproepe
Wagwoord: Die wagwoord vir daardie gebruikersnaam
Sokpoort: Vir geleenthede is dit die Socket Port (gewoonlik 8035)
Toegang tot gebeure: Dit is die geldige toegangsgebeurtenisse waarna ons kyk om te bepaal of 'n kaarthouer die fasiliteit binnegekom het.
Aktiveer gebruikerblaai: Hou dit gekontroleer, tensy u 'n klein stelsel het. Hou dit net nagegaan.
Bladsygrootte: Die aantal rekords op elke bladsyversoek.
Wys gebiede outomaties aan deure toe: Merk dit as u wil hê dat die "Buitengebied" en "Binnegebied" aan deure moet toegeken word as ons nie die regte area van AEOS kan bepaal nie.
Buitegebied: Die gebied wat aan die buitekant van die deur toegewys is.
Binne-area: Die area wat aan die binnekant van die deur toegewys is.
Om te toets of die SOAP API funksioneer, druk "Test Connect"
U moet 'n antwoord verwag soos 'Connection Success! AEOS VERSION ”in die Status-veld onderaan die vorm.
Let daarop dat dit nie die Socket-verbinding vir gebeure nagaan nie.
Socket gebeure
As u van plan is om AEOS-geleenthede in XPressEntry in te skakel, moet u die opsie "Kyk tafels via sagteware-geleenthede" inskakel. As u "Save" in die Data Manager-aansig druk, moet u iets soortgelyk aan die volgende in die logboek sien:
DEBUG: MSG: Antwoord: erkenning = aan;
INFO: TCP-kliënt gekoppel
DEBUG: MSG: Status: gekoppel aan AEOS-weergawe 2019.1.4 gebou op 2019-09-10
INFO: Kyketafels begin
Aktiwiteitstipes:
U kan kies om volledige aktiwiteite by hierdie geleenthede te kry, of net besettingsopdaterings vir u kaarthouers.
Vir volledige aktiwiteite, kyk in die Data Manager-aansig na die "Pull DataManager-aktiwiteite in XPressEntry".
Om net besetting te kry, merk die opsie "Pull DataManager Occupancy".
As u nie omgee vir besetting nie, moet u dit ook nie nagaan nie en nie die opsie "Kyk tafels via sagteware-geleenthede" nagaan nie.
6.Aanvanklike datasinkronisasie en instel XPressEntry Data
Die volgende stap is om die data vanaf AEOS te sinkroniseer en intervalle op te stel vir sinkronisasie. Hieronder is verduidelikings vir elke tipe sinchronisasie
Volledige sinkronisering:
Dit sinchroniseer al die data van die AEOS-stelsel. Dit sluit kaarthouers, tokens, besoekers en kontrakteurs in. Dit moet ook beeldinligting vir kaarthouers bevat.
Dit bevat ook al die gegewens van die gedeeltelike sinkronisering.
Gedeeltelike sinkronisering:
Dit sinchroniseer die volgende tabelle wat vir bokoste gebruik word:
sones
Lesers
deure
Kenteken
groepe
Groep- / lesertoewysings
Besetting-sinkronisering:
As die opsie “Pull DataManager Occupancy” ingestel is, sal die kaarthouers met hul huidige ligging vanaf AEOS gesinkroniseer word.
Aktiwiteitsinkronisering:
Sinkroniseer die gebeure vanaf AEOS. Dit is slegs van toepassing as die opsie "Gaan DataManager-aktiwiteite na XPressEntry" gemerk is.
Datakaarte
Hier definieer ons watter tabelle in AEOS na watter tabelle in XPressEntry verwys
AEOS |
XPRESSENTRY |
Persoon / besoeker / kontrakteur |
gebruikers |
Teken |
kentekens |
Toegang |
Door |
Access Point |
Reader |
7.XPressEntry Handlesers / Deure
XPressEntry-handverifikasie word deur twee tabelle gedoen. Lesers en deure.
Daar is drie tipes lesers in XPressEntry:
- Die bedienerleser - word gebruik om kentekenaktiwiteite vanaf die bediener toe te ken. Dit sal waarskynlik die naam "Server Reader: COMPUTER NAME" heet en het 'n 20-22 karakter GUID.
- Lesers - Logiese lesers word gebruik om toegangsbeheerregte van eksterne stelsels toe te ken. In die geval van AEOS moet dit ooreenstem met die ingang
- Handhelds - Dit is die fisiese toestelle. Dit is gewoonlik 'n Android of 'n toestel. Hierdie het 'n GUID gebaseer op die fisiese masjien.
Handdeure gebruik deure om toestemmings op 'n toestel dinamies toe te ken. Die gebruiker mag standaard deure van die toestel af skakel. Die toestelle gebruik die toestemmings vir die “External Entry / Exit Readers” wat aan die deur toegeken is om te bepaal of die kaarthouer toestemming het om na die leser te skandeer.
Vir AEOS word vervoerders wat by 'n ingang toegelaat word, by die ooreenstemmende deure toegelaat.
Die laaste stuk wat ons vir XPressEntry moet karteer, is die gebiede / lesers vir elke deur. Om dit te doen, moet u dalk die instelling "Laat wysiging van eksterne data toe" inskakel.
Dan kan ons die deurareas / lesers toewys vanaf die XPressEntry Info / Add Info-koppelvlak
As alle ingange na dieselfde gebied gaan, of as dit nie saak maak in u opstelling nie, kan u die opsie "Auto's Areas to Doors" kies op die AEOS Data Manager Setup-bladsy.
Raadpleeg die volgende dokument vir meer inligting oor die instelling van die handtoestel en die sinkronisering met die XPressEntry Service:
8.Stel XPressEntry op om kentekenaktiwiteite na AEOS te stoot
AEOS moet 'n InterfaceServer-objekopstelling hê om gebeurtenisse te ontvang.
Maak seker dat die "Gebeurtenisgenerering toegelaat"-merkblokkie geaktiveer is.
Elke koppelvlakbediener kan slegs een identifiseerdertipe bedien. Maak seker dat die gekose Identifiseerdertipe die korrekte voorvoegsel uit die volgende tabel het:
Let daarop dat vir sommige generiese tipes 0000 hier die korrekte waarde is.
Die gebruikersnaam/wagwoord vir hierdie InterfaceServer kan dalk anders wees as die een vir die res van die API, so dubbel seker. Dit is by verstek nedap / nedap.
Maak seker dat die Data Bestuurder Opsie "Push XPressEntry Activities to Data Manager" geaktiveer is.