Как показать в списке только элементы нужного владельца: способы для 1С 8.3

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

Тема общая для платформы 1С:Предприятие 8.3 и управляемых форм. Приёмы одинаково работают в 1С:Бухгалтерии 3.0, ЗУП 3.1, УТ 11 и в самописных базах. Разница только в том, какие справочники подчинены и можно ли менять конфигурацию.

Владелец справочника: что это и где отбор по нему нужен

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

Отбор по владельцу решает три практические задачи:

• 📋 Выбор из короткого списка. В документе бухгалтер выбирает договор только среди договоров своего контрагента, а не из тысячи строк.
• 🔒 Защита от ошибок. Нельзя случайно подставить договор чужого контрагента — потом это всплывает в оборотно-сальдовой ведомости как «чужие» расчёты.
• 👤 Разграничение доступа. Менеджер видит только договоры своих клиентов.

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

Что проверить в конфигурации перед настройкой

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

1. Откройте справочник в дереве конфигурации, закладку «Владельцы». В списке владельцев должен быть нужный справочник. Если владельцев несколько, реквизит Владелец будет составного типа.
2. Посмотрите свойство «Использование подчинения»: Элементам, Группам или Группам и элементам. От него зависит, у каких записей заполнен владелец.
3. Проверьте, что у старых элементов владелец заполнен. Простой запрос в консоли запросов:

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

4. Если форма списка построена на произвольном запросе, убедитесь, что поле Владелец есть в выборке. Без него отбор по полю просто не к чему применить.
5. Определите, можно ли менять конфигурацию. Если типовая на поддержке и снимать её нельзя — делайте правки в расширении (расширения доступны с платформы 8.3.6).

Способ 1. Связи параметров выбора — отбор без кода

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

Настройка в свойствах реквизита

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

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

То же самое для одного поля формы

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

Кодом это делается так:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

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

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

Фиксированный владелец: параметры выбора

Когда владелец заранее известен и не зависит от другого поля, используйте свойство «Параметры выбора» с фиксированным значением:

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

Способ 2. Отбор по владельцу программно в модулях формы

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

Передача отбора при открытии формы

Платформа понимает параметр Отбор у стандартных форм списка и выбора. Ключи структуры — имена полей, значения — то, по чему отбирать:

&НаКлиенте
Процедура ДоговорНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)

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

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

Отбор из параметра платформа ставит сама. Пользователь видит его, но значение подставлено заранее.

Отбор в динамическом списке

Если вы пишете свою форму со списком, добавьте элемент отбора при создании формы на сервере:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

    Если Не ЗначениеЗаполнено(Параметры.Владелец) Тогда
        Возврат;
    КонецЕсли;

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

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

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

В конфигурациях на БСП (а это все современные типовые) короче вызвать готовую процедуру:

ОбщегоНазначенияКлиентСервер.УстановитьЭлементОтбораДинамическогоСписка(
    Список, "Владелец", Параметры.Владелец,
    ВидСравненияКомпоновкиДанных.Равно, , Истина);

Процедура не плодит дубли: при повторном вызове она обновит существующий элемент отбора, а не добавит второй.

Владелец меняется прямо в форме

Если владельца выбирают в той же форме (поле над списком), повесьте обработчик ПриИзменении на это поле и вызовите ту же процедуру установки отбора. Использование передавайте как ЗначениеЗаполнено(Владелец): пустое поле — отбор выключен, а не «показать записи с пустым владельцем».

Отбор в запросе

В отчётах и обработках отбор по владельцу — обычное условие:

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

Слово РАЗРЕШЕННЫЕ пригодится, если в базе включены ограничения на уровне записей — о них ниже.

Способ 3. Автоматический отбор подчинённого справочника из формы владельца

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

• 🔗 Переход из карточки владельца. Если в командном интерфейсе формы контрагента есть ссылка на договоры, список откроется уже с отбором по этому контрагенту. Так устроены ссылки «Договоры», «Банковские счета», «Контактные лица» в карточке контрагента в БП 3.0.
• ✍️ Заполнение нового элемента. Если в списке стоит отбор по владельцу с видом сравнения «Равно», новый элемент, созданный из этого списка, получит владельца автоматически.
• 🧭 Добавление ссылки в карточку. В редакторе формы владельца на закладке «Командный интерфейс» включите видимость команды перехода к подчинённому справочнику. Платформа сама предложит её в панели навигации формы.

Способ 4. Ограничение доступа по владельцу (RLS)

Когда задача — не удобство, а запрет, отбор в форме не подходит. Нужен RLS — ограничение доступа к данным на уровне записей.

Как устроено

В роли для справочника задаётся условие для права «Чтение» (и при необходимости «Изменение»). Пример условия: менеджер видит договоры только тех контрагентов, у которых он указан ответственным:

ГДЕ Владелец.ОсновнойМенеджер = &ТекущийПользователь

Здесь ТекущийПользователь — параметр сеанса, а ОсновнойМенеджер — реквизит контрагента. Имена у вас будут свои: подставьте реквизиты своей конфигурации.

Порядок настройки в самописной базе

1. Создайте или откройте роль, перейдите в редактор прав.
2. Выберите справочник, право «Чтение».
3. В нижней части окна введите условие ограничения доступа к данным.
4. Проверьте, что параметр сеанса заполняется при входе пользователя (обычно в УстановкаПараметровСеанса модуля сеанса).
5. Назначьте роль пользователю и обновите конфигурацию базы данных.

Типовые конфигурации

В типовых на БСП условия RLS в роли руками не пишут. Ограничения настраивают через группы доступа. В 1С:Бухгалтерии 3.0 сначала включается флажок ограничения доступа на уровне записей в разделе Администрирование → Настройки пользователей и прав. Состав видов доступа зависит от конфигурации: в БП ограничивают в основном по организациям, в УТ 11 и ERP набор шире.

Какой способ выбрать

Связь параметров выбора и RLS часто ставят вместе: первое делает выбор удобным, второе — безопасным.

Где отбор по владельцу ломается

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

Проверяем, что отбор работает

Проверку делайте под тем пользователем, для которого настраивали отбор, а не под администратором. У полноправного пользователя RLS не действует, и тест ничего не покажет.

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

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