Тип: Структура. Используется для установки отбора в наборе записей. Ключ структуры - имя поля набора.
Полное описание, параметры и ограничения
Расширение формы клиентского приложения для набора записей.Отбор (Managed form extension for record set.Filter)
Расширение формы клиентского приложения для набора записей (Managed form extension for record set)
Отбор (Filter)
Доступен, начиная с версии 8.2.
Описание:
Тип: Структура.
Используется для установки отбора в наборе записей. Ключ структуры - имя поля набора.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Открыть настоящий управляемый набор по собственному ключу
Форма относится к конкретному собственному регистру, открывается с документированным параметром Отбор и работает только со своим новым UUID-ключом.
Где и как запускать
Модуль собственной внешней обработки; форма назначения — настоящий УчебныйНабор собственного регистра.
Подготовка
В отдельной учебной конфигурации создайте свой независимый непериодический регистр сведений УчебныеНаборыФормы: измерение Ключ (Строка 40, Основной отбор Истина), ресурс Количество (Число 12.2 со знаком).
Мастером создайте у этого регистра именно управляемую форму набора записей УчебныйНабор, сохранив её настоящий основной реквизит и таблицу строк. Не заменяйте её формой записи или произвольной общей формой.
В УчебныйНабор добавьте реквизиты РазрешитьЗапись и ОтменитьВТранзакции (Булево), СчетчикСобытий (Число 10.0), СтатусУрока (Строка 200), выведите их на форму. Отдельный инициализатор относится к этой форме.
В своей внешней обработке с управляемой формой создайте команду ОткрытьСвойНабор. Дополнительный блок открытия и серверной подготовки поместите только в её модуль; он создаёт свою запись и передаёт форме настоящий параметр Отбор.
Открывайте форму только этой командой. Новый UUID-ключ ограничивает набор одной собственной записью; не открывайте без отбора рабочий регистр и не подставляйте чужое имя.
&НаКлиенте
Процедура ОткрытьСвойНабор(Команда)
СвойКлюч = ПодготовитьСвойНабор();
ОтборНабора = Новый Структура("Ключ", СвойКлюч);
ПараметрыОткрытия = Новый Структура("Отбор", ОтборНабора);
ОткрытьФорму("РегистрСведений.УчебныеНаборыФормы.Форма.УчебныйНабор", ПараметрыОткрытия);
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПодготовитьСвойНабор()
СвойКлюч = Строка(Новый УникальныйИдентификатор);
Набор = РегистрыСведений.УчебныеНаборыФормы.СоздатьНаборЗаписей();
Набор.Отбор.Ключ.Установить(СвойКлюч);
Запись = Набор.Добавить();
Запись.Ключ = СвойКлюч;
Запись.Количество = 3;
Набор.Записать();
Возврат СвойКлюч;
КонецФункцииФорма УчебныйНабор: инициализация после открытия по отбору
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
РазрешитьЗапись = Ложь;
ОтменитьВТранзакции = Ложь;
СчетчикСобытий = 0;
СтатусУрока = "Свой набор открыт по уникальному ключу";
КонецПроцедурыРазбор по шагам
Создаём собственный регистр и настоящую управляемую форму набора мастером.
Отдельная обработка создаёт одну свою строку и открывает форму с нужным отбором.
Выполняем указанную команду / действие и различаем чтение, отказ до транзакции, событие внутри и событие после транзакции.
Как проверить результат
Открытая форма набора содержит одну собственную строку Количество=3 и переданный уникальный Ключ.
Отбор — структура стандартного параметра формы, не отбор динамического списка. Чужие ключи в набор не включены.
Ожидаемый результат
Метод / событие показано на собственном реально открываемом наборе с точным контекстом и ограниченным отбором.
На что обратить внимание
Запись набора с пустым отбором опасна: урок открывает только свой набор по новому уникальному Ключ.
Форма записи, форма набора записей и произвольная общая форма не имеют одинакового расширения.
Код 1С при сборке HTML не исполнялся; учебные и рабочие записи агентом не менялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.