1С: Синхронизация оргструктуры – настройка интеграции

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

Кратко

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

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

• Лишние подразделения удаляются. Синхронизируемое подразделение, которого нет в 1С, UnSpot удалит вместе с вложенными — в том числе созданные вручную внутри синхронизируемой ветки. Перед первым запуском сохраните копию дерева.
• Пустой список удалит всё. Если скрипт по ошибке не найдёт подразделений, UnSpot удалит все синхронизируемые. Сверяйте число «Выбрано подразделений 1С» кнопкой «Сохранить и проверить».
• Один источник оргструктуры. Если дерево уже ведёт каталог, 1С будет с ним конфликтовать даже без флажка — см. Как можно передать оргструктуру.
• Не чаще раза в час. Чаще UnSpot оргструктуру не обновляет.

Как можно передать оргструктуру

Вариант	Что включить в обработке	Что получится в UnSpot
Пользователи и оргструктура вместе	Режим «Полная» или «Только обновление» и флажок «Оргструктура»	Сотрудники обновляются, а дерево подразделений приводится в соответствие с 1С; каждый сотрудник привязан к своему подразделению
Только оргструктура	Режим «Только обновление оргструктуры» (флажок «Оргструктура» включается сам)	Дерево и привязка существующих сотрудников к подразделениям обновляются, остальные поля сотрудников не меняются. Подходит, если пользователей создаёт другой источник, например каталог
Без дерева	Флажок «Оргструктура» выключен	Дерево из 1С не передаётся. Каждому сотруднику передаётся только название его подразделения, и в UnSpot для каждого названия создаётся отдельное подразделение верхнего уровня — без вложенности и без руководителей

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

Требования

• Установлена и настроена обработка UnSpot SCIM Adapter: подключение SCIM 2.0, адрес и токен, регулярный запуск — по статье 1С: Синхронизация пользователей – настройка интеграции.
• В 1С заполнены справочники «Организации» и «Подразделения организаций». Для передачи руководителей подразделений — данные руководителей подразделений (по комментарию во встроенном скрипте, они есть в редакции КОРП) и ответственные лица организаций.
• У руководителей заполнен email в контактной информации физлица, и такие пользователи есть в UnSpot: руководитель подразделения назначается только по email активного пользователя.
• Роль в UnSpot для проверки результата — доступ к разделу Настройка → Управление персоналом → Оргструктура.

Шаг 1. Откройте настройки обработки

Откройте команду UnSpot SCIM Adapter Settings — форма «Настройки синхронизации сотрудников в UnSpot». Подробно все поля формы описаны в статье 1С: Синхронизация пользователей – настройка интеграции.

Шаг 2. Выберите режим и флажки

1. В списке «Синхронизация пользователей» выберите режим: «Полная» или «Только обновление», если обновляются и сотрудники, либо «Только обновление оргструктуры», если нужна только оргструктура.
2. Включите флажок «Оргструктура» (в режиме «Только обновление оргструктуры» он включён принудительно).
3. Если нужно, чтобы сотрудникам в UnSpot назначался руководитель подразделения, включите флажок «Менеджер». Руководители самих подразделений передаются вместе с деревом и без этого флажка — он управляет только полем «Руководитель» у сотрудников.
4. Нажмите «Сохранить».

Шаг 3. Проверьте, что попадёт в дерево

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

• Каждое подразделение передаётся с полным путём через /, например Департамент продаж/Отдел по работе с партнёрами, а также с руководителем (email) и описанием.
• Расформированные подразделения (дата расформирования уже наступила) в дерево не попадают.
• Если в справочнике «Организации» одна головная организация, её название в пути не входит. Если головных организаций несколько, название головной организации ставится первым элементом пути: ООО Альфа/Департамент продаж/Отдел по работе с партнёрами — так одноимённые отделы разных юрлиц не сливаются.
• Описание подразделения — наименование для записей о трудовой деятельности, описание организации — её полное наименование.
• Подразделения без сотрудников тоже передаются.

Шаг 4. Проверка

1. Нажмите «Сохранить и проверить». В сообщениях появится строка «Выбрано подразделений 1С: N» — сравните число с ожидаемым.
2. Перед первым полным запуском сверьтесь с таблицей ниже: часть подразделений в UnSpot может измениться или быть удалена.
3. Нажмите «Сохранить и запустить» (или дождитесь регламентного задания) и откройте в UnSpot Настройка → Управление персоналом → Оргструктура. Дерево должно совпасть с деревом в 1С.

Что есть в UnSpot	Что произойдёт при синхронизации
Подразделение, созданное вручную, с тем же названием на том же уровне, что и в 1С	Остаётся тем же подразделением, но становится синхронизируемым: его описание и руководитель будут приводиться к данным 1С
Подразделение, созданное синхронизацией, которого больше нет в 1С	Удаляется вместе со всеми вложенными подразделениями
Подразделение, созданное вручную внутри синхронизируемой ветки, которого нет в 1С	Удаляется
Подразделение верхнего уровня, созданное вручную, которого нет в 1С	Не меняется
Сотрудники удаляемых подразделений	Не удаляются: у них очищается привязка к подразделению (если в 1С сотрудник относится к другому подразделению, он будет привязан к нему)

Что учитывать. Не запускайте синхронизацию оргструктуры на рабочем пространстве, где дерево ведётся вручную, не сохранив его копию: ручные подразделения внутри совпавших веток будут удалены. Если скрипт по ошибке вернёт пустой список подразделений, UnSpot удалит все синхронизируемые подразделения.

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

Что произошло в 1С	Что будет в UnSpot после запуска
Создали отдел	Отдел появится в дереве на своём месте с пометкой «синхронизируемое»
Переименовали отдел	Появится подразделение с новым названием, сотрудники перейдут в него, старое удалится. Привязки к старому подразделению в UnSpot (например, доступ к местам) переназначьте на новое
Расформировали отдел (дата расформирования наступила)	Подразделение пропадёт из присланного дерева и удалится — если в нём не осталось действующих дочерних подразделений и сотрудников. Пути дочерних подразделений и обновление сотрудников, которые по 1С числятся в нём, создают его заново. Поэтому до расформирования переведите сотрудников и дочерние подразделения
Назначили нового руководителя	У подразделения сменится руководитель — если новый руководитель активен в UnSpot и его email совпадает с 1С; иначе руководитель будет снят
Перевели сотрудника в другой отдел	Сотрудник окажется в новом подразделении

Ограничения

• Обновление оргструктуры по SCIM принимается не чаще одного раза в час. Час отсчитывается от запроса, который прошёл проверку формата: запрос, отклонённый этой проверкой (пустое поле пути, неверный email руководителя, описание длиннее 255 символов), лимит не расходует, а запрос с ошибкой в самих путях (например, путь из одних «/» или пробелов) — расходует. Не запускайте синхронизацию с флажком «Оргструктура» чаще; достаточно одного запуска в сутки.
• Если подразделений больше 500 (в запросе или уже в UnSpot), обновление выполняется в фоне: UnSpot принимает запрос сразу, а результат появляется позже, и ошибки применения в ответе обработке не приходят.
• Название, положение в дереве и описание синхронизируемого подразделения в UnSpot изменить вручную нельзя — правьте их в 1С. Руководитель подразделения при каждом запуске приводится к значению из 1С.
• Подразделения сопоставляются по названию на каждом уровне без учёта регистра, поэтому переименование подразделения в 1С воспринимается как удаление старого подразделения и создание нового; сотрудники при этом переносятся в новое.

Что дают подразделения в UnSpot

Руководитель подразделения получает права на сотрудников этого подразделения — см. Подчинённость через оргструктуру. Подразделение можно указать владельцем рабочих мест — см. Доступ к местам через оргструктуру. Поэтому после первой синхронизации проверьте, что у нужных подразделений назначены руководители.

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

Сообщение	Причина и что делать
В журнале «оргструктура: N код: 400» и сообщение о том, что подразделения сейчас нельзя обновить (по-английски — «Unable to update organisation units. Please try again later.», по-русски — «Организационные подразделения не могут быть обновлены. Пожалуйста, попробуйте позже»)	Оргструктура уже обновлялась в течение последнего часа. Подождите час и уменьшите частоту регламентного задания
В журнале «оргструктура: N код: 400» с другим ответом	В дереве ошибка формата: пустое название подразделения, email руководителя, не похожий на адрес, или описание длиннее 255 символов. Проверьте эти данные в 1С
«Выбрано подразделений 1С: 0»	Включён флажок «Оргструктура», но скрипт не нашёл подразделений: проверьте справочники и условия отбора в скрипте. Не запускайте полную синхронизацию — UnSpot удалит синхронизируемые подразделения
Руководитель подразделения не назначился	Пользователя с таким email нет в UnSpot или он неактивен. Создайте или активируйте пользователя и повторите запуск через час
Сотрудник не попал в подразделение	В режиме «Только обновление» и «Только обновление оргструктуры» сотрудник должен уже существовать в UnSpot с тем же email; проверьте email и подразделение сотрудника в 1С

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

• 1С: Синхронизация оргструктуры – как устроен обработчик — как UnSpot применяет присланное дерево.
• 1С: Синхронизация пользователей – настройка интеграции — подключение, установка и поля формы.
• 1С: Синхронизация оргструктуры – как устроен скрипт — как скрипт строит дерево.
• 1С: Обзор интеграции — какие бывают интеграции с 1С и с чего начать.
• Подчинённость через оргструктуру — права руководителя подразделения.
• Доступ к местам через оргструктуру — подразделение как владелец мест.