Как правильно работать с запросами к ТаблицеЗначений и сериализовать ее в JSON в 1С:Предприятии?

← К списку

При работе с данными в 1С:Предприятии мы часто сталкиваемся с необходимостью обрабатывать информацию, находящуюся в оперативной памяти, а не только в базе данных. Объект ТаблицаЗначений является одним из наиболее распространенных для таких задач. Однако, когда дело доходит до сложных выборок, фильтрации, группировки или передачи этих данных в другие системы через формат JSON, возникают вопросы: как эффективно использовать запросы к ТаблицаЗначений и как корректно ее сериализовать?

Давайте вместе разберем эту проблему и рассмотрим несколько подходов, которые помогут нам справиться с этими задачами.

Использование запросов к ТаблицеЗначений

Запросы к ТаблицаЗначений — это мощный инструмент, позволяющий выполнять сложные манипуляции с данными, уже загруженными в память, используя синтаксис языка запросов 1С. Это часто более эффективно, чем программный перебор строк в цикле, особенно для больших объемов данных или сложных условий. Основной подход заключается в передаче ТаблицаЗначений во временную таблицу в контексте запроса.

Рассмотрим по шагам, как это сделать:

Создание и определение колонок ТаблицыЗначений. Прежде чем передавать ТаблицаЗначений в запрос, убедимся, что она создана и ее колонки определены. Крайне важно явно указывать типы данных для колонок с помощью ОписаниеТипов. Это помогает избежать неявных преобразований и потенциальных ошибок при выполнении запроса. Если ТаблицаЗначений уже была выгружена из табличной части или результата другого запроса, типы колонок, как правило, уже определены.
Инициализация объектов запроса и менеджера временных таблиц. Для работы с временными таблицами нам потребуется создать объекты Запрос и МенеджерВременныхТаблиц.
```
Запрос = Новый Запрос;
МенеджерВременныхТаблиц = Новый МенеджерВременныхТаблиц;
Запрос.УстановитьМенеджерВременныхТаблиц(МенеджерВременныхТаблиц);
```
Помещение ТаблицыЗначений во временную таблицу. В тексте запроса мы используем оператор ПОМЕСТИТЬ, чтобы скопировать данные из нашей ТаблицыЗначений (переданной как параметр) во временную таблицу. При этом мы указываем, какие колонки нам нужны и как их назвать.
Установка параметра запроса. Нам необходимо привязать нашу ТаблицаЗначений к параметру запроса с помощью метода УстановитьПараметр.
Выполнение основного запроса. После того как данные помещены во временную таблицу, мы можем выполнять основной запрос, обращаясь к ней как к обычному источнику данных. Это позволяет нам применять любые операции языка запросов: выборки, группировки, сортировки, соединения с другими таблицами базы данных.

Посмотрим на пример запроса к ТаблицаЗначений, который был предложен в обсуждении. Предположим, у нас есть ТаблицаЗначений с именем ТЗВыходныеДанные, и мы хотим выбрать из нее определенные колонки. Вначале мы помещаем ее во временную таблицу, а затем выбираем данные:


// Предположим, что ТЗВыходныеДанные уже заполнена
// и содержит колонки: ТЗВыходныеДанныеНаименование, ТЗВыходныеДанныех,
// ТЗВыходныеДанныеШирина, ТЗВыходныеДанныеу, ТЗВыходныеДанныеВысота

Запрос = Новый Запрос;
МенеджерВременныхТаблиц = Новый МенеджерВременныхТаблиц;
Запрос.УстановитьМенеджерВременныхТаблиц(МенеджерВременныхТаблиц);

// 1. Помещаем ТаблицуЗначений во временную таблицу
Запрос.Текст = 
    "ВЫБРАТЬ
    |    ТЗ.ТЗВыходныеДанныеНаименование,
    |    ТЗ.ТЗВыходныеДанныех,
    |    ТЗ.ТЗВыходныеДанныеШирина,
    |    ТЗ.ТЗВыходныеДанныеу,
    |    ТЗ.ТЗВыходныеДанныеВысота
    |ПОМЕСТИТЬ ВремТЗ
    |ИЗ
    |    &ТЗВыходныеДанные КАК ТЗ";

Запрос.УстановитьПараметр("ТЗВыходныеДанные", ТЗВыходныеДанные);
Запрос.Выполнить(); // Выполняем первую часть запроса для помещения данных

// 2. Выбираем данные из временной таблицы
Запрос.Текст =
    "ВЫБРАТЬ
    |    ВремТЗ.ТЗВыходныеДанныеНаименование КАК ТЗВыходныеДанныеНаименование,
    |    ВремТЗ.ТЗВыходныеДанныех КАК ТЗВыходныеДанныех,
    |    ВремТЗ.ТЗВыходныеДанныеШирина КАК ТЗВыходныеДанныеШирина,
    |    ВремТЗ.ТЗВыходныеДанныеу КАК ТЗВыходныеДанныеу,
    |    ВремТЗ.ТЗВыходныеДанныеВысота КАК ТЗВыходныеДанныеВысота
    |ИЗ
    |    ВремТЗ КАК ВремТЗ";

РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

Как мы видим, в данном примере мы сначала помещаем ТаблицаЗначений во временную таблицу с именем ВремТЗ, а затем обращаемся к ней уже как к полноценному источнику данных. Этот метод особенно удобен для получения сложных выборок, группировки и сортировки данных, а также для получения информации в различных временных разрезах. Использование таблиц значений в запросе 1С является одним из признаков хорошего тона разработки, помогая избежать выполнения запросов в цикле.

Однако, как было отмечено в форуме, если нам не нужны сложные условия отбора или группировки, а требуется лишь простая выборка или сериализация, то запрос может быть избыточным.

Альтернативные методы работы с ТаблицейЗначений без запроса

Для более простых задач, когда нам не требуется вся мощь языка запросов, ТаблицаЗначений может быть эффективно обработана программно. Объект ТаблицаЗначений является полностью динамическим и предоставляет нам широкий набор методов для манипуляции данными. Давайте проанализируем основные из них:

Добавление и удаление строк и колонок. Мы можем динамически менять структуру и содержимое таблицы.

Перебор строк. Для последовательной обработки каждой строки используем цикл Для Каждого.


Для Каждого СтрокаТЗ Из ТЗВыходныеДанные Цикл
    // Обработка данных строки
    Сообщить(СтрокаТЗ.ТЗВыходныеДанныеНаименование);
КонецЦикла;

Поиск строк. Методы Найти (возвращает первую найденную строку по условию) и НайтиСтроки (возвращает массив всех найденных строк по условию) позволяют быстро найти нужные данные.
Сортировка. Метод Сортировать позволяет упорядочить данные по одной или нескольким колонкам.
Отбор строк. Мы можем получить подмножество строк, удовлетворяющих определенным условиям.
Свертка. Метод Свернуть позволяет сгруппировать данные по указанным колонкам, выполняя агрегатные функции (сумма, количество, максимум, минимум) по другим колонкам. Это очень похоже на оператор СГРУППИРОВАТЬ ПО в запросах.
Копирование. Мы можем скопировать таблицу значений целиком или только определенные колонки.

Эти методы позволяют нам гибко работать с данными, избегая накладных расходов на создание и выполнение запроса, если задача не требует его функционала.

Сериализация ТаблицыЗначений в JSON

Передача данных во внешние системы или между клиентом и сервером часто требует их сериализации в формат JSON. В 1С ТаблицаЗначений может быть сериализована в JSON, но здесь есть свои нюансы, которые мы разберем подробнее.

Стандартные механизмы сериализации в JSON (методы глобального контекста ПрочитатьJSON() и ЗаписатьJSON() в связке с объектами ЧтениеJSON и ЗаписьJSON) работают с ограниченным набором типов: Строка, Число, Булево, Неопределено, Массив, ФиксированныйМассив, Структура, ФиксированнаяСтруктура, Соответствие, Дата. Важный момент: если ТаблицаЗначений содержит ссылки на объекты базы данных, объекты конфигурации или другие сложные типы, то прямая сериализация может работать некорректно или привести к ошибкам.

Для корректной сериализации таких сложных ТаблицЗначений в JSON часто применяется промежуточное преобразование. Наиболее распространенный и удобный способ — это преобразование ТаблицыЗначений в массив структур. Каждая строка ТаблицыЗначений при этом становится отдельной структурой в массиве.

Рассмотрим пример, предложенный в обсуждении, который использует функцию ОбщегоНазначения.ТаблицаЗначенийВМассив (или аналогичные самописные функции, если такой нет в вашей конфигурации):


// Предположим, у нас есть ТЗВыходныеДанные, которую нужно сериализовать

// 1. Преобразуем ТаблицуЗначений в Массив структур
МассивДанных = ОбщегоНазначения.ТаблицаЗначенийВМассив(ТЗВыходныеДанные);

// 2. Создаем объект ЗаписьJSON
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку(); // Указываем, что запись будет производиться в строку

// 3. Записываем Массив в JSON
ЗаписатьJSON(ЗаписьJSON, МассивДанных);
    
// 4. Получаем итоговую строку JSON
СтрокаJSON = ЗаписьJSON.Закрыть();

// СтрокаJSON теперь содержит сериализованные данные
Возврат СтрокаJSON;

В этом примере мы видим, как сначала ТаблицаЗначений преобразуется в Массив. Этот Массив, состоящий из Структур, уже легко сериализуется стандартными средствами 1С в JSON. Это очень удобно для передачи данных между сервером и клиентом или во внешние системы, так как формат JSON является универсальным стандартом обмена данными.

Как было указано в обсуждении, в некоторых случаях ТаблицаЗначений может быть сериализована и без промежуточного преобразования в массив, если она содержит только простые типы данных. Однако, использование промежуточного массива структур обеспечивает большую надежность и универсальность, особенно когда мы не уверены в типах данных внутри ТаблицыЗначений.

Передача ТаблицыЗначений между сервером и клиентом

Отдельно рассмотрим важную особенность платформы 1С: объект ТаблицаЗначений не может быть напрямую передан с сервера на клиент и наоборот. Если нам требуется передать ТаблицаЗначений между контекстами (например, из серверной функции в клиентскую или наоборот), ее необходимо преобразовать. Проанализируем распространенные способы:

Преобразование в массив структур. Как мы уже выяснили при работе с JSON, это один из наиболее универсальных и надежных способов. Массив структур легко передается между контекстами, сохраняя при этом исходную структуру данных.
Использование временного хранилища. Мы можем поместить ТаблицаЗначений во временное хранилище на сервере (например, с помощью метода ПоместитьВоВременноеХранилище) и затем получить ссылку на это хранилище. Эту ссылку (уникальный идентификатор) можно передать в другой контекст (например, на клиент), где по ней можно будет получить данные из хранилища.
Использование реквизитов формы. На управляемых формах ТаблицаЗначений может быть реквизитом формы (с типом ТаблицаЗначений). В этом случае платформа 1С автоматически берет на себя заботу о передаче данных между сервером и клиентом при определенных условиях (например, при вызове серверных процедур из клиентского кода), без необходимости явного написания кода для сериализации/десериализации.

Выбор метода зависит от конкретной задачи и архитектуры решения. Для простых случаев на управляемых формах реквизит формы может быть самым удобным. Для обмена данными с внешними системами или сложной логики сериализация в JSON через массив структур – предпочтительный путь.

Надеемся, что этот подробный разбор поможет вам эффективно работать с ТаблицейЗначений, использовать запросы к ней и корректно сериализовать данные в JSON в ваших проектах 1С:Предприятия!

← К списку