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

> Где настраивается сервис и что находится на каждой вкладке формы.

Все настройки сервиса собраны в одной форме: раздел **OData4** → **Настройки OData4**. Открыть её может пользователь
с ролью `OData4_Администратор`.

<Frame caption="Раздел «OData4» → «Настройки OData4»">
  <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/app-section-odata4.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=899a9c63bd9721c486a1eda615b6ad3e" alt="Раздел «OData4» → «Настройки OData4»" width="700" height="751" data-path="images/admin/app-section-odata4.png" />
</Frame>

Настройки хранятся в информационной базе (регистр сведений `OData4_Настройки`, одна запись) и действуют
**со следующего запроса**: перезапускать веб-сервер или завершать сеансы не нужно.

<Info>
  Любой вариант поведения в форме — переключатель с безопасным значением по умолчанию. Рядом с каждым флажком
  написано, что нужно, чтобы включить другой вариант, и чем он рискован.
</Info>

## Вкладки

<Steps>
  <Step title="Аутентификация">
    * строгий режим Basic: пользователь без профиля получает `403`;
    * режим применения профиля;
    * права служебного пользователя сервиса `odatat`;
    * токены продолжения и их срок жизни;
    * список служебных учёток и разрешение для них входа по Basic;
    * заголовок адреса клиента от прокси;
    * предупреждения об опасных настройках.

    Подробно: [Доступ и безопасность](/odatav4/security/overview), [Токены](/odatav4/security/tokens).

    <Frame caption="Вкладка «Аутентификация»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-auth.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=5d5f072ed176564ba3cfc8ecfaaab854" alt="Вкладка «Аутентификация»" width="1094" height="680" data-path="images/admin/settings-auth.png" />
    </Frame>
  </Step>

  <Step title="Движки">
    Переключатели Rust-компоненты:

    * разбор параметров;
    * выдача JSON;
    * разбор тел;
    * вывод `$metadata`;
    * состояние компоненты.

    Здесь же:

    * кэш `$metadata` между сеансами и проверка изменений конфигурации;
    * выдача коллекций: страницами или одним ответом.

    Подробно: [Rust-компонента](/odatav4/admin/native), [Производительность](/odatav4/admin/performance).

    <Frame caption="Вкладка «Движки»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-engines.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=263d2401073ba76422145171e1ff336a" alt="Вкладка «Движки»" width="1094" height="680" data-path="images/admin/settings-engines.png" />
    </Frame>
  </Step>

  <Step title="Даты">
    Режим выдачи дат, см. [ниже](#режим-дат).

    <Frame caption="Вкладка «Даты»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-dates.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=73eba3efa815f236c060c3402f957da0" alt="Вкладка «Даты»" width="1094" height="680" data-path="images/admin/settings-dates.png" />
    </Frame>
  </Step>

  <Step title="Запись">
    * проверка заполнения перед записью;
    * требование `If-Match`;
    * режим `Post` без параметра;
    * отказ на неизвестные свойства;
    * проверка ссылок в теле;
    * `Ref_Key` при создании;
    * подробные ошибки записи клиенту;
    * субконто в строках регистров бухгалтерии и их сохранение при изменении наборов;
    * срок хранения ответов повторяемых запросов;
    * лимиты `$batch`.

    Подробно: [Запись](/odatav4/write/basics), [Надёжная запись](/odatav4/write/reliability), [\$batch](/odatav4/write/batch).

    <Frame caption="Вкладка «Запись»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-write.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=1059810d13da21fc9b33bb2010f9498f" alt="Вкладка «Запись»" width="1094" height="680" data-path="images/admin/settings-write.png" />
    </Frame>
  </Step>

  <Step title="Удаление">
    * режим `DELETE`: пометка удаления (по умолчанию) или физическое удаление по праву профиля;
    * поиск ссылок при физическом удалении;
    * чек-лист «Что нужно для физического удаления»: кнопка «Проверить» показывает, каким профилям и учёткам это
      удаление доступно.

    Подробно: [Запись](/odatav4/write/basics).

    <Frame caption="Вкладка «Удаление»: режим DELETE и чек-лист физического удаления">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-delete.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=4b412e4e4f6a2b4728cb145a0bbb0d32" alt="Вкладка «Удаление»: режим DELETE и чек-лист физического удаления" width="1094" height="680" data-path="images/admin/settings-delete.png" />
    </Frame>
  </Step>

  <Step title="Состав">
    Дерево объектов конфигурации с флажками. Здесь выбирается, что публикует сервис.
    Подробно: [Состав публикации](/odatav4/admin/composition).

    <Frame caption="Вкладка «Состав»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-composition.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=d080ac77f5fd1039c6a9d438febfdc8d" alt="Вкладка «Состав»" width="1094" height="680" data-path="images/admin/settings-composition.png" />
    </Frame>
  </Step>

  <Step title="Профили">
    Список профилей и карточка профиля:

    * лимиты;
    * дерево прав «все объекты → вид → объект»;
    * исключённые поля;
    * отборы строк;
    * правила частоты.

    Подробно: [Профили доступа](/odatav4/security/profiles).

    <Frame caption="Вкладка «Профили»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-profiles.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=8e63758981363130393ad3519ade683b" alt="Вкладка «Профили»" width="1094" height="680" data-path="images/admin/settings-profiles.png" />
    </Frame>
  </Step>

  <Step title="Пользователи">
    Сопоставление «пользователь ИБ → профиль» для входа по Basic.

    <Frame caption="Вкладка «Пользователи»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-users.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=56e2642300c1896888d3c069dc5f2aac" alt="Вкладка «Пользователи»" width="1094" height="680" data-path="images/admin/settings-users.png" />
    </Frame>
  </Step>

  <Step title="Токены">
    Кнопки «Выпустить», «Отозвать» и «Продлить». Значение токена показывается один раз, при выпуске.
    Подробно: [Токены](/odatav4/security/tokens).

    <Frame caption="Вкладка «Токены»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-tokens.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=bcf00a71e4b673a4877d2018a599a4b2" alt="Вкладка «Токены»" width="1094" height="680" data-path="images/admin/settings-tokens.png" />
    </Frame>
  </Step>

  <Step title="Журнал">
    Настройки журнала запросов и список записей с отбором. Подробно: [Журнал и мониторинг](/odatav4/admin/journal).

    <Frame caption="Вкладка «Журнал»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-journal.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=160fbbe33b7f5c5428c575a748999c4f" alt="Вкладка «Журнал»" width="1094" height="680" data-path="images/admin/settings-journal.png" />
    </Frame>
  </Step>

  <Step title="Адреса">
    * готовые адреса публикаций Basic (`odata`) и токенов (`odatat`);
    * подсказки для Power BI и Excel;
    * список источников CORS.

    Подробно: [Power BI](/odatav4/connect/power-bi), [CORS](/odatav4/security/cors).

    <Frame caption="Вкладка «Адреса»: готовые адреса и источники CORS">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-addresses.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=99bfcd5355b04c3c8ff74f2087380c27" alt="Вкладка «Адреса»: готовые адреса и источники CORS" width="1094" height="680" data-path="images/admin/settings-addresses.png" />
    </Frame>
  </Step>

  <Step title="Лимиты">
    Базовые лимиты запроса, которые действуют всегда, даже без профиля: число раскрытий `$expand`, элементов
    `in` и `$orderby`, длина строкового литерала, сложность выражения. Подробно: [Лимиты запросов](/odatav4/security/limits).

    <Frame caption="Вкладка «Лимиты»">
      <img src="https://mintcdn.com/o-data-v4/8iesiGXq06VGcZxz/images/admin/settings-limits.png?fit=max&auto=format&n=8iesiGXq06VGcZxz&q=85&s=1087e6ad6a160b888634f81eb2e28b0f" alt="Вкладка «Лимиты»" width="1094" height="680" data-path="images/admin/settings-limits.png" />
    </Frame>
  </Step>
</Steps>

Флажки с пометкой **\[Экспериментально]** включают новые возможности, которые проверены, но по умолчанию выключены:

* разбор параметров компонентой;
* сверка движков;
* токены продолжения.

## Режим дат

| Режим | Как выдаются даты |
| - | - |
| **Строгий** (по умолчанию) | `Дата` → `Edm.Date`, `Время` → `Edm.TimeOfDay`, `Дата и время` → `Edm.DateTimeOffset` со смещением часового пояса базы; пустая дата → `null` |
| **Совместимый** | всё — `Edm.DateTimeOffset` с `Z`, как в `standard.odata`; пустая дата → `0001-01-01T00:00:00Z` |

«Совместимый» режим нужен клиентам, которые написаны под `standard.odata` и ждут даты в его виде. При записи в этом
режиме явное смещение `±чч:мм` переводится в местное время базы, а `Z` — нет: чтение тоже выдаёт местное время с `Z`.

## Предупреждение при запуске

Если в настройках есть опасные значения, при входе в 1С расширение показывает окно с их списком. Его видит тот, у
кого есть право «Администрирование» или роль `OData4_Администратор`. Опасные значения — например:

* разрешён вход по Basic служебным учёткам;
* выбран привилегированный режим;
* задан токен с ограничением по IP, но без доверенного заголовка адреса.

Окно немодальное и не мешает работе.


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