/role-compile - генерация роли 1С из JSON DSL

Принимает JSON-определение роли → генерирует Roles/Имя.xml (метаданные) и Roles/Имя/Ext/Rights.xml (права). UUID автоматически.

Параметры и команда

Параметр	Описание
JsonPath	Путь к JSON-определению роли
OutputDir	Корень выгрузки конфигурации (где Configuration.xml, Roles/ и т.д.)

powershell.exe -NoProfile -File skills/1c-role-compile/scripts/role-compile.ps1 -JsonPath "<json>" -OutputDir "<ConfigDir>"

Создает {OutputDir}/Roles/Имя.xml и {OutputDir}/Roles/Имя/Ext/Rights.xml. Регистрирует <Role> в Configuration.xml.

JSON DSL

Структура

{ "name": "ИмяРоли", "synonym": "Отображаемое имя", "objects": [...], "templates": [...] }

Необязательные: comment (""), setForNewObjects (false; у роли ПолныеПрава и FullAccess - true), setForAttributesByDefault (true), independentRightsOfChildObjects (false).

Shorthand-строки и объектная форма

"objects": [
  "Catalog.Номенклатура: @view",
  "Document.Реализация: @edit",
  "DataProcessor.Загрузка: @view",
  "InformationRegister.Цены: Read, Update",
  { "name": "Document.Продажа", "preset": "view", "rights": {"Delete": false}, "rls": {"Read": "#Шаблон(\"\")"} }
]

• Shorthand: "Тип.Имя: @пресет" или "Тип.Имя: Право1, Право2"
• Объектная форма: preset + rights (переопределения) + rls (ограничения)

Пресеты

Пресет	Действие
@view	Просмотр - Read, View (+InputByString для справочников/документов; Use+View для обработок/отчетов)
@edit	Полное редактирование - CRUD + Interactive* + Posting (документы)

@ обязателен в shorthand. В объектной форме - "preset": "view" без @.

Замыкание прав

Навык дописывает права, которые платформа добавляет сама при загрузке роли (замер 8.3.27): Edit влечет Read, Update, View; View у обработки влечет Use; InteractivePostingRegular влечет InteractivePosting, а тот - Posting, и далее по зависимостям. Полный набор правил - в scripts/role-compile.py (GLOBAL_RIGHT_IMPL и RIGHT_IMPL_BY_TYPE). Файл роли после сборки совпадает с выгрузкой после первой загрузки в базу.

Права выдаются в порядке выгрузки платформы (RIGHT_ORDER), а не в порядке ввода.

Явное false конфликтует с замыканием (Edit включен, Read выключен) - платформа отбрасывает весь блок объекта при загрузке; навык предупреждает об этом в stderr.

View и Edit реквизита, табличной части, стандартного реквизита, измерения и ресурса регистра пишутся только если не совпадают с setForAttributesByDefault (замер 8.3.27): при флажке true явный true не попадает в файл, false остается; при флажке false наоборот. Пустой блок не пишется. Перед этим View и Edit согласуются: явный Edit=true при View=false дает View=true, View=false без явного Edit дает Edit=false.

У регистров вложенные объекты - Dimension, Resource, Attribute, StandardAttribute, Command, у регистра расчета еще Recalculation: "InformationRegister.Цены.Dimension.Товар: View".

Условие RLS на вложенном объекте: у стандартного реквизита право с условием пишется при любом значении; у реквизита, измерения и ресурса условие не записывается, в выводе предупреждение.

Права сервисов

У самих WebService, HTTPService и IntegrationService прав нет - платформа отбрасывает такой блок при загрузке. Право Use дается операции, методу и каналу: "WebService.Обмен.Operation.Загрузить: Use", "HTTPService.Сервис.URLTemplate.Файлы.Method.get: Use", "IntegrationService.Канал.IntegrationServiceChannel.Основной: Use".

Русские синонимы

Поддерживаются русские типы (Справочник→Catalog, Документ→Document) и права (Чтение→Read, Просмотр→View). Смешивание допустимо: "Справочник.Контрагенты: Чтение, View".

Шаблоны RLS

"templates": [{"name": "ДляОбъекта(Мод)", "condition": "ГДЕ Организация = &ТекОрг"}]

Ссылка в rls: "#ДляОбъекта(\"\")". Символ & автоматически экранируется в XML.

Примеры

Простая роль

{
  "name": "ЧтениеНоменклатуры", "synonym": "Чтение номенклатуры",
  "objects": ["Catalog.Номенклатура: @view", "Catalog.Контрагенты: @view", "DataProcessor.Загрузка: @view"]
}

Роль с RLS

{
  "name": "ЧтениеДокументовПоОрганизации",
  "synonym": "Чтение документов (ограничение по организации)",
  "objects": [
    "Catalog.Организации: @view",
    {"name": "Document.РеализацияТоваровУслуг", "preset": "view", "rls": {"Read": "#ДляОбъекта(\"\")"}}
  ],
  "templates": [{"name": "ДляОбъекта(Модификатор)", "condition": "ГДЕ Организация = &ТекущаяОрганизация"}]
}

Подробные таблицы пресетов, русских синонимов и дополнительные примеры - в dsl-reference.md.

Верификация

/role-validate <RightsPath> [MetadataPath]  - проверка корректности XML, прав, RLS
/role-info <RightsPath>                     - визуальная сводка структуры