К статье
Практический материал

Другое · 7 мин

Передача массива в форму 1С через параметры формы

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

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

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

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

Параметр формы естьМассив доступен при открытии

Проверьте свойства формы и имя параметра

Параметр отсутствуетОбращение к массиву вызовет ошибку

Добавьте параметр типа Массив в форму

Тип не совпадаетНесоответствие при открытии

Приведите тип передаваемого значения к типу параметра

Способ передачи через параметры формы

Основной механизм работает одинаково для разных конфигураций: форма должна заранее иметь параметр с именем, под которым массив будет передан, и типом Массив. В коде вызова формируется структура, например Параметры = Новый Структура("Массив", МойМассив), и передаётся в ОткрытьФорму вместе с именем формы.

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

Порядок действий
  1. 1
    Создайте массив и заполните его данными
  2. 2
    Положите массив в структуру параметров под нужным именем
  3. 3
    Откройте форму, передав структуру параметров
  4. 4
    В модуле формы прочитайте Параметры.Массив
  5. 5
    Проверьте, что данные отображаются или обрабатываются корректно

Подготовка массива и открытие формы

Сначала создайте массив в вызывающем модуле, заполните его необходимыми значениями и только потом упакуйте в структуру параметров. Пример порядка действий: создание массива, заполнение, заполнение структуры, вызов ОткрытьФорму с этой структурой в качестве параметров.

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

Чтение массива в модуле формы

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

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

Обычные и управляемые формы: отличия

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

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

Типичные ошибки
01
Передача массива без описания параметра в форме приводит к ошибке при открытии
02
Ожидание автоматической записи изменений массива обратно в источник без явного возврата

Когда массив неудобен и какие есть альтернативы

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

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

Контрольные точки

Как проверить результат

Массив открыт в форме
Норма

Значения доступны через Параметры.Массив

Тревожный признак

Ошибка отсутствия параметра или пустой массив

Изменения после закрытия
Норма

Результат возвращён через параметры закрытия или записан в объект

Тревожный признак

Изменения потеряны при закрытии формы

Проверка результата и границы безопасной работы

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

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

Итог

Что важно запомнить

Массив передают через параметры формы, читают в модуле формы, проверяют тип и наличие параметра, а изменения возвращают явно.

Частые вопросы

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

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

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

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

В чём отличие обычной и управляемой формы при передаче массива?

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

Чем заменить массив, если форма требует табличного представления?

Чаще всего удобнее ТаблицаЗначений: она лучше подходит для колонок и строк, упрощает отображение и редактирование в форме, чем массив однородных значений.

Что делать, если форма не открывается с массивом?

Проверьте, что параметр формы создан, имеет тип Массив и заполнен перед вызовом ОткрытьФорму. Также убедитесь в правильности имени формы и наличии прав на открытие формы и доступ к данным.