Documentation Honeywell Prowatch

1.Objet #

Ce document est destiné à informer les administrateurs système sur la manière de synchroniser un système XPressEntry avec le système Honeywell Prowatch.

Pré-requis

On suppose que vous avez installé Honeywell Prowatch et XPressEntry à des endroits sur un réseau où ils peuvent se parler (ou sur le même boîtier)

Prowatch doit être autorisé à utiliser l'API Web

Vous devez être administrateur ou super utilisateur du système Prowatch.

2.Configuration de Prowatch pour la synchronisation avec XPressEntry #

On suppose que Honeywell Prowatch v4.4 ou v4.5 est installé sur un serveur.

Pour les intégrations dans d'autres versions de Prowatch, veuillez contacter Telaeris pour confirmer la compatibilité.

Prowatch exige que vous ayez installé leur API Prowatch. Contactez votre représentant Honeywell pour plus d'informations sur les licences et l'installation de l'API Prowatch.

 

Prowatch 5.0 est pris en charge avec la version d'API 5.0.0.510. Assurez-vous que le framework .NET 4.8 est installé et vérifiez la section Dépannage pour vous assurer que ces lignes ne sont pas dans le fichier .config.

 

Installation du service d'API Pro-Watch

(cette section est copiée gratuitement à partir du fichier Pro-Watch_DTU_Service.pdf)

1. Créez et copiez le fichier zip de l'API Pro-Watch dans un dossier sous le répertoire d'installation de Pro-Watch

2. En cas de mise à niveau à partir d'une version précédente, exécutez le fichier Uninstall_PW_DTU_Service.bat en tant qu'administrateur pour supprimer le service Pro-Watch DTU des services Windows. Supprimer l'ancienne version.

3. Dans le répertoire DTU Service sous le répertoire d'installation de Pro-Watch, décompressez tous les fichiers dans le répertoire actuel.

4. Modifiez le fichier PW-DTU-Service.exe.config et définissez les sections de point de terminaison et de liaison. Le service DTU est configuré par défaut pour utiliser la liaison de base HTTP sans sécurité.

5. Exécutez le fichier Install_PW_DTU_Service.bat en tant qu'administrateur. Cela ajoutera un service Windows appelé Service ProWatch DTU.

6. Dans les services Windows, cliquez avec le bouton droit sur le service Pro-Watch DTU et sélectionnez Propriétés.

7. Sélectionnez l'onglet «Connexion» et ajoutez un compte utilisateur au service ayant accès au serveur Pro-Watch et à la base de données Pro-Watch.

Remarque: le compte de service DTU doit avoir accès à la base de données Pro-Watch dans SQL Server, être un utilisateur valide dans Pro-Watch et avoir accès Pro-Watch à ce poste de travail / serveur. Le même compte qui est utilisé pour Pro-Watch peut et est suggéré pour être utilisé pour le service Pro-Watch DTU. Lorsque vous utilisez un compte de service, exécutez la commande suivante pour réserver l'URL (comme spécifié dans le fichier de configuration de l'API).

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

8. Dans les services Windows, démarrez le service Pro-Watch DTU.

Configurer l'API Prowatch

Pour que la synchronisation des API fonctionne correctement, nous devons configurer deux API dans Prowatch.

L'API SOAP et SignalR.

Les 4 clés suivantes doivent être définies dans le fichier PW-DTU-WinService.exe.config

Notez que si vous installez XPressEntry sur une machine différente de l'API, vous devrez changer le "localhost" en "votre nom de machine" dans ces clés.

3.Compte utilisateur de l'API Prowatch #

(cette section est également copiée gratuitement à partir du fichier Pro-Watch_DTU_Service.pdf)

Activation d'un utilisateur Pro-Watch

  1. Dans Pro-Watch, sélectionnez Configuration de la base de données
  2. Sélectionnez des utilisateurs ou des classes
  3. Modifiez ou créez un utilisateur qui se connectera au service Pro-Watch DTU.
  4. Sélectionnez l'onglet Programmes
  5. Développer la configuration de la base de données
  6. Sélectionnez "Définit l'utilisateur"
  7. Cliquez sur le bouton "Ajouter une fonction"
  8. Ajouter 'Activer le mot de passe Web'
  9. Enregistrez l'enregistrement de l'utilisateur ou de la classe. Le 'Mot de passe Web' de l'utilisateur doit maintenant être activé.
  10. Entrez un 'Mot de passe Web' et enregistrez l'enregistrement utilisateur.

Autorisations utilisateur

Les autorisations minimales suivantes sont nécessaires au niveau de l'utilisateur API dans Prowatch:

Administration -> Utilitaire de transfert de données -> Événement de problème n'est nécessaire que si nous envoyons des activités à Prowatch

Administration -> Utilitaire de transfert de données -> S'abonner aux événements n'est nécessaire que si nous utilisons l'API SignalR

Assurez-vous également que l'utilisateur de l'API dispose d'un groupe de routage avec le poste de travail Prowatch «dtuservice» ajouté. Ceci est nécessaire pour que SignalR fonctionne.

Celles-ci sont nécessaires car XPressEntry effectue les appels suivants via l'API:

  • IssueReaderEvent
  • ObtenirAreaOccupants
  • GetCompagnies
  • Obtenir les types de badge
  • Obtenir des zones
  • GetLogDevsByHWClass ou GetLogicalDevicesAll
  • Obtenir des codes de dédouanement
  • GetClearanceCodesLD
  • QueryBadgesPaging
  • GetBadgeBlob ou GetBadgePhoto

4.Configurer les lecteurs Prowatch et les niveaux de dégagement #

Si vous souhaitez envoyer des événements dans Prowatch, vous devrez configurer un canal / un panneau / des lecteurs comme espaces réservés pour recevoir les événements de XPressEntry.

Pour chaque ordinateur de poche physique, nous devons configurer deux lecteurs de périphériques logiques (IN / OUT) dans Prowatch.

Si nous ne faisons que du rassemblement, vous n'avez besoin que d'un seul périphérique logique par ordinateur de poche.

Vous pouvez faire ça comme ça:

Configuration matérielle -> Ajouter un canal

Sélectionnez PW-5000 / PW6000

Donnez-lui un nom, puis cliquez sur Suivant, Suivant puis sur Terminer (les options n'ont pas d'importance car nous utilisons simplement ce canal et les panneaux comme espaces réservés pour les événements de lecteur).

Cochez «Installé» uniquement au départ. Sélectionnez le TimeZone pour le moment.


Ensuite, nous ajouterons un panneau au système Prowatch.

Sous Configuration matérielle, cliquez avec le bouton droit sur Panneaux et sélectionnez Nouveau -> Panneau

Choisissez le site et le canal.

Sélectionnez un type de contrôleur PW-5000 ou PW-6000.

Appuyez sur Suivant et ajoutez un PW5000 2R pour chaque ordinateur de poche effectuant une entrée / sortie.

Puis appuyez sur Terminer.

Nous devons maintenant ajouter les lecteurs de périphériques logiques au panneau.

Sous Configuration matérielle, cliquez avec le bouton droit sur Lecteurs et sélectionnez Nouveau -> Périphérique logique

Sélectionnez le bon panneau que nous venons de créer

Définissez le modèle de matériel sur DoorTypical ACR (Access Control Reader) ou Entry / Exit Reader Door.

Appuyez ensuite sur Suivant et sélectionnez un ou plusieurs ports pour le (s) lecteur (s). Si vous utilisez la porte du lecteur d'entrée / sortie, cela couplera automatiquement les deux périphériques logiques pour l'entrée / la sortie.

S'il n'y en a pas, revenez au panneau et ajoutez un port de lecteur.

Puis appuyez sur Terminer

Lorsque vous avez terminé, décochez la case Installé sous le panneau.

Codes de liquidation

Ajoutez les lecteurs aux codes de dédouanement appropriés si nous effectuons une entrée / sortie

Pour ce faire, allez dans Configuration de la base de données -> Codes de dégagement.

Sélectionnez la clairance appropriée pour ajouter les lecteurs ou ajoutez-en une nouvelle

Notez que ce n'est pas nécessaire si nous ne faisons que du rassemblement.

Ajouter des périphériques logiques aux zones

Ensuite, vous devez vous assurer que vos lecteurs Prowatch et XPressEntry actuels sont correctement mappés aux zones dans Prowatch.

Cela se fait à partir de la configuration de la base de données -> Zone

Ajoutez ou sélectionnez les zones dans lesquelles vous souhaitez que les lecteurs entrent / sortent. Cliquez sur le périphérique logique à gauche, puis sur le lecteur au milieu. Utilisez ensuite la flèche droite pour déplacer l'appareil. Cliquez sur In / Out X pour définir si l'appareil met l'utilisateur en / hors

5.Activer la synchronisation du gestionnaire de données dans XPressEntry #

Ensuite, vous allez configurer XPressEntry pour synchroniser les données de Prowatch. Tout cela est géré à partir de l'application serveur XPressEntry sous Outils -> Paramètres -> Gestionnaire de données

En haut, cochez la case Activer le gestionnaire de données, puis définissez le type sur Prowatch DTU

Déterminez les fonctionnalités de Data Manager que vous souhaitez utiliser avec Prowatch

  1. Envoyer des activités
  2. Recevoir des activités
  3. Occupation
  4. Inclure des fonctionnalités spécifiques pour le gestionnaire de données

Voici ce que font les options:

Tirez les activités du gestionnaire de données dans XPressEntry:

Lorsque SignalR est activé, cela ajoute les événements de Prowatch dans XPressEntry en tant qu'activités de badge.

Poussez les activités XPressEntry vers Data Manager:

Cela utilisera le canal / les panneaux / les lecteurs ci-dessus pour envoyer des activités dans Prowatch.

Occupation du gestionnaire de données Pull

Cela synchronise les occupants de zone de Prowatch avec XPressEntry.

Regarder des tableaux via des événements logiciels

Cela active l'élément d'événement SignalR

Rôle par défaut

Le rôle par défaut à attribuer aux badges (utilisateurs) lors de la synchronisation des utilisateurs depuis Prowatch.

Aucune synchronisation synchrone

Utilisé pour s'assurer qu'une seule synchronisation (complète, partielle, occupation, activité) est en cours d'exécution à un moment donné. Pas nécessaire pour cette intégration.

Synchronisation des activités maintenant

Exécute le processus de synchronisation des activités. Pour Prowatch, cela tirera l'occupation ET enverra immédiatement les activités au gestionnaire de données. Ce n'est pas nécessaire, mais a été utilisé dans les versions précédentes de Prowatch Data Manager.

Synchronisation d'occupation maintenant

Synchronise les occupants de la zone de Prowatch dans XPressEntry. Nécessaire pour le rassemblement.

Il est suggéré de régler ce paramètre toutes les 5 minutes. Cela «rattrapera» toutes les activités manquées si l'un des services était hors ligne pendant une période de temps significative.

Synchronisation partielle maintenant

Cela synchronise toutes les données non utilisateur. Cela comprend les panneaux / lecteurs / dégagements / entreprises, etc.

Synchronisation complète maintenant

Cela exécute une synchronisation partielle et synchronise également les données utilisateur

Options spécifiques au gestionnaire de données Prowatch

Ensuite, vous devez cliquer sur le gros bouton «Configurer le gestionnaire de données» en haut à droite.

Cela vous mènera aux options du gestionnaire de données spécifiques à Prowatch.

Les éléments suivants sont nécessaires:

L'adresse IP du serveur (et le port si vous l'avez modifié), l'utilisateur et le mot de passe

Cochez la case «Utiliser les zones Prowatch / LogDev comme portes pour l'occupation» si vous effectuez un rassemblement ou un suivi d'occupation.

Si vous n'effectuez PAS Entrée / Sortie, cochez la case «Aucune donnée de groupe».

Si vous souhaitez utiliser SignalR, définissez l'utilisateur de l'événement (probablement le même que l'utilisateur de l'API) et le poste de travail d'événements (il s'agit du poste de travail de Prowatch pour le service XPressEntry).

Vous pouvez mapper les champs du badge Prowatch à l'utilisateur XPressEntry avec les colonnes source / destination sur la gauche (n'oubliez pas d'appuyer sur le bouton vert plus)

Vous pouvez sélectionner les zones Prowatch sur lesquelles nous suivons réellement l'occupation en bas à droite. Notez que ceux-ci ne se rempliront qu'après une synchronisation partielle. Le côté pratique de cela signifie que vous devez entrer ici, tout configurer, puis sortir et appuyer sur Partial Sync Now, puis revenir ici pour configurer les zones d'occupation.

Les autres options sont explicites mais peuvent toutes être laissées vides / décochées en cas de doute.

"Test Connect" vous dira si l'API est connectée (mais pas SignalR)

Cliquez sur OK lorsque vous avez terminé, puis appuyez sur "Enregistrer" sur la page Gestionnaire de données.

Si SignalR fonctionne, vous devriez voir quelque chose comme ceci:

VERBOSE: aucune erreur dans ProwatchDataManager pendant StartWatchingTables

INFO: L'abonnement à l'événement SignalR a commencé

6.Synchronisation initiale des données et configuration des données XPressEntry #

Il est suggéré d'exécuter d'abord une synchronisation partielle pour que les lecteurs / dégagements / zones soient tous synchronisés et configurés.

Après avoir configuré ces données dans XPressEntry, exécutez une synchronisation complète.

7.Configurer les zones Prowatch en tant que zones XPressEntry #

Avant de faire cela, assurez-vous d'avoir effectué une synchronisation partielle avec le système Prowatch

Les zones de Prowatch seront mappées à la table XPressEntry Zones.

Pour chaque zone où vous souhaitez suivre l'occupation, vous devrez effectuer les opérations suivantes.

  1. Assurez-vous que les cases «Zone is Outside» et «Zone is a Muster Point» ne sont pas cochées
  2. Assurez-vous que «Zone est une zone à risque» est coché

Pour les points de rassemblement, ils devraient être le contraire.

Dépannage de l'occupation

Si les occupants n'apparaissent pas dans les zones dans XPressEntry, il y a des choses à vérifier.

  1. Vérifiez que le canal que vous utilisez dans Prowatch est ajouté aux groupes de routage de l'utilisateur
  2. Assurez-vous que des périphériques logiques sont affectés aux zones dans Prowatch
  3. Dans XPressEntry, assurez-vous que les zones sont configurées et sélectionnées comme ci-dessus. Si les 3 cases à cocher sont cochées, la zone ne suivra pas l'occupation!
  4. Assurez-vous que les options du gestionnaire de données pour «Extraire l'occupation du gestionnaire de données» et «Surveiller les tables via des événements logiciels» sont cochées.
  5. Assurez-vous que les portes de XPressEntry sont correctement configurées. (surtout si vous n'avez pas coché «Utiliser les zones Prowatch / LogDev comme portes pour l'occupation» dans le formulaire de configuration de Prowatch Data Manager.

8.Configurer les lecteurs et les portes portables XPressEntry #

Avant de faire cela, assurez-vous d'avoir effectué une synchronisation partielle avec le système Prowatch

Portes

Les portes sont directement mappées à partir des périphériques logiques et des zones dans Prowatch. Celles-ci ne sont créées automatiquement que si les appareils sont affectés à une zone dans Prowatch. Sinon, vous POUVEZ créer des portes locales et les mapper vous-même.

Si nous avons tout fait correctement, nous n'aurons pas grand-chose à faire ici. Vérifiez simplement que les portes que nous avons permettront aux personnes d'entrer et de sortir correctement des zones.

La façon de les lire est que la zone de départ sera l'endroit d'où vous venez lors d'une analyse d'entrée sur l'appareil portable et la zone de fin sera l'endroit où vous vous dirigez lors d'une analyse d'entrée. Ceux-ci sont inversés pour les scans de sortie.

Les champs du lecteur externe d'entrée / sortie doivent correspondre aux périphériques logiques que nous avons configurés dans Prowatch

Lecteurs

Les lecteurs sont directement mappés à partir des périphériques logiques dans Prowatch.

Si le fuseau horaire des appareils et le fuseau horaire du serveur sont différents, vous devrez effectuer une configuration supplémentaire.

Tout d'abord, activez l'option "Afficher les fuseaux horaires du lecteur" dans Outils -> Paramètres -> Général -> Ajouter / Modifier l'affichage

Ensuite, définissez le fuseau horaire du lecteur dans la section Ajouter / modifier des informations -> Lecteurs -> Ordinateurs de poche pour chaque appareil dans un fuseau horaire différent.

Enfin, si vous utilisez les appareils pour le rassemblement et que vous souhaitez que les activités de rassemblement soient envoyées à Prowatch, définissez l'option «Lecteur externe de rassemblement» pour chaque appareil portable.

À ce stade, vous devriez pouvoir continuer avec les options standard du profil XPressEntry Reader pour configurer votre appareil.

9.Dépannage #

Si vous voyez les erreurs suivantes:

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

Trace de la pile du serveur:
à System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnderstood (Réponse de message, erreur MessageFault, action de chaîne, version MessageVersion, FaultConverter faultConverter)
à System.ServiceModel.Channels.ServiceChannel.HandleReply (opération ProxyOperationRuntime, ProxyRpc & rpc)
à System.ServiceModel.Channels.ServiceChannel.Call (action de chaîne, Boolean oneway, opération ProxyOperationRuntime, Object[] ins, Object[] outs, TimeSpan timeout)
à System.ServiceModel.Channels.ServiceChannelProxy.InvokeService(IMethodCallMessage methodCall, ProxyOperationRuntime operation)
à System.ServiceModel.Channels.ServiceChannelProxy.Invoke (message IMessage)

Vous devez aller éditer le fichier PW-DTU-WinService.exe et commenter les deux lignes suivantes:

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

Et en les supprimant ou en les entourant d'une section de commentaire XML :

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

Suggérer Modifier