Traduit de Anglais vers Français - www.onlinedoctranslator.

com

Les gens de Zoho

Biométrique
L'intégration
01
INTRODUCTION
Introduction de base sur l'intégration biométrique de
Zoho People et l'organigramme des processus

02
TERMINOLOGIE
Terminologies utilisées et leurs liens de téléchargement

03
CONDITIONS PRÉALABLES

Liste des éléments qui doivent être prêts avant

la mise en œuvre

04
PROCÉDURE
Procédure étape par étape pour mettre en œuvre
l'intégration biométrique

05
DES EXCEPTIONS
Liste des exceptions courantes qui se produisent lors
de l'intégration
 INTRODUCTION

BLes appareils iométriques peuvent être intégrés à Zoho People de deux manières :

API

Intégration de plugins

Intégration à l'aide de la méthode API

tuGrâce à cette API, les données peuvent être transmises directement à Zoho People à partir de l'appareil biométrique.
C onconfiguration de la même chose doit être fait à partir de la fin du client. Veuillez noter que l'API Attendance ulk
BImport a des limites de seuil de 10 requêtes/minute et une période de verrouillage de 5 minutes.

Intégration de plugins

UN
Une autre façon d'intégrer l'appareil biométrique à Zoho People consiste à configurer un lugin à
pl'aide deServeur Tomcat.

Biométrique BD SQL &

L'intégration
Conditions préalables Schéma de tableau

Fin de Zoho Client final

Intégration via le plugin Zoho Intégration via API

Construction de requête SQL L'AP sera partagé et l'intégration

doit être effectuée du côté client
via un script

Les données de présence de SQL DB

seront transmises à Zoho People toutes
les 5 minutes

01
 TERMINOLOGIE

DISPOSITIF BIOMETRIQUE

Il s'agit d'une machine électronique conçue pour l'identification et

l'authentification grâce à des caractéristiques physiologiques et
comportementales telles que la reconnaissance faciale, la lecture des
empreintes digitales, la reconnaissance de la paume, etc.

SERVEUR TOMCAT
Il s'agit d'un conteneur de servlet Java open source qui
implémente de nombreuses spécifications d'entreprise Java telles
que l'API Websites, les pages Java-Server et le servlet Java.

MySQL (BASE DE DONNÉES)

MySQL est un système de gestion de base de données relationnelle

open source. La licence GPL open source permet aux
programmeurs de modifier le logiciel MySQL pour l'adapter à leurs
propres environnements spécifiques.

ACCÈS MS
Microsoft Access est un système de gestion de base de données de
Microsoft qui combine le moteur de base de données Access
relationnel avec une interface utilisateur graphique et des outils de
développement de logiciels.

SERVEUR MS SQL
Microsoft SQL Server est un système de gestion de bases de données
relationnelles. Il s'agit d'un produit logiciel dont la fonction principale
est de stocker et de récupérer des données demandées par d'autres
applications logicielles.

02
 CONDITIONS PRÉALABLES

Nous prenons en charge les bases de données MS SQL SERVER, MS Access et MYSQL et le format de requête
mentionné ci-dessous.

Note:Il est important d'avoir un informaticien ou votre fournisseur biométrique à vos côtés pour procéder
à l'intégration.

QExigences générales :
Pgénérez le format de requête ci-dessous afin de récupérer les informations de votre base de données.

"Sélectionnez employeeID, eventTime, isCheckin, downloadDate from Attendance »

eID employé-Doit être identique à l'identifiant de l'employé dans Zoho People*

eventTime-Pointage d'entrée et pointage de présence (au format date/heure)

je
enregistrement-1/0 (1 indique l'enregistrement et 0 indique le départ)

ddate de chargement-Date et heure auxquelles les données de présence sont transmises à la base de données (au format date/
F heure).

S logiciels à installer

Apache Tomcat 8
Cliquez sur le programme d'installation du service Windows 32 bits/64 bits sous Core.

Java 8
Téléchargez un fichier JDK sous Java SE Development Kit qui convient à votre
configuration Windows.

03
Veuillez trouver l'exemple de schéma de table ci-joint pour votre référence

Note:

• Si la colonne "Downloaddate" n'est pas disponible dans le tableau, nous ne pouvons pas garantir que toutes les données de la

base de données SQL seront transmises à Zoho People et il pourrait y avoir un changement possible de perte de données.

• S'il y a plusieurs équipes pour vos employés, elles doivent toutes être cartographiées dans Zoho People.

• Si l'identifiant biométrique est différent de l'identifiant de l'employé Zoho People, l'identifiant biométrique doit être mappé

dans Zoho People. Aller àPrésence → Paramètres → Mappage de l'ID utilisateurpour faire cette cartographie.

• L'intégration dépend entièrement du système serveur sur lequel les données biométriques sont stockées. S'il

se bloque ou redémarre en raison d'un arrêt incorrect du système, il peut corrompre la page de configuration.

Dans un tel scénario, nous devrons reconfigurer l'intégration.

04
 PROCÉDURE

Assurez-vous queJavaetApache Tomcatsont installés. Vérifiez sous Disque local C → Fichiers programme ou
Fichiers programme (86) → si JAVA/Tomcat est installé. Sinon, installez les deux logiciels.

Configuration de Tomcat

Nom: Tomcat8Zoho
Arrêter le port :8989
Port de connexion/numéro de port du serveur Tomcat :8584 (vérifiez si ce numéro de port n'est utilisé pour aucun

service)
Type de démarrage :Démarrer → Rechercher → Service → Tomcat8Zoho (clic droit) → propriétés → Démarrage

Type → Automatique

Installer le fichier war

Cliquez sur le lien ci-dessous pour télécharger le fichier war.

https://www.zoho.com/people/downloads/ZAttendance.war
Accédez au disque local C → Fichier programme → Fondation logicielle Apache → Tomcat8 → Applications Web →

Collez le fichier war → actualiser → Le fichier sera extrait.

Routage vers la page du plugin

Vérifiez si vous pouvez accéder à la page du plugin vialocalhost:8584/ZAtendance

URL de connexion

Spécifiez l'URL de connexion :Copiez et collez l'URL par exemple et mettez à jour le nom de la base de données SQL

Nom d'utilisateur et mot de passe de la base de données :Le client doit le fournir

Temporisation:5 minutes

Temps de sommeil:5 minutes

05
Générer un jeton d'authentification

pi-console.zoho.fr (ou com/eu - basé sur le DC) → Auto-client → Générer du code → Portée →
un
zohopeople.attendance.all → Durée : 10min → Créer → Copier le secret client CODE → Copier → ID client
C et secret client → coller le même dans la configuration du plugin.

Mettre à jour le fuseau horaire :Sélectionnez le fuseau horaire de votre emplacement comme indiqué dans votre base de données SQL.

g générer le jeton d'actualisation :Collez le Client ID / Client Secret / CODE / > Sélectionnez le DC > enerate >
g Mettez à jour le jeton d'actualisation.

Note:Lors de la génération du jeton d'accès, assurez-vous qu'il est généré à partir du compte administrateur et que le
fuseau horaire est aligné sur le lieu d'enregistrement/de départ.

06
 Requête SQL

Base de données MSSQL et MS ACCESS :

Lorsque toutes les colonnes selon les conditions préalables :

Tableau statique :

sélectionnez [employeeID] comme employeeId, ischeckin comme isCheckin ,[eventTime] comme eventTime,
[downloadDate] FROM [ZAttendance].[dbo].[Att-checkin] où DownloadDate>=$1 et DownloadDate<$2

Tableau dynamique :

sélectionnez [employeeID] comme employeeId, ischeckin comme isCheckin ,[eventTime] comme eventTime,
[DownloadDate] FROM #Tablename_%M_%Y# où DownloadDate>=$1 et DownloadDate<$2

Lorsque la colonne de date de téléchargement n'est pas disponible : (le délai doit être de 1 à 2 heures)

sélectionnez [Id] comme employeeId, cas [Checkin] quand 'IN' puis 1 quand 'OUT' puis 0 fin comme
isCheckin , [EventTime] comme eventTime FROM [ZAttendance].[dbo].[Att-checkin] where eventTime>= $1 et
eventTime<$2

Lorsque IN/OUT n'est pas spécifié dans le tableau, poussez chaque coup de poing comme IN&OUT vers ZOHO

sélectionnez [empid] comme employeeId, '1' comme isCheckin, [EventTime] comme eventTime,
[downloaddate] FROM [ZAttendance].[dbo].[Att_noCheck] où DownloadDate>=$1 et DownloadDate<$2
SYNDICAT

sélectionnez [empid] comme employeeId, '0' comme isCheckin, [EventTime] comme eventTime,
[downloaddate] FROM [ZAttendance].[dbo].[Att_noCheck] où DownloadDate>=$1 et DownloadDate<$2

Poinçons IN & Out alternés

sélectionnez [Id] comme employeeId , [EventTime] as eventTime ,[DownloadDate] DE

[ZAttendance].[dbo].[Att-checkin] où DownloadDate>=$1 et DownloadDate<$2

Tomcat > config.properties > url doit être remplacé par bulkImportRawEntry au lieu d'importer en
bloc.

07
Poussée manuelle (test)

sélectionnez [Id] comme employeeId, case [Checkin] quand 'IN' puis 1 quand 'OUT' puis 0 end as n
isChecki , [EventTime] as eventTime ,[DownloadDate] FROM [ZAttendance].[dbo].[Att-checkin] où e
EventTime>=$1 et EventTime<$2 et Id='1001'

Une fois que tout est défini, veuillez modifier la requête SQL (remplacez où DownloadDate par où CheckedTim et passez le e
user_id dans la chaîne Id = 'User_id') pour récupérer les données de la base de données et les mettre à jour manuellement o
dans Zoh People pour vous assurer que l'intégration fonctionne sans faille

Paramètre dynamique qui doit être saisi dans la requête SQL en fonction de l'en-tête de
colonne dans le tableau :

IDENTIFIANT:ID utilisateur de la base de données

Heure vérifiée :check-in et check-out de la base de données Date de

téléchargement :Date de téléchargement à partir de la base de données

Enregistrement:IsCheckin (1/0) à partir de la base de données Att-enregistrement :

Nom de la table

Lorsqu'il s'agit d'un tableau dynamique :#Tablename_%M_%Y# (Besoin de l'utiliser dans la requête)

Exemple de table de base de données SQL :

Ici, les en-têtes de tableau sont différents des prérequis et vous devez suivre le ste ci-dessus pour p
construire la requête.

08
 Exceptions les plus courantes :

La requête n'a pas pu récupérer les données (Obtenir le nombre d'enregistrements) :Compter jusqu'à 0

Accédez au fichier programme C → tomcat → journaux → Catalina → Faites défiler vers le bas du bloc-notes →
"Connexion refusée : connexion"

Accédez au fichier programme C → fenêtres → syswow64 → sql_server_manager → configuration réseau du

serveur SQL → protocole SQLExpress → TCP/IP → adresse IP → port TCP : port 1433 → appliquer → OK.

<ou>
Accédez à démarrer → rechercher → gestion de l'ordinateur → gestion ou configuration du réseau du serveur
SQL (deuxième option à gauche) → TCP/IP → adresse IP → port TCP : port 1433 → appliquer → OK.

Redémarrez le service SQL Server :Service SQL Server → SQL Server (MSSQLSERVER) → Clic droit →
Propriétés → Redémarrer.

Échec de la requête de mise à jour de l'enregistrement (récupération et téléchargement) :"Jeton d'accès introuvable"

Accédez au fichier programme C → tomcat → Config.properties → à l'aide du bloc-notes, ouvrez la configuration

→ mettre à jour le DC approprié dans targetURL et acesstokenURL

Si le domaine des personnes est autre que .com (.in ou .eu), mettez à jour le domaine dans config.properties dans le
dossier tomcat pour targetURL et acesstokenURL.

Réponse de l'API dans les journaux :

Une fois que les données ont été transmises de la base de données SQL à la base de données ZOHO - Vérifiez la même chose en

naviguant vers le fichier programme C → Tomcat → journaux → Catalina → Réponse API : Succès

Automatisez la synchronisation :

Une fois que le test fonctionne correctement, veuillez modifier la requête SQL pour automatiser la synchronisation biométrique en cliquant sur

"Reprendre la synchronisation" et en ajoutant le temps d'exécution.

09