Как передать параметры в форму 1С: практическое руководство

Передача параметров в форму — одна из базовых задач при разработке на платформе 1С:Предприятие 8. Параметры нужны, чтобы открыть форму списка с отбором, создать новый элемент с предзаполненными реквизитами, открыть произвольную форму с настройками или заблокировать форму от изменений. Механизм единый: вы формируете структуру с именами и значениями, передаёте её в метод открытия формы, а на стороне формы читаете значения через свойство Параметры.

Работает это одинаково в управляемых и обычных формах, но в управляемом приложении есть особенности: форма создаётся на сервере, обработка параметров выполняется в обработчике ПриСозданииНаСервере, а часть параметров платформа обрабатывает сама, без вашего кода. Понимание того, какие параметры стандартные, а какие произвольные, избавляет от типовых ошибок вроде «параметр передал, а форма его не видит».

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

Общий принцип передачи параметров

Механизм построен на трёх шагах. Сначала в вызывающем коде создаётся структура: ключи — строковые имена параметров, значения — любые сериализуемые данные (примитивы, ссылки, структуры, массивы). Затем эта структура передаётся в метод ОткрытьФорму, ПолучитьФорму или ОткрытьФормуМодально. Наконец, в модуле открываемой формы значения читаются через Параметры.ИмяПараметра.

Важно понимать, что параметры существуют только в момент создания формы. После того как обработчик ПриСозданииНаСервере отработал, обратиться к структуре параметров нельзя — если значение нужно позже, сохраните его в реквизит формы. Это одна из самых частых причин «потери» переданных данных у начинающих разработчиков.

// Код, открывающий форму
ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Организация", ТекущаяОрганизация);
ПараметрыФормы.Вставить("ДатаНачала", НачалоМесяца(ТекущаяДатаСеанса()));

ОткрытьФорму("Обработка.ВыгрузкаДанных.Форма.ФормаНастроек", ПараметрыФормы, ЭтотОбъект);

Чтение параметров внутри формы

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

Перед обращением к параметру проверяйте его наличие методом Параметры.Свойство("Имя", Значение). Если форма открывается из разных мест программы и не все вызовы передают одинаковый набор параметров, прямое обращение Параметры.Имя к отсутствующему ключу вызовет ошибку.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

	Организация = Неопределено;
	Если Параметры.Свойство("Организация", Организация) Тогда
		ЭтотОбъект.ОрганизацияОтбор = Организация;
	КонецЕсли;

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

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

Стандартные параметры форм объектов и списков

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

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

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Отбор", Новый Структура("Владелец", КонтрагентСсылка));

ОткрытьФорму("Справочник.ДоговорыКонтрагентов.ФормаСписка", ПараметрыФормы);

Аналогично работает создание нового элемента с предзаполнением: параметр ЗначенияЗаполнения принимает структуру, где ключи — имена реквизитов объекта. Платформа подставит их при создании, а обработчик ОбработкаЗаполнения в модуле объекта получит эти данные как источник заполнения.

Открытие формы с отбором и предзаполнением: пошагово

Наиболее востребованные сценарии — отбор списка и создание объекта с заполненными реквизитами. Оба реализуются стандартными параметрами, и последовательность действий почти одинакова.

1. 1
   Определите полное имя формы: ИмяОбъектаМетаданных + точка + имя формы, например Справочник.Номенклатура.Форма.ФормаСписка
2. 2
   Создайте структуру и добавьте стандартный параметр Отбор или ЗначенияЗаполнения с нужными значениями
3. 3
   Вызовите ОткрытьФорму, передав имя формы, структуру параметров и при необходимости владельца формы
4. 4
   Откройте форму в режиме предприятия и проверьте, что отбор применён или реквизиты заполнены

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

Произвольные параметры и возврат результата

Когда стандартных параметров не хватает, форма принимает любые произвольные. Например, форма настройки отчёта может получить имя схемы компоновки, признак «только просмотр» или массив ссылок для обработки. Ограничение одно: значения должны быть сериализуемы — нельзя передать, например, объект типа Запрос или таблицу значений напрямую без помещения во временное хранилище.

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

Если форма должна вернуть результат (например, форма выбора периода), открывайте её с описанием оповещения: ОткрытьФорму(..., ОписаниеОповещения), а в форме-источнике обработайте результат в процедуре, указанной в оповещении. Форма возвращает значение методом Закрыть(Результат).

Типичные ошибки и их устранение

Большинство проблем с параметрами форм сводится к нескольким повторяющимся ситуациям. Их легко диагностировать, если знать, где искать.

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

Ограничения и безопасная работа с параметрами

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

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

FAQ: частые вопросы о передаче параметров в форму 1С