OData 1С для тех, кто пишет код: локализация запросов, конструктор и анализ данных в памяти
Разработка - Инструментарий разработчика
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
Забудьте про переключение раскладки клавиатуры в запросах к OData!
Модуль для разработчика 1С, который регулярно читает данные другой базы через OData из кода: выгрузки/загрузки, сверки, отчеты. Пишете запрос по-русски («Наименование», «КонтрагентСсылка») — обертка сама переводит имена в физические, собирает URL с правильным кодированием, читает JSON, догружает страницы пагинации и при ошибке сервера громко падает в месте вызова. А дальше — анализ уже у себя: индексы, группировки, итоги и соединение таблиц в памяти за O(N+M), без JOIN на чужой базе.
Быстрый старт — весь запрос в шесть строк:
Настройки = НастройкиСоединения("мой-сервис.рф", "/моя-база/odata/standard.odata", Логин, Пароль);
Запрос = НовыйЗапрос("Документ.ПриходнаяНакладная");
ДобавитьПоля(Запрос, "Ссылка,Номер,Дата,Проведен,КонтрагентСсылка");
ДобавитьПериод(Запрос, Начало, Конец);
ДобавитьФлаг(Запрос, "Проведен");
ДобавитьСортировку(Запрос, "Дата");
Шапки = Выборка(Настройки, Запрос); // пагинация, повторы при сбое и odata.error — внутри
Что внутри:
- Локализация имен. Четыре уровня перевода: «Дата» → Date, «КонтрагентСсылка» → Контрагент_Key, регистронезависимый поиск, люк «=» для имен, которые трогать нельзя. Физические имена проходят как есть.
- Конструктор запросов. Поля, условия («равно», «содержит», списки GUID), периоды, флаги, сортировка, срезы виртуальных таблиц регистров — SliceLast собирается функцией с корректным кодированием кириллицы.
- Громкие ошибки. Пустой список GUID, поле не из выборки, неверное имя — исключение с подсказкой в месте вызова, а не тихо пустая выборка, которую ищешь три часа.
- Анализ в памяти. ИндексПоКлючу, ГруппировкаПоКлючу, ИтогиПоКлючу, СловарьЗначений, ПрисоединитьПоля — строки ТЧ получают Док_Номер и Номенклатура_Наименование двумя проходами, каждый справочник загружается один раз по уникальным GUID.
- Сахар. СтандартнаяВыборкаПоОтбору — расшифровка ссылок одним вызовом: стандартные поля, готовый индекс, доступ по ключу за O(1).
Соединения — в памяти, не JOIN-ами на чужом сервере. Каждая сущность загружается один раз по списку уникальных GUID: 100 документов + 8 контрагентов вместо 100 копий справочника внутри ответа. Чужой базе не тяжело — мы гости. А почему не $expand — коротко: он не разворачивает реквизиты табличных частей и не работает по одиночной сущности, а копии вложенных объектов утяжеляют и трафик, и SQL на той стороне. Для точечных случаев с одной связью развертка в модуле тоже есть.
Экономия на практике. Полный демонстрационный конвейер из семи примеров (справочники → шапки → строки ТЧ → вливания → срез цен → итоги → расшифровка ссылок) опытный разработчик пишет вручную за 85–105 минут и ~295 строк. С оберткой — 18–22 минуты и ~90 строк. И если ручной путь стоит столько на каждый новый запрос, то с модулем каждый следующий пример — уже 2–4 минуты.
Честно о границах.
Есть:
- чтение данных: отборы («равно», «не равно», «содержит»), списки GUID, периоды, булевы флаги;
- сортировка, ограничение выборки, пагинация;
- срезы виртуальных таблиц регистров;
- разбор ошибок odata.error и локализация имён;
- анализ в памяти: индексы, группировки, итоги, словари, вливание полей;
- работа с типовыми отборами через СтандартнаяВыборкаПоОтбору.
Нет:
- запись через OData (POST/PATCH);
- строковые функции startswith/endswith — из строковых реализован только аналог «содержит»;
- лямбды any/all в фильтре;
- разбор $metadata — задел на будущие версии;
- форма с деревом метаданных — модуль для кода, не для мышки.
А если нужен один URL разово, без интеграции в код — проще взять готовый генератор запросов: это не наш сценарий.
Не собирайте URL — пишите Код на 1С!
Обкатка: каждая версия с 1.2.1 прогонялась на живой базе с идентичным регрессионным результатом. В комплекте — документация с примерами, стандартными наборами полей и историей версий.
В архиве находится текст модуля "Обертка Odata1C_v1_4_0". Документация в формате "docx".
Текстовый файл с примерами использования (7 примеров) и Результаты прогонки примеров на живой базе (анонимизированы).
В качестве теста были использованы:
- База-источник "УНФ 3.0.13.314" с опубликованным интерфейсом Odata
- База-приемник "БП 3.0.210.8" где работала внешняя обработка с встроенным МодулемОберткойOdata1C. Данные запрашивались у УНФ, обрабатывались на стороне БП.
Тестировалось на платформе 8.5.1.1529.
Вступайте в нашу телеграмм-группу Инфостарт