Prowatch XPressEntry Synchronization Documentation

1.Layunin #

Ang dokumentong ito ay inilaan upang turuan ang mga tagapangasiwa ng system sa kung paano i-synchronize ang isang XPressEntry system na may sistema ng Honeywell Prowatch.

Kinakailangan

Ipinapalagay na na-install mo ang Honeywell Prowatch at XPressEntry sa mga lugar sa isang network kung saan maaari silang makipag-usap sa bawat isa (o sa parehong kahon)

Dapat na lisensyado ang Prowatch upang magamit ang Web API

Dapat kang maging isang Administrator o sobrang gumagamit sa sistema ng Prowatch.

2.Pagse-set Up Prowatch upang I-synchronize sa XPressEntry #

Sinusuportahan lang ng API ang Honeywell Prowatch v4.5 SP2 at higit pa. Ipinapalagay namin na naka-install at handa na para sa pagsasama.

Para sa mga pagsasama sa iba pang mga bersyon ng Prowatch, mangyaring makipag-ugnay sa Telaeris upang kumpirmahin ang pagiging tugma.

Kinakailangan ng Prowatch na mai-install ang kanilang Prowatch API. Makipag-ugnay sa iyong kinatawan ng Honeywell para sa karagdagang impormasyon sa paglilisensya at pag-install ng Prowatch API.

 

Sinusuportahan ang Prowatch 5.0 sa pagbuo ng API 5.0.0.510. Tiyaking naka-install ang .NET framework 4.8 at suriin ang seksyon ng Pag-troubleshoot upang matiyak na ang mga linya na iyon ay wala sa .config file.

 

Pag-install ng Pro-Watch API Service

(ang seksyon na ito ay nakakuha ng kopya mula sa Pro-Watch_DTU_Service.pdf file)

1. Lumikha at kopyahin ang file ng zip ng Pro-Watch API sa isang folder sa ibaba ng direktoryo ng pag-install ng Pro-Watch

2. Kung mag-upgrade mula sa isang nakaraang bersyon, patakbuhin ang file na Uninstall_PW_DTU_Service.bat bilang tagapangasiwa upang alisin ang Pro-Watch DTU Service mula sa mga serbisyo sa Windows. Tanggalin ang lumang bersyon.

3. Sa direktoryo ng Serbisyo ng DTU sa ibaba ng direktoryo ng pag-install ng Pro-Watch, i-unzip ang lahat ng mga file sa kasalukuyang direktoryo.

4. I-edit ang file na PW-DTU-Service.exe.config file at itakda ang mga seksyon ng endpoint at nagbubuklod. Ang Serbisyo ng DTU ay default na gumamit ng pangunahing pagbubuklod ng HTTP na walang seguridad.

5. Patakbuhin ang file ng Install_PW_DTU_Service.bat bilang isang tagapangasiwa. Ito ay magdagdag ng isang serbisyo sa Windows na tinatawag na ProWatch DTU Service.

6. Sa Mga Serbisyo sa Windows, mag-click sa Pro-Watch DTU Service at piliin ang Mga Katangian.

7. Piliin ang tab na 'Log On' at magdagdag ng isang account sa gumagamit sa serbisyo na may access sa Pro-Watch server at ang Pro-Watch database.

Tandaan: Ang account ng DTU Serbisyo ay dapat magkaroon ng access sa Pro-Watch database sa SQL Server, maging isang wastong gumagamit sa Pro-Watch at magkaroon ng pag-access sa Pro-Watch sa workstation / server na iyon. Ang parehong account na ginagamit para sa Pro-Watch ay maaaring at iminumungkahi na magamit para sa serbisyo ng Pro-Watch DTU. Kapag gumagamit ng isang account sa serbisyo mangyaring patakbuhin ang sumusunod na utos upang magreserba ng URL (tulad ng tinukoy sa file ng pagsasaayos ng API).

Halimbawang: Netsh http magdagdag ng urlacl url = http: // machinename: 8734 / pwapi user = DOMAINaccountname

8. Sa Mga Serbisyo sa Windows, simulan ang Pro-Watch DTU Service.

Pag-configure ng Prowatch API

Para sa Pag-synchronize ng API upang gumana nang maayos, kailangan nating mag-setup ng dalawang API sa Prowatch.

Ang SOAP at SignalR API.

Ang sumusunod na 4 na mga key ay kailangang itakda sa PW-DTU-WinService.exe.config file

Tandaan na kung nag-install ka ng XPressEntry sa ibang machine kaysa sa API, kailangan mong baguhin ang "localhost" sa "pangalan ng iyong makina" sa mga key na ito.

3.Prowatch API Gumagamit ng Account #

(ang seksyon na ito ay gratuitously kinopya mula sa Pro-Watch_DTU_Service.pdf file)

Paganahin ang isang gumagamit ng Pro-Watch

  1. Sa Pro-Watch, piliin ang Pag-configure ng Database
  2. Piliin ang Mga Gumagamit o Klase
  3. I-edit o lumikha ng isang gumagamit na makakakonekta sa Pro-Watch DTU Service.
  4. Piliin ang tab na Mga Programa
  5. Palawakin ang Pag-configure ng Database
  6. Piliin ang 'User Defines'
  7. I-click ang pindutang 'Add Function'
  8. Magdagdag ng 'Paganahin ang Web Password'
  9. I-save ang talaan ng Gumagamit o Klase. Ngayon ang 'Web Password' para sa Gumagamit ay dapat na paganahin.
  10. Magpasok ng isang 'Web Password' at i-save ang record ng Gumagamit

Mga Pahintulot ng User

Ang sumusunod na minimal na Pahintulot ay kinakailangan sa antas ng gumagamit ng API sa Prowatch:

Pangangasiwa -> Paggamit ng Data Transfer -> Kaganapan ng Isyu kinakailangan lamang kung nagpapadala kami ng mga aktibidad sa Prowatch

Pangangasiwa -> Paggamit ng Data Transfer -> Mag-subscribe sa Mga Kaganapan kinakailangan lamang kung gumagamit kami ng SignalR API

Tiyaking tiyakin na ang gumagamit ng API ay may isang grupo ng pagruruta na may idinagdag na 'dtuservice' Prowatch Workstation. Kinakailangan ito upang gumana ang SignalR.

Kinakailangan ito dahil ginagawa ng XPressEntry ang mga sumusunod na tawag sa pamamagitan ng API:

  • IsyuReaderEvent
  • Mga GetAreaOccupant
  • GetCompanies
  • Mga Uri ng GetBadge
  • GetAreas
  • GetLogDevsByHWClass o GetLogicalDevicesAll
  • GetClearanceCode
  • GetClearanceCodesLD
  • QueryBadgesPaging
  • GetBadgeBlob o GetBadgePhoto

4.Mga Setting ng Mambabasa ng Pribanda at Mga Antas ng clearance #

Kung nais mong magpadala ng mga kaganapan sa Prowatch, kakailanganin mong mag-setup ng Channel / Panel / Readers bilang mga placeholder upang matanggap ang mga kaganapan mula sa XPressEntry.

Para sa bawat pisikal na ginawang kamay, dapat nating itakda ang dalawang mga mambabasa ng lohikal na aparato (IN / OUT) sa Prowatch.

Kung nagsasagawa lang kami ng Mustering, kailangan mo lamang ng isang lohikal na aparato sa bawat handheld.

Magagawa mo ito tulad nito:

Pag-configure ng Hardware -> Magdagdag ng isang Channel

Piliin ang PW-5000 / PW6000

Bigyan ito ng isang pangalan, pagkatapos ay i-click ang Susunod, Susunod at pagkatapos ay Tapos na (ang mga pagpipilian ay hindi mahalaga dahil ginagamit lamang namin ang channel na ito at mga panel bilang mga placeholder para sa mga kaganapan sa mambabasa).

Suriin ang "Naka-install" lamang sa una. Piliin ang TimeZone ngayon.


Susunod ay magdagdag kami ng isang Panel sa Prowatch System.

Sa ilalim ng Pag-configure ng Hardware, mag-right click sa Mga Panel at piliin ang Bago -> Panel

Piliin ang Site at Channel.

Pumili ng isang PW-5000 o PW-6000 uri ng Controller.

Pindutin ang Susunod at magdagdag ng isang PW5000 2R para sa bawat Handheld na ginagawa ang Pagpasok / Paglabas.

Pagkatapos pindutin ang Tapos na.

Ngayon kailangan nating magdagdag ng mga lohikal na Mambabasa ng aparato sa Panel.

Sa ilalim ng Pag-configure ng Hardware, mag-right click sa Mga Mambabasa at piliin ang Bago -> Lohikal na Device

Piliin ang tamang Panel na nilikha lamang namin

Itakda ang template ng Hardware sa DoorTypical ACR (Access Control Reader) o Entry / Exit Reader Door.

Pagkatapos pindutin ang Susunod at Pumili ng isang (port) para sa (mga) mambabasa. Kung gumagamit ka ng Entry / Exit Reader Door, pares nito ang dalawang lohikal na aparato para sa Pagpasok / Paglabas awtomatiko.

Kung walang umiiral, bumalik sa panel at magdagdag ng isang port ng mambabasa.

Pagkatapos pindutin ang Tapos na

Kapag tapos ka na, alisan ng tsek ang naka-install na checkbox sa ilalim ng Panel.

Mga Code ng Clearance

Idagdag ang mga mambabasa sa naaangkop na Mga Code ng Clearance kung ginagawa namin ang Pagpasok / Paglabas

Upang magawa iyon, pumunta sa Pag-configure ng Database -> Mga Kodigo sa Pag-clearance.

Alinman piliin ang naaangkop na Clearance upang magdagdag ng mga mambabasa upang o magdagdag ng bago

Tandaan na hindi ito kinakailangan kung ginagawa lamang namin ang Mustering.

Magdagdag ng lohikal na aparato sa mga lugar

Susunod na kailangan mong tiyakin na ang iyong kasalukuyang mga mambabasa ng Prowatch at mga mambabasa ng XPressEntry ay na-mapa sa mga lugar sa maayos na Prowatch.

Ginagawa ito mula sa Konfigurasi ng Database -> Lugar

Idagdag o Piliin ang mga lugar na nais mong puntahan ng mga mambabasa / Pag-out ng. I-click ang Logical Device sa kaliwa, pagkatapos ang Reader sa gitna. Pagkatapos ay gamitin ang tamang arrow upang ilipat ang aparato. I-click ang In / Out X upang itakda kung inilalagay ng aparato ang / palabas

5.Paganahin ang Pag-synchronize ng Data Manager sa XPressEntry #

Susunod ay magse-set up ng XPressEntry upang mai-synchronize ang data mula sa Prowatch. Pinamamahalaan lahat ito mula sa loob ng application ng server ng XPressEntry sa ilalim ng Mga Tool -> Mga Setting -> Data Manager

Sa itaas, suriin ang Paganahin ang Data Manager at pagkatapos itakda ang Uri sa Prowatch DTU

Alamin kung aling mga tampok ng Data Manager ang nais mong gamitin sa Prowatch

  1. Magpadala ng mga Aktibidad
  2. Tumanggap ng mga Aktibidad
  3. Occupancy
  4. Isama ang mga tukoy na tampok para sa data manager

Narito kung ano ang ginagawa ng mga pagpipilian:

Hilahin ang Mga Aktibidad ng Tagapamahala ng Data sa XPressEntry:

Kapag pinagana ang SignalR, idinadagdag nito ang mga kaganapan mula sa Prowatch sa XPressEntry bilang mga aktibidad ng badge.

Itulak ang Mga Aktibidad sa XPressEntry sa Data Manager:

Gagamitin nito ang Channel / Panels / Readers sa itaas upang magpadala ng mga aktibidad sa Prowatch.

Hilahin ang Data Manager Occupancy

Ini-synchronize nito ang Area Occupants mula sa Prowatch na may XPressEntry.

Manood ng Mga Talahanayan sa pamamagitan ng Mga Kaganapan sa Software

Pinapayagan nito ang piraso ng kaganapan sa SignalR

Default na Papel

Ang default na tungkulin na itatalaga sa Badges (mga gumagamit) kapag nag-synchronize ng mga gumagamit mula sa Prowatch.

Walang Mga Sinkronikong Sync

Ginamit upang matiyak na isang pag-sync lamang (Buo, Bahagyang, Trabaho, Aktibidad) ay tumatakbo sa anumang oras. Hindi kinakailangan para sa pagsasama na ito.

Gawain I-sync Ngayon

Nagpapatakbo ng proseso ng Pag-sync ng Aktibidad. Para sa Prowatch ito ay Hilahin ang trabaho at ipadala ang mga aktibidad sa data manager kaagad. Hindi ito kinakailangan, ngunit ginamit sa mga nakaraang bersyon ng Prowatch Data Manager.

Pag-sync ng Trabaho Ngayon

I-synchronize ang mga nagsasakop sa lugar mula sa Prowatch sa XPressEntry. Kinakailangan para sa Mustering.

Iminumungkahi na itakda ito sa bawat 5 minuto. Ito ay "mahuli" ang anumang mga aktibidad na napalampas kung ang alinman sa serbisyo ay nasa offline para sa isang makabuluhang tagal ng panahon.

Bahagyang Pag-sync Ngayon

Ini-synchronize nito ang lahat ng data ng hindi gumagamit. Kasama dito ang mga Panels / Readers / Clearances / Company, atbp.

Buong Pag-sync Ngayon

Nagpapatakbo ito ng isang Bahagi ng Pag-sync at nag-synchronize din ng data ng gumagamit

Mga Pagpipilian sa Tukoy na Data Manager ng Prowatch

Susunod na dapat mong pindutin ang malaking "Setup Data Manager" na pindutan sa kanang itaas.

Dadalhin ka nito sa mga pagpipilian sa Prowatch Tukoy na Data Manager.

Ang mga sumusunod ay kinakailangan:

Ang Server IP (at port kung binago mo ito), Gumagamit at Password

Lagyan ng tsek ang "Gumamit ng Prowatch Area / LogDevs bilang Doors for Occupancy" kung nagsasagawa ka ng pagsubaybay sa Muselling o hanapbuhay.

Kung HINDI ka gumagawa ng Entry / Exit, suriin ang checkbox na "Walang Mga Grupo ng Grupo".

Kung nais mong gumamit ng SignalR, itakda ang Gumagamit ng Kaganapan (malamang na katulad ng gumagamit ng API) at ang Event Workstation (ito ang workstation mula sa Prowatch para sa serbisyo ng XPressEntry).

Maaari kang mag-mapa ng mga patlang mula sa Prowatch Badge sa XPressEntry Gumagamit gamit ang Mga Haligi ng Pinagmulan / patutunguhan sa kaliwa (huwag kalimutang pindutin ang pindutan ng berdeng plus)

Maaari mong piliin kung aling mga Prowatch Areas na aktwal na sinusubaybayan namin ang Occupancy sa ibabang kanan. Tandaan na ang mga ito ay mam populasyon lamang matapos ang isang Partial Sync. Ang praktikal na bahagi nito ay nangangahulugan na kailangan mong pumasok dito, i-setup ang lahat, pagkatapos ay lumabas at pindutin ang Bahagi ng Pag-sync Ngayon, pagkatapos ay bumalik dito upang i-setup ang mga lugar na nasasakupan.

Ang natitirang mga pagpipilian ay paliwanag sa sarili ngunit lahat ay maiiwanang blangko / hindi mapapansin kung alinlangan.

Sasabihin sa iyo ng "Test Connect" kung nakakonekta ang API (ngunit hindi SignalR)

Pindutin ang OK kapag tapos na at pagkatapos ay pindutin ang "I-save" sa pahina ng Data Manager.

Kung ang SignalR ay gumagana, dapat mong makita ang isang katulad nito:

TANDAAN: Walang Mga Mali sa ProwatchDataManager habang ang StartWatchingTables

INFO: Nagsimula ang Pag-subscribe sa Kaganapan sa SignalR

6.Ang Paunang Pag-synchronize ng Data at Setup ng XPressEntry Data #

Iminungkahi na magpatakbo muna ng isang Bahagi ng Pag-sync upang makuha ang lahat ng mga Readers / Clearances / Zones na lahat ay naka-synchronize at set up.

Matapos mong i-setup ang data na iyon sa XPressEntry, magpatakbo ng isang Buong Sync.

7.I-set up ang Mga Prowatch Area bilang XPressEntry Zones #

Bago gawin ito, siguraduhin na nakagawa ka ng isang Bahagi ng Pag-sync kasama ang sistema ng Prowatch

Ang mga lugar ng Prowatch ay mai-mapa sa talahanayan ng XPressEntry Zones.

Para sa bawat lugar kung saan nais mong subaybayan ang trabaho, kailangan mong gawin ang sumusunod.

  1. Siguraduhin na ang "Zone ay nasa labas" at "Ang Zone ay isang Muster Point" ay hindi mapapansin
  2. Siguraduhing naka-check ang "Zona ay isang Panganib na Lugar"

Para sa Mga Punto ng Muster, dapat silang kabaligtaran.

Pag-aayos ng pag-aayos

Kung ang mga nagsasakop ay hindi nagpapakita ng mga Zones sa XPressEntry, mayroong ilang mga bagay upang suriin.

  1. Suriin na ang Channel na ginagamit mo sa Prowatch ay idinagdag sa Mga Ruta ng Ruta para sa gumagamit
  2. Tiyaking mayroon kang mga lohikal na aparato na nakatalaga sa Mga Lugar sa Prowatch
  3. Sa XPressEntry, siguraduhin na ang mga zone ay naka-setup at napili tulad ng sa itaas. Kung nakatakda ang lahat ng 3 mga checkbox, hindi masusubaybayan ng zone ang pagsakop!
  4. Tiyaking nasuri ang mga pagpipilian ng Data Manager para sa "Hilahin Data Manager Occupancy" at "Mga Tore ng Watch sa pamamagitan ng Mga Kaganapan ng Software" ay nasuri.
  5. Siguraduhin na ang mga Pintuan sa XPressEntry ay maayos na naka-setup. (lalo na kung hindi mo nasuri ang "Gumamit ng Prowatch Area / LogDevs bilang Doors for Occupancy" sa form ng Prowatch Data Manager Setup.

8.I-set up ang XPressEntry Handheld Readers at Mga Pintuan #

Bago gawin ito, siguraduhin na nakagawa ka ng isang Bahagi ng Pag-sync kasama ang sistema ng Prowatch

Mga Pintuan

Ang mga pintuan ay direktang na-mapa mula sa Logical Device at Mga Lugar sa Prowatch. Ang mga ito ay awtomatikong nilikha lamang kung ang mga aparato ay naatasan sa isang Area sa Prowatch. Kung hindi, MAAARI kang makagawa ng mga lokal na Pintuan at i-map ang mga ito sa iyong sarili.

Kung nagawa namin nang tama ang lahat, hindi namin kailangang gumawa ng marami dito. Patunayan lamang na ang mga pintuan na mayroon kami ay lilipat ang mga tao sa / Out ng mga lugar nang maayos.

Ang paraan ng pagbabasa nito ay ang Start Zone ay kung saan ka darating mula sa isang Pag-scan ng entry sa handheld device at ang End Zone ay kung saan pupunta ka sa isang pag-scan ng Entry. Ang mga ito ay baligtad para sa mga Exit na mga pag-scan.

Ang Panlabas na Pag-entry / Exit Reader ay dapat tumugma sa Mga lohikal na Mga aparato na na-setup namin sa Prowatch

Mga Mambabasa

Ang mga mambabasa ay direktang na-map mula sa mga lohikal na aparato sa Prowatch.

Kung ang timezone para sa mga aparato at timezone para sa server ay magkakaiba, kakailanganin mong gumawa ng ilang karagdagang pag-setup.

Una, paganahin ang pagpipiliang "Ipakita ang Mga Timezone ng Reader" sa Mga Tool -> Mga Setting -> Pangkalahatan -> Idagdag / I-edit ang Display

Pagkatapos, itakda ang Reader Timezone sa ilalim ng Idagdag / I-edit ang Impormasyon -> Mga Mambabasa -> Seksyon ng Mga Handheld para sa bawat aparato sa isang iba't ibang timezone.

Panghuli, kung gumagamit ka ng mga aparato para sa Mustering at nais ang mga aktibidad ng muster na ipinadala sa Prowatch, itakda ang pagpipilian na "Panlabas na Muster Reader" para sa bawat handheld device.

Sa puntong ito, dapat mong magpatuloy sa karaniwang mga pagpipilian sa Profile ng XPressEntry Reader upang mai-setup ang iyong aparato.

9.Troubleshooting #

Kung nakikita mo ang mga sumusunod na error:

---Exception Message--------------------------
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]
The type initializer for 'HoneywellAccess.ProWatch.PWLogger.Log' threw an exception.
---Exception Stack Trace----------------------

Subaybayan ang stack ng server:
sa System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnderstand (Sagot ng mensahe, error sa MessageFault, Pagkilos ng string, bersyon ng MessageVersion, FaultConverter faultConverter)
sa System.ServiceModel.Channels.ServiceChannel.HandleReply (ProxyOperationRuntime na operasyon, ProxyRpc & rpc)
sa System.ServiceModel.Channels.ServiceChannel.Call (String action, Boolean oneway, ProxyOperationRuntime operation, Object [] ins, Object [] outs, TimeSpan timeout)
sa System.ServiceModel.Channels.ServiceChannelProxy.InvokeService (IMethodCallMessage na pamamaraanCall, ProxyOperationRuntime operasyon)
sa System.ServiceModel.Channels.ServiceChannelProxy.Invoke (IMessage message)

Kailangan mong pumunta at i-edit ang file na PW-DTU-WinService.exe at bigyan ng puna ang sumusunod na dalawang linya:

<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" />

At sa pamamagitan ng pag-aalis sa kanila o pagpaligid sa kanila ng seksyon ng puna ng XML:

<!--<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" /> -->

Magmungkahi ng I-edit