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