В современной разработке на платформе 1С:Предприятие 8.3, особенно при работе с управляемыми формами, мы часто сталкиваемся с архитектурными ограничениями разделения кода на клиентский и серверный. Одним из самых распространенных вопросов, возникающих у разработчиков, является невозможность прямой передачи объекта ТаблицаЗначений с сервера на клиент. При попытке сделать это мы получаем ошибку о том, что тип не может быть сериализован, или сообщение "Переменная не определена" при обращении к ней на клиенте.
В этой статье мы подробно разберем, почему возникает данная проблема, проанализируем архитектурные причины и, самое главное, рассмотрим несколько надежных, проверенных на практике способов решения этой задачи. Мы изучим примеры кода, которые помогут вам выбрать оптимальный метод для вашей конкретной ситуации.
Прежде чем приступать к написанию кода, давайте разберем теорию. Платформа 1С в режиме управляемого приложения строго разделяет контексты выполнения. Клиентская часть (тонкий клиент, веб-клиент) должна быть максимально "легкой". Объект ТаблицаЗначений является тяжеловесным серверным объектом. Он содержит не только данные, но и метаданные колонок, индексы и другую информацию, которая не поддерживается на уровне клиентского приложения.
Когда мы пытаемся вернуть ТаблицаЗначений из серверной функции в клиентскую процедуру, платформа пытается выполнить сериализацию этого объекта (преобразовать его в поток байтов для передачи по сети), но, поскольку для данного типа сериализация в XDTO (формат обмена данными) по умолчанию не предусмотрена для прямого использования на клиенте в чистом виде (вне коллекций формы), возникает ошибка.
Рассмотрим, какие методы существуют для обхода этого ограничения. Мы выделим три основных подхода, которые рекомендуют профессионалы на форумах и в документации.
Это самый универсальный и часто используемый метод. Логика проста: Массив и Структура — это универсальные коллекции, которые существуют и на сервере, и на клиенте. Они прекрасно сериализуются. Следовательно, мы можем преобразовать нашу таблицу в массив, где каждым элементом будет структура, соответствующая строке таблицы, а ключи структуры будут соответствовать именам колонок.
Давайте посмотрим, как реализовать этот алгоритм. Напишем серверную функцию, которая принимает таблицу и возвращает массив.
// Функция преобразования ТаблицыЗначений в Массив структур
// Выполняется НА СЕРВЕРЕ (или НаСервереБезКонтекста)
Функция ПреобразоватьТЗвМассив(ИсходнаяТаблица)
РезультатМассив = Новый Массив;
// Получаем имена колонок для формирования структуры
МассивКолонок = Новый Массив;
Для Каждого Колонка Из ИсходнаяТаблица.Колонки Цикл
МассивКолонок.Добавить(Колонка.Имя);
КонецЦикла;
// Формируем строку с именами колонок через запятую для конструктора Структуры
СтрокаКолонок = СтрСоединить(МассивКолонок, ",");
// Обходим строки таблицы
Для Каждого СтрокаТЗ Из ИсходнаяТаблица Цикл
// Создаем новую структуру, используя имена колонок
НоваяСтруктура = Новый Структура(СтрокаКолонок);
// Заполняем значениями из строки таблицы
ЗаполнитьЗначенияСвойств(НоваяСтруктура, СтрокаТЗ);
РезультатМассив.Добавить(НоваяСтруктура);
КонецЦикла;
Возврат РезультатМассив;
КонецФункции
Теперь рассмотрим, как мы будем работать с этими данными на клиенте. Получив массив, мы можем перебирать его циклом Для Каждого, обращаясь к свойствам структур так же, как мы обращались бы к колонкам таблицы.
&НаКлиенте
Процедура ОбработатьДанныеНаКлиенте()
// Вызываем серверную функцию
МассивДанных = ПолучитьДанныеССервера();
Для Каждого СтрокаДанных Из МассивДанных Цикл
// Обращаемся к полям как к свойствам структуры
Сообщить("Товар: " + СтрокаДанных.Номенклатура + ", Количество: " + СтрокаДанных.Количество);
КонецЦикла;
КонецПроцедуры
Преимущества метода:
Если вам не нужно обрабатывать каждую строку на клиенте, а необходимо просто "перенести" таблицу с одного серверного вызова на другой через клиент (например, передать таблицу из формы подбора в форму документа), идеально подойдет механизм ПоместитьВоВременноеХранилище.
В этом случае мы не передаем саму таблицу, а передаем только строковый адрес, по которому она лежит в оперативной памяти сервера (во временном кластере).
Разберем по шагам, как это реализовать:
1. На сервере помещаем таблицу в хранилище и получаем адрес.
&НаСервере
Функция ПоместитьТЗВХранилище()
МояТаблица = СоздатьИЗаполнитьТаблицу(); // Ваша функция получения ТЗ
// УникальныйИдентификатор (второй параметр) важен, если мы хотим привязать данные к жизни формы
АдресВХранилище = ПоместитьВоВременноеХранилище(МояТаблица, УникальныйИдентификатор);
Возврат АдресВХранилище;
КонецФункции
2. На клиенте мы получаем эту строку-адрес. Сами данные нам недоступны, но мы можем передать этот адрес обратно на сервер в другую процедуру.
&НаКлиенте
Процедура ВыполнитьОбработку()
Адрес = ПоместитьТЗВХранилище();
// Передаем адрес в другую серверную процедуру
ОбработатьТЗНаСервере(Адрес);
КонецПроцедуры
3. На сервере восстанавливаем таблицу из адреса.
&НаСервере
Процедура ОбработатьТЗНаСервере(АдресВХранилище)
// Получаем данные обратно. Важно проверить на Неопределено
ТаблицаИзХранилища = ПолучитьИзВременногоХранилища(АдресВХранилище);
Если ТипЗнч(ТаблицаИзХранилища) = Тип("ТаблицаЗначений") Тогда
// Работаем с таблицей
КонецЕсли;
КонецПроцедуры
Этот метод оптимален для случаев, когда клиент выступает просто посредником, и данные ему самому для вычислений не нужны. Это экономит трафик, так как между клиентом и сервером "летает" только короткая строка адреса, а не весь массив данных.
В дополнение к методам, обсуждаемым на форуме, проанализируем еще один современный подход — использование JSON. Это может быть полезно, если данные нужно передать, например, в JavaScript на веб-страницу или во внешнюю компоненту.
На сервере мы используем объект ЗаписьJSON и СериализаторXDTO.
&НаСервере
Функция ПолучитьТЗКакJSON(ИсходнаяТаблица)
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
СериализаторXDTO.ЗаписатьJSON(ЗаписьJSON, ИсходнаяТаблица);
Возврат ЗаписьJSON.Закрыть(); // Возвращает строку
КонецФункции
На клиенте мы можем использовать ЧтениеJSON, но помните: восстановить полноценную ТаблицаЗначений на клиенте все равно не получится, так как этого типа там нет. Однако, вы получите структуру данных, которую можно разобрать.
Отдельно рассмотрим ситуацию, когда таблица значений является реквизитом вашей управляемой формы (тип ДанныеФормыКоллекция). В этом случае преобразовывать ничего не нужно — платформа сама заботится о синхронизации.
Если же вы сформировали ТаблицаЗначений программно на сервере и хотите загрузить её в табличную часть на форме, используйте метод ЗначениеВРеквизитФормы.
&НаСервере
Процедура ЗагрузитьВТЧ()
ТЗ = ПолучитьДанныеИзБазы();
// "Товары" - это имя табличной части (реквизита формы)
ЗначениеВРеквизитФормы(ТЗ, "Товары");
КонецПроцедуры
Проанализировав проблему передачи ТаблицаЗначений на клиент, мы можем сделать следующие выводы:
ЗначениеВРеквизитФормы и РеквизитФормыВЗначение.Используйте эти паттерны, и ваш код будет работать стабильно и предсказуемо.