1С:Документооборот

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

Назначение

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

Подключение

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

Promto проверяет $metadata, сохраняет фактические имена объектов и не передаёт пароль агенту. Подключением управляет владелец рабочего стола.

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

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

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

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

Инструмент — promto_onec_docflow. Агент использует:

• list_entities с префиксом Task_ или BusinessProcess_;
• describe_entity для проверки полей статуса, исполнителя и сроков;
• query для фильтрации активных задач и документов;
• get_object для чтения выбранной карточки.

Входящие, исходящие и внутренние документы могут быть представлены как Catalog_* или Document_*. Их имена определяет конкретная конфигурация.

Сценарии

Активные задачи

Через promto_onec_docflow вызови list_entities с префиксами Task_ и BusinessProcess_. Проверь поля через describe_entity и собери активные задачи по срокам и исполнителям. Только чтение.

Документы без движения

Найди опубликованный объект документов, уточни поля состояния и изменения и покажи записи, которые давно не переходили на следующий этап.

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

• Задачи и бизнес-процессы доступны только если они явно добавлены в состав OData.
• OData показывает опубликованные поля объекта, но не заменяет полнофункциональный интерфейс 1С:Документооборота.
• Создание, изменение и удаление объектов требует confirm=true.
• Проведение применимо только к объектам Document_* и может менять связанные данные.
• Максимум выборки — 1000 объектов за вызов; используйте $filter и $select.
• Удаление через delete_object физическое, а не пометка.

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

• Нет Task_* или BusinessProcess_*. Добавьте нужные объекты в состав OData и перечитайте $metadata.
• 403. Пользователю интеграции не хватает объектных или строковых прав.
• Статус называется иначе. Посмотрите реальные свойства через describe_entity.
• Документ не читается. Проверьте, опубликован ли сам объект и связанные типы, которые нужны через $expand.
• Большой ответ. Сузьте период, поля и количество строк.

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

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