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

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

Выбор способа зависит от задачи. Пользователю достаточно найти регистр в меню или через функцию «Все функции». Разработчику, который хочет открыть список из кнопки формы или обработки, понадобится метод ОткрытьФорму с правильным именем объекта и параметрами отбора. Ниже разобраны все варианты с примерами кода и ограничениями.

Открытие через интерфейс пользователя

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

Универсальный способ — открыть список через «Все функции». В тонком клиенте и веб-клиенте нажмите Ctrl+Shift+F (или найдите пункт «Все функции» в главном меню). В открывшемся дереве раскройте ветку «Регистры сведений» и дважды щёлкните по нужному регистру — откроется его форма списка.

Учтите: команда «Все функции» доступна только пользователям с правами администратора или при включённом режиме технического специалиста. Если пункта нет, проверьте права доступа к конкретному регистру — без права «Просмотр» форма списка не откроется даже программно.

1. 1
   Нажмите Ctrl+Shift+F или откройте «Все функции» из главного меню
2. 2
   Раскройте ветку «Регистры сведений»
3. 3
   Найдите нужный регистр и дважды щёлкните по нему
4. 4
   Проверьте, что список открылся и данные отображаются

Открытие формы списка программно

Для открытия формы из кода используется глобальный метод ОткрытьФорму. Первый параметр — полное имя формы. Для формы списка регистра сведений оно строится по шаблону РегистрСведений.ИмяРегистра.ФормаСписка.

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

Если у регистра в конфигураторе создана дополнительная форма списка с собственным именем (например, «ФормаСпискаРасширенная»), укажите её: РегистрСведений.КурсыВалют.Форма.ФормаСпискаРасширенная. Если имя формы не задано явно, платформа откроет основную форму списка, назначенную в свойствах регистра.

Метод ОткрытьФорму работает только в клиентском контексте — в клиентских процедурах форм и обработок. Вызов из серверной процедуры без контекста клиента приведёт к ошибке, потому что на сервере нет пользовательского интерфейса.

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

Частая задача — показать пользователю не весь регистр, а только записи по конкретному объекту: например, все цены одной номенклатуры или адреса одного контрагента. Для этого во второй параметр ОткрытьФорму передаётся структура с ключом «Отбор», внутри которой — ещё одна структура с именами измерений и значениями отбора.

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

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

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

Дополнительные параметры открытия

Метод ОткрытьФорму принимает до семи параметров: имя формы, параметры, владельца, уникальность, окно, навигационную ссылку и описание оповещения о закрытии. На практике чаще всего используются первые четыре.

Параметр «Владелец» связывает открываемую форму с текущей: при закрытии владельца закроется и форма списка. Параметр «Уникальность» определяет, откроется ли новая копия формы или активируется уже открытая. Если передать в уникальность, например, ссылку на объект, то повторный вызов для того же объекта не создаст дубль окна, а активирует существующее.

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

Если нужно открыть не список, а конкретную запись регистра, передайте в параметрах ключ записи: Новый Структура(\"Ключ\", КлючЗаписи) и откройте форму записи. Предварительно ключ записи формируют через менеджер регистра: РегистрыСведений.ИмяРегистра.СоздатьКлючЗаписи(СтруктураИзмерений).

Открытие в управляемом и обычном приложении

В управляемом приложении (тонкий, толстый и веб-клиент) используется описанный выше метод ОткрытьФорму. В обычном приложении, которое встречается в старых конфигурациях на платформе 8.2 и ранних 8.3, синтаксис другой: форму получают через ПолучитьФорму и затем вызывают метод Открыть.

При переходе конфигурации с обычного на управляемое приложение все вызовы ПолучитьФорму нужно переписывать на ОткрытьФорму: старый метод в управляемом режиме недоступен или ведёт себя иначе.

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

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

Как проверить результат

Для отладки программного открытия полезно временно вывести имя формы и параметры через Сообщить() перед вызовом — так видно, что именно передаётся в метод. Если форма открывается, но ведёт себя не так, проверьте, какая форма назначена основной формой списка в свойствах регистра в конфигураторе.

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