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

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

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

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

Как устроены роли и права в 1С

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

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

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

Программная проверка через РольДоступна()

Основной способ проверить наличие роли у текущего пользователя — встроенная функция РольДоступна(<ИмяРоли>). Она принимает строковое имя роли, как оно задано в конфигураторе, и возвращает булево значение: Истина, если роль назначена текущему пользователю, и Ложь в противном случае.

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

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

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

Если РольДоступна("ДобавлениеИзменениеДокументов") Тогда
    Сообщить("Роль назначена текущему пользователю");
Иначе
    Сообщить("Роль не назначена");
КонецЕсли;

Проверка права доступа вместо проверки роли

Часто настоящая цель — не узнать про роль, а убедиться, что пользователь может выполнить конкретное действие. Для этого предназначена функция ПравоДоступа(<Право>, <ОбъектМетаданных>). Она учитывает все роли пользователя сразу и возвращает итоговое право.

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

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

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

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

ПользовательИБ = ПользователиИнформационнойБазы.НайтиПоИмени("ИвановИИ");
Если ПользовательИБ <> Неопределено Тогда
Для Каждого Роль Из ПользовательИБ.Роли Цикл
Сообщить(Роль.Имя);
КонецЦикла;
КонецЕсли;

Для проверки конкретной роли у конкретного пользователя коллекцию ролей перебирают и сравнивают имена. Учтите, что доступ к ПользователиИнформационнойБазы требует права «Администрирование» — обычный пользователь такой код выполнить не сможет.

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

Визуальная проверка ролей без программирования

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

В режиме 1С:Предприятие в типовых конфигурациях роли видны в карточке пользователя: раздел «Администрирование → Настройки пользователей и прав → Пользователи». Там же через группы доступа видно, какие профили (а значит, и роли) действуют для пользователя.

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

1. 1
   Откройте конфигуратор и войдите под учётной записью с правами администратора
2. 2
   Перейдите: Администрирование → Пользователи
3. 3
   Откройте нужного пользователя двойным щелчком
4. 4
   Перейдите на вкладку «Прочие» и найдите список ролей
5. 5
   Отмеченные роли — назначены пользователю; сравните с требуемой ролью

Типичные ошибки при проверке ролей

Самая распространённая ошибка — опечатка в имени роли. Строка передаётся в РольДоступна() как литерал, поэтому компилятор её не проверяет, и ошибка проявляется только в момент выполнения. Чтобы снизить риск, выносите имена ролей в константы или функции-проверки.

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

Ответы на частые вопросы