> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1unic.com/odatav4/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Загрузка OData4.cfe, свойства расширения, обновление до новой версии и удаление

Готовое расширение — файл `OData4-<версия>.cfe` на странице
[Releases](https://github.com/wiikoservice/odata4/releases). Собирать его самому не нужно: внешняя
компонента уже лежит внутри расширения.

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

## Загрузка

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

    <Frame caption="Конфигурация → Расширения конфигурации">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-menu-extensions.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=07198afe196a649f5e6411de2e63c348" alt="Конфигурация → Расширения конфигурации" width="470" height="652" data-path="images/install/cfg-menu-extensions.png" />
    </Frame>

    <Frame caption="Действия → Добавить, затем Действия → Конфигурация → Загрузить конфигурацию из файла…">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-extension-load.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=5bdbb555b6b34ed4d7ee5601b9e724d7" alt="Действия → Добавить, затем Действия → Конфигурация → Загрузить конфигурацию из файла…" width="807" height="251" data-path="images/install/cfg-extension-load.png" />
    </Frame>

    <Frame caption="Конфигурация → Обновить конфигурацию базы данных (F7)">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-update-db.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=1cd0200ec1684032a2e537a7ed977acc" alt="Конфигурация → Обновить конфигурацию базы данных (F7)" width="486" height="196" data-path="images/install/cfg-update-db.png" />
    </Frame>
  </Tab>

  <Tab title="Пакетный режим">
    ```powershell theme={null}
    $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`.
  </Tab>
</Tabs>

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

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

<Frame caption="Свойства задаются флажками прямо в списке расширений">
  <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-extension-properties.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=7eade467b065e3edef907626a426e1ee" alt="Свойства задаются флажками прямо в списке расширений" width="974" height="134" data-path="images/install/cfg-extension-properties.png" />
</Frame>

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

После загрузки [опубликуйте HTTP-сервисы](/odatav4/install/publication), [назначьте роли](/odatav4/install/roles) и выполните
первый запрос от администратора: он сохранит снимок состава стандартного интерфейса.

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

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

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

<Note>
  Модель и `$metadata` кэшируются. После обновления расширения или конфигурации кэш сбрасывается сам: ключ кэша
  включает отпечаток конфигурации и расширений. Если в настройках выбран режим проверки «По номеру версии», а
  конфигурацию изменили без смены номера, перезапустите веб-сервер. Подробнее — [Производительность](/odatav4/admin/performance).
</Note>

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

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

```powershell theme={null}
& $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С:Предприятие
(**Администрирование → Расширения**) и обновите конфигурацию базы данных.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.