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

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

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

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

Архитектура передачи данных и механизм сериализации

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

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

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

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

Примитивные и простые типы данных

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

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

Ниже приведен перечень базовых типов, которые можно использовать без опасений:

• 🔢 Число (любой разрядности и точности)
• 📅 Дата и Время (включая пустые даты)
• ✅ Булево (Истина/Ложь)
• 📝 Строка (любой длины, но с учетом сетевых задержек)
• ❌ Неопределено (Null)

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

Сложные типы значений и коллекции

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

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

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

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

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

Ссылочные типы и объекты базы данных

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

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

К передаваемым ссылочным типам относятся:

• 📎 Ссылка на объект справочника или документа
• 👤 Ссылка на объект плана видов характеристик
• 📂 Ссылка на объект плана счетов или видов расчетов
• 🗂 Уникальный идентификатор (UUID)

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

Специальные типы и исключения

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

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

Некоторые типы доступны только в определенном контексте. Например, объекты работы с криптографией или специфические системные объекты могут быть недоступны в веб-клиенте. В таблице ниже приведены особенности передачи специальных типов:

Тип данных	Возможность передачи	Особенности
ДвоичныеДанные	Да	Высокий трафик, риск таймаутов
Файл	Нет (как объект)	Можно передавать только имя/путь
ЗащищенноеСоединениеOpenSSL	Нет	Только в контексте создания
HTTPСоединение	Нет	Создается заново на сервере

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

Запрещенные типы и объекты контекста

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

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

⚠️ Внимание: Объекты метаданных (описание справочников, документов) передаются только в виде имен или ссылок, но не как объекты описания в чистом виде в некоторых контекстах веб-клиента.

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

Почему нельзя передавать объекты форм?

Объекты форм содержат ссылки на графические элементы операционной системы (окна, кнопки). Сервер 1С работает в фоновом режиме без графического интерфейса и не может интерпретировать эти ссылки, что вызывает исключение сериализации.

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

Можно ли передавать объекты запросов между клиентом и сервером?

Сам объект Запрос передавать можно, но это не имеет смысла, так как выполнение запроса происходит на стороне базы данных. Обычно на сервер передается текст запроса или параметры для него, а результат (выборка) обрабатывается там же. Передача объекта запроса возможна, но избыточна.

Что делать, если нужно передать большой объем данных из таблицы значений?

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

Почему возникает ошибка "Сериализация типа.. не поддерживается"?

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

Передаются ли объекты планов обмена?

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