Другое · 7 мин
Передача данных с сервера на клиент в 1С:Enterprise
Что можно передать с сервера на клиент в 1С: значения, таблицы, ссылки и объекты, способы вызовов, ограничения и проверка результата в управляемом приложении.
В клиент-серверном варианте 1С сервер выполняет обработку и доступ к данным, а клиент отвечает за взаимодействие с пользователем и отображение форм. Передача информации возможна только в рамках вызова: клиент инициирует выполнение серверной процедуры или функции, а сервер возвращает результат.
Нельзя считать, что сервер «видит» открытую клиентскую форму или может напрямую изменить её элементы. Доступный набор зависит от типа приложения, режима вызова и того, какое значение поддерживает платформа для передачи между уровнями.
Ниже разобраны, какие значения и объекты можно отправить с сервера клиенту, через какие механизмы это делается, а также где появляются ограничения и риски.
Какие значения сервер может вернуть клиенту
Сервер может вернуть примитивные значения: строку, число, дату, булево значение. Такие данные безопасно передаются между уровнями и обычно используются для результатов вычислений, признаков выполнения, сообщений и кодов состояния.
Допустимы составные значения: структуры, массивы, таблицы значений. Через них удобно возвращать наборы реквизитов, списки строк или результаты выборки. Клиент получает копию данных в том виде, в котором сервер подготовил их к возврату.
Можно передавать ссылки на объекты конфигурации: справочники, документы, перечисления и другие метаданные. Клиент получает возможность открыть объект или использовать ссылку в дальнейших запросах, но сама ссылка не даёт автоматического права на изменение.
Проверьте, что данные не содержат секретов и не слишком велики для сети.
Убедитесь, что клиент умеет обработать возвращаемую структуру и не ожидает иной формы.
Проверьте права клиента на просмотр объекта по этой ссылке.
Механизмы передачи: параметры и возвращаемые значения
Основной способ — клиент вызывает серверную функцию или процедуру и получает возвращаемое значение. Серверный код готовит данные на своей стороне, а клиент принимает результат после завершения вызова. Это подходит для выборок, расчётов и подготовки отчётов.
Данные можно передавать и в параметрах при открытии формы или запуске обработки. Сервер формирует пакет параметров, клиент получает его при старте и использует для инициализации интерфейса. Важно, что форма не может быть изменена сервером уже после открытия без нового вызова.
Общие модули с свойством вызова на сервере позволяют инкапсулировать логику подготовки данных. Клиент вызывает общий модуль, сервер выполняет его и возвращает готовый результат. Это упрощает повторное использование и разделение ответственности между уровнями.
Составные и табличные данные
Таблица значений удобна для возврата списков с колонками и строками, например номенклатуры с остатками. Клиент может вывести её в табличное поле или использовать для дальнейшей обработки. Массивы подходят для однородных наборов, структуры — для набора именованных реквизитов.
Не следует передавать избыточные объёмы: лишние колонки, строки и вложенные структуры замедляют сеть и увеличивают потребление памяти на клиенте. Отбирайте только те данные, которые реально нужны для текущей задачи.
При работе с таблицами проверяйте соответствие типов колонок и наличие ожидаемых реквизитов. Если сервер возвращает пустую таблицу вместо списка, клиент должен обрабатывать это как нормальный результат, а не как ошибку.
| Вид данных | Когда подходит | Ограничение |
|---|---|---|
| Примитив | Один результат, флаг, код | Не подходит для наборов |
| Таблица значений | Списки, отчёты, выборки | Избыточные данные замедляют передачу |
| Ссылка | Открытие объекта по идентификатору | Права проверяются отдельно |
- 1Определите, какие данные нужны клиенту
- 2Выберите способ передачи: возвращаемое значение, параметр формы или общий модуль
- 3Подготовьте данные на сервере и верните результат
- 4Проверьте результат на клиенте и права доступа
Ссылки, объекты и файлы
Ссылки на справочники и документы передаются легко и часто используются для навигации. Клиент получает идентификатор объекта, а не салю объект целиком, что снижает объём передачи. Открытие объекта по ссылке выполняется отдельным действием клиента.
Объекты конфигурации и файлы требуют осторожности. Не все типы объектов удобно возвращать напрямую; иногда лучше передать ссылку или идентификатор, а клиент сам запросит нужные реквизиты. Файлы могут передаваться через временное хранилище или отдельные механизмы выгрузки, в зависимости от конфигурации.
Если сервер возвращает объект, клиент получает доступ к его реквизитам в рамках текущего контекста. Изменения, сделанные клиентом, не применяются автоматически на сервере: для записи нужен отдельный серверный вызов с проверкой прав.
Ограничения, безопасность и проверка результата
Сервер не может напрямую управлять элементами клиентской формы: менять видимость полей, устанавливать фокус или выводить сообщения без нового вызова. Все взаимодействие клиент инициирует сам, а сервер только отвечает.
Безопасность обеспечивается на сервере: проверка прав, валидация данных и запрет на передачу конфиденциальной информации. Клиент может быть недоверчивой средой, поэтому нельзя полагаться на проверки, выполненные только на стороне пользователя.
После получения данных клиент должен проверять наличие ошибок, пустоту результата и соответствие ожидаемой структуре. Если сервер вернул исключение, клиент видит сообщение об ошибке и должен обработать его без прерывания работы сеанса.
Типичные ошибки и альтернативы
Частая ошибка — попытка вернуть слишком большой объект или всю таблицу базы, когда достаточно ссылки или отфильтрованного набора. Это приводит к задержкам и превышению ресурсов клиента. Альтернатива: передавать идентификатор и запрашивать детали по требованию.
Другая ошибка — считать, что данные, полученные с сервера, уже актуальны в момент отображения. Между получением и использованием значения данные могли измениться другими пользователями. Проверку актуальности лучше выполнять непосредственно перед записью.
Если обычный возврат значения не подходит, можно использовать фоновые задания, регулярную проверку состояния или отдельные сервисы обмена данными. Выбор зависит от того, нужен ли ответ немедленно или допустима задержка.
Что важно запомнить
С сервера на клиент передаются значения, ссылки и таблицы через вызовы и параметры; прямая работа с формой с сервера невозможна, а права и секреты остаются под контролем сервера.
Может ли сервер изменить открытую форму клиента без нового вызова?
Нет. Сервер может только вернуть данные или результат вызова, а клиент сам решает, как обновить форму. Для изменения элементов формы нужно выполнить повторный клиентский вызов с использованием полученных данных.
Какие данные не стоит передавать с сервера на клиент?
Не стоит передавать пароли, ключи доступа, сеансовые токены и другую конфиденциальную информацию. Такие данные должны оставаться на сервере, а клиент должен получать только результаты проверок и разрешенные реквизиты.
Что делать, если сервер вернул пустую таблицу вместо ожидаемого списка?
Пустая таблица может быть нормальным результатом, если данных нет. Клиент должен обрабатывать это состояние без ошибки, показывая пользователю сообщение об отсутствии записей, а не прерывая работу.
Нужно ли проверять права доступа на клиенте после получения ссылки?
Права проверяются на сервере. Клиент может получить ссылку, но при попытке открыть или изменить объект сервер снова проверит разрешения и может вернуть ошибку доступа.
Может ли сервер отправить данные клиенту без инициативы клиента?
В обычном клиент-серверном взаимодействии клиент инициирует вызов, а сервер отвечает. Несанкционированная отправка без запроса клиента не является стандартным механизмом передачи данных.