> ## 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.

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

> Установить расширение, опубликовать сервис и выполнить первый запрос за 10 минут

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

<Steps>
  <Step title="Скачайте расширение">
    Возьмите файл `OData4-<версия>.cfe` последнего выпуска на странице
    [Releases](https://github.com/wiikoservice/odata4/releases).
  </Step>

  <Step title="Загрузите расширение в базу">
    В конфигураторе откройте **Конфигурация → Расширения конфигурации**, нажмите **Действия → Добавить**,
    затем для нового расширения **Действия → Конфигурация → Загрузить конфигурацию из файла…** и выберите `.cfe`.

    <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>

    В свойствах расширения:

    * **Безопасный режим** можно оставить включённым. Тогда не подключается внешняя компонента на Rust
      (ускорение выдачи JSON) и недоступен режим прав «Привилегированный»: сервис работает на языке 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>

    Подробнее — [Установка расширения](/odatav4/install/extension).
  </Step>

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

    <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>
  </Step>

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

    <Frame caption="Вкладка «HTTP сервисы» → «Публиковать HTTP сервисы расширений по умолчанию» → «Опубликовать»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-publication-http.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=dc2d9f1d0fd7fe791ac820ab544b8b13" alt="Вкладка «HTTP сервисы» → «Публиковать HTTP сервисы расширений по умолчанию» → «Опубликовать»" width="509" height="510" data-path="images/install/cfg-publication-http.png" />
    </Frame>

    Подробнее — [Публикация на веб-сервере](/odatav4/install/publication).
  </Step>

  <Step title="Назначьте роли">
    Без ролей расширения сервис отвечает `403`.

    * пользователям сервиса — `OData4_Пользователь`;
    * администратору сервиса — `OData4_Администратор`.

    <Frame caption="Роли расширения в карточке пользователя (Администрирование → Пользователи → вкладка «Прочие»)">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/install/cfg-user-roles.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=e012a55c0440006d6acbd5c5a3af9ad4" alt="Роли расширения в карточке пользователя (Администрирование → Пользователи → вкладка «Прочие»)" width="364" height="290" data-path="images/install/cfg-user-roles.png" />
    </Frame>

    В конфигурациях на БСП назначайте роли через профили групп доступа, иначе БСП снимет их при следующем
    обновлении прав. Права на сами данные по-прежнему дают роли конфигурации. Подробнее — [Роли](/odatav4/install/roles).
  </Step>

  <Step title="Выполните первый запрос от администратора">
    Состав стандартного интерфейса OData платформа отдаёт только администратору. Первый запрос пользователя
    с правом «Администрирование» сохраняет его снимок, после этого сервис работает и для остальных пользователей.

    ```bash theme={null}
    curl -u "Администратор:пароль" https://server/base/hs/odata/v4/
    ```

    <Warning>
      Пока снимок не сохранён, пользователи без прав администратора получают `503` «Состав стандартного
      интерфейса OData не сохранён».
    </Warning>
  </Step>

  <Step title="Проверьте сервис">
    <CodeGroup>
      ```bash Служебный документ theme={null}
      curl -u "user:password" https://server/base/hs/odata/v4/
      ```

      ```bash $metadata theme={null}
      curl -u "user:password" "https://server/base/hs/odata/v4/\$metadata"
      ```

      ```bash Данные theme={null}
      curl -u "user:password" -G "https://server/base/hs/odata/v4/Catalog_Номенклатура" \
        --data-urlencode "\$select=Ref_Key,Description" \
        --data-urlencode "\$top=5"
      ```
    </CodeGroup>

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

## Что дальше

<CardGroup cols={2}>
  <Card title="Подключить Power BI" icon="chart-column" href="/odatav4/connect/power-bi">
    Канал OData с токеном, без пароля пользователя в отчёте.
  </Card>

  <Card title="Параметры запроса" icon="filter" href="/odatav4/read/query-options">
    `$filter`, `$select`, `$expand`, `$orderby`, `$top`, `$count`.
  </Card>

  <Card title="Состав публикации" icon="list-checks" href="/odatav4/admin/composition">
    Опубликуйте только нужные объекты и поля.
  </Card>

  <Card title="Безопасность" icon="shield" href="/odatav4/security/overview">
    Профили, токены, лимиты, CORS.
  </Card>
</CardGroup>


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