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

Автоматизация состояния отметок биометрической системы: вход и выход

Автоматизация состояния отметок биометрической системы: вход и выход

В биометрической системе учета посещаемости точное определение того, является ли отметка ВХОДОМ или ВЫХОДОМ, имеет решающее значение для корректного учета рабочего времени. Компания Cams Biometrics предлагает гибкие способы определения состояния отметки как на уровне оборудования, так и на уровне административного портала (API).

В этой статье описано, как записываются состояния отметок, какие параметры могут настроить разработчики и какие важные технические ограничения необходимо учитывать для обеспечения надежной работы в системах реального времени.


🛠️ 1. Состояние отметки на уровне оборудования

На большинстве биометрических устройств все отметки по умолчанию записываются как “Вход”.

Если пользователю необходимо записать “Выход” или любое другое пользовательское состояние, он должен вручную выбрать соответствующий режим отметки на устройстве (например, нажав кнопку “Выход” или выбрав пункт на сенсорном экране) перед прикладыванием.

✅ Такая схема хорошо работает в средах, где пользователи обучены выбирать правильный режим отметки на устройстве.

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


🌐 2. Состояние отметки на уровне портала Cams (параметры автоматизации)

Чтобы упростить работу пользователя и автоматизировать классификацию состояний отметок, разработчики, интегрирующие систему с Cams Web API, могут выбрать один из следующих вариантов серверной логики. Эти правила применяются после того, как отметка записана на устройстве.

📌 Вариант 1: Actual

  • Точное состояние отметки (ВХОД/ВЫХОД), выбранное пользователем на устройстве, передается на сервер без изменений.

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

  • Первая отметка дня помечается как ВХОД.
  • Все последующие отметки того же пользователя в пределах одного 24-часового периода помечаются как ВЫХОД.
  • Подходит для систем, в которых пользователи не выбирают тип отметки вручную.

📌 Вариант 3: ZigZag

  • Отметки чередуются между ВХОДОМ и ВЫХОДОМ в течение дня.
  • Первая отметка — ВХОД, вторая — ВЫХОД, третья — ВХОД и так далее.
  • Логика поддерживается для каждого пользователя на основе его активности за последние 24 часа.

ℹ️ Режимы First In Rest Out и ZigZag требуют доступа к истории отметок за последние 24 часа для корректной работы.


⚠️ Ключевые ограничения, которые необходимо учитывать

Хотя эти варианты автоматической логики упрощают интеграцию, необходимо учитывать важные ограничения:

❗ 1. Отсутствие постоянного хранения данных пользователей

Cams Biometrics не хранит данные пользователей и отметок постоянно. Для First In Rest Out и ZigZag мы временно сохраняем историю отметок только за последние 24 часа.

Если устройство находится в автономном режиме более 24 часов, более ранние отметки становятся недоступны для корректной оценки следующей отметки. Это может привести к неверной классификации (например, к тому, что вторая отметка будет расценена как ВХОД вместо ВЫХОДА).

❗ 2. Логика работает только в пределах одного устройства

Эти логики состояний отметок применяются для каждого устройства и каждого пользователя отдельно. Если пользователь отмечается на нескольких устройствах, система не сопоставляет данные между устройствами. Это приведет к сбоям логики в сценариях с использованием нескольких устройств.

❗ 3. Устройства должны подключаться не реже одного раза в 24 часа

Для надежной работы автоматизации состояний отметок устройства должны выходить в сеть и синхронизироваться не реже одного раза в каждые 24 часа. В противном случае серверы Cams не смогут поддерживать необходимую краткосрочную историю отметок.

❗ 4. Не подходит для учета посещаемости по сменам

Автоматизация состояний отметок основана только на данных за последние 24 часа, а классификация выполняется в пределах того же календарного дня, что и отметка.

Если вы работаете с учетом посещаемости по сменам, особенно с ночными или гибкими сменами, настоятельно рекомендуем не полагаться на состояние отметки из API. Вместо этого создайте собственную логику в вашей системе для интерпретации отметок на основе ваших определений смен.

🛠️ Cams в настоящее время не поддерживает автоматизацию состояний отметок на основе времени смен. Такая логика должна быть реализована в вашем программном обеспечении для управления учетом посещаемости.


✅ Рекомендации и лучшие практики

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

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

🛑 Не активируйте эти параметры, если ваша конфигурация не полностью соответствует вышеуказанным условиям, так как неправильное использование может привести к ошибкам в расчете посещаемости для вашего клиента.


🚀 Cams предлагает интеграцию без программирования и с быстрым запуском

Чтобы упростить процесс разработки, Cams предлагает варианты интеграции “подключи и работай” (без программирования), а также полную индивидуальную поддержку.

При необходимости наша команда может:

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

Просто сообщите нам, какой у вас технологический стек, и мы поможем вам бесшовно выполнить интеграцию.

Was this article helpful?