Установка расширения

Готовое расширение — файл OData4-<версия>.cfe на странице Releases. Собирать его самому не нужно: внешняя компонента уже лежит внутри расширения.

Перед установкой в рабочую базу сделайте резервную копию и проверьте установку на копии.

Загрузка

Конфигуратор
Пакетный режим

Конфигурация → Расширения конфигурации.
Действия → Добавить, затем для нового расширения Действия → Конфигурация → Загрузить конфигурацию из файла… и выберите OData4-<версия>.cfe.
Задайте свойства расширения (см. ниже).
Конфигурация → Обновить конфигурацию базы данных (F7).

Действия → Добавить, затем Действия → Конфигурация → Загрузить конфигурацию из файла…

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

$v8 = "C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe"
& $v8 DESIGNER /F "D:\Bases\Base" /N "Администратор" /P "пароль" `
  /LoadCfg "OData4-1.0.0.cfe" -Extension OData4 /UpdateDBCfg /Out install.log

Для клиент-серверной базы вместо /F укажите /S "сервер\база". Результат — в install.log.

Свойства расширения

Свойство	Рекомендация
Безопасный режим	Снять, если нужна полная скорость. В безопасном режиме платформа запрещает подключать внешнюю компоненту, и сервис работает на языке 1С. Недоступен и режим прав «Привилегированный» для публикации токенов
Защита от опасных действий	Снять
Активно	Включено

Свойства задаются флажками прямо в списке расширений

Снимая безопасный режим, вы разрешаете расширению то же, что разрешено основной конфигурации. Исходный код расширения открыт — его можно проверить перед установкой.

После загрузки опубликуйте HTTP-сервисы, назначьте роли и выполните первый запрос от администратора: он сохранит снимок состава стандартного интерфейса.

Обновление до новой версии

Скачайте новый .cfe.
В конфигураторе выделите расширение OData4 в списке расширений и выберите Конфигурация → Загрузить конфигурацию из файла… (или в пакетном режиме ту же команду /LoadCfg … -Extension OData4).
Обновите конфигурацию базы данных.

Настройки, состав публикации, профили, токены и журнал хранятся в регистрах и справочниках расширения и при обновлении сохраняются. Что изменилось в версии — в истории изменений.

Модель и $metadata кэшируются. После обновления расширения или конфигурации кэш сбрасывается сам: ключ кэша включает отпечаток конфигурации и расширений. Если в настройках выбран режим проверки «По номеру версии», а конфигурацию изменили без смены номера, перезапустите веб-сервер. Подробнее — Производительность.

Сборка из исходников

Каталог src/cfe репозитория — выгрузка расширения в файлы. Чтобы собрать расширение самому:

& $v8 DESIGNER /F "D:\Bases\Base" /N "Администратор" /P "пароль" `
  /LoadConfigFromFiles "src\cfe" -Extension OData4 /UpdateDBCfg
# при необходимости сохранить в файл
& $v8 DESIGNER /F "D:\Bases\Base" /N "Администратор" /P "пароль" `
  /DumpCfg "OData4.cfe" -Extension OData4

Или в конфигураторе: создайте расширение OData4, затем Конфигурация → Загрузить конфигурацию из файлов и укажите каталог src/cfe. Rust для этого не нужен: собранная компонента лежит в макете расширения.

Удаление

Удалите расширение OData4 в списке расширений конфигуратора или в режиме 1С:Предприятие (Администрирование → Расширения) и обновите конфигурацию базы данных.

Вместе с расширением удаляются его данные: настройки, профили, токены и журнал запросов. Выпущенные токены перестают действовать.

Начало