1С:Зарплата и управление персоналом

Приложение 1С:Зарплата и управление персоналом подключает OData-интерфейс базы ЗУП. Агент получает доступ к опубликованным данным сотрудников, физических лиц, кадровых документов, начислений и видов расчёта в пределах прав пользователя интеграции.

Назначение

Подключение помогает готовить кадровые списки, проверять состав опубликованных объектов, собирать выборки по сотрудникам и кадровым событиям и анализировать начисления без передачи пароля базы агенту.

Подключение

1. Включите Публиковать стандартный интерфейс OData при публикации базы на веб-сервере.
2. Заполните Состав стандартного интерфейса OData только необходимыми объектами.
3. Создайте отдельного пользователя с ролью УдаленныйДоступOData и ограничьте его права задачей интеграции.
4. Используйте HTTPS-адрес публикации.
5. В Promto укажите адрес, логин и пароль и нажмите Подключить базу.

При подключении Promto читает $metadata и сохраняет список опубликованных EntitySet. Пароль хранится на сервере и возвращается в интерфейс только маской. Подключить или отключить базу может владелец рабочего стола.

Интерфейс и данные

На главной находятся сценарии Что доступно в базе, Список сотрудников, Выборка данных и помощь по подключению.

Настройки показывают адрес публикации, пользователя, маску пароля, число объектов и поиск по их именам. Кнопка Обновить состав ($metadata) перечитывает публикацию после изменений в конфигураторе. Доступ агента можно временно отключить без удаления подключения.

Возможности агента

Инструмент — promto_onec_hr. Безопасный порядок: list_entities → describe_entity → query или get_object.

В типовой ЗУП ориентиры такие:

• Catalog_*Сотрудники* и Catalog_*ФизическиеЛица* — сотрудники и физические лица;
• Document_* — приём, перевод, увольнение и другие кадровые события;
• CalculationRegister_* — начисления и удержания;
• ChartOfCalculationTypes_* — виды расчёта.

Доработанная база может использовать другие имена, поэтому агент берёт их только из list_entities.

Сценарии

Действующие сотрудники

Через promto_onec_hr найди в list_entities справочник сотрудников, опиши поля через describe_entity и покажи действующих сотрудников с должностями. Запрашивай только необходимые поля.

Кадровые события

Найди опубликованные кадровые документы за указанный период и собери сводку по приёмам, переводам и увольнениям. Только чтение.

Ограничения и подтверждения

• Кадровые и зарплатные данные чувствительны: публикуйте только необходимые поля и выдавайте минимальные права пользователю интеграции.
• Максимум query — 1000 объектов за вызов; используйте $select, фильтр и страницы.
• Создание, изменение и удаление кадровых объектов требует confirm=true после явного согласия.
• Проведение документа может изменить расчёты и кадровое состояние, поэтому также требует подтверждения.
• delete_object не равен пометке на удаление.
• В ответах агента не следует запрашивать или показывать лишние персональные данные.

Если что-то не работает

• Состав пуст. Добавьте объекты в состав OData; по умолчанию он не заполняется автоматически.
• 403. Проверьте роль удалённого доступа и объектные права пользователя.
• Справочник называется иначе. Найдите его через поиск list_entities, не используйте имя из другой базы.
• Не видны отдельные поля. Проверьте публикацию объекта и права пользователя на реквизиты.
• 412 при изменении. Перечитайте актуальную версию объекта и повторно согласуйте запись.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto