# 1С:Документооборот Находите застрявшие согласования и истекающие договоры Управление документами и бизнес-процессами через OData ## Как агент работает с 1С:Документооборот Агент работает с Документооборотом по стандартному интерфейсу OData: запросы уходят на опубликованную базу в раздел /odata/standard.odata, и отвечает та же конфигурация, которую видят пользователи, — без внешних обработок, регламентных выгрузок и правок в самой конфигурации. Данные приходят сущностями с типовыми именами, а отбор по датам, статусам и исполнителям агент отдаёт серверу параметрами запроса, чтобы не тянуть базу целиком ради одного отчёта. Состав того, что агент вообще способен увидеть, задаётся на вкладке «Состав»: внутренние, входящие и исходящие документы, задачи и бизнес-процессы, справочники корреспондентов и видов документов. Схему агент читает из /$metadata, поэтому ваши виды документов и дополнительные реквизиты берутся из реальной базы, а не из типового описания конфигурации. Прикладной смысл — видеть, где встал документооборот: документы, висящие на согласовании дольше регламентного срока, вместе с сотрудниками, у которых остановился маршрут; открытые задачи бизнес-процессов по исполнителям, чтобы найти очередь, упирающуюся в одного человека; договоры, истекающие в ближайший месяц, и те из них, по которым не запущено продление; реестр входящей и исходящей корреспонденции по корреспондентам и видам с пометкой, что осталось без резолюции и ответа. Что агент может сделать, а не только прочитать, определяет роль пользователя. Технически OData позволяет стартовать бизнес-процесс и выполнить задачу, если роль это разрешает, но по умолчанию агент читает и анализирует, а решение по согласованию остаётся за человеком. Отсутствие нужного вида документа агент отличает от отказа по правам: если объект не отмечен в составе, он назовёт причину прямо, а состав после правки требует перепубликации базы. ## Сценарии интеграции ### Просроченные согласования Агент найдёт документы, которые висят на согласовании дольше регламентного срока, и назовёт сотрудников, у которых остановился маршрут. ### Загрузка исполнителей по задачам Агент посчитает открытые задачи бизнес-процессов по сотрудникам и покажет, где очередь согласования упирается в одного человека. ### Сроки договоров и продления Агент соберёт договоры из базы документооборота, отберёт истекающие в ближайший месяц и покажет, по каким не запущено продление. ### Реестр корреспонденции за период Агент сведёт входящие и исходящие документы по корреспондентам и видам и покажет, что осталось без резолюции и ответа. ### Внутренние документы по видам Агент сведёт внутренние документы за период по видам и подразделениям и покажет, сколько из них так и не дошло до конца маршрута согласования. ### Что отдаёт ваша база Агент прочитает схему из /$metadata и назовёт, какие виды документов и дополнительные реквизиты доступны через OData, а что не попало в состав публикации. ## Как подключить **Перед подключением** - Доступ к Конфигуратору базы документооборота - Права администратора на веб-сервере IIS или Apache - Веб-сервер доступен из интернета, а не только из локальной сети ### Опубликуйте базу на веб-сервере Конфигуратор → Администрирование → «Публикация на веб-сервере…»: имя базы латиницей, флажок «Публиковать стандартный интерфейс OData», затем «Опубликовать». ### Задайте состав интерфейса OData Администрирование → Синхронизация данных → «Настройка стандартного интерфейса OData», вкладка «Состав» → «Загрузить метаданные»: отметьте документы и задачи. ### Заведите пользователя для OData Там же на вкладке «Авторизация» отметьте «Создать отдельные имя пользователя и пароль» и сохраните их. Пользователю нужна роль «Удаленный доступ OData». ### Проверьте адрес публикации в браузере Откройте https://ваш-сервер/имя-базы/odata/standard.odata/$metadata под этим логином — придёт XML со списком сущностей. Дальше нужен адрес без хвоста. ## Частые вопросы ### Как подключить 1С:Документооборот? Адресом публикации базы, логином и паролем. На вкладке «Авторизация» в настройке стандартного интерфейса OData отмечают «Создать отдельные имя пользователя и пароль» — эта пара и вводится в подключении вместе с адресом вида https://сервер/имя-базы. ### Что агент видит в документообороте? Внутренние, входящие и исходящие документы, задачи и бизнес-процессы, справочники корреспондентов и видов документов — в пределах объектов, включённых в состав публикации OData, и прав роли пользователя. ### Может ли агент выполнять задачи и запускать процессы? Технически OData позволяет стартовать бизнес-процесс и выполнить задачу, если роль пользователя это разрешает. По умолчанию агент читает и анализирует, а решение по согласованию остаётся за человеком. ### Почему агент не видит нужный вид документа? Скорее всего объект не отмечен на вкладке «Состав» настройки OData: после изменения состава базу нужно перепубликовать. Ошибка прав выглядит иначе, и агент назовёт причину прямо. [Открыть 1С:Документооборот](https://v8.1c.ru/doc8/)