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

Другое · 7 мин

Программное добавление роли в 1С:Предприятие

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

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

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

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

Что такое роль и где она хранится

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

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

Как добавить роль через конфигурацию

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

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

Программное создание роли «внутри» уже развёрнутой базы без доступа к конфигурации не предусмотрено стандартными средствами языка 1С. Конфигурация защищена от изменений во время обычной работы, поэтому создание нового объекта роли требует прав разработчика и режима конфигурирования.

Порядок добавления роли
  1. 1
    Открыть конфигурацию в Configurator и перейти к разделу «Роли»
  2. 2
    Создать новую роль и настроить набор прав доступа
  3. 3
    Сохранить конфигурацию и выполнить обновление информационной базы
  4. 4
    Проверить, что роль появилась в списке прав доступа

Программная выдача роли пользователю

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

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

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

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

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

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

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

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

Роль появилась в конфигурации после обновления
Норма

Роль отображается в списке ролей Configurator

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

Роли нет в списке или не сохранена

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

Действие доступно тестовому пользователю

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

Доступ закрыт или ошибка прав

Пользователь без роли не имеет доступа
Норма

Действие недоступно

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

Доступ открыт для всех пользователей

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

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

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

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

Альтернативы и типичные ошибки

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

Типичные ошибки
01
Создали роль, но не обновили информационную базу — роль не видна в правах доступа
02
Назначили роль пользователю, но не попросили его перезайти в программу — права не применяются
03
Выдавали избыточные права «на всякий случай» — снижается безопасность доступа

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

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

Итог

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

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

FAQ

Можно ли создать роль только программно, не открывая Configurator?

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

Нужно ли перезапускать 1С после назначения роли?

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

Что делать, если роль не отображается в списке прав пользователя?

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

Может ли программное назначение роли повредить базу?

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

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

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