Как программно открыть форму списка регистра сведений в 1С

Форма списка регистра сведений открывается программно чаще всего из команд формы документа, обработки или другого регистра — например, чтобы показать пользователю записи, отобранные по конкретному измерению: контрагенту, номенклатуре, сотруднику. В управляемом приложении для этого используется глобальный метод ОткрытьФорму() или ОткрытьФормуМодально(), а имя формы строится по шаблону РегистрСведений.<ИмяРегистра>.ФормаСписка.

Ключевая сложность задачи — не сам вызов, а корректная передача отбора. Если передать отбор неправильно, форма откроется с полным списком записей или с ошибкой. Ниже разобраны оба подхода (управляемые и обычные формы), способы передачи отбора, блокировка окна владельца и проверка результата.

Базовый синтаксис в управляемом приложении

В управляемых формах (тонкий клиент, веб-клиент, такси-интерфейс) применяется глобальный метод ОткрытьФорму(). Первый параметр — строка с полным именем формы, второй — структура параметров. Минимальный вызов выглядит так:

ОткрытьФорму("РегистрСведений.ЦеныНоменклатуры.ФормаСписка");

Такой вызов откроет форму списка без отборов — пользователь увидит все записи регистра. Если у регистра создана собственная (основная) форма списка в конфигураторе, будет использована она; если нет — платформа сгенерирует форму автоматически. Задать конкретную форму можно полным путём: РегистрСведений.ЦеныНоменклатуры.Форма.МояФормаСписка.

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

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

Открытие формы с отбором по измерению

Типовой сценарий — показать записи регистра, относящиеся к объекту, из формы которого выполняется вызов. Для этого в структуру параметров добавляют ключ Отбор — тоже структуру, где имена свойств совпадают с именами измерений, ресурсов или реквизитов регистра, по которым разрешён отбор.

&НаКлиенте
Процедура ПоказатьЦены(Команда)

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

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

ОткрытьФорму("РегистрСведений.ЦеныНоменклатуры.ФормаСписка",
ПараметрыФормы, ЭтотОбъект);

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

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

Отбор по нескольким условиям и по периоду

Для периодических регистров сведений отбор по измерениям работает так же, но дополнительно можно передать параметр Отображение или управлять режимом «Срез последних» через настройки списка. Стандартный параметр Отбор принимает несколько условий — они объединяются по «И»:

Отбор = Новый Структура;
Отбор.Вставить("Организация", ТекущаяОрганизация);
Отбор.Вставить("Сотрудник",   ТекущийСотрудник);

Открытие с блокировкой окна владельца и обработкой закрытия

Когда форма списка используется как диалог выбора записи, удобно открыть её модально и получить результат. В управляемом приложении модальность реализуется через режим открытия окна и описание оповещения:

&НаКлиенте
Процедура ВыбратьЗапись(Команда)

Оповещение = Новый ОписаниеОповещения("ПослеВыбораЗаписи", ЭтотОбъект);

ОткрытьФорму("РегистрСведений.КурсыВалют.ФормаСписка", ,
ЭтотОбъект, , , , Оповещение,
РежимОткрытияОкнаФормы.БлокироватьОкноВладельца);

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

&НаКлиенте
Процедура ПослеВыбораЗаписи(Результат, ДопПараметры) Экспорт

Если Результат <> Неопределено Тогда
// обработка выбранного ключа записи
КонецЕсли;

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

Чтобы форма списка возвращала выбранную запись, в её свойствах должен быть установлен режим выбора — либо передаётся параметр РежимВыбора = Истина в структуре параметров. Без этого при нажатии на запись форма просто откроет её на редактирование, а не вернёт результат вызывающей стороне.

1. 1
   Передайте в параметрах формы РежимВыбора = Истина
2. 2
   При необходимости добавьте Отбор по измерениям
3. 3
   Укажите владельца и РежимОткрытияОкнаФормы.БлокироватьОкноВладельца
4. 4
   Передайте ОписаниеОповещения для обработки результата
5. 5
   В обработчике проверьте, что результат не Неопределено

Обычные формы: ПолучитьФормуСписка

В конфигурациях на обычных формах (режим обычного приложения) подход другой: сначала получают объект формы через менеджер регистра, затем при необходимости настраивают отбор и открывают её методом Открыть() или ОткрытьМодально().

ФормаСписка = РегистрыСведений.ЦеныНоменклатуры.ПолучитьФормуСписка();
ФормаСписка.Отбор.Номенклатура.Установить(ТекущаяНоменклатура);
ФормаСписка.Открыть();

Здесь отбор настраивается через свойство Отбор формы — оно содержит элементы по всем полям регистра. Метод Установить() одновременно задаёт значение и включает использование элемента отбора. Для модального открытия с возвратом значения используется ОткрытьМодально(), который возвращает выбранное значение после закрытия формы.

Типичные ошибки и их признаки

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

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

Как проверить, что всё работает правильно

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

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