Что можно передавать с клиента на сервер в 1С

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

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

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

Основные принципы разграничения контекстов

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

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

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

⚠️ Внимание: Некоторые методы глобального контекста имеют одинаковые имена, но разную реализацию или доступность. Всегда проверяйте документацию по конкретному методу перед использованием в кросс-контекстном вызове.

Типы данных, поддерживающие передачу

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

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

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

• 🔢 Примитивные типы: Число, Строка, Дата, Булево, Null.
• 📦 Контейнеры данных: Массив, Структура, Фиксированная структура, Таблица значений.
• 🔗 Ссылки и объекты: Ссылки на объекты метаданных, Планы видов характеристик.

Исключения и ограничения при передаче

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

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

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

⚠️ Внимание: Не пытайтесь передавать объекты типа HTTPСоединение или FTPСоединение. Сетевые соединения привязаны к конкретному потоку выполнения и не подлежат сериализации для передачи между узлами.

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

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

Механизм передачи параметров в вызовах

При вызове серверной процедуры из клиента параметры передаются по значению. Это означает, что если вы передадите переменную типа Число и измените её внутри серверной процедуры, исходная переменная на клиенте не изменится. Для получения результата необходимо использовать возвращаемое значение функции или передавать изменяемые контейнеры, такие как Структура или Массив.

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

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

Тип данных	Способ передачи	Особенности
Число, Строка	По значению	Копирование быстрое, изменения не влияют на оригинал
Таблица значений	Глубокое копирование	Требует ресурсов памяти, возвращать нужно явно
Ссылка на объект	По ссылке (UID)	Передается идентификатор, данные подгружаются на сервере
Элемент формы	Запрещено	Вызывает ошибку выполнения

Работа с глобальным контекстом и утилитами

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

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

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

⚠️ Внимание: Функции работы с криптографией могут требовать наличия установленных сертификатов как на клиенте, так и на сервере. Убедитесь, что необходимые ключи доступа присутствуют в хранилище сервера перед вызовом методов шифрования.

Оптимизация и безопасность передачи

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

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

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

Как уменьшить размер передаваемых данных?

Используйте тип "Список значений" вместо "Таблица значений", если вам нужен только один колонка. Также отключайте лишние колонки в запросе перед помещением данных в таблицу.

Частые ошибки и способы их решения

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

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

Третья ошибка связана с типизацией. Попытка передать Неопределено в параметр, который ожидает конкретный тип, может вызвать ошибку в строго типизированных сценариях. Всегда проверяйте значения перед передачей и используйте обработку исключений Попытка...Исключение для graceful degradation.

Можно ли передать объект формы на сервер для чтения свойств?

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

Как передать большой файл с клиента на сервер?

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

Влияет ли версия платформы на список передаваемых типов?

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

Что делать, если при передаче возникает ошибка "Слишком большой объем данных"?

Необходимо разбить данные на части (пакетная передача) или пересмотреть архитектуру, перенеся формирование данных полностью на сервер, передав лишь критерии отбора.