Другое · 8 мин
Передача массива с клиента на сервер в 1С
Как передать массив с клиента на сервер в 1С: варианты вызова, проверка результата, ограничения и типичные ошибки разработчиков для типовых конфигураций
Передача массива с клиента на сервер в 1С используется, когда клиентская форма собирает данные и отправляет их на серверную процедуру для обработки, записи или расчёта. Массив может содержать значения, структуры, таблицы значений или ссылки на объекты, но не все типы одинаково подходят для удалённого вызова.
Основной способ — вызвать серверную процедуру с параметром типа Массив из клиентского кода, предварительно поместив в процедуру директиву &НаСервере. Сервер получает копию переданных данных и работает с ними в своём контексте.
Задача возникает в типовых ситуациях: отправка выбранных строк из табличной части, пакетная обработка документов, передача набора идентификаторов для отбора или подготовка данных к записи в регистры. Клиент отвечает за сбор и валидацию вводимой информации, сервер — за защиту целостности и выполнение бизнес-логики.
Не стоит передавать массив просто ради удобства, если достаточно одного значения или ссылки на объект. Лишние данные увеличивают сетевой трафик, нагрузку на сервер и усложняют отладку, особенно при работе через тонкий клиент или веб-клиент.
Убедитесь, что процедура доступна на сервере и принимает массив
Проверьте, можно ли получить массив напрямую на сервере.
Уберите ссылки на клиентские объекты перед отправкой
Когда передача массива с клиента на сервер нужна
Передача оправдана, когда пользователь на форме отмечает несколько элементов, а затем запускает одно серверное действие над всем набором. Например, провести выделенные документы, рассчитать скидки по списку контрагентов или экспортировать отмеченные номенклатуры.
Если массив используется только для отображения на клиенте, отправлять его на сервер не обязательно. Сервер должен получать массив только тогда, когда без него невозможно выполнить защищённое или централизованное действие.
Клиентский сценарий сбора данных
На клиенте массив обычно заполняется в обработчике события формы, например при нажатии кнопки. Перед вызовом сервера целесообразно проверить, что массив не пуст, не содержит дубликатов и не превышает разумный объём для передачи.
Серверный сценарий обработки
На сервере массив принимается в параметре процедуры и обходит циклом. Каждый элемент может быть проверен на соответствие допустимым значениям, после чего выполняется запись, расчёт или отбор. Результат возвращается клиенту отдельным значением или структурой.
Способы передачи массива в 1С
Чаще всего используется прямой вызов серверной процедуры с параметром типа Массив. Это подходит для большинства типовых конфигураций и не требует дополнительных объектов обмена данными.
Альтернативой может быть запись массива в временное хранилище или регистр с последующим чтением на сервере, но такой подход усложняет схему и подходит для долговременных или распределённых задач, а не для одной передачи.
- 1Создайте и заполните массив на клиенте
- 2Вызовите серверную процедуру, передав массив параметром
- 3На сервере обойдите массив и выполните нужную обработку
- 4Верните клиенту результат или признак успешного выполнения
Прямой вызов проще отлаживать, так как стек вызовов остаётся понятным, а ошибки проще локализовать. Временные хранилища оправданы, если данные должны остаться доступными после завершения сеанса или использоваться несколькими процедурами.
При выборе способа учитывайте архитектуру конфигурации, режим работы клиента и требования к безопасности. Не передавайте через массив секретные данные без дополнительной проверки прав доступа на сервере.
Пример вызова серверной процедуры с массивом
На клиенте создаётся массив, заполняется нужными значениями и передаётся в процедуру. Процедура на сервере помечена директивой &НаСервере и принимает параметр Массив.
&НаКлиенте
Процедура ОтправитьНаСервер(Команда)
Массив = Новый Массив;
Массив.Добавить("Значение1");
Массив.Добавить("Значение2");
Результат = ЭтотОбъект.ОбработатьМассивНаСервере(Массив);
Сообщить(Результат);
КонецПроцедуры
&НаСервере
Функция ОбработатьМассивНаСервере(Массив) Экспорт
Для Каждого Элемент Из Массив Цикл
// обработка элемента
КонецЦикла;
Возврат "Обработано";
КонецФункции
&НаКлиенте
Массив = Новый Массив;
...
СервернаяПроцедура(Массив);
&НаСервере
Процедура СервернаяПроцедура(Массив) Экспорт
...
КонецПроцедурыВ примере клиент не ждёт завершения каждой итерации отдельно, а получает итоговый результат после обработки всего массива. Это снижает количество вызовов между клиентом и сервером.
Если массив большой, целесообразно ограничить количество элементов и предупредить пользователя о возможной задержке. Серверная обработка больших объёмов может занять время и повлиять на отзывчивость интерфейса.
Проверка результата и ограничения
После вызова сервера клиент должен проверить возвращаемое значение, признак успеха или сообщение об ошибке. Если сервер вернул неопределённое значение или пустую структуру, это может означать, что массив не был передан или обработка прервана.
Ограничения касаются состава массива: ссылки на формы, элементы управления или клиентские объекты некорректно передаются на сервер. Также не следует полагаться на состояние клиентского интерфейса внутри серверной процедуры.
Безопасная самостоятельная работа возможна при типовых типах данных: числа, строки, даты, перечисления, структуры без клиентских ссылок. При работе с документами, справочниками или регистрами проверяйте права доступа и правила блокировок на сервере.
Не изменяйте массив на клиенте после вызова сервера, если ожидаете обратной связи по тем же данным. Сервер работает со своей копией, и изменения на клиенте не будут отражены автоматически.
Типичные ошибки и как их избежать
Одна из частых ошибок — вызов клиентской процедуры вместо серверной, из-за чего массив обрабатывается неправильно или не уходит с клиента вообще. Проверьте директиву &НаСервере и доступность процедуры в нужном контексте.
Другая ошибка — передача пустого или неинициализированного массива. Сервер может обработать его без ошибки, но не выполнит ожидаемых действий, что трудно обнаружить без протоколирования.
Чтобы избежать проблем, добавляйте простую проверку на пустоту массива перед вызовом и фиксируйте результат серверной функции. Если результат не соответствует ожидаемому, выводите сообщение пользователю и отменяйте дальнейшие действия.
При повторных вызовах следите за тем, чтобы один и тот же массив не обрабатывался дважды. Это важно для документов, проводок и операций, изменяющих остатки или реквизиты объектов.
Альтернативы и выбор подходящего варианта
Если нужно передать не просто набор значений, а структурированный набор с реквизитами, удобнее использовать таблицу значений или массив структур. Они сохраняют связь между полями и упрощают серверную обработку.
Для разовых расчётов подходит массив, для постоянного обмена данными между сессиями — регистры или временные таблицы, для сложных объектов — ссылки с последующей выборкой на сервере.
Что важно запомнить
Массив передаётся параметром серверной процедуры с &НаСервере, без ссылок на клиентские объекты, с проверкой результата и разумным объёмом данных.
Нужно ли помечать процедуру &НаСервере?
Да, если процедура должна выполняться на сервере и принимать массив, переданный из клиентского кода. Без этой директивы вызов может остаться клиентским или не сработать в ожидаемом контексте.
Можно ли передать массив со ссылками на документы?
Можно передавать ссылки на серверные объекты, но ссылки на формы, элементы управления или клиентские окна не подходят. Перед отправкой убедитесь, что все элементы массива корректны на сервере.
Что делать, если сервер не обработал массив?
Проверьте возвращаемое значение, наличие ошибок в сеансе и состав переданного массива. Убедитесь, что массив не пуст и процедура доступна на сервере в текущем режиме работы.
Есть ли ограничение на размер массива?
Жёсткого универсального лимита указывать нельзя, но большие массивы увеличивают нагрузку и время выполнения. Для больших объёмов лучше разбивать передачу или использовать серверные отборы вместо передачи всего набора с клиента.