/role-edit — точечное редактирование роли 1С
Меняет права существующей роли на месте: UUID, прочие права, RLS и шаблоны сохраняются.
Создание новой роли — /role-compile.
Параметры и команда
| Параметр | Описание |
|---|---|
RolePath | Каталог роли, Roles/Имя.xml или Roles/Имя/Ext/Rights.xml |
Operation | Одна операция из таблицы ниже |
Value | Значение операции; несколько значений — через ;; |
DefinitionFile | JSON-массив операций (альтернатива Operation) — так задают несколько разных операций |
NoValidate | Не запускать role-validate после правки |
powershellpowershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-edit.ps1" -RolePath "<роль>" -Operation <op> -Value "<значение>"
Операции применяются в том порядке, в котором перечислены.
Операции
| Операция | Формат Value | Описание |
|---|---|---|
add-rights | Тип.Имя: Право1, Право2 или Тип.Имя: @пресет | Добавить права, прежние сохранить |
set-rights | то же | Заменить набор прав объекта целиком |
remove-rights | Тип.Имя: Право1, Право2 — снять праваТип.Имя — удалить объект целиком | Снять права |
deny-rights | Тип.Имя: Право1, Право2 | Закрыть реквизит или ТЧ, которые иначе наследуют права объекта |
set-rls | Тип.Имя.Право: условиеТип.Имя.Право[Поле1, Поле2]: условие | Ограничение доступа к данным |
remove-rls | Тип.Имя.Право — снять всеТип.Имя.Право[Поле1] — снять одну строку | Снять ограничение, право оставить |
add-template | Имя(Параметры): условие | Добавить шаблон ограничения |
set-template | то же | Заменить шаблон, а если его нет — добавить |
remove-template | Имя(Параметры) или Имя | Удалить шаблон |
modify-property | setForNewObjects=truesetForAttributesByDefault=falseindependentRightsOfChildObjects=true | Глобальные флаги роли |
set-synonym | текст | Синоним роли |
set-comment | текст | Комментарий роли |
Быстрые примеры
powershell# Добавить права нового регистра, ничего не потеряв ... -RolePath "src/Roles/Менеджер" -Operation add-rights -Value "InformationRegister.Цены: Read, Update" # Пресет и несколько объектов в одном вызове ... -RolePath "src/Roles/Менеджер" -Operation add-rights -Value "Catalog.Товары: @view ;; Document.Заказ: @edit" # Снять права; объект без разрешающих прав удаляется целиком ... -RolePath "src/Roles/Менеджер" -Operation remove-rights -Value "Document.Заказ: Delete" # Закрыть реквизит от роли ... -RolePath "src/Roles/Менеджер" -Operation deny-rights -Value "Catalog.Товары.Attribute.Цена: View"
Несколько разных операций — списком в файле:
json[ { "operation": "add-rights", "value": "Catalog.Товары: @view" }, { "operation": "set-rls", "value": "Catalog.Товары.Read: #ПоОрганизации(\"\")" } ]
powershell... -RolePath "src/Roles/Менеджер" -DefinitionFile "операции.json"
Права
Имена объектов и прав — те же, что в /role-compile: Catalog, Read, пресеты @view и
@edit, вложенные пути (Catalog.Контрагенты.Attribute.ИНН: View, Edit), короткая запись сервиса
(HTTPService.ЭДО: Use раскрывается по всем методам шаблонов URL).
remove-rights и deny-rights задевают больше перечисленного: уходят и права, которым снятое
нужно (сняли Read — уйдут Update, View, Edit). Снятое каскадом перечисляется в выводе.
Ошибка в значении — отказ до записи, файл не меняется. Полные таблицы «тип → права» и виды
вложенности — в справке /role-compile.
RLS
Ограничения права — это список строк, как в таблице «Ограничения доступа к данным» редактора. Строка без списка полей действует на все прочие поля, строка со списком — только на них. Типовой приём: закрыть данные целиком, но оставить поля представления ссылки открытыми, иначе ссылки на объект превратятся в «объект не найден»:
powershell... -Operation set-rls -Value "Catalog.Товары.Read: ГДЕ ЛОЖЬ" ... -Operation set-rls -Value "Catalog.Товары.Read[Ссылка, Код, Наименование]: "
Строка с тем же набором полей заменяется, с другим — добавляется. Право должно быть уже выдано: ограничение без права платформа игнорирует, поэтому навык откажет.
Ссылка на шаблон — #ИмяШаблона(""); & в условиях экранируется автоматически.
Значение из файла
Вместо текста можно указать @путь — условие RLS, тело шаблона, синоним и комментарий берутся из
файла. Относительный путь ищется рядом с DefinitionFile, затем в текущем каталоге. Разделитель
;; внутри файла остаётся обычным текстом.
powershell... -Operation set-rls -Value "Catalog.Товары.Read: @условие.txt" ... -Operation add-template -Value "ПоОрганизации(Мод): @условие.txt" ... -Operation set-comment -Value "@комментарий.txt"
Верификация
/role-info <RightsPath> — сводка прав после правки /role-validate <RightsPath> — проверка корректности (запускается автоматически)
