Documentazione sulla sincronizzazione di Prowatch XPressEntry

Questo documento ha lo scopo di istruire gli amministratori di sistema su come sincronizzare un sistema XPressEntry con il sistema Honeywell Prowatch.

Prerequisiti

Si presume che tu abbia installato Honeywell Prowatch e XPressEntry in punti di una rete in cui possono comunicare tra loro (o sulla stessa scatola)

Prowatch dovrebbe essere concesso in licenza per utilizzare l'API Web

Dovresti essere un amministratore o un super utente nel sistema Prowatch.

L'API supporta solo Honeywell Prowatch v4.5 SP2 e versioni successive. Assumiamo che sia installato e pronto per l'integrazione.

Per integrazioni in altre versioni di Prowatch, contatta Telaeris per confermare la compatibilità.

Prowatch richiede che tu abbia installato la loro API Prowatch. Contatta il tuo rappresentante Honeywell per ulteriori informazioni sulla licenza e l'installazione dell'API Prowatch.

Prowatch 5.0 è supportato con API build 5.0.0.510. Assicurati che .NET Framework 4.8 sia installato e controlla la sezione Risoluzione dei problemi per assicurarti che queste righe non siano nel file .config.

Installazione del servizio API Pro-Watch

(questa sezione è copiata gratuitamente dal file Pro-Watch_DTU_Service.pdf)

1. Crea e copia il file zip dell'API Pro-Watch in una cartella sotto la directory di installazione di Pro-Watch

2. Se esegui l'aggiornamento da una versione precedente, esegui il file Uninstall_PW_DTU_Service.bat come amministratore per rimuovere il servizio Pro-Watch DTU dai servizi Windows. Elimina la vecchia versione.

3. Nella directory del servizio DTU sotto la directory di installazione di Pro-Watch, decomprimere tutti i file nella directory corrente.

4. Modificare il file PW-DTU-Service.exe.config e impostare le sezioni dell'endpoint e dell'associazione. Per impostazione predefinita, il servizio DTU utilizza l'associazione di base HTTP senza sicurezza.

5. Eseguire il file Install_PW_DTU_Service.bat come amministratore. Questo aggiungerà un servizio Windows chiamato ProWatch DTU Service.

6. In Servizi Windows, fare clic con il pulsante destro del mouse sul servizio Pro-Watch DTU e selezionare Proprietà.

7. Seleziona la scheda "Accedi" e aggiungi un account utente al servizio che ha accesso al server Pro-Watch e al database Pro-Watch.

Nota: l'account del servizio DTU deve avere accesso al database Pro-Watch in SQL Server, essere un utente valido in Pro-Watch e disporre dell'accesso Pro-Watch a tale workstation/server. Lo stesso account utilizzato per Pro-Watch può e si consiglia di utilizzare per il servizio Pro-Watch DTU. Quando utilizzi un account di servizio, esegui il seguente comando per prenotare l'URL (come specificato nel file di configurazione dell'API).

Esempio: Netsh http add urlacl url=http://machinename:8734/pwapi user=DOMAINaccountname

8. In Servizi Windows, avvia il servizio Pro-Watch DTU.

Configurazione dell'API Prowatch

Affinché la sincronizzazione delle API funzioni correttamente, dobbiamo impostare due API in Prowatch.

L'API SOAP e SignalR.

Le seguenti 4 chiavi devono essere impostate nel file PW-DTU-WinService.exe.config

Tieni presente che se stai installando XPressEntry su una macchina diversa dall'API, dovrai modificare "localhost" in "nome della tua macchina" in queste chiavi.

(questa sezione è anche copiata gratuitamente dal file Pro-Watch_DTU_Service.pdf)

Abilitazione di un utente Pro-Watch

1. In Pro-Watch, seleziona Configurazione database
2. Seleziona Utenti o Classi
3. Modifica o crea un utente che si connetterà al servizio Pro-Watch DTU.
4. Seleziona la scheda Programmi
5. Espandere Configurazione database
6. Seleziona "Definizioni utente"
7. Fare clic sul pulsante "Aggiungi funzione".
8. Aggiungi "Abilita password Web"
9. Salva il record dell'utente o della classe. Ora la 'password web' per l'utente dovrebbe essere abilitata.
10. Immettere una "password web" e salvare il record dell'utente.

Autorizzazioni utente

Le seguenti autorizzazioni minime sono necessarie a livello di utente API in Prowatch:

Amministrazione -> Utilità di trasferimento dati -> Evento problema è necessario solo se inviamo attività a Prowatch

Amministrazione -> Utilità di trasferimento dati -> Iscriviti agli eventi è necessario solo se si usa l'API SignalR

Assicurati inoltre che l'utente API disponga di un gruppo di instradamento con la workstation Prowatch "dtuservice" aggiunta. Questo è necessario per il funzionamento di SignalR.

Questi sono necessari perché XPressEntry effettua le seguenti chiamate tramite l'API:

• IssueReaderEvent
• OttieniAreaOccupanti
• Ottieni aziende
• OttieniBadgeTypes
• Ottieni aree
• GetLogDevsByHWClass o GetLogicalDevicesAll
• Ottieni codici di liquidazione
• Ottieni codici di liquidazioneLD
• QueryBadgesPaging
• GetBadgeBlob o GetBadgePhoto

Se desideri inviare eventi a Prowatch, dovrai configurare un canale/pannello/lettori come segnaposto per ricevere gli eventi da XPressEntry.

Per ogni palmare fisico, dovremmo impostare due lettori di dispositivi logici (IN/OUT) nel Prowatch.

Se stiamo solo eseguendo il raduno, è necessario un solo dispositivo logico per palmare.

Puoi farlo in questo modo:

Configurazione hardware -> Aggiungi un canale

Selezionare PW-5000/PW6000

Assegnagli un nome, quindi fai clic su Avanti, Avanti e poi su Fine (le opzioni non contano poiché utilizziamo solo questo canale e i pannelli come segnaposto per gli eventi dei lettori).

Seleziona "Installato" solo inizialmente. Seleziona il fuso orario per ora.

Successivamente aggiungeremo un pannello al sistema Prowatch.

In Configurazione hardware, fare clic con il tasto destro su Pannelli e selezionare Nuovo -> Pannello

Scegli il sito e il canale.

Selezionare un tipo di controller PW-5000 o PW-6000.

Premi Avanti e aggiungi un PW5000 2R per ogni palmare che esegue Entrata/Uscita.

Quindi premi Fine.

Ora dobbiamo aggiungere i lettori di dispositivi logici al pannello.

In Configurazione hardware, fare clic con il tasto destro su Lettori e selezionare Nuovo -> Dispositivo logico

Seleziona il pannello corretto che abbiamo appena creato

Impostare il modello hardware su DoorTypical ACR (Access Control Reader) o Entry/Exit Reader Door.

Quindi premi Avanti e seleziona una o più porte per i lettori. Se si utilizza la Porta del Lettore Entrata/Uscita, questo abbinerà automaticamente i due dispositivi logici per Entrata/Uscita.

Se non esiste, torna al pannello e aggiungi una porta del lettore.

Quindi premi Fine

Al termine, deseleziona la casella di controllo Installato sotto il Pannello.

Codici di autorizzazione

Aggiungi i lettori ai codici di autorizzazione appropriati se stiamo effettuando Entrata/Uscita

Per farlo, vai su Configurazione database -> Codici di autorizzazione.

Selezionare l'autorizzazione appropriata a cui aggiungere i lettori o aggiungerne una nuova

Nota che questo non è necessario se stiamo solo facendo il Raduno.

Aggiungi dispositivi logici alle aree

Successivamente devi assicurarti che i tuoi attuali lettori Prowatch e lettori XPressEntry siano mappati correttamente alle aree in Prowatch.

Questo viene fatto da Configurazione database -> Area

Aggiungi o seleziona le aree in cui vuoi che i lettori entrino o escano. Fare clic sul dispositivo logico a sinistra, quindi sul lettore al centro. Quindi utilizzare la freccia destra per spostare il dispositivo. Fare clic sulla X In/Out per impostare se il dispositivo inserisce/esclude l'utente

Il prossimo sarà l'impostazione di XPressEntry per sincronizzare i dati da Prowatch. Tutto questo è gestito dall'applicazione server XPressEntry in Strumenti -> Impostazioni -> Gestore dati

In alto, seleziona Enable Data Manager e quindi imposta Type su Prowatch DTU

Determina quali funzionalità di Data Manager desideri utilizzare con Prowatch

1. Invia attività
2. Ricevi attività
3. occupazione
4. Includi funzionalità specifiche per il gestore dati

Ecco cosa fanno le opzioni:

Inserisci le attività di Data Manager in XPressEntry:

Quando SignalR è abilitato, aggiunge gli eventi da Prowatch a XPressEntry come attività badge.

Invia attività XPressEntry a Data Manager:

Questo utilizzerà il canale/pannelli/lettori sopra per inviare attività in Prowatch.

Tirare l'occupazione di Data Manager

Questo sincronizza gli occupanti dell'area da Prowatch con XPressEntry.

Guarda tabelle tramite eventi software

Ciò abilita la parte dell'evento SignalR

Ruolo predefinito

Il ruolo predefinito da assegnare ai badge (utenti) durante la sincronizzazione degli utenti da Prowatch.

Nessuna sincronizzazione sincrona

Utilizzato per assicurarsi che sia in esecuzione solo una sincronizzazione (completa, parziale, occupazione, attività) in un dato momento. Non necessario per questa integrazione.

Sincronizza attività ora

Esegue il processo di sincronizzazione delle attività. Per Prowatch questo ritirerà l'occupazione E invierà immediatamente le attività al gestore dati. Questo non è necessario, ma è stato utilizzato nelle versioni precedenti di Prowatch Data Manager.

Sincronizzazione occupazione ora

Sincronizza gli occupanti dell'area da Prowatch a XPressEntry. Necessario per il Raduno.

Si consiglia di impostarlo ogni 5 minuti. Questo "recupererà" tutte le attività che sono state perse se uno dei due servizi è rimasto offline per un periodo di tempo significativo.

Sincronizzazione parziale ora

Questo sincronizza tutti i dati non utente. Ciò include pannelli/lettori/autorizzazioni/aziende, ecc.

Sincronizzazione completa ora

Questo esegue una sincronizzazione parziale e sincronizza anche i dati dell'utente

Opzioni specifiche del gestore dati di Prowatch

Successivamente dovresti premere il grande pulsante "Setup Data Manager" in alto a destra.

Questo ti porterà alle opzioni di Prowatch Specific Data Manager.

Sono necessari i seguenti requisiti:

L'IP del server (e la porta se l'hai modificata), l'utente e la password

Seleziona "Usa aree Prowatch/LogDev come porte per l'occupazione" se stai eseguendo il raduno o il monitoraggio dell'occupazione.

Se NON stai effettuando Entrata/Uscita, seleziona la casella di controllo "Nessun dato di gruppo".

Se si desidera utilizzare SignalR, impostare Event User (probabilmente uguale all'utente API) e Event Workstation (questa è la workstation di Prowatch per il servizio XPressEntry).

Puoi mappare i campi dal badge Prowatch all'utente XPressEntry con le colonne di origine/destinazione a sinistra (non dimenticare di premere il pulsante più verde)

Puoi selezionare quali aree Prowatch stiamo effettivamente monitorando l'occupazione in basso a destra. Tieni presente che questi verranno popolati solo dopo che è stata eseguita una sincronizzazione parziale. Il lato pratico di questo significa che devi entrare qui, impostare tutto, quindi uscire e premere Partial Sync Now, quindi tornare qui per impostare le aree di occupazione.

Il resto delle opzioni sono autoesplicative ma possono essere lasciate tutte vuote/deselezionate in caso di dubbio.

"Test Connect" ti dirà se l'API è connessa (ma non SignalR)

Premi OK quando hai finito, quindi premi "Salva" nella pagina Gestione dati.

Se SignalR funziona, dovresti vedere qualcosa del genere:

VERBOSE: nessun errore in ProwatchDataManager durante l'avvio di WatchingTables

INFORMAZIONI: sottoscrizione all'evento SignalR avviata

Si consiglia di eseguire prima una sincronizzazione parziale per sincronizzare e impostare tutti i lettori/autorizzazioni/zone.

Dopo aver impostato i dati in XPressEntry, esegui una sincronizzazione completa.

Prima di farlo, assicurati di aver eseguito una sincronizzazione parziale con il sistema Prowatch

Le aree Prowatch verranno mappate alla tabella XPressEntry Zones.

Per ogni area in cui desideri monitorare l'occupazione, dovrai eseguire le seguenti operazioni.

1. Assicurati che "Zone is Outside" e "Zone is a Muster Point" siano deselezionati
2. Assicurati che "La zona è un'area a rischio" sia selezionata

Per i punti di raccolta, dovrebbero essere l'opposto.

Risoluzione dei problemi di occupazione

Se gli occupanti non vengono visualizzati nelle zone in XPressEntry, ci sono alcune cose da controllare.

1. Verifica che il canale che stai utilizzando in Prowatch sia stato aggiunto ai gruppi di instradamento per l'utente
2. Assicurati di avere dispositivi logici assegnati alle aree in Prowatch
3. In XPressEntry, assicurati che le zone siano configurate e selezionate come sopra. Se tutte e 3 le caselle di controllo sono impostate, la zona non monitorerà l'occupazione!
4. Assicurarsi che le opzioni di Data Manager per "Pull Data Manager Occupancy" e "Watch Tables via Software Events" siano selezionate.
5. Assicurati che le porte in XPressEntry siano configurate correttamente. (soprattutto se non hai selezionato "Usa aree Prowatch/LogDev come porte per l'occupazione" nel modulo di configurazione di Prowatch Data Manager.

Prima di farlo, assicurati di aver eseguito una sincronizzazione parziale con il sistema Prowatch

Porte

Le porte sono mappate direttamente dai dispositivi logici e dalle aree in Prowatch. Questi vengono creati automaticamente solo se i dispositivi sono assegnati a un'area in Prowatch. Altrimenti PUOI creare porte locali e mapparle da solo.

Se abbiamo fatto tutto correttamente, non dovremo fare molto qui. Basta verificare che le porte che abbiamo sposteranno correttamente le persone dentro e fuori le aree.

Il modo per leggerli è che la zona di partenza sarà da dove vieni in una scansione di entrata sul dispositivo portatile e la zona di arrivo sarà dove stai andando in una scansione di entrata. Questi sono invertiti per le scansioni di uscita.

I campi del lettore di ingresso/uscita esterno devono corrispondere ai dispositivi logici che abbiamo impostato in Prowatch

Lettori

I lettori vengono mappati direttamente dai dispositivi logici in Prowatch.

Se il fuso orario dei dispositivi e il fuso orario del server sono diversi, dovrai eseguire alcune impostazioni aggiuntive.

Innanzitutto, abilita l'opzione "Mostra fusi orari del lettore" in Strumenti -> Impostazioni -> Generale -> Aggiungi/Modifica visualizzazione

Quindi, impostare il fuso orario del lettore nella sezione Aggiungi/Modifica informazioni -> Lettori -> Palmari per ciascun dispositivo in un fuso orario diverso.

Infine, se stai utilizzando i dispositivi per il Raduno e desideri che le attività di raccolta vengano inviate a Prowatch, imposta l'opzione "Lettore di raccolta esterno" per ogni dispositivo portatile.

A questo punto, dovresti essere in grado di procedere con le opzioni standard del profilo XPressEntry Reader per configurare il tuo dispositivo.

Se visualizzi i seguenti errori:

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

Traccia dello stack del server:
in System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnderstain (risposta messaggio, errore MessageFault, azione stringa, versione MessageVersion, errore FaultConverter faultConverter)
in System.ServiceModel.Channels.ServiceChannel.HandleReply (operazione ProxyOperationRuntime, ProxyRpc e rpc)
in System.ServiceModel.Channels.ServiceChannel.Call (azione String, oneway booleano, operazione ProxyOperationRuntime, Object [] ins, Object [] out, TimeSpan timeout)
in System.ServiceModel.Channels.ServiceChannelProxy.InvokeService (IMethodCallMessage methodCall, operazione ProxyOperationRuntime)
in System.ServiceModel.Channels.ServiceChannelProxy.Invoke (messaggio IMessage)

Devi andare a modificare il file PW-DTU-WinService.exe e commentare le seguenti due righe:

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

E rimuovendoli o circondandoli con la sezione dei commenti XML:

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