Типы данных 1С: что можно передать с сервера на клиент

В архитектуре платформы 1С Предприятие 8 разделение на клиентскую и серверную части является фундаментальным принципом обеспечения безопасности и производительности. Разработчики часто сталкиваются с необходимостью обмена данными между этими контекстами, но не все структуры данных могут быть бесшовно перемещены через границу вызова. Непонимание правил сериализации приводит к критическим ошибкам выполнения, которые трудно отловить на этапе написания кода.

Механизм передачи значений работает по принципу сериализации объекта на сервере и его десериализации на клиенте. Это означает, что сложная структура должна быть преобразована в поток байтов, передан по сети или шине IPC, и затем восстановлена в памяти клиентского процесса. Если объект содержит ссылки на недопустимые сущности, процесс прерывается с сообщением о невозможности передачи типа.

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

Базовые примитивные типы и строки

Самая простая категория данных, которая передается без каких-либо ограничений и дополнительных преобразований. К этой группе относятся стандартные скалярные значения, используемые повсеместно в алгоритмах любой сложности. Они занимают минимальный объем памяти и сериализуются мгновенно.

К таким типам относятся числа любой разрядности, булевы значения и строки произвольной длины. Также сюда входят даты и время, которые являются неотъемлемой частью бизнес-логики. При передаче даты важно помнить о часовых поясах, хотя платформа обычно сама приводит их к локальному времени клиента.

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

• 🔢 Числа (целые, вещественные, фиксированные)
• 📅 Даты и время (тип Date)
• ✅ Булевы значения (Истина/Ложь)
• 📝 Строки произвольной длины

⚠️ Внимание: При передаче очень длинных строк (более 10-20 Мб) может наблюдаться заметная задержка интерфейса из-за времени на копирование памяти, хотя технически ограничение по размеру отсутствует.

Работа со ссылками и идентификаторами

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

Важно различать сам объект и ссылку на него. С сервера на клиент можно передать только ссылку (Reference), но не полноценный объект в памяти со всеми его реквизитами и табличными частями, если он не был явно прочитан. Попытка передать объект типа ДокументОбъект напрямую вызовет ошибку, если этот тип не входит в список допустимых для конкретной версии платформы.

Особое внимание стоит уделить предопределенным элементам. Ссылки на них передаются корректно, и на клиенте они остаются предопределенными. Это позволяет использовать их для жесткой логики, не зависящей от конкретных записей в базе данных.

Помимо ссылок, поддерживаются уникальные идентификаторы (UUID). Они часто используются в распределенных системах или при синхронизации данных, где важна глобальная уникальность записи, а не ее ссылка в конкретной базе.

Структурированные данные: Массивы и Соответствия

Для передачи коллекций значений используются специальные типы-контейнеры. Они позволяют группировать разнородные данные в единую структуру, которую можно передать одним параметром. Это критически важно для оптимизации количества вызовов сервера.

Тип Массив позволяет хранить упорядоченный список значений. Элементами массива могут быть любые допустимые типы, включая другие массивы, что позволяет создавать многомерные структуры. Глубина вложенности ограничена только объемом оперативной памяти.

Тип Соответствие (Map) представляет собой набор пар "Ключ-Значение". Ключом может выступать почти любой примитивный тип или ссылка. Это идеальный вариант для передачи словарей, настроек или результатов агрегации данных, где доступ осуществляется по ключу.

Тип контейнера	Особенности ключа	Упорядоченность	Рекомендуемое использование
Массив	Числовой индекс	Да	Списки, очереди, наборы однотипных данных
Соответствие	Любой допустимый тип	Нет (обычно)	Ассоциативные массивы, кэши, словари
Структура	Строка (имя свойства)	Нет	Передача сложных параметров в функции

Структуры (Structure) также широко применяются для передачи параметров. Они похожи на соответствия, но ключи всегда являются строками, что делает их удобными для эмуляции именованных аргументов в методах.

Табличные значения и наборы записей

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

При передаче таблицы значений копируются не только данные, но и структура колонок, их типы, заголовки и настройки (ширина, видимые колонки). Клиент получает полную копию таблицы, с которой может работать локально: сортировать, фильтровать, изменять ячейки.

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

⚠️ Внимание: Передача таблицы значений с миллионами строк может "подвесить" тонкий клиент. Всегда оценивайте объем передаваемых данных и при необходимости используйте постраничную выборку.

Для оптимизации работы с большими объемами данных рекомендуется использовать ТаблицаЗначений.ПолучитьКолонки() для анализа структуры перед отправкой. Это позволит убедиться, что вы не передаете служебные или тяжелые поля, которые не нужны на клиенте.

Специализированные типы и объекты метаданных

Платформа поддерживает передачу ряда специализированных типов, описывающих структуру конфигурации. К ним относятся ОписанияТипов, ПланыВидовХарактеристик и другие метаданные.

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

Также допустима передача объектов типа ПланСчетов, ПланВидовРасчета и их ссылок. Это необходимо при разработке универсальных механизмов ввода проводок или начислений, где пользователь должен выбирать элементы из разных планов.

Нюансы передачи Фиксированных структур

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

Следует отметить, что объекты бизнес-логики, такие как Обработка или Отчет, передаются только в виде ссылок на метаданные или объектов менеджеров, но не как исполняемые модули. Вы не можете передать код программы для выполнения на клиенте.

Запрещенные типы и ограничения передачи

Существует четкий список типов, которые нельзя передавать с сервера на клиент. Попытка сделать это приведет к исключению ОшибкаСервера с сообщением о недопустимом типе значения. Понимание этого списка критически важно для архитектора системы.

В первую очередь запрещена передача потоков данных (Поток, ДвоичныеДанные в некоторых контекстах без явного чтения), соединений с внешними источниками и транзакций. Эти объекты привязаны к серверному процессу и не имеют смысла в контексте клиента.

Также нельзя передавать объекты, содержащие блокировки или активные курсоры выборки, которые не были считаны в память. Любая сущность, имеющая состояние, зависящее от серверного окружения, должна быть преобразована в нейтральные данные перед передачей.

⚠️ Внимание: Детали поддержки конкретных типов могут меняться с выходом новых версий платформы 1С. Всегда сверяйтесь с официальной документацией по вашей версии платформы, если работаете с экзотическими типами данных.

• 🚫 Потоки ввода-вывода (Stream)
• 🚫 Активные соединения с базой данных
• 🚫 Объекты блокировок данных
• 🚫 Не прочитанные объекты базы данных (без явного чтения)

Часто задаваемые вопросы (FAQ)

Можно ли передать объект "Файл" с сервера на клиент?

Напрямую объект типа Файл передать нельзя, так как он содержит путь к файловой системе сервера, которая недоступна клиенту. Однако вы можете прочитать содержимое файла в ДвоичныеДанные и передать их. На клиенте их можно сохранить в локальную папку пользователя.

Что произойдет, если передать ссылку на удаленный элемент?

Ссылка передастся успешно, так как это просто набор байтов (UUID). Однако при попытке прочитать реквизиты этого элемента на клиенте или открыть форму, возникнет ошибка, указывающая на то, что объект не найден в базе данных.

Есть ли ограничение на размер передаваемой Структуры?

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

Можно ли передать результат выполнения запроса?

Сам объект ВыборкаИзРезультатаЗапроса передать нельзя. Необходимо считать данные из выборки в ТаблицуЗначений и передать уже таблицу. Это стандартный паттерн работы с запросами в 1С.