1С:Предприятие 8
Система программ

Есть форма, содержащая динамический список с произвольным запросом. Как при открытии формы установить нужные параметры в этом запросе?

25.06.2012

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

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

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

ВЫБРАТЬ
   РегистрСведенийЦеныТоваров.Период,
   РегистрСведенийЦеныТоваров.Товар,
   РегистрСведенийЦеныТоваров.Цена
ИЗ
   РегистрСведений.ЦеныТоваров КАК РегистрСведенийЦеныТоваров
ГДЕ
   РегистрСведенийЦеныТоваров.Товар = &Товар
   И РегистрСведенийЦеныТоваров.Период >= &НачалоПериода
   И РегистрСведенийЦеныТоваров.Период <= &КонецПериода 

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

Чтобы передать собственные параметры в форму, желательно создать их в редакторе формы.

Вообще говоря, делать это не обязательно. Любые параметры, переданные в функцию ОткрытьФорму(), будут доступны в обработчике события формы ПриСозданииНаСервере. Но все же лучше создать их у формы в явном виде.

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

Итак, создадим у формы списка регистра сведений три параметра: НачалоПериодаКонецПериода (тип Дата) и Товар (тип СправочникСсылка.Товары).

Теперь в форме элемента справочника Товары создадим команду ЦеныВДекабре со следующим текстом:

ПараметрыФормы = Новый Структура("НачалоПериода, КонецПериода, Товар", '20121201000000', '20121231235959', Объект.Ссылка);
ОткрытьФорму("РегистрСведений.ЦеныТоваров.Форма.ФормаСписка", ПараметрыФормы); 

Этой командой мы открываем форму списка регистра сведений и передаем ей значения трех параметров.

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
   Список.Параметры.УстановитьЗначениеПараметра("НачалоПериода", Параметры.НачалоПериода);
   Список.Параметры.УстановитьЗначениеПараметра("КонецПериода",  Параметры.КонецПериода);
   Список.Параметры.УстановитьЗначениеПараметра("Товар",         Параметры.Товар);
КонецПроцедуры