Как установить отбор по владельцу в 1С

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

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

Что такое владелец в 1С и где используется отбор по нему

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

Типовые примеры из стандартных конфигураций: «Договоры контрагентов» подчинены «Контрагентам», «Банковские счета» — «Организациям» и «Контрагентам», «Единицы измерения» — «Номенклатуре», «Спецификации» — «Номенклатуре». Во всех этих случаях показ полного списка без отбора по владельцу делает работу неудобной и чреват ошибками выбора.

Отбор по владельцу при открытии формы списка

Самый простой способ — передать отбор через параметры при программном открытии формы списка. Это не требует изменения самой формы и работает в управляемых формах любой конфигурации. Параметр «Отбор» принимает структуру, где ключ — имя поля, а значение — искомая ссылка.

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

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

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

Программная установка отбора в модуле формы списка

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Параметры.Свойство("ВладелецДляОтбора") Тогда
ЭлементОтбора = Список.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Владелец");
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
ЭлементОтбора.ПравоеЗначение = Параметры.ВладелецДляОтбора;
ЭлементОтбора.Использование = Истина;
ЭлементОтбора.РежимОтображения = РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Недоступный;
КонецЕсли;
КонецПроцедуры

Режим отображения «Недоступный» скрывает отбор из настроек пользователя — он не сможет его случайно отключить. Если нужно, чтобы пользователь мог менять владельца сам, используйте «БыстрыйДоступ» или «Обычный».

1. 1
   Определите, где нужен отбор: при открытии формы, внутри модуля формы или в запросе
2. 2
   Для открытия формы передайте структуру Отбор с ключом «Владелец» в параметрах формы
3. 3
   Для отбора в модуле формы добавьте ЭлементОтбораКомпоновкиДанных в Список.Отбор
4. 4
   Установите ВидСравнения «Равно» и правое значение — ссылку на владельца
5. 5
   Проверьте результат: в списке должны остаться только элементы выбранного владельца

Отбор по владельцу в форме выбора и поле ввода

Когда пользователь выбирает подчинённый элемент в документе — например, договор в поле «Договор» после выбора контрагента — отбор обычно настраивается через связь параметров выбора. В конфигураторе у поля ввода есть свойство «СвязиПараметровВыбора», где задаётся связь: «Отбор.Владелец» ← «Объект.Контрагент».

Программно то же самое делается добавлением связи в коллекцию СвязиПараметровВыбора элемента формы:

НоваяСвязь = Новый СвязьПараметраВыбора("Отбор.Владелец", "Объект.Контрагент");
Элементы.Договор.СвязиПараметровВыбора.Добавить(НоваяСвязь);

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

Отбор по владельцу в запросах и отчётах

В запросах отбор по владельцу задаётся через параметр виртуальной таблицы или условие ГДЕ. Для справочников оба варианта корректны, но условие в секции ГДЕ читается проще:

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

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

Запрос = Новый Запрос("ВЫБРАТЬ Ссылка ИЗ Справочник.ДоговорыКонтрагентов ГДЕ Владелец = &Владелец"); Запрос.УстановитьПараметр("Владелец", КонтрагентСсылка); Результат = Запрос.Выполнить().Выгрузить();

Проверка результата и типичные ошибки

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

Когда отбор по владельцу не сработает: ограничения

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

Во внешних обработках и расширениях учитывайте, что в разных конфигурациях имена справочников могут отличаться (например, «ДоговорыКонтрагентов» в одной конфигурации и «Договоры» в другой). Перед внедрением кода проверьте фактические имена объектов в конфигураторе конкретной базы.

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

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