Паттерны работы с БСП (вход, профили доступа, допреквизиты)

Рекомендация

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

1. Управление входом пользователей

ВходВПрограммуРазрешен в БСП — не реквизит, который пишется в регистр, а вычисляемое OR всех auth-флагов ПользователяИБ (Стандартная, OpenID, OpenIDConnect, ТокеномДоступа, ОС). Управлять входом — через запись СправочникОбъект.Пользователи с заполненным ДополнительныеСвойства.ОписаниеПользователяИБ (см. Catalogs/Пользователи/ObjectModule.bsl). Прямая запись регистра СведенияОПользователях не работает / разваливается через время. Нельзя пометить Недействителен = Истина пользователя с разрешённым входом — платформа бросит исключение.

// Прямая запись «флага» в регистр: БСП пересчитает его из auth-флагов,
// изменение потеряется.
НаборЗаписей = РегистрыСведений.СведенияОПользователях.СоздатьНаборЗаписей();
// ... ВходВПрограммуРазрешен = Ложь
НаборЗаписей.Записать();

// Документированный программный интерфейс объекта Пользователи
// (состав структуры — см. Catalogs/Пользователи/ObjectModule.bsl вашей версии БСП).
ПользовательОбъект = Пользователь.ПолучитьОбъект();
ОписаниеИБ = Новый Структура;
ОписаниеИБ.Вставить("Действие", "Записать");
ОписаниеИБ.Вставить("МожноВходить", Ложь);
ПользовательОбъект.ДополнительныеСвойства.Вставить(
    "ОписаниеПользователяИБ", ОписаниеИБ);
ПользовательОбъект.Записать(); // БСП сама сохранит прежние auth-флаги

2. Профили групп доступа пользователя

Получая профили, через которые у пользователя есть доступ, нельзя выбирать только из табчасти ГруппыДоступа.Пользователи: персональные группы доступа хранят пользователя в реквизите шапки Пользователь. Брать оба источника одним пакетным запросом; «административными» считать профили с ролями ПолныеПрава / АдминистраторСистемы.

3. Значение допреквизита одним пакетным запросом

Допреквизит БСП («Свойства») вытаскивать одним пакетным запросом по имени свойства, без обхода в цикле и без разыменования ссылочного поля Свойство через точку. Решение — JOIN с ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения по полю Свойство и фильтр по Наименование.

// Обход объектов в цикле + разыменование через точку:
// N неявных запросов и предупреждение линтера QueryNestedFieldsByDot.
Для Каждого Сотрудник Из Сотрудники Цикл
    Для Каждого Строка Из Сотрудник.ПолучитьОбъект().ДополнительныеРеквизиты Цикл
        Если Строка.Свойство.Наименование = "Должность" Тогда
            Должность = Строка.Значение;
        КонецЕсли;
    КонецЦикла;
КонецЦикла;

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

Зачем

Модель данных БСП здесь контринтуитивна: прямые записи в регистры и выборки «в лоб» дают код, который проходит тесты, но ломается на проде или теряет часть связей.

Когда не применять

В конфигурациях без БСП (самописные) этих подсистем нет — правила неприменимы. В старых версиях БСП состав структур может отличаться — сверяйтесь с ObjectModule.bsl своей версии, а не копируйте примеры вслепую.

См. также

Секреты в безопасном хранилище; техпользователь с минимальными правами