Skip to main content
OData4 — это расширение конфигурации 1С:Предприятия, которое публикует данные информационной базы по протоколу OData v4. Имена наборов, свойств и ключей совпадают со стандартным интерфейсом standard.odata, поэтому готовые запросы и отчёты переносятся почти без правок. Расширение работает с любой конфигурацией, с БСП и без неё, и ничего не меняет в основной конфигурации.

Зачем, если есть standard.odata

Штатный интерфейс 1С реализует OData v3 с собственными особенностями. OData4 даёт то, чего в нём нет:

OData v4 для Power BI и Excel

Канал OData подключается штатными средствами Power BI и Excel. Ответы в JSON v4, $metadata в CSDL XML и JSON.

Агрегация на сервере

$apply с groupby, aggregate, filter, compute и topcount считает итоги в СУБД, а не в клиенте.

Запись с бизнес-логикой

POST, PATCH, PUT и DELETE выполняют обработчики конфигурации и проверку заполнения. Есть проведение документов, наборы движений, ETag и безопасный повтор запроса.

$batch

Пакеты multipart/mixed и JSON batch. Набор изменений выполняется одной транзакцией 1С.

Токены и профили доступа

Токены для BI-инструментов без пароля пользователя, профили с правами на объекты, отборами строк, лимитами и ограничением частоты запросов.

Эксплуатация

Журнал запросов, CORS, форма настроек, состав публикации, кэш $metadata между сеансами.

Скорость

Большие ответы в JSON собирает внешняя компонента на Rust; если она недоступна, работает тот же код на языке 1С. Цифры получены на файловой базе с веб-сервером Apache на той же машине: Чтобы оценить скорость на своей базе, повторите запросы на ней: результат зависит от СУБД, веб-сервера и состава данных. Подробнее о настройке скорости — на странице Производительность.

С чего начать

Быстрый старт

Установка и первый запрос за 10 минут.

Установка

Требования, публикация, роли, токены.

Подключение

Power BI, Excel, curl, Python, JavaScript.
OData4 распространяется по лицензии MIT. Исходный код, готовые расширения .cfe и история изменений — в репозитории wiikoservice/odata4.