1С: Обзор интеграции
UnSpot получает данные из 1С напрямую: специальные внешние обработки сами читают информационную базу и отправляют в UnSpot сотрудников, структуру компании и рабочие статусы. Публиковать базу в интернет не нужно, работать с UnSpot из 1С вручную тоже. В статье — что именно можно передавать, какие обработки для этого есть, с чего начать и какую статью открыть под свою задачу.
Что можно передавать из 1С
Передача устроена по трём направлениям. Первые два выполняет одна обработка, третье — другая.
| Что передаётся | Какая обработка | Что происходит в UnSpot | Статьи |
|---|---|---|---|
| Пользователи | UnSpot SCIM Adapter | Создаются, обновляются и архивируются пользователи (создание и архивация — в режиме «Полная»). Дополнительно можно передавать прямого руководителя и режим работы (офис или удалённо) — это поля пользователя | Настройка · Как устроен обработчик · Как устроен скрипт |
| Оргструктура | UnSpot SCIM Adapter | Дерево подразделений и их руководители. Связывает пользователей с подразделениями и используется в доступах и подчинённости | Настройка · Как устроен обработчик · Как устроен скрипт |
| Статусы в расписании | UnSpot Schedule Status Adapter | Больничные, отпуска, командировки, отсутствия и удалённая работа попадают в расписание сотрудников и освобождают их места на эти дни | Настройка · Как устроен обработчик · Как устроен скрипт |
У каждого направления две основные статьи. «Настройка» — пошаговая инструкция для администратора: что подготовить, где взять токен, как установить обработку, что значит каждое поле формы и как проверить результат. «Как устроен обработчик» — описание для администратора 1С и службы информационной безопасности: кто кого вызывает, какие данные и по какому протоколу уходят, что хранится в 1С, что попадает в журнал. «Как устроен скрипт» — разбор скрипта выбора данных по блокам: что он берёт из базы 1С и откуда берётся каждое поле.
Две обработки
| Обработка | Для чего | Токен в UnSpot | Как работает |
|---|---|---|---|
| UnSpot SCIM Adapter | Пользователи, руководители, режим работы и оргструктура | Токен подключения SCIM 2.0: Настройка → Интеграции → Синхронизации, карточка «SCIM 2.0» | Вызывает SCIM API UnSpot: читает пользователей, сопоставляет их с данными 1С и создаёт, обновляет и удаляет |
| UnSpot Schedule Status Adapter | Статусы сотрудников в расписании | Токен External API: Настройка → Интеграции → Настройки API, карточка «Импорт расписания сотрудника» | Отправляет статусы по одному запросу на сотрудника и дату в External API UnSpot |
В заголовках статей обработку называют обработчиком — это одно и то же. У обеих обработок одинаковое устройство: готовый движок и скрипт выбора данных. Движок отправляет данные и ведёт журнал, скрипт собирает данные из базы 1С. Для конфигурации «ЗУП 3.1» (ПРОФ и КОРП) скрипт встроен, для другой конфигурации его можно написать самостоятельно. Подробнее — в статьях 1С: Синхронизация пользователей – как устроен скрипт, 1С: Синхронизация оргструктуры – как устроен скрипт, 1С: Синхронизация статусов расписания – как устроен скрипт и 1С: Собственный скрипт – настройка интеграции.
Что учитывать. Токены у обработок разные и не взаимозаменяемы: токен SCIM 2.0 не подойдёт для статусов, а токен External API — для пользователей.
Что общего у обеих обработок
- Инициатор всегда 1С. Обработка сама открывает исходящее соединение по HTTPS (порт 443, адрес из карточки UnSpot начинается с
https://); UnSpot к информационной базе не обращается, входящие правила на межсетевом экране не нужны. - Обработка устанавливается через раздел «Дополнительные отчеты и обработки» в 1С и запускается по расписанию или вручную.
- Настройки и токен хранятся внутри информационной базы 1С — в справочнике «Файлы».
- Каждый запуск пишет подробный журнал в журнал регистрации 1С.
- Данные из UnSpot в 1С не загружаются: обмен односторонний.
С чего начать
- Синхронизация пользователей. Пока в UnSpot нет пользователей, нечего связывать с оргструктурой и нечего отмечать в расписании. Начните со статьи 1С: Синхронизация пользователей – настройка интеграции.
- Оргструктура. Включается тем же флажком «Оргструктура» в той же обработке — см. 1С: Синхронизация оргструктуры – настройка интеграции. Подразделения нужны для подчинённости и доступа к местам: Подчинённость через оргструктуру и Доступ к местам через оргструктуру.
- Статусы в расписании. Для этого нужна вторая обработка и отдельный токен — см. 1С: Синхронизация статусов расписания – настройка интеграции. Сотрудники сопоставляются по email, поэтому пользователи с теми же email должны уже существовать в UnSpot.
Режим работы и прямого руководителя настраивать отдельно не нужно: это поля пользователя, которые передаются той же синхронизацией пользователей при включённых флажках «Режим работы» и «Менеджер». Как они влияют на работу в UnSpot — в статьях Режим посещения офиса и норма посещения и Прямой руководитель в карточке сотрудника.
Какую статью открыть
Термины
Короткие пояснения к словам, которые встречаются во всех статьях о 1С.
| Термин | Что это |
|---|---|
| Обработка (обработчик) | Внешняя обработка 1С — файл .epf, который устанавливается в вашу информационную базу и передаёт данные в UnSpot. Обработок две: для пользователей и оргструктуры и для статусов |
| Скрипт выбора данных | Часть обработки — текст на встроенном языке 1С, который выбирает данные из вашей базы. Для ЗУП 3.1 встроен, для другой конфигурации пишется самостоятельно |
| Движок | Остальная часть обработки: берёт результат скрипта, сравнивает его с UnSpot (обработка статусов — со своим кэшем), отправляет изменения и ведёт журнал |
| SCIM 2.0 | Стандартный протокол обмена учётными записями. По нему обработка передаёт в UnSpot пользователей и оргструктуру |
| External API | Программный интерфейс UnSpot. Обработка статусов вызывает его метод «Импорт расписания сотрудника» |
| Токен | Секретная строка, которую выдаёт UnSpot при подключении. По ней UnSpot узнаёт обработку — по сути это пароль |
| Физлицо | Элемент справочника «Физические лица» — один человек. В 1С у него может быть несколько сотрудников (должностей), в UnSpot он всегда один пользователь |
externalId | Идентификатор физлица из 1С. В режиме «Полная» обработка записывает его пользователю UnSpot и потом находит человека по нему, даже если сменился email |
| Сопоставление | Поиск пары «сотрудник 1С — пользователь UnSpot»: по externalId или по email |
| Архивация | Так UnSpot удаляет пользователя: он пропадает из активных списков, его брони отменяются, закреплённые места освобождаются. Учётную запись можно восстановить. Пользователя каталожной синхронизации UnSpot в такой ситуации не архивирует, а деактивирует |
| Вид учёта времени | То, что ЗУП ставит сотруднику на день: явка, отпуск, больничный и т. д. У видов есть буквенные коды — Я, О, Б и другие |
| Регламентное задание | Запуск обработки по расписанию на сервере 1С |
| Журнал регистрации | Штатный журнал событий 1С. Обработка записывает туда ход каждого запуска |
| Безопасный режим | Ограничение, которое 1С накладывает на внешние обработки. У обеих обработок он выключен, потому что скрипт выполняется как код |
Связанные статьи
- 1С: Синхронизация пользователей – настройка интеграции — подключение обработки для пользователей.
- 1С: Синхронизация оргструктуры – настройка интеграции — передача дерева подразделений.
- 1С: Синхронизация статусов расписания – настройка интеграции — подключение обработки для статусов.
- 1С: Собственный скрипт – настройка интеграции — скрипт для нестандартной конфигурации.
- Как выбрать способ синхронизации пользователей — сравнение способов синхронизации.
- Обзор интеграций — все интеграции UnSpot.
- Статусы в расписании: простановка и влияние на брони — как статус влияет на брони.
