Передача объектов между клиентом и сервером в 1С

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

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

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

Архитектура клиент-серверного взаимодействия

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

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

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

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

Директивы компиляции и контекст выполнения

Для управления тем, где именно будет выполняться код, в 1С используются специальные директивы компиляции. Они указывают платформе, в каком контексте должен работать модуль или конкретная функция. Основные директивы — это &НаКлиенте, &НаСервере, &НаСервереБезКонтекста и &НаКлиентеНаСервереБезКонтекста. Правильное их использование гарантирует, что объект будет создан в нужном месте.

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

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

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

Типы объектов, поддерживающие передачу

Далеко не все типы данных в 1С могут быть переданы через границу клиент-сервер. Платформа поддерживает автоматическую сериализацию для большинства примитивных типов и некоторых сложных структур. К передаваемым типам относятся: Число, Строка, Дата, Булево, Неопределено, Null.

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

Ниже приведена таблица, демонстрирующая основные типы и возможность их передачи:

Тип данных	Передача на сервер	Особенности
Примитивы (Число, Строка)	Да	Полная копия значения
ТаблицаЗначений	Да	Копируется структура и данные
Ссылка на объект ИБ	Да	Передается ссылка (уникальный идентификатор)
Объект формы	Нет	Допустима передача только реквизитов
COM-объект	Нет	Не поддерживается сериализация

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

Особенности передачи Таблицы Значений

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

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

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

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

Код заполнения и передачи таблицы часто выглядит следующим образом:

&НаКлиенте
Процедура ОтправитьДанныеНаСервер(Команда)

ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Номенклатура", СправочникСсылка.Номенклатура);
ТаблицаДанных.Колонки.Добавить("Количество", Тип("Число(15,2)"));

// Заполнение данными..

ОбработатьНаСервере(ТаблицаДанных);

КонецПроцедуры

&НаСервере
Процедура ОбработатьНаСервере(ТабДанные)

// Работа с таблицей на сервере
Для Каждого Строка Из ТабДанные Цикл
// Логика обработки
КонецЦикла;

КонецПроцедуры

Передача объектов метаданных и ссылок

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

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

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

Что происходит при передаче СправочникСсылка.ПустаяСсылка?

Пустая ссылка сериализуется корректно. На сервере это будет валидный объект типа СправочникСсылка, у которого метод Пустая() вернет Истина. Ошибок при передаче не возникает.

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

Типовые ошибки и методы отладки

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

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

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

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

Оптимизация и лучшие практики

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

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

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

Можно ли передать на сервер объект COM или внешнюю обработку?

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

Что будет, если передать на сервер пустое значение (Null)?

Значение Null (или Неопределено) передается корректно. На сервере параметр примет соответствующее значение. Это часто используется для опциональных параметров, когда действие зависит от наличия данных.

Как передать на сервер картинку или макет?

Объекты типа Картинка и Макет поддерживают сериализацию. Их можно передавать между клиентом и сервером. Однако учитывайте размер: большие изображения могут замедлить передачу. Лучше хранить их в базе данных и передавать ссылки.

В чем разница между &НаСервере и &НаСервереБезКонтекста при передаче параметров?

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