Начните отсюда, если что-то не работает. Найдите свой симптом, прочитайте, что он означает, и выполните исправление. Большинство проблем связано с сетью, неверным Comm Key, неправильным часовым поясом или несопоставленным кодом, а не с терминалом.
#Быстрые проверки (сделайте их в первую очередь)
- ПК с коннектором включён и показывает В сети на вкладке Коннекторы?
- Говорит ли карточка устройства, что не так? (Она сообщает, например: «Коннектор ... не в сети», «Требуется настройка» или «Коннектор не назначен».)
- Нажмите Проверить подключение на устройстве. Сверьте ответ с таблицей статусов.
- Откройте Активность на устройстве: приходят ли отметки и что с ними происходит?
#Устройство недоступно
«Устройство недоступно» или «не ответило вовремя».
| Проверьте | Как это сделать |
|---|---|
| Питание и кабель | Терминал включён, горит ли индикатор сети? |
| Адрес и порт | Сверьте с меню устройства (ZKTeco: Menu → Comm. → Ethernet; порт 4370). Адрес мог измениться, если устройство использует DHCP: задайте ему фиксированный адрес. |
| Та же сеть | ПК с коннектором и терминал должны находиться в одном сегменте сети или быть маршрутизированы друг к другу. Гостевой Wi-Fi или другая VLAN это блокируют. |
| Брандмауэр | Разрешите порт устройства с ПК: 4370 TCP/UDP для ZKTeco, 5010 TCP для Anviz, веб-порт (80) для Hikvision. |
| Одно подключение за раз | Некоторые терминалы допускают подключение только одного ПК. Закройте другие программы учёта посещаемости, подключённые к тому же устройству. |
| Ping с ПК | В командной строке: ping <device address>. Если не проходит, проблема в сети, а не в SolaHR. |
#Коннектор
| Симптом | Решение |
|---|---|
| Коннектор Не в сети | Включите ПК; проверьте службу командой sc query SolaHRDeviceConnect (должно быть RUNNING); проверьте доступ в интернет. Ожидающие отметки отправятся, когда он вернётся. |
| «Коннектор не принял запрос» | То же: ПК выключен, находится в спящем режиме или не в сети. Отключите спящий режим на этом ПК. |
| «Коннектор нужно привязать заново» / «Коннектор был отозван» | Создайте новый код привязки и привяжите снова (Установка). |
| «Срок действия кода истёк — создайте новый» | Код привязки действует 15 минут и срабатывает один раз. |
| Windows предупреждает об установщике | Это ожидаемо: предварительная версия не имеет цифровой подписи. Проверьте значение SHA-256, затем Подробнее → Выполнить в любом случае. |
127.0.0.1:8790 не открывается |
Возможно, этот порт занят другой программой. Служба работает и без страницы. |
#Аутентификация и ключи
| Симптом | Решение |
|---|---|
| Доступно · Comm Key отклонён | Введите Comm Key с устройства (Menu → Comm. → PC Connection). Отсутствие ключа означает 0. Ключи содержат от 1 до 6 цифр. На прошивке ZKTeco Ver 6.60 устройство запрашивает вход даже при ключе 0; коннектор версии 0.1.5 и новее это учитывает, поэтому, если вы всё ещё это видите, обновите коннектор. |
| Доступно · устройство занято | Подождите минуту и проверьте снова. |
| Hikvision: вход отклонён | Используйте отдельного пользователя устройства, созданного для SolaHR (не admin), и проверьте, что устройство активировано. |
| Suprema: вход отклонён | Используйте оператора BioStar 2 только для чтения и точный адрес сервера (с https://). |
| «Несовпадение серийного номера» | Устройство по этому адресу не то, что зарегистрировано. Проверьте IP. |
#Требуется настройка
Требуется настройка — это статус, а не неисправность терминала. Типу подключения нужно программное обеспечение производителя на ПК с коннектором, и оно не готово. Выполните настройку SDK производителя или нажмите Использовать встроенное подключение. Для большинства терминалов ZKTeco ZKTeco (напрямую) не требует дополнительного ПО.
#Отметки приходят, но посещаемость не появляется
| Причина | Решение |
|---|---|
| Код не сопоставлен | Пользователи устройства → свяжите код. Ожидающие отметки записываются, как только вы его свяжете. См. Сопоставление и посещаемость. |
| Нет настроек расчёта зарплаты на эту дату | Добавьте их, затем выберите Обработать ожидающие. |
| До даты Импортировать историю с или до даты начала работы сотрудника | Измените дату на устройстве или исправьте дату начала работы. |
| День уже внесён HR или порталом | Отметка с устройства его не перезаписывает. См. Отклонённые отметки на вкладке Проверка. |
| Сотрудник отстранён без сохранения оплаты | Посещаемость не создаётся. |
| Уход без прихода | Добавьте пропущенную регистрацию в Attendance. |
#Неверное время
| Симптом | Решение |
|---|---|
| Расхождение на целые часы | Измените устройство и задайте правильный часовой пояс часов устройства (например, Asia/Amman, Asia/Dubai). |
| Расхождение на минуты | Синхронизировать время сейчас (владелец). Также проверьте собственные часы устройства и настройки перехода на летнее время. |
| Ночная смена выглядит разделённой | Проверьте настройку ночной смены в графике работы в разделе Рабочие графики. |
#Имена и текст
| Симптом | Решение |
|---|---|
Арабские имена отображаются как ??? или странные символы |
В записи устройства задайте кодировку текста: сначала UTF-8, затем Windows-1256 (арабская), затем GBK. Снова прочитайте пользователей. |
| Имена обрезаются | Многие терминалы допускают только короткое имя (часто 24 символа или меньше). |
#Изменения не работают
| Симптом | Решение |
|---|---|
| «Изменения этого устройства отключены на ПК с коннектором» | Включите Разрешить изменения устройств на странице коннектора. |
| Изменение, включение, удаление или передача недоступны / «здесь не поддерживается» | Тип подключения или модель этого не поддерживает. ZKTeco напрямую не умеет включать/отключать пользователей и копировать лица; тип ZKTeco SDK умеет (протестировано программно). |
| Нет копирования, перезапуска или синхронизации времени | Только владелец. |
| «На устройстве нет места для этого» | Терминал заполнен пользователями, лицами или отпечатками. Удалите ненужных пользователей. |
| «Устройство отклонило изменение» | Проверьте Comm Key и то, что устройство разрешает удалённые изменения. |
#Устройства с отправкой
| Симптом | Решение |
|---|---|
| «Последний контакт» давний или пуст | Проверьте настройку сервера на терминале (ZKTeco: Menu → Comm. → Cloud Server Setting): адрес, порт и наличие у терминала доступа к сети. |
| Отметки отклонены | Серийный номер устройства должен совпадать с зарегистрированным в SolaHR. См. Карантин. |
| Обычный HTTP отклонён | Многие устройства с отправкой работают только по HTTP. Попросите администратора прочитать панель Готовность установки; она проверяет правила веб-сервера. |
#Часто задаваемые вопросы
Хранит ли SolaHR отпечатки пальцев или лица? Нет. Никогда. Он знает только, есть ли у человека лицо или отпечаток на устройстве. См. что хранится.
Нужно ли открывать порт на роутере? Нет. Коннектор только устанавливает исходящие подключения к SolaHR. Только устройствам с отправкой нужно, чтобы SolaHR был им доступен, и он доступен.
Работает ли это без интернета? Коннектор продолжает работать внутри офиса, но не может связаться с SolaHR; отметки ждут и отправляются позже.
Можно ли использовать больше одного коннектора? Да, обычно по одному на площадку. Каждое устройство назначается одному коннектору.
Поддерживается ли мой терминал? См. Поддерживаемые устройства. По-настоящему подключали пока только ZKTeco iFace702; остальные модели ожидаемо работают или не проверялись. Сначала проверьте один.
Можно ли сочетать коннектор и импорт файла? Да. Повторные отметки распознаются и не учитываются дважды.
Как часто считываются отметки? Как вы выберете: каждые 1, 2, 5, 10, 15 или 30 минут. См. Сопоставление и посещаемость.
Безопасно ли запускать коннектор? Он слушает только на самом ПК и хранит секреты в зашифрованном виде, но это неподписанная предварительная версия, и её служба Windows проверена не на всех конфигурациях Windows. Относитесь к этому ПК как к серверу.
Где получить помощь? Выполните solahr-dc diagnostics на ПК с коннектором, чтобы создать пакет для поддержки без секретов, и отправьте его вместе с названием устройства и статусом, который вы видите.