Область применения
n8n — это современная open-source платформа для автоматизации рабочих процессов (workflow automation), которая позволяет легко связывать различные сервисы и приложения через визуальный интерфейс или JSON-конфигурации. Основные преимущества технологии n8n:
- Универсальность: поддерживает интеграцию с сотнями сервисов (включая HTTP-запросы, Telegram, базы данных и т.д.), что делает её универсальным инструментом для автоматизации.
- Гибкость: позволяет быстро адаптировать процессы без необходимости изменения кода 1С или прямой интеграции с каждым новым сервисом.
- Простота масштабирования: добавление новых интеграций сводится к настройке дополнительных рабочих процессов (workflows) в n8n, а не к переработке кода 1С.
- Отказоустойчивость: n8n может обрабатывать ошибки, логировать действия и отправлять уведомления (например, через Telegram), что упрощает мониторинг.
Почему интеграцию 1С лучше делать через n8n, а не напрямую с каждым сервисом?
Прямая интеграция 1С с внешними сервисами требует индивидуальной разработки для каждого API, что увеличивает затраты времени и ресурсов на поддержку. n8n выступает в роли "посредника", позволяя централизовать логику интеграции, минимизировать изменения в 1С и упростить дальнейшее расширение функциональности. Например, для добавления уведомлений в Telegram или интеграции с другим сервисом достаточно изменить настройки n8n, а не переписывать код в 1С.
Технические требования
Работа расширения проверена на конфигурации:
- 1C:Зарплата и управление персоналом, 3.1.30.117
- Код открыт
- Внимание! Расширение не работает на БАЗОВЫХ конфигурациях (в базовых конфигурациях 1С, возможности подключения расширений - отсутствуют
- Возможна адаптация расширения под другие конфигурации 1С/потребности клиента.
Функциональные возможности расширения n8n
- Автоматическое создание учетных записей:
- При приеме нового сотрудника в 1С создается учетная запись в Яндекс 360 с уникальным никнеймом, паролем и данными (ФИО, email, телефон, должность).
- Обновление данных:
- При изменении данных сотрудника (например, ФИО или должности) информация синхронизируется с Яндекс 360.
- Блокировка учетных записей:
- При увольнении сотрудника его учетная запись в Яндекс 360 отключается.
- Сопоставление существующих данных:
- Возможность ручного сопоставления сотрудников 1С с пользователями Яндекс 360 через обработку.
- Логирование и мониторинг:
- Успешные операции и ошибки фиксируются в журнале регистрации 1С.
- Уведомления об операциях отправляются в Telegram через n8n.
Преимущества для администратора
- Автоматизация рутинных задач:
- Исключение ручного создания и блокировки учетных записей в Яндекс 360.
- Снижение ошибок:
- Автоматическое формирование никнеймов и синхронизация данных минимизируют человеческий фактор.
- Гибкость и масштабируемость:
- Благодаря n8n можно легко добавить новые интеграции (например, уведомления в мессенджеры или синхронизацию с другими сервисами) без изменения кода 1С.
- Удобство мониторинга:
- Уведомления в Telegram и логи в 1С позволяют быстро реагировать на проблемы.
- Экономия времени:
- Администратору не нужно вручную поддерживать соответствие данных между 1С и Яндекс 360.
Подходы к разработке расширения
- Минимальное вмешательство в базовую конфигурацию: Расширение использует механизмы подписок на события и добавляет собственные объекты, не изменяя стандартные объекты 1С:ЗУП.
- Модульность: Логика разделена на области (API, регистрация событий, обработка событий, сервисные функции) для удобства поддержки и расширения.
- Асинхронность: Использование независимого сервера n8n позволяет избежать блокировки работы 1С при выполнении внешних запросов.
- Логирование: Ошибки и успешные операции фиксируются в журнале регистрации 1С для упрощения диагностики.
Ограничения текущей версии
- Работа только с одной организацией в Яндексе. Т.е. в 1С:ЗУП у вас может быть сколько угодно организаций или сколько угодно баз ЗУП – все будет работать если в Яндексе у вас 1 компания на 1 домен. Это не ограничение Яндекса или 1С – это ограничение текущей версии расширения. Технически нет ограничений реализовать управление несколькими организациями Яндекса.
- Реализовано только 2 метода для справочника «users»: «Добавить» и «Изменить информацию». Блокировка пользователя выполняется через «Изменить…» путем передачи только 1 ключа «isEnabled» с флагом «false». Разблокировки из 1С нет, только вручную из web-интерфейса Яндекса.
Техническая поддержка и обновления
Бесплатный период техподдержки составляет 1 месяц со дня покупки.
Также после приобретения вы получаете 1 месяц бесплатных обновлений.
По окончании бесплатного периода вы можете приобрести услугу технической поддержки с доступом к обновлениям на платной основе.
Проверить наличие обновлений можно в личном кабинете. Если обновления недоступны - загрузить новую версию можно после покупки обновлений/технической поддержки.
Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.
При создании тикета необходимо предоставить:
- Номер заказа
- Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
- Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.
К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения
Внимание! Техническая поддержка предоставляется исключительно в рамках переписки по обращению. В некоторых случаях для диагностики ошибок и/или вопросов, связанных с особенностями использования продукта в информационных базах покупателя, может потребоваться дополнительная платная диагностика с организацией удаленного доступа к информационной базе. Стоимость уточняется индивидуально.
Проверено на следующих конфигурациях и релизах:
- Зарплата и управление персоналом, редакция 3.1, релизы 3.1.30.117