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

# Частые вопросы

> Ответы на вопросы, которые задают чаще всего.

<AccordionGroup>
  <Accordion title="Нужна ли БСП? Подойдёт ли моя конфигурация?">
    Подойдёт любая конфигурация на управляемом приложении: типовая, отраслевая или самописная. Расширение строит
    модель данных по метаданным самой конфигурации и не привязано к конкретным объектам. БСП не нужна.

    Если БСП в конфигурации есть, учтите одно: роли пользователей там пересчитываются по профилям групп доступа.
    Поэтому роли OData4 назначайте через профили, иначе БСП снимет их при следующем обновлении. См.
    [Роли](/odatav4/install/roles).
  </Accordion>

  <Accordion title="С какой версией платформы работает?">
    С платформой **8.3.11 и новее**: расширение собрано в режиме совместимости 8.3.11. Rust-компонента работает
    на Windows и Linux, x86 и x64. Подробнее — [Требования](/odatav4/install/requirements).
  </Accordion>

  <Accordion title="Можно ли оставить standard.odata?">
    Да. OData4 — отдельный HTTP-сервис по адресу `…/hs/odata/v4/`. Стандартный интерфейс по адресу
    `…/odata/standard.odata/` продолжает работать. Можно переводить клиентов по одному: имена наборов и свойств
    совпадают, поэтому меняется только адрес.
  </Accordion>

  <Accordion title="Почему 503 «Состав стандартного интерфейса OData не сохранён»?">
    Платформа отдаёт состав стандартного интерфейса только администратору, а OData4 по умолчанию публикует именно
    его. Достаточно одного запроса к сервису от пользователя с правами администратора: расширение запишет снимок
    состава, и остальные пользователи начнут получать данные. Дальше снимок обновляется сам при запросах
    администратора, если состав изменился. Другой путь — настроить свой [состав публикации](/odatav4/admin/composition).
  </Accordion>

  <Accordion title="Почему 403?">
    Проверьте по порядку:

    1. **Роли расширения.** Пользователю Basic нужна роль `OData4_Пользователь`, пользователю публикации токенов —
       `OData4_СлужебныйПользователь`. Без них сервис отвечает `403` на всё. См. [Роли](/odatav4/install/roles).
    2. **Права в конфигурации.** Данные читаются с правами и RLS пользователя 1С. Роли расширения прав на объекты
       конфигурации не дают.
    3. **Профиль.** Если пользователю или токену назначен [профиль](/odatav4/security/profiles), операция должна быть
       разрешена в нём. Текст ответа называет объект и операцию.
    4. **Строгий режим Basic.** В этом режиме пользователь без профиля получает `403`.
    5. **Служебная учётка по Basic.** Учётка публикации токенов не может входить по Basic на сервис `odata`.
  </Accordion>

  <Accordion title="Power BI не видит таблицу">
    * Объект должен быть в [составе публикации](/odatav4/admin/composition), а пользователь должен иметь право на чтение
      (роль конфигурации, профиль).
    * После изменения состава обновите источник в Power BI: список таблиц берётся из `$metadata`.
    * Если подключаетесь по токену, проверьте, что профиль токена разрешает чтение этого объекта.
    * Табличные части — отдельные наборы (`Document_X_Товары`) и доступны через `$expand`.

    Пошагово — [Power BI](/odatav4/connect/power-bi).
  </Accordion>

  <Accordion title="Как ускорить большую выгрузку?">
    * Снимите с расширения безопасный режим, чтобы работала [Rust-компонента](/odatav4/admin/native): выдача быстрее в
      3,5–6 раз.
    * Для полных выгрузок включите «Выдача коллекций: одним ответом» или передавайте
      `Prefer: odata.maxpagesize=5000`.
    * Выбирайте только нужные поля через `$select` и фильтруйте через `$filter`.
    * Агрегируйте на сервере через `$apply` и виртуальные таблицы регистров.

    Подробнее — [Производительность](/odatav4/admin/performance).
  </Accordion>

  <Accordion title="Можно ли открыть сервис в интернет?">
    Можно, если соблюдать базовые правила:

    * публикуйте только через HTTPS;
    * подключайте внешних клиентов по [токенам](/odatav4/security/tokens) с профилем, сроком действия и, по возможности,
      ограничением по IP;
    * заведите отдельную [публикацию токенов](/odatav4/install/token-publication), на которой открыт только сервис
      `odatat`;
    * ограничьте профилем объекты, поля и строки;
    * задайте правила частоты;
    * держите [журнал](/odatav4/admin/journal) хотя бы на уровне «Ошибки».

    Ответы `401` не раскрывают, существует ли токен. Ответы `500` не раскрывают внутренний текст. Ссылки в теле
    записи проверяются на видимость. Подробнее — [Безопасность](/odatav4/security/overview).
  </Accordion>

  <Accordion title="Как обновить расширение?">
    1. Скачайте новый `OData4_<версия>.cfe` со страницы
       [релизов](https://github.com/wiikoservice/odata4/releases).
    2. В списке расширений конфигурации выберите `OData4` и обновите его из файла. Данные расширения сохранятся:
       настройки, состав, профили, токены, журнал.
    3. Проверьте флажки «Безопасный режим» и «Защита от опасных действий». После обновления они должны остаться
       такими же, как были.
    4. В конфигурациях на БСП убедитесь, что роли OData4 по-прежнему назначены через профили групп доступа.

    Что изменилось — в [истории изменений](/odatav4/changelog).
  </Accordion>

  <Accordion title="Можно ли использовать в коммерческих проектах?">
    Да. Проект распространяется по лицензии **MIT**: его можно использовать, изменять и включать в коммерческие
    решения бесплатно. Нужно сохранить текст лицензии и уведомление об авторских правах ООО «ВиикоСервис».
  </Accordion>

  <Accordion title="Где задать вопрос или сообщить об ошибке?">
    В [GitHub Issues](https://github.com/wiikoservice/odata4/issues). Для ошибки приложите:

    * версию платформы и расширения;
    * запрос (без токенов и паролей);
    * статус и текст ответа;
    * события `OData4.*` из журнала регистрации.

    Об уязвимостях не пишите в открытые Issues: порядок описан в файле `SECURITY.md` репозитория.
  </Accordion>
</AccordionGroup>


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