К статье
Практический материал

Другое · 8 мин

Как программно изменить роль в 1С:Enterprise

Программное изменение роли пользователя в 1С:Enterprise: способы назначения прав, проверка результата, ограничения и типичные ошибки при работе с ролями и профилями доступа.

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

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

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

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

Когда программное изменение роли оправдано

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

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

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

Основные способы изменения роли в 1С

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

Смена роли через объект пользователя

В этом сценарии скрипт находит пользователя по имени, находит роль по названию и создаёт новую строку в таблице ролей пользователя, указывая на нужную роль. После этого объект пользователя записывается обратно в базу.

Удаление роли пользователя

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

Использование внешней обработки

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

Порядок действий
  1. 1
    Сделать резервную копию информационной базы
  2. 2
    Открыть конфигурацию в режиме разработчика с правами администратора
  3. 3
    Найти пользователя и нужную роль в справочниках
  4. 4
    Добавить или удалить роль из списка ролей пользователя
  5. 5
    Записать пользователя и проверить права при новом входе

Пример программного изменения роли

Ниже приведён общий вид кода на встроенном языке 1С. Точные имена объектов и свойств зависят от конфигурации, поэтому перед использованием нужно проверить их в синтакс-помощнике вашей базы.

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

1c
Пользователь = Пользователи.НайтиПоИмени("Иванов");
Роль = Роли.НайтиПоНазванию("Менеджер");
НоваяРоль = Пользователь.Роли.Добавить();
НоваяРоль.Роль = Роль;
Пользователи.Записать(Пользователь);

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

Проверка результата и признаки успешного изменения

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

Второй признак — поведение пользователя при новом входе. Он должен видеть те отчёты, документы и справочники, которые доступны по новой роли, и не иметь доступа к объектам, к которым права отозваны.

Контрольные точки

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

Список ролей пользователя
Норма

Нужная роль присутствует, лишние отсутствуют

Тревожный признак

Роль не отображается или запись не сохранилась

Права при входе
Норма

Доступ к объектам соответствует новой роли

Тревожный признак

Права остались прежними после смены роли

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

Ограничения и риски

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

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

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

Типичные ошибки
01
Изменение ролей в текущей сессии не обновляет права доступа пользователя до повторного входа
02
Попытка присвоить роль, которой нет в справочнике ролей конфигурации

Типичные ошибки

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

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

Сравнение вариантов

Ручное изменение через интерфейс

Подходит для единичных правок, не требует программирования, но неудобно при большом числе пользователей

Программное изменение скриптом

Оптимально для массовых и регулярных изменений, требует прав разработчика и тестирования на копии базы

Альтернативы и выбор способа

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

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

Итог

Что важно запомнить

Программное изменение роли в 1С выполняется через список ролей пользователя с обязательным сохранением и проверкой прав после нового входа в базу.

Часто задаваемые вопросы

Можно ли сменить роль пользователю, который сейчас зашёл в базу?

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

Нужны ли права администратора для программной смены роли?

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

Что делать, если роль не применяется после изменения?

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

Безопасно ли менять роли программно в рабочей базе?

Только с резервной копией и после проверки на копии базы. Ошибка может привести к потере доступа у сотрудников или к открытию несанкционированного просмотра данных.

Чем роль отличается от профиля доступа?

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