> ## 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 для 1С

> Сервис OData v4 для любой конфигурации 1С:Предприятия 8.3 с именами, совместимыми со standard.odata

**OData4** — это расширение конфигурации 1С:Предприятия, которое публикует данные информационной базы по протоколу
**OData v4**. Имена наборов, свойств и ключей совпадают со стандартным интерфейсом `standard.odata`, поэтому
готовые запросы и отчёты переносятся почти без правок. Расширение работает с любой конфигурацией, с БСП и без неё,
и ничего не меняет в основной конфигурации.

```http theme={null}
GET https://server/base/hs/odata/v4/Catalog_Номенклатура?$select=Ref_Key,Description&$top=2
```

```json theme={null}
{
  "@odata.context": "https://server/base/hs/odata/v4/$metadata#Catalog_Номенклатура(Ref_Key,Description)",
  "value": [
    { "Ref_Key": "3f2a…", "Description": "Бумага А4" },
    { "Ref_Key": "8b1c…", "Description": "Картридж" }
  ]
}
```

## Зачем, если есть standard.odata

Штатный интерфейс 1С реализует OData v3 с собственными особенностями. OData4 даёт то, чего в нём нет:

<CardGroup cols={2}>
  <Card title="OData v4 для Power BI и Excel" icon="chart-column">
    Канал OData подключается штатными средствами Power BI и Excel. Ответы в JSON v4, `$metadata` в CSDL XML и JSON.
  </Card>

  <Card title="Агрегация на сервере" icon="sigma">
    `$apply` с `groupby`, `aggregate`, `filter`, `compute` и `topcount` считает итоги в СУБД, а не в клиенте.
  </Card>

  <Card title="Запись с бизнес-логикой" icon="pen-line">
    `POST`, `PATCH`, `PUT` и `DELETE` выполняют обработчики конфигурации и проверку заполнения. Есть проведение документов, наборы движений, ETag и безопасный повтор запроса.
  </Card>

  <Card title="$batch" icon="layers">
    Пакеты `multipart/mixed` и JSON batch. Набор изменений выполняется одной транзакцией 1С.
  </Card>

  <Card title="Токены и профили доступа" icon="key-round">
    Токены для BI-инструментов без пароля пользователя, профили с правами на объекты, отборами строк, лимитами и ограничением частоты запросов.
  </Card>

  <Card title="Эксплуатация" icon="activity">
    Журнал запросов, CORS, форма настроек, состав публикации, кэш `$metadata` между сеансами.
  </Card>
</CardGroup>

## Скорость

Большие ответы в JSON собирает внешняя компонента на Rust; если она недоступна, работает тот же код на языке 1С.
Цифры получены на файловой базе с веб-сервером Apache на той же машине:

| Замер | OData4 | standard.odata |
| - | -: | -: |
| Повторный запрос `$metadata` (5,4 МБ) | \~25 мс | \~400 мс |
| 100 тыс. документов с табличными частями | 161–229 с | 257–263 с |
| Строки табличной части с `$expand`, 1 млн строк | 39 с, первая страница | 323 с, весь миллион одним ответом |
| 1 млн записей регистра накопления, одним ответом | 134 с, 1,5 ГБ | 147 с, 3,3 ГБ |

Чтобы оценить скорость на своей базе, повторите запросы на ней: результат зависит от СУБД, веб-сервера
и состава данных. Подробнее о настройке скорости — на странице [Производительность](/odatav4/admin/performance).

## С чего начать

<CardGroup cols={3}>
  <Card title="Быстрый старт" icon="rocket" href="/odatav4/quickstart">
    Установка и первый запрос за 10 минут.
  </Card>

  <Card title="Установка" icon="download" href="/odatav4/install/requirements">
    Требования, публикация, роли, токены.
  </Card>

  <Card title="Подключение" icon="plug" href="/odatav4/connect/power-bi">
    Power BI, Excel, curl, Python, JavaScript.
  </Card>
</CardGroup>

<Note>
  OData4 распространяется по лицензии MIT. Исходный код, готовые расширения `.cfe` и история изменений —
  в репозитории [wiikoservice/odata4](https://github.com/wiikoservice/odata4).
</Note>


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