Support Hub/API & Integrations/Автоматизація стану відмітки біометричних пристроїв:…
Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Fix

Автоматизація стану відмітки біометричних пристроїв: Check-In та Check-Out

Автоматизація стану відмітки біометричних пристроїв: Check-In та Check-Out

У системі біометричного обліку відвідуваності точне визначення того, чи є відмітка записом IN (вхід) чи OUT (вихід), має вирішальне значення для правильного обліку відвідуваності. У Cams Biometrics ми пропонуємо гнучкі способи визначення стану відмітки як на рівні обладнання, так і на рівні адміністративного порталу (API).

У цій статті пояснюється, як записуються стани відміток, які параметри можуть налаштувати розробники та які важливі технічні обмеження слід враховувати, щоб забезпечити надійну роботу в системах реального часу.


🛠️ 1. Стан відмітки на рівні обладнання

На більшості біометричних пристроїв усі відмітки за замовчуванням записуються як «Check In».

Якщо користувачеві потрібно записати «Check Out» або будь-який інший користувацький стан, він має вручну вибрати відповідний режим відмітки на пристрої (наприклад, натиснувши кнопку «Check Out» або обравши опцію на сенсорному екрані) перед відміткою.

✅ Цей варіант добре працює в середовищах, де користувачі навчені вибирати правильний режим відмітки на пристрої.

❌ Важливо: автоматичний вибір стану на рівні обладнання неможливий. Біометричні пристрої не містять жодної бізнес-логіки. Розробники мають забезпечити правильну обробку станів відміток підключеним програмним забезпеченням або логікою API.


🌐 2. Стан відмітки на рівні порталу Cams (параметри автоматизації)

Щоб спростити взаємодію з користувачем і автоматизувати класифікацію станів відміток, розробники, які інтегруються з Cams Web API, можуть обрати один із таких варіантів серверної логіки. Ці правила застосовуються після того, як відмітка була записана на пристрої.

📌 Варіант 1: Actual

  • Точний стан відмітки (IN/OUT), обраний користувачем на пристрої, передається на сервер.

📌 Варіант 2: First In Rest Out

  • Перша відмітка дня позначається як IN.
  • Усі наступні відмітки того самого користувача протягом 24-годинного періоду позначаються як OUT.
  • Ідеально підходить для систем, де користувачі не обирають тип відмітки вручну.

📌 Варіант 3: ZigZag

  • Відмітки чергуються між IN і OUT протягом дня.
  • Перша відмітка має стан IN, друга — OUT, третя — IN і так далі.
  • Логіка підтримується для кожного користувача на основі його активності за останні 24 години.

ℹ️ Режими First In Rest Out і ZigZag потребують доступу до історії відміток за останні 24 години для коректної роботи.


⚠️ Ключові обмеження, які варто знати

Хоча ці варіанти автоматичної логіки спрощують інтеграцію, існують важливі обмеження, які слід розуміти:

❗ 1. Відсутнє постійне зберігання даних користувачів

Cams Biometrics не зберігає дані користувачів і відміток постійно. Для First In Rest Out і ZigZag ми тимчасово зберігаємо історію відміток лише за останні 24 години.

Якщо пристрій офлайн більше ніж 24 години, попередні відмітки більше недоступні для коректної оцінки наступної відмітки. Це може призвести до неправильної класифікації (наприклад, другу відмітку буде розглянуто як IN замість OUT).

❗ 2. Логіка працює лише в межах одного пристрою

Ці логіки станів відміток застосовуються для кожного пристрою окремо та для кожного користувача окремо. Якщо користувач відмічається на кількох пристроях, система не виконує перехресну перевірку між пристроями. Це призведе до збоїв логіки у сценаріях з використанням кількох пристроїв.

❗ 3. Пристрої мають підключатися щонайменше раз на 24 години

Щоб автоматизація стану відміток працювала надійно, пристрої мають виходити в мережу та синхронізуватися щонайменше один раз на кожні 24 години. Інакше сервери Cams не зможуть зберігати необхідну короткострокову історію відміток.

❗ 4. Не підходить для обліку за змінами

Автоматизація стану відміток базується лише на даних за останні 24 години, а класифікація виконується в межах того самого календарного дня, що й відмітка.

Якщо ви працюєте з обліком за змінами, особливо з нічними або гнучкими змінами, ми наполегливо рекомендуємо не покладатися на стан відмітки з API. Натомість створіть власну логіку у вашій системі для інтерпретації відміток на основі ваших визначень змін.

🛠️ Наразі Cams не підтримує автоматизацію станів відміток на основі графіків змін. Цю логіку необхідно реалізувати у вашому програмному забезпеченні для обліку відвідуваності.


✅ Найкращі практики та рекомендації

Перш ніж увімкнути автоматичну логіку станів відміток (First In Rest Out або ZigZag), переконайтеся, що:

  • Користувачі послідовно відмічаються на одному закріпленому пристрої.
  • Кожен пристрій підключається до сервера щонайменше раз на кожні 24 години.
  • Ви розумієте поведінку та обмеження цих режимів логіки, щоб уникнути неправильної інтерпретації відміток.

🛑 Не активуйте ці параметри, якщо ваша конфігурація повністю не відповідає наведеним вище умовам, — неправильне використання може призвести до помилок у розрахунку відвідуваності для вашого клієнта.


🚀 Cams пропонує інтеграцію без коду або миттєву інтеграцію

Щоб спростити процес розробки, Cams пропонує варіанти інтеграції «plug-and-play» (без коду), а також повну індивідуальну підтримку.

За потреби наша команда може:

  • Розробити індивідуальну логіку на основі робочого процесу вашої системи.
  • Надати готовий до встановлення код інтеграції для будь-якої серверної мови (PHP, Node.js, Java, Python, .NET тощо) та будь-якої бази даних (MySQL, PostgreSQL, SQL Server тощо).

Просто повідомте нам ваш технологічний стек, і ми допоможемо вам бездоганно інтегрувати систему.

Was this article helpful?