Automatisation de l'état de pointage biométrique : entrée et sortie
Dans un système de pointage biométrique, il est essentiel d'identifier avec précision si un pointage correspond à une entrée IN ou à une sortie OUT afin d'assurer un suivi correct des présences. Chez Cams Biometrics, nous proposons plusieurs méthodes souples pour déterminer l'état du pointage, à la fois au niveau du matériel et au niveau du portail d'administration (API).
Cet article explique comment les états de pointage sont enregistrés, quelles options les développeurs peuvent configurer et quelles contraintes techniques importantes doivent être prises en compte pour garantir des performances fiables dans les systèmes en temps réel.
🛠️ 1. État du pointage au niveau matériel
Sur la plupart des appareils biométriques, tous les pointages sont enregistrés comme “Check In” par défaut.
Si un utilisateur souhaite enregistrer une “Check Out” ou tout autre état personnalisé, il doit sélectionner manuellement le mode de pointage approprié sur l'appareil (par exemple en appuyant sur un bouton “Check Out” ou en utilisant une option de l'écran tactile) avant de pointer.
✅ Cette configuration fonctionne bien dans les environnements où les utilisateurs sont formés à sélectionner le bon mode de pointage sur l'appareil.
❌ Important : la sélection automatique de l'état au niveau matériel n'est pas possible. Les appareils biométriques ne gèrent aucune logique métier. Les développeurs doivent s'assurer que les états de pointage sont correctement traités par le logiciel connecté ou la logique de l'API.
🌐 2. État du pointage au niveau du portail Cams (options d'automatisation)
Pour simplifier l'expérience utilisateur et automatiser la classification des états de pointage, les développeurs qui intègrent l'API Web Cams peuvent choisir parmi les options de logique côté serveur suivantes. Ces règles sont appliquées après l'enregistrement du pointage sur l'appareil.
📌 Option 1 : Actual
- L'état exact du pointage (IN/OUT) sélectionné par l'utilisateur sur l'appareil est transmis au serveur.
📌 Option 2 : First In Rest Out
- Le premier pointage de la journée est marqué comme IN.
- Tous les pointages suivants du même utilisateur, au cours d'une même période de 24 heures, sont marqués comme OUT.
- Idéal pour les systèmes où les utilisateurs ne sélectionnent pas manuellement le type de pointage.
📌 Option 3 : ZigZag
- Les pointages alternent entre IN et OUT tout au long de la journée.
- Le premier pointage est IN, le deuxième est OUT, le troisième est IN, et ainsi de suite.
- La logique est maintenue pour chaque utilisateur en fonction de son activité des dernières 24 heures.
ℹ️ Les modes
First In Rest OutetZigZagnécessitent tous deux l'accès à l'historique des pointages des 24 dernières heures pour fonctionner correctement.
⚠️ Contraintes principales à connaître
Bien que ces options de logique automatique simplifient l'intégration, certaines limitations importantes doivent être comprises :
❗ 1. Aucun stockage permanent des données utilisateur
Cams Biometrics ne stocke pas de données utilisateur ou de pointage de manière permanente. Pour First In Rest Out et ZigZag, nous conservons temporairement l'historique des pointages des 24 dernières heures uniquement.
Si un appareil est hors ligne pendant plus de 24 heures, les pointages antérieurs ne sont plus disponibles pour évaluer correctement le pointage suivant. Cela peut entraîner une classification incorrecte (par exemple, considérer le deuxième pointage comme IN au lieu de OUT).
❗ 2. La logique fonctionne uniquement par appareil
Ces logiques d'état de pointage sont appliquées par appareil et par utilisateur. Si un utilisateur pointe sur plusieurs appareils, le système ne croise pas les données entre les machines. Cela provoquera des échecs de logique dans les cas d'utilisation multi-appareils.
❗ 3. Les appareils doivent se connecter au moins une fois toutes les 24 heures
Pour que l'automatisation de l'état de pointage fonctionne de manière fiable, les appareils doivent se mettre en ligne et se synchroniser au moins une fois toutes les 24 heures. Sinon, les serveurs Cams ne pourront pas conserver l'historique de pointage à court terme nécessaire.
❗ 4. Non adapté aux présences basées sur des horaires en équipe
L'automatisation de l'état de pointage repose uniquement sur les données des 24 dernières heures, et la classification est effectuée dans le même jour calendaire que le pointage.
Si vous gérez des présences basées sur des équipes de travail, en particulier des équipes de nuit ou à horaires flexibles, nous vous recommandons vivement de ne pas vous fier à l'état de pointage fourni par l'API. Il est préférable de développer votre propre logique au sein de votre système afin d'interpréter les pointages selon vos définitions d'équipes.
🛠️ Cams ne prend actuellement pas en charge l'automatisation de l'état de pointage en fonction des horaires de travail. Cette logique doit être mise en œuvre dans votre logiciel de gestion des présences.
✅ Bonnes pratiques & recommandation
Avant d'activer la logique automatique de l'état de pointage (First In Rest Out ou ZigZag), assurez-vous que :
- Les utilisateurs pointent systématiquement sur un seul appareil attribué.
- Chaque appareil se connecte au serveur au moins une fois toutes les 24 heures.
- Vous comprenez le fonctionnement et les limites de ces modes de logique afin d'éviter une interprétation incorrecte des pointages.
🛑 N'activez pas ces options si votre configuration ne respecte pas entièrement les conditions ci-dessus. Une utilisation inappropriée peut entraîner des erreurs de calcul des présences pour votre client.
🚀 Cams propose une intégration sans code ou immédiate
Pour simplifier votre processus de développement, Cams propose des options d'intégration prêtes à l'emploi (sans code) ainsi qu'un accompagnement personnalisé complet.
Si nécessaire, notre équipe peut :
- Développer une logique personnalisée en fonction du flux de travail de votre système.
- Fournir du code d'intégration prêt à installer pour n'importe quel langage serveur (PHP, Node.js, Java, Python, .NET, etc.) et n'importe quelle base de données (MySQL, PostgreSQL, SQL Server, etc.).
Indiquez-nous simplement votre environnement technique, et nous vous aiderons à réaliser une intégration sans accroc.