1С (OData)

Агент читает данные 1С — справочники, документы — через стандартный интерфейс OData.

Когда это работает (важно)

Дирижёр обращается к 1С по сети. Поэтому база должна быть доступна из интернета:

  • 1С:Фреш (облако 1cfresh.com) — подходит.
  • Своя 1С с «белым» IP / опубликованная наружу через https — подходит.
  • Локальная 1С внутри офисной сети — НЕ подходит: до неё нет доступа извне. Для такого случая будет отдельное решение («Дирижёр» на компьютере) — оно в планах.

Подключение принимается только по https — пароль 1С нельзя передавать незашифрованным.

Шаг 1. Включите OData в 1С

  1. В 1С: Администрирование Настройка стандартного интерфейса OData.
  2. Опубликуйте интерфейс и добавьте в «Состав» нужные объекты (справочники, документы), которые агент должен видеть.
  3. Заведите ОТДЕЛЬНОГО пользователя информационной базы с минимальными правами и ролью «Удалённый доступ OData».

Самая частая причина «подключилось, но данные пустые»: интерфейс опубликован, но в «Состав» не добавлены объекты, либо у пользователя нет прав на них. Добавьте объекты в состав и выдайте права.

Шаг 2. Подключите в Дирижёре

  1. «Интеграции» → «Подключить сервис» → «1С (OData)».
  2. Адрес базы — до /odata/standard.odata, например https://host/base/odata/standard.odata.
  3. Логин и пароль — того самого служебного пользователя 1С.
  4. Нажмите «Подключить» — проверка пройдёт автоматически.

Шаг 3. Узнайте имена объектов

Имена объектов в 1С зависят от вашей конфигурации (в Бухгалтерии и УНФ они разные). В ноде «Интеграция» вызовите операцию «Список объектов (метаданные)» — она вернёт точные имена (например Catalog_Номенклатура), которые подставляются в операцию «Прочитать записи». Имя объекта проще всего подобрать через копилот.

При чтении задавайте «Сколько записей» (например 50) — выборки 1С бывают очень большими.