Role DSL — полная справка

Role DSL — полная справка

Подробная справка по JSON DSL для /role-compile. Компактное описание — в SKILL.md.

Структура верхнего уровня

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

• name — программное имя роли (обязательно)
• synonym — отображаемое имя (по умолчанию = name)
• comment — комментарий (по умолчанию пусто)
• Глобальные флаги — по умолчанию false, true, false

Объекты: два формата

Массив objects принимает строки (shorthand) и объекты (полная форма).

Строковый shorthand

"ОбъектМетаданных: @пресет"
"ОбъектМетаданных: Право1, Право2"

Примеры:

"objects": [
  "Catalog.Номенклатура: @view",
  "Document.Реализация: @edit",
  "InformationRegister.Цены: Read, Update",
  "DataProcessor.Загрузка: @view"
]

Объектная форма (для RLS и переопределений)

{
  "name": "Document.Реализация",
  "preset": "view",
  "rights": { "Delete": false },
  "rls": { "Read": "#ДляОбъекта(\"\")" }
}

• preset — базовый набор прав ("view", "edit")
• rights — переопределения: dict {"Right": true/false} или массив ["Right1", "Right2"]
• rls — RLS-ограничения: {"ИмяПрава": "текст условия"}

Пресеты — подробные таблицы

Пресеты обозначаются @ в строковом формате. В объектной форме ключ preset без @.

@view — просмотр

@edit — полное редактирование

Для сервисов (WebService, HTTPService, IntegrationService) пресеты не определены — используй явные права: "WebService.Имя: Use".

Если пресет не определён для типа объекта — предупреждение с подсказкой доступных.

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

Скрипт автоматически транслирует русские имена в английские. Можно смешивать: "Справочник.Контрагенты: Чтение, View" — работает.

Типы объектов

Вложенные типы

Права (основные)

Права (интерактивные)

Права (конфигурация)

Типы объектов без прав в ролях

Следующие типы 1С не могут иметь права в ролях (не добавляются в objects):

Шаблоны ограничений (RLS templates)

"templates": [
  {
    "name": "ДляОбъекта(Модификатор)",
    "condition": "// текст шаблона\nГДЕ 1=1\n&Модификатор"
  }
]

• & в условии автоматически экранируется в & в XML
• Ссылка на шаблон в rls: "#ИмяШаблона(\"параметры\")" — начинается с #
• Параметры шаблона можно передавать пустыми: #ДляОбъекта("")

Примеры

1. Простая роль (только пресеты)

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

2. Роль для регламентного задания

{
  "name": "ОбновлениеЦен",
  "synonym": "Обновление цен номенклатуры",
  "objects": [
    "Catalog.Номенклатура: Read",
    "Catalog.Валюты: Read",
    "InformationRegister.ЦеныНоменклатуры: Read, Update",
    "Constant.ОсновнаяВалюта: Read"
  ]
}

3. Роль с RLS

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

4. Роль с русскими синонимами

{
  "name": "ПросмотрДанных",
  "synonym": "Просмотр данных",
  "objects": [
    "Справочник.Контрагенты: @view",
    "Документ.Реализация: Чтение, Просмотр",
    "РегистрСведений.Цены: @edit",
    "Обработка.ЗагрузкаДанных: @view"
  ]
}

5. Роль с переопределением прав из пресета

{
  "name": "ОграниченноеРедактирование",
  "synonym": "Редактирование без удаления",
  "objects": [
    {
      "name": "Catalog.Контрагенты",
      "preset": "edit",
      "rights": { "Delete": false }
    }
  ]
}