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