Skip to main content
Понадобятся права администратора информационной базы, доступ к конфигуратору и к веб-серверу, на котором опубликована база (Apache или IIS).
1

Скачайте расширение

Возьмите файл OData4-<версия>.cfe последнего выпуска на странице Releases.
2

Загрузите расширение в базу

В конфигураторе откройте Конфигурация → Расширения конфигурации, нажмите Действия → Добавить, затем для нового расширения Действия → Конфигурация → Загрузить конфигурацию из файла… и выберите .cfe.
Список расширений: «Добавить», затем «Загрузить конфигурацию из файла…»

Список расширений: «Добавить», затем «Загрузить конфигурацию из файла…»

В свойствах расширения:
  • Безопасный режим можно оставить включённым. Тогда не подключается внешняя компонента на Rust (ускорение выдачи JSON) и недоступен режим прав «Привилегированный»: сервис работает на языке 1С. Чтобы получить полную скорость, снимите флажок.
  • Защита от опасных действий — снимите флажок, иначе платформа будет спрашивать подтверждение там, где отвечать некому, например при подключении компоненты.
Флажки «Активно», «Безопасный режим» и «Защита от опасных действий» в списке расширений

Флажки «Активно», «Безопасный режим» и «Защита от опасных действий» в списке расширений

Подробнее — Установка расширения.
3

Обновите конфигурацию базы данных

Конфигурация → Обновить конфигурацию базы данных (F7). Расширение добавляет свои регистры и справочники (настройки, профили, токены, журнал), поэтому без обновления сервис работать не будет.
Конфигурация → Обновить конфигурацию базы данных (F7)

Конфигурация → Обновить конфигурацию базы данных (F7)

4

Опубликуйте HTTP-сервисы расширения

Администрирование → Публикация на веб-сервере, флажок «Публиковать HTTP-сервисы расширений по умолчанию». Если база уже опубликована, достаточно включить этот флажок и нажать «Опубликовать».
Вкладка «HTTP сервисы» → «Публиковать HTTP сервисы расширений по умолчанию» → «Опубликовать»

Вкладка «HTTP сервисы» → «Публиковать HTTP сервисы расширений по умолчанию» → «Опубликовать»

Подробнее — Публикация на веб-сервере.
5

Назначьте роли

Без ролей расширения сервис отвечает 403.
  • пользователям сервиса — OData4_Пользователь;
  • администратору сервиса — OData4_Администратор.
Роли расширения в карточке пользователя (Администрирование → Пользователи → вкладка «Прочие»)

Роли расширения в карточке пользователя (Администрирование → Пользователи → вкладка «Прочие»)

В конфигурациях на БСП назначайте роли через профили групп доступа, иначе БСП снимет их при следующем обновлении прав. Права на сами данные по-прежнему дают роли конфигурации. Подробнее — Роли.
6

Выполните первый запрос от администратора

Состав стандартного интерфейса OData платформа отдаёт только администратору. Первый запрос пользователя с правом «Администрирование» сохраняет его снимок, после этого сервис работает и для остальных пользователей.
Пока снимок не сохранён, пользователи без прав администратора получают 503 «Состав стандартного интерфейса OData не сохранён».
7

Проверьте сервис

Служебный документ перечисляет опубликованные наборы, $metadata описывает их типы.

Что дальше

Подключить Power BI

Канал OData с токеном, без пароля пользователя в отчёте.

Параметры запроса

$filter, $select, $expand, $orderby, $top, $count.

Состав публикации

Опубликуйте только нужные объекты и поля.

Безопасность

Профили, токены, лимиты, CORS.