Получить пользователя БСП в 1С: АвторизованныйПользователь и ТекущийПользователь

Пользователи.АвторизованныйПользователь — универсальный способ

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

// Общий модуль Пользователи (сервер)
Пользователь = Пользователи.АвторизованныйПользователь();

// Ссылка пригодна для отбора, реквизита документа, записи регистра
НоваяЗапись = РегистрыСведений.ИсторияДействий.СоздатьМенеджерЗаписи();
НоваяЗапись.Пользователь = Пользователь;
НоваяЗапись.Момент       = ТекущаяДатаСеанса();
НоваяЗапись.Записать();

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

Значение берётся не из базы напрямую, а из параметров сеанса: если заполнен ПараметрыСеанса.ТекущийПользователь, возвращается он, иначе — ПараметрыСеанса.ТекущийВнешнийПользователь. Отсюда два следствия: вызов дешёвый (обращения к справочнику при каждом вызове нет) и он недоступен в сеансе без разделителей в модели сервиса — там функция вызовет исключение.

Пользователи.ТекущийПользователь — только справочник Пользователи

Вторая функция — обёртка над первой с жёсткой проверкой типа. Она возвращает ровно СправочникСсылка.Пользователи и предназначена для кода, который не поддерживает работу с внешними пользователями.

// Внутри реализации БСП:
// Возврат ПользователиСлужебныйКлиентСервер.ТекущийПользователь(АвторизованныйПользователь());
//
// Если ТипЗнч(АвторизованныйПользователь) <> Тип("СправочникСсылка.Пользователи") Тогда
//     ВызватьИсключение(ТекстОшибки, КатегорияОшибки.ОшибкаКонфигурации);
// КонецЕсли;

Автор = Пользователи.ТекущийПользователь();

Документ = Документы.ЗаказКлиента.СоздатьДокумент();
Документ.Ответственный = Автор;   // реквизит типа СправочникСсылка.Пользователи

Текст исключения — «Невозможно получить текущего пользователя в сеансе внешнего пользователя». Это именно ошибка конфигурации, а не ошибка данных: платформа сообщает, что код вызван там, где он не рассчитан работать. Гасить её через Попытка не нужно — нужно либо перейти на АвторизованныйПользователь(), либо заранее отсечь сеанс внешнего пользователя.

В чём разница между АвторизованныйПользователь и ТекущийПользователь

Разница ровно в одном — в допустимом типе результата и в поведении, когда вход в сеанс выполнил внешний пользователь:

• АвторизованныйПользователь() — возвращает ссылку на Пользователи или на ВнешниеПользователи. Исключений по типу не бросает.
• ТекущийПользователь() — возвращает ссылку только на Пользователи. В сеансе внешнего пользователя вызывает исключение.

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

Проверить вид сеанса до вызова помогает третья функция того же модуля:

Если Пользователи.ЭтоСеансВнешнегоПользователя() Тогда
    Автор      = ВнешниеПользователи.ТекущийВнешнийПользователь();
    Контрагент = ВнешниеПользователи.ПолучитьОбъектАвторизацииВнешнегоПользователя();
Иначе
    Автор      = Пользователи.ТекущийПользователь();
КонецЕсли;

Справочник Пользователи и пользователь информационной базы

БСП разводит два объекта: элемент справочника Пользователи (прикладной пользователь, к нему привязаны настройки, права, история) и ПользовательИнформационнойБазы (учётная запись платформы с именем, аутентификацией и ролями). Связь между ними — реквизит справочника ИдентификаторПользователяИБ. Ходить по нему руками не нужно, есть штатные функции.

// Ссылка справочника -> учётная запись платформы
ПользовательИБ = Пользователи.НайтиПоСсылке(Пользователи.АвторизованныйПользователь());

Если ПользовательИБ <> Неопределено Тогда
    ИмяДляВхода = ПользовательИБ.Имя;
    ПолноеИмя   = ПользовательИБ.ПолноеИмя;
КонецЕсли;

// Учётная запись платформы -> ссылка справочника
Пользователь = Пользователи.НайтиПоИмени("Иванов");
Пользователь = Пользователи.НайтиПоИдентификатору(
    ПользователиИнформационнойБазы.ТекущийПользователь().УникальныйИдентификатор);

У НайтиПоСсылке() есть ограничение из описания функции: для поиска требуются административные права, без них допустимо искать учётную запись только для текущего пользователя ИБ. НайтиПоИмени() ведёт себя мягче и различает два «нет»: Неопределено — пользователя ИБ с таким именем не существует; пустая ссылка Справочники.Пользователи.ПустаяСсылка() — учётная запись есть, но с элементом справочника она не сопоставлена.

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

Свойства = Пользователи.СвойстваПользователяИБ("Иванов");

Если Свойства <> Неопределено Тогда
    Сообщить(Свойства.ПолноеИмя);
    Сообщить(Строка(Свойства.АутентификацияСтандартная));
КонецЕсли;

Функция запрещена в безопасном режиме: внутри стоит явная проверка ПроверитьБезопасныйРежимОтключен. Такое же ограничение действует у НайтиПоИмени(), НайтиПоИдентификатору() и НайтиПоСсылке() — из кода расширения в безопасном режиме они не отработают.

Как проверить права и роли пользователя средствами БСП

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

// Полные права у текущего пользователя
Если Пользователи.ЭтоПолноправныйПользователь() Тогда
    // ...
КонецЕсли;

// Права администрирования системы у конкретного пользователя,
// привилегированный режим не учитываем
ЭтоАдмин = Пользователи.ЭтоПолноправныйПользователь(СсылкаПользователя, Истина, Ложь);

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

Если Пользователи.РолиДоступны("ДобавлениеИзменениеЗаказовКлиентов, ПроведениеДокументов") Тогда
    // ...
КонецЕсли;

// Проверка ролей другого пользователя
ЕстьДоступ = Пользователи.РолиДоступны("ЧтениеОтчетовПоПродажам", СсылкаПользователя);

Важная деталь из описания функции: она возвращает Истина не только когда доступна одна из указанных ролей, но и когда ЭтоПолноправныйПользователь() для этого пользователя даёт Истина. Поэтому для администратора любая проверка ролей пройдёт — на этом ломаются сценарии вида «скрыть кнопку у всех, кроме роли X», если тестировать их под полными правами.

Второй нюанс — привилегированный режим. По умолчанию УчитыватьПривилегированныйРежим = Истина, и внутри привилегированного блока обе функции вернут Истина для текущего пользователя. Если проверка должна отражать реальные роли, а не режим исполнения, передавайте третьим параметром Ложь.

Как получить пользователя БСП на клиенте

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

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

    Если ПользователиКлиент.ЭтоСеансВнешнегоПользователя() Тогда
        Элементы.ГруппаСлужебная.Видимость = Ложь;
    КонецЕсли;

    Если ПользователиКлиент.ЭтоПолноправныйПользователь() Тогда
        Элементы.КнопкаНастройки.Видимость = Истина;
    КонецЕсли;

    ТекущийАвтор = ПользователиКлиент.АвторизованныйПользователь();

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

Клиентская ЭтоПолноправныйПользователь() принимает единственный параметр ПроверятьПраваАдминистрированияСистемы (по умолчанию Ложь) — проверить другого пользователя или отключить учёт привилегированного режима на клиенте нельзя, для этого нужен серверный вызов. Аналога РолиДоступны() на клиенте тоже нет.

1С БСП: пользователи, группы и неуказанный пользователь

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

• Пользователи.ГруппаВсеПользователи() → СправочникСсылка.ГруппыПользователей — ссылка на стандартную группу «ВсеПользователи», корень иерархии групп.
• Пользователи.СсылкаНеуказанногоПользователя(СоздатьЕслиНеСуществует = Ложь) — ссылка служебного пользователя «Не указан». Возвращает Неопределено, если такой элемент ещё не создан, а флаг не поднят. Текстовое представление отдаёт Пользователи.ПолноеИмяНеуказанногоПользователя().
• Пользователи.ВходВПрограммуРазрешен(ОписаниеПользователяИБ) → Булево — есть ли у пользователя хотя бы один вид аутентификации. Принимает ссылку справочника, ПользовательИнформационнойБазы, УникальныйИдентификатор или структуру свойств аутентификации.
• Пользователи.ПользовательИБЗанят(ПользовательИБ, УчетнаяЗапись = Неопределено) → Булево — сопоставлена ли учётная запись платформы с элементом справочника Пользователи или ВнешниеПользователи.

Частые ошибки при получении пользователя через БСП

• ТекущийПользователь() в универсальном коде. В сеансе внешнего пользователя функция вызывает исключение «Невозможно получить текущего пользователя в сеансе внешнего пользователя». В подписках, регламентных механизмах и общих подсистемах используйте АвторизованныйПользователь().
• Ссылка справочника вместо пользователя ИБ. АвторизованныйПользователь() отдаёт элемент справочника, а не ПользовательИнформационнойБазы. Имя для входа, аутентификация и роли берутся только через Пользователи.НайтиПоСсылке().
• Сравнение результата с ПользователиИнформационнойБазы.ТекущийПользователь(). Это объекты разной природы, их нельзя сравнивать напрямую — сопоставляйте по УникальныйИдентификатор через Пользователи.НайтиПоИдентификатору().
• Проверка ролей под полными правами. РолиДоступны() вернёт Истина для полноправного пользователя независимо от списка ролей — тестируйте разграничение под обычной учётной записью.
• Проверка прав внутри привилегированного блока. При УчитыватьПривилегированныйРежим = Истина (значение по умолчанию) ЭтоПолноправныйПользователь() вернёт Истина просто из-за режима. Для реальной картины передавайте Ложь.
• Вызов в безопасном режиме. НайтиПоИмени(), НайтиПоСсылке(), НайтиПоИдентификатору() и СвойстваПользователяИБ() содержат проверку ПроверитьБезопасныйРежимОтключен и в безопасном режиме завершатся ошибкой.
• Ожидание пустой ссылки вместо Неопределено. НайтиПоИмени() возвращает Неопределено, когда учётной записи нет, и пустую ссылку справочника, когда учётная запись есть, но не сопоставлена. Эти случаи нужно различать.
• Вызов в сеансе без разделителей. В модели сервиса АвторизованныйПользователь() требует доступности разделённых данных, иначе будет исключение — в фоновых заданиях области это надо учитывать.

Частые вопросы о получении пользователя в БСП