Honeywell Prowatch-dokumentasie
1.Doel
Hierdie dokument is bedoel om stelseladministrateurs te onderrig hoe om 'n XPressEntry-stelsel met Honeywell Prowatch-stelsel te sinchroniseer.
Voorvereistes
Daar word aanvaar dat u Honeywell Prowatch en XPressEntry op plekke op 'n netwerk geïnstalleer het waar hulle met mekaar (of in dieselfde vak) kan praat.
Prowatch moet gelisensieer wees om die Web API te gebruik
U moet 'n administrateur of supergebruiker wees in die Prowatch-stelsel.
2.Instel van Prowatch om te sinchroniseer met XPressEntry
Die API ondersteun net Honeywell Prowatch v4.5 SP2 en verder. Ons neem aan dat dit geïnstalleer is en gereed is vir integrasie.
Vir integrasies in ander weergawes van Prowatch, kontak Telaeris om versoenbaarheid te bevestig.
Prowatch vereis dat hulle hul Prowatch API geïnstalleer het. Kontak u Honeywell-verteenwoordiger vir meer inligting oor die lisensiëring en installering van die Prowatch API.
Prowatch 5.0 word ondersteun met API build 5.0.0.510. Maak seker dat die .NET framework 4.8 geïnstalleer is en kyk na die afdeling Probleemoplossing om seker te maak dat die lyne nie in die .config-lêer is nie.
Die installering van die Pro-Watch API-diens
(hierdie afdeling is gratis gekopieër uit die Pro-Watch_DTU_Service.pdf-lêer)
1. Skep en kopieer die Pro-Watch API-zip-lêer na 'n lêergids onder die Pro-Watch-installasiegids
2. As u van 'n vorige weergawe opgradeer, moet u die Uninstall_PW_DTU_Service.bat-lêer as administrateur gebruik om die Pro-Watch DTU-diens van Windows-dienste te verwyder. Vee ou weergawe uit.
3. Ontpak alle lêers in die DTU-diensgids onder die Pro-Watch-installasiegids vir die huidige gids.
4. Bewerk die lêer PW-DTU-Service.exe.config-lêer en stel die eindpunt en bindingsafdelings in. Die DTU-diens is standaard om HTTP-basiese binding sonder sekuriteit te gebruik.
5. Begin die lêer Install_PW_DTU_Service.bat as 'n administrateur. Dit sal 'n Windows-diens met die naam ProWatch DTU-diens byvoeg.
6. In Windows Services klik u met die rechtermuisknop op die Pro-Watch DTU-diens en kies Eienskappe.
7. Kies die blad 'Aanmeld' en voeg 'n gebruikersrekening by tot die diens wat toegang het tot die Pro-Watch-bediener en die Pro-Watch-databasis.
Opmerking: die DTU-diensrekening moet toegang hê tot die Pro-Watch-databasis in SQL Server, 'n geldige gebruiker in Pro-Watch wees en Pro-Watch-toegang tot daardie werkstasie / bediener hê. Dieselfde rekening wat vir Pro-Watch gebruik word, kan en word voorgestel om gebruik te word vir die Pro-Watch DTU-diens. Wanneer u 'n diensrekening gebruik, voer die volgende opdrag uit om die URL te reserveer (soos gespesifiseer in API-konfigurasielêer).
Voorbeeld: Netsh http voeg urlacl url = http: // masjiennaam: 8734 / pwapi-gebruiker = DOMAIN-rekeningnaam
8. Begin in Windows Services die Pro-Watch DTU-diens.
Stel die Prowatch API op
Vir die API-sinchronisasie om behoorlik te werk, moet ons twee API's in Prowatch instel.
Die SOAP en SignalR API.
Die volgende 4 sleutels moet in die PW-DTU-WinService.exe.config-lêer ingestel word
Let daarop dat as u XPressEntry op 'n ander masjien installeer as die API, u die “localhost” in hierdie sleutels moet verander na “u naam van die masjien”.
3.Prowatch API-gebruikersrekening
(hierdie afdeling is ook gratis gekopieër uit die Pro-Watch_DTU_Service.pdf-lêer)
Aktiveer 'n Pro-Watch-gebruiker
- In Pro-Watch, kies databasekonfigurasie
- Kies gebruikers of klasse
- Wysig of skep 'n gebruiker wat met die Pro-Watch DTU-diens verbind.
- Kies die blad Programme
- Brei databasiskonfigurasie uit
- Kies 'Gebruikersdefinisies'
- Klik op die knoppie 'Voeg funksie toe'
- Voeg 'Aktiveer webwagwoord' by
- Stoor die gebruiker of klasrekord. Nou moet die 'Webwagwoord' vir die gebruiker aangeskakel word.
- Voer 'n 'Webwachtwoord' in en stoor die gebruikersrekord.
Gebruikers toestemmings
Die volgende minimale toestemmings is nodig op die API-gebruikersvlak in Prowatch:
Administrasie -> Hulpprogram vir data-oordrag -> Uitreikgebeurtenis is slegs nodig as ons aktiwiteite stuur na Prowatch
Administrasie -> Hulpprogramma vir data-oordrag -> Teken in op gebeure is slegs nodig as ons die SignalR API gebruik
Maak ook seker dat die API-gebruiker 'n routinggroep het met die 'dtuservice' Prowatch Workstation bygevoeg. Dit is nodig vir SignalR om te werk.
Dit is nodig omdat XPressEntry die volgende oproepe via die API maak:
- IssueReaderEvent
- GetAreaOccupants
- GetCompanies
- GetBadgeTypes
- GetAreas
- GetLogDevsByHWClass of GetLogical DevicesAll
- Kry ClearanceCodes
- GetClearanceCodesLD
- QueryBadgesPaging
- GetBadgeBlob of GetBadgePhoto
4.Stel Prowatch-lesers en opruimingsvlakke op
As u gebeure na Prowatch wil stuur, moet u 'n kanaal / paneel / lesers opstel as plekhouers om die gebeure vanaf XPressEntry te ontvang.
Vir elke fisiese handtoestel moet ons twee lesers vir logiese toestelle opstel (IN / OUT) in Prowatch.
As ons net Mustering doen, benodig u net een logiese toestel per hand.
Jy kan dit so doen:
Hardeware-konfigurasie -> Voeg 'n kanaal by
Kies PW-5000 / PW6000
Gee dit 'n naam, klik dan op Volgende, Volgende en dan Voltooi (die opsies maak nie saak nie, want ons gebruik net hierdie kanaal en panele as plekhouers vir lesersgeleenthede).
Kyk eers “geïnstalleer” na. Kies die TimeZone vir nou.
Vervolgens voeg ons 'n paneel by die Prowatch-stelsel.
Klik met die rechtermuisknop op Panele onder hardewarekonfigurasie en kies Nuut -> Paneel
Kies die webwerf en kanaal.
Kies 'n PW-5000- of PW-6000-beheerstipe.
Klik Volgende en voeg 'n PW5000 2R by vir elke handtoegang wat inskrywing / uitgang doen.
Klik dan op Finish.
Nou moet ons die logiese apparaatlesers by die paneel voeg.
Klik met die rechtermuisknop onder Hardeware-konfigurasie op Lesers en kies Nuut -> Logiese toestel
Kies die regte paneel wat ons so pas geskep het
Stel die hardeware sjabloon op DoorTypical ACR (Toegangsbeheerleser) of Toets / Uitgangleserdeur.
Klik dan op Volgende en kies 'n poort (e) vir die leser (s). As u die ingang / uitgang-leser deur gebruik, sal dit die twee logiese toestelle outomaties vir Ingang / uitgang koppel.
As daar nie een bestaan nie, gaan dan terug na die paneel en voeg 'n leserspoort by.
Klik dan op Finish
As u klaar is, moet u die vakkie geïnstalleer onder die paneel verwyder.
Opruimingskodes
Voeg die lesers by die toepaslike opruimingskodes as ons met Invoer / Uitgang doen
Om dit te doen, gaan na Databasiskonfigurasie -> Opruimingskodes.
Kies die toepaslike klaring om die lesers by te voeg of 'n nuwe een
Let daarop dat dit nie nodig is as ons net Mustering doen nie.
Voeg logiese toestelle by gebiede
Volgende moet u seker maak dat u huidige Prowatch-lesers en XPressEntry-lesers behoorlik na Gebiede in Prowatch gekarteer word.
Dit word gedoen vanaf die databasiskonfigurasie -> Area
Voeg by of kies die gebiede waarheen die lesers wil gaan. Klik op die logiese apparaat aan die linkerkant, en dan op die leser in die middel. Gebruik die pyltjie regs om die toestel te skuif. Klik op die In / Uit X om te bepaal of die toestel die gebruiker in / uit plaas
5.Aktiveer datahantering-sinchronisasie in XPressEntry
Volgende gaan XPressEntry instel om die data vanaf Prowatch te sinkroniseer. Dit word alles bestuur vanuit die XPressEntry-bediener-toepassing onder Tools -> Settings -> Data Manager
Aan die bokant, kontroleer die Enable Data Manager en stel die Type dan op Prowatch DTU
Bepaal watter Data Manager-funksies u met Prowatch wil gebruik
- Stuur aktiwiteite
- Ontvang aktiwiteite
- besetting
- Sluit spesifieke funksies vir die databestuurder in
Hier is wat die opsies doen:
Trek Data Manager-aktiwiteite in XPressEntry:
As SignalR geaktiveer is, voeg dit die gebeure vanaf Prowatch in XPressEntry toe as kentekenaktiwiteite.
Stoot XPressEntry-aktiwiteite na databestuurder:
Dit sal die kanaal / panele / lesers hierbo gebruik om aktiwiteite na Prowatch te stuur.
Trek besetting van databestuurder
Dit sinchroniseer die Areabewoners van Prowatch met XPressEntry.
Kyk na tabelle via sagteware-geleenthede
Dit maak die SignalR-gebeurtenisstuk moontlik
Standaard rol
Die standaardrol om aan Badges (gebruikers) toe te ken wanneer gebruikers vanaf Prowatch gesinkroniseer word.
Geen sinchrone sinchronisasies nie
Word gebruik om seker te maak dat slegs een sinkronisasie (volledig, gedeeltelik, besetting, aktiwiteit) op enige gegewe tydstip loop. Nie nodig vir hierdie integrasie nie.
Aktiwiteit sinchroniseer nou
Voer die aktiwiteitsinkroniseringsproses uit. Vir Prowatch sal dit die besetting uittrek EN aktiwiteite onmiddellik na die databestuurder stuur. Dit is nie nodig nie, maar is in vorige weergawes van die Prowatch Data Manager gebruik.
Besetting synchroniseer nou
Synchroniseer die inwoners van Prowatch na XPressEntry. Benodig vir mustering.
Ons beveel dit aan om elke 5 minute in te stel. Dit sal enige aktiwiteite wat gemis is, inhaal as die een of ander diens vir 'n beduidende periode vanlyn was.
Gedeeltelike sinkronisering nou
Dit sinchroniseer alle nie-gebruikersdata. Dit sluit panele / lesers / klaring / ondernemings, ens. In.
Volledige sinkronisering nou
Dit voer 'n gedeeltelike sinkronisering aan en sinchroniseer ook gebruikersdata
Prowatch-spesifieke data-bestuurderopsies
Volgende regs moet u die groot “Setup Data Manager” -knoppie druk.
Dit sal u na die Prowatch-spesifieke databestuurder-opsies neem.
Die volgende word vereis:
Die bediener-IP (en poort as u dit verander het), gebruiker en wagwoord
Gaan na die “Gebruik Prowatch-gebiede / LogDevs as deure vir besetting” as u besig is met opsporing of besetting.
As u NIE inskrywings / uittreksels doen NIE, merk dan die "Geen groepsdata" nie.
As u SignalR wil gebruik, stel die Event User (waarskynlik dieselfde as die API-gebruiker) en die Event Workstation (dit is die werkstasie vanaf Prowatch vir die XPressEntry-diens).
U kan velde karteer vanaf die Prowatch Badge tot die XPressEntry-gebruiker met die bron- / bestemmingskolomme aan die linkerkant (moenie vergeet om die groen plus-knoppie te druk nie)
U kan kies watter Prowatch-gebiede ons werklik opvolg, regs onder. Let daarop dat hierdie slegs gevul word nadat 'n gedeeltelike sinkronisering gedoen is. Die praktiese kant hiervan beteken dat u hier moet inkom, alles moet instel, dan moet u uitgaan en gedeeltelike sync nou moet druk, en dan weer moet binnekom om die besettingsareas op te stel.
Die res van die opsies is vanselfsprekend, maar kan almal leeg / ongemerk gelaat word as u twyfel.
'Test Connect' sal u vertel of die API gekoppel is (maar nie SignalR nie)
Klik OK wanneer u klaar is en druk dan op "Stoor" op die Data Manager-bladsy.
As SignalR werk, moet u so iets sien:
VERBOSE: Geen foute in ProwatchDataManager tydens StartWatchingTables nie
INFO: Inteken op SignalR-geleentheid het begin
6.Aanvanklike datasinkronisasie en instel XPressEntry Data
Dit word voorgestel dat u eers 'n gedeeltelike sinkronisering moet uitvoer om die lesers / opruimings / sones te laat gesinchroniseer en opgestel.
Nadat u die data in XPressEntry opgestel het, voer u 'n volledige sinkronisasie uit.
7.Stel Prowatch-gebiede op as XPressEntry-sones
Voordat u dit doen, moet u seker maak dat u 'n gedeeltelike sync met die Prowatch-stelsel gedoen het
Prowatch-gebiede word gekarteer aan die XPressEntry Zones-tabel.
Vir elke gebied waar u besetting wil opspoor, moet u die volgende doen.
- Maak seker dat “Zone is buite” en “Zone is a Muster Point” nie gemerk is nie
- Maak seker dat 'Zone is a Hazard Area' gemerk is
Vir Muster Points behoort dit die teenoorgestelde te wees.
Probleemoplossing van besetting
As inwoners nie in XPressEntry opdaag nie, is daar 'n paar dinge om na te gaan.
- Kontroleer of die kanaal wat u in Prowatch gebruik, vir die gebruiker by die routinggroepe gevoeg word
- Maak seker dat u logiese toestelle het wat toegewys is aan Areas in Prowatch
- Maak seker in XPressEntry dat die sones opgestel is en soos hierbo gekies. As al drie die merkblokkies ingestel is, sal die sone nie die besetting naspeur nie!
- Maak seker dat die databestuurderopsies vir "Pull Data Manager Occupancy" en "Watch Tabels via Software Events" gemerk is.
- Maak seker dat die Deure in XPressEntry behoorlik opgestel is. (veral as u nie die “Gebruik Prowatch-gebiede / LogDevs as deure vir besetting” in die Prowatch Data Manager-instellingsvorm nagaan nie).
8.Stel XPressEntry-handlesers en deure in
Voordat u dit doen, moet u seker maak dat u 'n gedeeltelike sync met die Prowatch-stelsel gedoen het
deure
Deure word direk gekarteer vanaf die logiese toestelle en gebiede in Prowatch. Dit word outomaties geskep as die toestelle aan 'n gebied in Prowatch toegewys is. Andersins kan u plaaslike deure skep en op u eie karteer.
As ons alles reg gedoen het, hoef ons nie veel hier te doen nie. Verifieer net dat die deure wat ons het mense behoorlik binne / buite die gebiede kan skuif.
Die manier om dit te lees, is dat die Begin Sone is waar u van 'n ingangskandering op die handtoestel af kom, en die Eindsone is waar u na 'n inskandering gaan. Dit word omgekeer vir Exit-skanderings.
Die velde vir eksterne invoer / uitgangleser moet ooreenstem met die logiese toestelle wat ons in Prowatch opgestel het
Lesers
Lesers word direk gekies vanaf logiese toestelle in Prowatch.
As die tydsone vir die toestelle en die tydsone vir die bediener verskil, moet u 'n paar ekstra opstellings doen.
Skakel eers die opsie "Reader Timezones" in Gereedskap -> Instellings -> Algemeen -> Voeg skerm by / wysig
Stel dan die Reader Timezone onder die Add / Edit Info -> Readers -> Handhelds-afdeling vir elke toestel in 'n ander tydsone.
Laastens, as u die toestelle vir die gebruik van mustering gebruik en wil hê dat die aktiwiteite wat na Prowatch gestuur word, stel die opsie 'External Muster Reader' vir elke handtoestel.
Op hierdie punt moet u met die standaard XPressEntry Reader-profielopsies kan voortgaan om u toestel op te stel.
9.Probleemoplossing
As u die volgende foute sien:
---Exception Message--------------------------
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]
The type initializer for 'HoneywellAccess.ProWatch.PWLogger.Log' threw an exception.
---Exception Stack Trace----------------------
Bediener-stapelspoor:
by System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnststood (Beantwoording van boodskap, MessageFault fout, String-aksie, MessageVersion weergawe, FaultConverter faultConverter)
by System.ServiceModel.Channels.ServiceChannel.HandleReply (bewerking ProxyOperationRuntime, ProxyRpc & rpc)
by System.ServiceModel.Channels.ServiceChannel.Call (String action, Boolean oneway, ProxyOperationRuntime operation, Object [] ins, Object [] outs, TimeSpan time-out)
by System.ServiceModel.Channels.ServiceChannelProxy.InvokeService (IMethodCallMessage methodCall, ProxyOperationRuntime-werking)
by System.ServiceModel.Channels.ServiceChannelProxy.Invoke (IMessage-boodskap)
U moet die PW-DTU-WinService.exe-lêer gaan redigeer en kommentaar lewer oor die volgende twee reëls:
<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" />
En deur dit te verwyder of omring met 'n XML-opmerkingsgedeelte:
<!--<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" /> -->