1С: Синхронизация пользователей – настройка интеграции

«UnSpot SCIM Adapter» — внешняя обработка 1С, которая передаёт в UnSpot сотрудников, их руководителей и режим работы по стандарту SCIM 2.0. В статье — что подготовить, как создать подключение в UnSpot, как установить обработку в 1С, что означает каждое поле формы настроек, как настроить регулярный запуск и что делать при ошибках. Как устроен обмен и какие данные уходят в UnSpot — в статье 1С: Синхронизация пользователей – как устроен обработчик. Передача дерева подразделений вынесена в отдельную статью — 1С: Синхронизация оргструктуры – настройка интеграции.

Кратко

• Обработка UnSpot SCIM Adapter устанавливается в 1С, по расписанию читает сотрудников из базы и создаёт или обновляет по ним пользователей UnSpot.
• Понадобятся: файл обработки, подключение SCIM 2.0 в UnSpot (адрес и токен), права администратора в 1С и заполненные email у сотрудников.
• Главная настройка — режим: «Полная» (учётные записи ведёт 1С), «Только обновление» (1С дополняет карточки, созданные другим источником) или «Только обновление оргструктуры».
• Перед регулярным запуском нажмите «Сохранить и проверить»: проверка считает сотрудников и обращается к UnSpot, ничего в нём не меняя.
• Незнакомое слово — загляните в раздел Термины статьи-обзора.

Важно до включения

• «Полная» архивирует пользователей. Архивируется каждый пользователь UnSpot с заполненным externalId, которого нет в выборке 1С: созданные 1С, найденные ею по email (им обработка записывает externalId) и созданные другим SCIM-источником, например Entra ID (пользователей каталожной синхронизации UnSpot не архивирует, а деактивирует). Брони архивированных отменяются, закреплённые места освобождаются. Перед первым запуском сверьте число «Выбрано пользователей 1С» с ожидаемым.
• Подразделение сотрудника передаётся всегда. С флажком «Оргструктура» — путём в дереве, без флажка — названием, по которому UnSpot находит или создаёт отдельное подразделение верхнего уровня. Если подразделения ведёт другой источник, читайте раздел Оргструктура.
• Токен лежит в базе 1С в открытом виде, а скрипт выполняется без безопасного режима. Доступ к форме настроек оставьте только администраторам. Подробности — в статье 1С: Синхронизация пользователей – как устроен обработчик.
• С флажком «Оргструктура» — не чаще раза в час: чаще UnSpot оргструктуру не обновляет.

Требования

Что нужно	Подробности
Платформа 1С	1С:Предприятие 8.3. Работа проверена на версии 8.3.27
Конфигурация	Конфигурация с Библиотекой стандартных подсистем (БСП). Встроенный выбор данных реализован для «Зарплата и управление персоналом» 3.1 (ПРОФ и КОРП); для остальных конфигураций выберите «Нестандартная конфигурация» и напишите собственный скрипт — см. 1С: Собственный скрипт – настройка интеграции
Файл обработки	1s-to-scim-adapter-bsp.epf — его предоставляет команда UnSpot
Права в 1С	Права администратора: обработка подключается механизмом «Дополнительные отчеты и обработки» и регистрируется без безопасного режима, так как исполняет скрипт выбора данных. Какие данные обработка читает — в статье 1С: Синхронизация пользователей – как устроен обработчик
Подключение SCIM 2.0	URL и токен из UnSpot — см. шаг 1
Роль в UnSpot	Создать подключение SCIM 2.0 может «Владелец» или «Администратор интеграций»
Email у сотрудников	Синхронизируются только сотрудники, у которых в 1С заполнен адрес электронной почты: по нему обработка находит пользователя UnSpot (в режиме «Полная» — если не нашла по идентификатору физлица externalId)
Сетевой доступ	Исходящее соединение по HTTPS (TCP 443) с сервера 1С:Предприятия к домену вашего рабочего пространства UnSpot. Входящие правила не нужны — UnSpot к 1С не обращается

Шаг 1. Подключение SCIM 2.0 в UnSpot

Токен и адрес для обработки создаются в UnSpot. Понадобится роль Владельца или Администратора интеграций.

Откройте Настройка → Интеграции → Синхронизации и на карточке SCIM 2.0 нажмите «Подключить». UnSpot покажет два значения:

• URL вида https://ваш-домен.unspot.ru/api/scim — это значение поля «UnSpot API URL» в обработке;
• секретный токен (строка из 64 символов) — значение поля «Токен доступа».

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

В настройках подключения SCIM также доступны:

• срок работы токена — «Без ограничения» или ограниченный срок. По истечении срока запуск будет останавливаться с ошибкой «Users HTTP Code = 400»;
• тумблер «Отправлять приветственные письма» — если он включён, каждый сотрудник, созданный синхронизацией, получит письмо с приглашением и паролем. По умолчанию тумблер выключен, и пользователей можно пригласить позже вручную.

Шаг 2. Установка обработки в 1С

Обработка подключается стандартным механизмом БСП «Дополнительные отчеты и обработки».

1. Запустите 1С:Предприятие (не Конфигуратор).
2. Откройте Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Если ссылка недоступна, включите одноимённый флажок на этой же странице.

1. Нажмите «Добавить из файла…» и выберите файл 1s-to-scim-adapter-bsp.epf.

После подключения в списке появится обработка UnSpot SCIM Adapter с двумя командами: UnSpot SCIM Adapter Settings — форма настроек синхронизации; UnSpot SCIM Adapter Sync — серверная команда запуска синхронизации, на которую назначается регламентное задание.

Шаг 3. Настройки обработки

Откройте команду UnSpot SCIM Adapter Settings — появится форма «Настройки синхронизации сотрудников в UnSpot». Настройки сохраняются внутри информационной базы, поэтому вводятся один раз.

UnSpot API URL

Адрес SCIM API вашей компании — значение URL с карточки SCIM 2.0 в UnSpot, например https://ваш-домен.unspot.ru/api/scim. К этому адресу обработка добавляет пути ресурсов. Если адрес указан без протокола, при проверке появится ошибка «Неверный формат URL».

Что учитывать. Указывайте адрес только с https://, как на карточке: адрес с незащищённой схемой (без буквы «s») обработка тоже примет, но токен и персональные данные уйдут без шифрования. Нестандартный порт в адресе указать нельзя — порт определяется только протоколом.

Токен доступа

Секретный токен с карточки SCIM 2.0. Обработка передаёт его в каждом запросе. Если токен неверный или истёк, запуск останавливается в самом начале с ошибкой «Users HTTP Code = 401» или «Users HTTP Code = 400»; в этом случае пересоздайте подключение SCIM 2.0 в UnSpot и обновите токен в настройках обработки.

Поле обычное текстовое, значение видно на экране целиком — вводите токен так, чтобы монитор не просматривался со стороны. Где токен хранится после сохранения и кто может его прочитать, описано в статье 1С: Синхронизация пользователей – как устроен обработчик.

Конфигурация 1С

Определяет, какой скрипт выбора данных использовать. Два значения:

• «ЗУП 3.1 (ПРОФ/КОРП)» — используется встроенный скрипт для типовой конфигурации «Зарплата и управление персоналом». Поле «Код выбора данных для синхронизации» показывает его текст только для чтения; при установке новой версии .epf встроенный скрипт обновляется вместе с обработкой;
• «Нестандартная конфигурация» — поле «Код выбора данных для синхронизации» становится редактируемым, и ваш скрипт выполняется вместо встроенного. За основу можно взять встроенный скрипт и заменить в нём справочники и регистры на аналоги вашей конфигурации.

Как устроен встроенный скрипт — в статье 1С: Синхронизация пользователей – как устроен скрипт, как написать свой — в статье 1С: Собственный скрипт – настройка интеграции.

Синхронизация пользователей (режим)

Главная настройка: она определяет, что обработка вправе делать с учётными записями в UnSpot. Режимов три.

«Полная» — 1С главный источник учётных записей.

• Что делает. Создаёт новых сотрудников, обновляет изменившихся, архивирует пропавших из выборки 1С (например, уволенных). Пользователя ищет сначала по идентификатору физлица externalId, затем по email; найденному по email записывает externalId.
• Когда выбирать. 1С — единственный или основной источник данных о сотрудниках.
• Чем рискуете. Архивируется каждый пользователь UnSpot с заполненным externalId, которого нет в выборке 1С, — в том числе созданный вручную или каталогом, если 1С однажды нашла его по email, и созданный другим SCIM-источником. Пользователей каталожной синхронизации UnSpot при этом не архивирует, а деактивирует.
• Активация. Деактивированного пользователя обработка активирует, когда обновляет его карточку, то есть если в 1С у него что-то изменилось. Администраторов это не касается.

«Только обновление» — 1С дополняет карточки, которые создаёт другой источник.

• Что делает. Обновляет уже существующих в UnSpot пользователей, найденных по email: ФИО, должность, табельный номер, подразделение, руководителя, режим работы. Никого не создаёт, не архивирует и не активирует; externalId не записывает.
• Когда выбирать. Учётные записи создаёт Active Directory, Entra ID, Google Workspace или администратор вручную, а 1С добавляет кадровые данные. Рекомендуемый режим при совместной работе с каталогом.
• Что учесть. Подразделение сотрудника обработка передаёт и в этом режиме — см. раздел Оргструктура.

«Только обновление оргструктуры» — из 1С нужна только оргструктура.

• Что делает. Передаёт дерево подразделений и обновляет привязку существующих пользователей к подразделениям. Имя, должность и табельный номер не передаются; руководитель — если включён флажок «Менеджер». Флажок «Оргструктура» в этом режиме включается принудительно, а «Режим работы» отключается.
• Когда выбирать. Остальные данные ведёт другой источник. Подробнее — в статье 1С: Синхронизация оргструктуры – настройка интеграции.

Оргструктура

Флажок «Оргструктура» (подсказка в форме: «список подразделений и подразделения пользователей») управляет передачей дерева подразделений. Когда он включён, каждому сотруднику передаётся полный путь его подразделения, а после обновления пользователей обработка отправляет в UnSpot всё дерево. Когда выключен, дерево не передаётся, но название подразделения сотрудника всё равно уходит: UnSpot находит по нему подразделение верхнего уровня с таким названием или создаёт его (без вложенности и руководителя) и привязывает к нему сотрудника. Поэтому выключенный флажок не защищает дерево, которое ведёт другой источник, например каталог. Чтобы 1С вообще не меняла подразделения сотрудников, нужен собственный скрипт, который не добавляет в структуру сотрудника ключи orgUnit и department (пустое значение тоже не годится: оно очищает подразделение), — см. 1С: Собственный скрипт – настройка интеграции. Как это настроить и проверить — в статье 1С: Синхронизация оргструктуры – настройка интеграции.

Менеджер

Флажок «Менеджер» включает передачу руководителя каждого сотрудника. Для типовой ЗУП руководитель определяется автоматически: это руководитель подразделения сотрудника. Если сотрудник сам руководит подразделением или у подразделения нет руководителя с email, поле передаётся пустым, и ранее назначенный руководитель в UnSpot очищается. Если руководителя ещё нет среди пользователей UnSpot, он назначается после его создания в этом же запуске; если так и не появился, прежний руководитель не меняется. В UnSpot указанный руководитель получает права на бронирования и расписание подчинённых и видит их в отчётах; подробнее — в статье Прямой руководитель в карточке сотрудника.

Особенности:

• сотрудник не может быть руководителем самого себя — в этом случае руководитель не передаётся, а прежнее назначение в UnSpot снимается;
• если у подразделения в 1С нет руководителя или его email не заполнен, у сотрудников этого подразделения руководитель в UnSpot очищается;
• руководителем в UnSpot может быть назначен только активный пользователь. Если руководитель появляется в UnSpot в этом же запуске, обработка назначит его подчинённым отложенно — после создания всех пользователей;
• руководителей подразделений встроенный скрипт берёт из данных, которые есть в редакции КОРП (так сказано в комментарии скрипта): в других редакциях руководитель сотрудника может остаться пустым.

Режим работы

Флажок «Режим работы» включает расчёт и передачу показателя attendance — доли офисных дней сотрудника от 0 (полностью удалённая работа) до 100 (полностью офисная). Для типовой ЗУП показатель считается по графику работы сотрудника за текущий календарный месяц: учитываются дни с видом времени «Явка» (код Я) как офисные и «Дистанционная работа» (код Д) как удалённые, а также признак дистанционной работы из кадровых документов. Подробный алгоритм — в разделе «Поле attendance: доля офисных дней» статьи 1С: Синхронизация пользователей – как устроен скрипт.

Пример. В июле у сотрудника 20 дней с кодами Я и Д, из них 15 — Я. Показатель равен 15 × 100 / 20 = 75, и в UnSpot сотрудник получит гибридный режим работы. Дни отпуска, больничного и командировок в расчёте не участвуют. Если данных о графике за месяц нет, существующему пользователю передаётся пустое значение: его режим в UnSpot становится «Свободный», а ранее заданное значение сбрасывается.

В UnSpot значение хранится как процент посещения офиса, а название режима вычисляется из него: 0 — «Удаленный», от 1 до 99 — «Гибридный», 100 — «Офисный», значение не задано — «Свободный». Подробнее — в статье Режим посещения офиса и норма посещения. Флажок недоступен в режиме «Только обновление оргструктуры».

Код выбора данных для синхронизации

Многострочное поле со скриптом выбора данных. При выборе «ЗУП 3.1 (ПРОФ/КОРП)» оно доступно только для чтения и показывает встроенный скрипт с комментариями. При выборе «Нестандартная конфигурация» оно редактируется; если своего кода ещё нет, поле заполняется шаблоном-инструкцией. Шаблон скриптом не считается и не сохраняется: сохраняется только текст, который вы ввели или вставили. Если сохранить настройки, не изменив шаблон, запуск остановится с ошибкой о неопределённой переменной СотрудникиДляUnspot. Ваш код сохраняется вместе с остальными настройками в информационной базе.

Кнопки формы

• Сохранить — проверяет заполненность обязательных полей (URL, токен, выбор данных, режим синхронизации, а для «Нестандартной конфигурации» — что поле кода не пустое) и сохраняет настройки. Нетронутая заготовка из комментариев эту проверку проходит, но как скрипт не сохраняется — см. «Код выбора данных для синхронизации».
• Сохранить и проверить — дополнительно выполняет пробную выборку и пробное обращение к UnSpot без изменения данных. При успехе выводятся сообщения: «Настройки сохранены», «Проверка настроек..», «Выбрано пользователей 1С: N», при включённой оргструктуре — «Выбрано подразделений 1С: N», затем «Проверен выбор пользователей UnSpot» и «Проверка завершена».
• Сохранить и запустить — сохраняет настройки и сразу выполняет синхронизацию в выбранном режиме. Ход выполнения записывается в журнал регистрации.

Шаг 4. Проверка и регулярный запуск

Заполните настройки и нажмите «Сохранить и проверить». Если число выбранных пользователей отличается от ожидаемого (например, ноль), проверьте, заполнены ли email сотрудников.

Для регулярной синхронизации назначьте регламентное задание. Откройте Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки, дважды щёлкните по обработке UnSpot SCIM Adapter и в строке команды UnSpot SCIM Adapter Sync отметьте флажок в колонке с часами — откроется окно «Расписание», где задаётся периодичность запуска. Здесь же синхронизацию можно запустить вручную: выделите команду и нажмите «Выполнить».

Что учитывать. Рекомендуемая частота — не чаще одного раза в час, достаточно одного раза в сутки. Обновление оргструктуры на стороне UnSpot ограничено примерно одним запросом в час: при более частых запусках UnSpot отклонит обновление оргструктуры — в ответе будет сообщение о том, что подразделения сейчас нельзя обновить (по-английски — «Unable to update organisation units. Please try again later.», по-русски — «Организационные подразделения не могут быть обновлены. Пожалуйста, попробуйте позже»). Запуск при этом не прерывается: пользователи обновятся, а ответ сервера попадёт в журнал регистрации. Кроме того, синхронизация выполняется в том сеансе, из которого запущена, и не защищена от параллельного запуска, поэтому не запускайте её вручную, пока идёт запуск по расписанию.

Все шаги синхронизации записываются в журнал регистрации: Администрирование → Обслуживание → Журнал регистрации, события с именем вида UnSpot#ггммдд. По каждому пользователю фиксируются отправленные данные и код ответа сервера — это основной инструмент диагностики. Дата в имени события — день первого сохранения настроек, а не день запуска. Что именно попадает в журнал — в статье 1С: Синхронизация пользователей – как устроен обработчик.

Что изменится в UnSpot: примеры

Как обычные кадровые события в 1С отражаются в UnSpot после ближайшего запуска.

Что произошло в 1С	Режим «Полная»	Режим «Только обновление»
Приняли сотрудника с email	Появится пользователь с ролью «Сотрудник». Письмо-приглашение уйдёт, только если в подключении SCIM 2.0 включён тумблер «Отправлять приветственные письма»	Ничего: пользователя должен создать другой источник, после этого 1С дополнит его карточку
Сменили должность или подразделение	Карточка обновится	Карточка обновится
Сменили email	Пользователь найдётся по externalId, и email в UnSpot сменится	Пользователь с новым email не найдётся, карточка обновляться перестанет, пока email не сменят и в UnSpot
Уволили сотрудника	Пользователь архивируется: брони отменяются, закреплённые места освобождаются	Ничего: уберите пользователя в источнике учётных записей
Сотрудник вернулся	Учётная запись восстановится по тому же email	Ничего, пока пользователя не восстановит его источник

Какой режим выбрать

Ситуация	Режим и флажки
1С — единственный источник сотрудников	«Полная»; «Менеджер» и «Режим работы» — по необходимости
Учётные записи создаёт каталог (AD, Entra ID, Google Workspace), 1С дополняет карточки	«Только обновление»; флажки по необходимости. Оргструктуру ведите только в одном источнике — см. раздел Оргструктура
Нужна только оргструктура из 1С	«Только обновление оргструктуры» — см. 1С: Синхронизация оргструктуры – настройка интеграции
Нужны только рабочие статусы (отпуск, больничный) в расписании	Эта обработка не нужна — см. 1С: Синхронизация статусов расписания – настройка интеграции

Возможные ошибки

В первом столбце — то, что видно в 1С: сообщение на экране или запись в журнале регистрации.

Что видно в 1С	Причина и что делать
«Users HTTP Code = 401»	Токен не подходит: опечатка или токен другого подключения. Проверьте поле «Токен доступа» и актуальность подключения SCIM 2.0 в UnSpot
«Users HTTP Code = 400»	Чаще всего истёк срок работы токена. Пересоздайте подключение SCIM 2.0 и обновите токен в обработке
В журнале «/создание пользователя: … код: 409»	Email или externalId уже занят другим пользователем. Обычно это дубль сотрудника или пересечение с другим источником синхронизации
В журнале «/обновление пользователя: … код: 404»	Пользователь удалён в UnSpot между чтением и записью. При следующем запуске состояние выровняется
В журнале «оргструктура: N код: 400»	Если в ответе сообщение о том, что подразделения сейчас нельзя обновить (по-английски — «Unable to update organisation units. Please try again later.», по-русски — «Организационные подразделения не могут быть обновлены. Пожалуйста, попробуйте позже»), оргструктура уже обновлялась в течение часа — уменьшите частоту запуска. Иначе в дереве ошибка: пустое название подразделения, неверный email руководителя, слишком длинное описание — исправьте данные в 1С
«Неверный формат URL: …»	Адрес в поле «UnSpot API URL» указан без протокола или протокол написан заглавными буквами. Введите адрес целиком, начиная с https://, как на карточке SCIM 2.0
«Выбрано пользователей 1С: 0»	У сотрудников не заполнены email либо скрипт выбора данных не подходит вашей конфигурации
«Настройки не установлены»	Синхронизация запущена до первого сохранения настроек. Откройте форму настроек и сохраните их

Связанные статьи

• 1С: Синхронизация пользователей – как устроен обработчик — направление и протокол обмена, передаваемые данные, создание, обновление и удаление, хранение токена, журнал и права.
• 1С: Синхронизация пользователей – как устроен скрипт — разбор встроенного скрипта по блокам.
• 1С: Синхронизация оргструктуры – настройка интеграции — как передавать дерево подразделений.
• 1С: Собственный скрипт – настройка интеграции — как написать скрипт для нестандартной конфигурации.
• 1С: Обзор интеграции — какие бывают интеграции с 1С и с чего начать.
• External API: Синхронизация пользователей по стандарту SCIM — описание SCIM-эндпоинтов и атрибутов.
• Прямой руководитель в карточке сотрудника — какие права даёт поле «Руководитель».
• Режим посещения офиса и норма посещения — что означает режим работы в UnSpot.