cc-1c-skills/docs/form-dsl-spec.md

Form DSL Specification

Спецификация JSON-формата для /form-compile — компактного описания управляемых форм 1С:Предприятия 8.3.

---

1. Корневой объект

{
  "title": "Заголовок формы",
  "properties": { ... },
  "excludedCommands": [ ... ],
  "events": { ... },
  "elements": [ ... ],
  "attributes": [ ... ],
  "parameters": [ ... ],
  "commands": [ ... ]
}

Поле	Тип	Описание
title	string	Заголовок формы (необязательный)
properties	object	Свойства формы (необязательный)
excludedCommands	string[]	Исключённые стандартные команды (необязательный)
events	object	Обработчики событий формы (необязательный)
elements	array	Дерево UI-элементов (необязательный)
attributes	array	Реквизиты формы (необязательный)
parameters	array	Параметры формы (необязательный)
commands	array	Команды формы (необязательный)

---

2. Properties — свойства формы

Объект со свойствами в camelCase. Компилятор преобразует в PascalCase для XML.

"properties": {
  "autoTitle": false,
  "windowOpeningMode": "LockOwnerWindow",
  "commandBarLocation": "Bottom"
}

Поддерживаемые свойства

DSL ключ	XML элемент	Значения
autoTitle	<AutoTitle>	true / false
windowOpeningMode	<WindowOpeningMode>	LockOwnerWindow, Modeless
commandBarLocation	<CommandBarLocation>	Top, Bottom, None
saveDataInSettings	<SaveDataInSettings>	UseList, Use, DontUse
autoSaveDataInSettings	<AutoSaveDataInSettings>	Use, DontUse
autoTime	<AutoTime>	CurrentOrLast, Current, Last
usePostingMode	<UsePostingMode>	Auto, Postings, Movements
repostOnWrite	<RepostOnWrite>	true / false
autoURL	<AutoURL>	true / false
autoFillCheck	<AutoFillCheck>	true / false
customizable	<Customizable>	true / false
enterKeyBehavior	<EnterKeyBehavior>	DefaultButton, NewLine
verticalScroll	<VerticalScroll>	useIfNecessary, Auto, AlwaysShow, Never
width	<Width>	число
height	<Height>	число
group	<Group>	Vertical, Horizontal, AlwaysHorizontal, AlwaysVertical
useForFoldersAndItems	<UseForFoldersAndItems>	Folders, Items, FoldersAndItems

Нераспознанные ключи преобразуются с автоматическим PascalCase (первая буква в верхний регистр).

---

3. Events — обработчики событий формы

"events": {
  "OnCreateAtServer": "ПриСозданииНаСервере",
  "OnOpen": "ПриОткрытии"
}

Ключ — имя события, значение — имя процедуры-обработчика. Тот же формат events используется и на элементах (§4.1) — единый способ описания событий во всём DSL.

Доступные события

Событие	Описание
OnCreateAtServer	Создание формы на сервере
OnOpen	Открытие формы
BeforeClose	Перед закрытием
OnClose	При закрытии
BeforeWrite	Перед записью
BeforeWriteAtServer	Перед записью на сервере
OnWriteAtServer	При записи на сервере
AfterWriteAtServer	После записи на сервере
AfterWrite	После записи
OnReadAtServer	При чтении объекта
NotificationProcessing	Обработка оповещений
ChoiceProcessing	Обработка выбора
FillCheckProcessingAtServer	Проверка заполнения

---

4. Elements — дерево UI-элементов

Массив объектов. Тип элемента определяется ключом-идентификатором.

4.1. Общие свойства всех элементов

Свойство	Тип	Описание
name	string	Имя элемента (по умолчанию — из значения ключа типа)
title	string/object	Заголовок. Нет ключа → авто-вывод из имени (для page/popup/label и непривязанных полей/кнопок). "" → подавить (заголовок не выводится). Строка → ru. Объект { "ru": "…", "en": "…" } → мультиязычный (по <v8:item> на язык). Так же tooltip/inputHint/title команд/реквизитов/колонок
hidden	bool	true → <Visible>false</Visible>
disabled	bool	true → <Enabled>false</Enabled>
readOnly	bool	true → <ReadOnly>true</ReadOnly>
userVisible	bool/object	Пользовательская видимость по ролям (<UserVisible>). См. §4.1c. Отсутствие = виден всем
commandBar	object/array	Командная панель элемента (companion <AutoCommandBar>) с контентом. См. §4.1d
contextMenu	object/array	Контекстное меню элемента (companion <ContextMenu>) с контентом. См. §4.1d
events	object	Обработчики событий: { "ИмяСобытия": "ИмяОбработчика" } — тот же формат, что у событий формы (§3). Значение null → имя по конвенции (§4.2). См. §4.2
titleLocation	string	Расположение заголовка: none/left/right/top/bottom/auto. Эмитится при наличии (input, labelField, picField, table, calendar). У check/radio — особая семантика с умным дефолтом (см. их разделы)
tooltip	string/object	Всплывающая подсказка элемента (<ToolTip>). Строка → ru, объект { "ru": …, "en": … } → мультиязычный (как title). Эмитится сразу после title
tooltipRepresentation	string	Режим показа подсказки (<ToolTipRepresentation>): None, Button, ShowBottom, ShowTop, ShowLeft, ShowRight, ShowAuto, Balloon. Эмитится при наличии
extendedTooltip	string/object	Расширенная подсказка (контент companion <ExtendedTooltip>). См. форму ML-текста ниже. Синоним: extTooltip

Форма ML-текста и formatted

title/tooltip/extendedTooltip принимают:

• "строка" — ru-текст;
• { "ru": "…", "en": "…" } — многоязычный;
• { "text": <строка|мапа>, "formatted": true } — форматированный текст (атрибут <Title formatted="true">).

formatted включает интерпретацию inline-разметки в тексте (1С-формат, похож на BBCode): <b>…</>, <i>, <u>, <color web:Red>…</>, <bgColor …>, <font …>, <fontSize …>, <link URL>…</>, <img …>; закрывающий тег — </>. Текст несётся raw (разметка — часть строки), парсинг не требуется.

Флаг авто-детектится по наличию известной разметки/</>: для plain-строки объект не нужен. Явная форма {text, formatted} — только когда авто-детект неверен (formatted-текст без разметки, либо буквальные <…>-плейсхолдеры в неформатированном).

4.1c. Доступ по ролям (userVisible / view / edit / use)

Единый механизм платформы (role-adjustable boolean): «общее значение + исключения по ролям». Один и тот же грамматик-значения у разных ключей на разных владельцах:

Ключ	Владелец	XML-тег	Смысл
userVisible	элемент (§4.1)	<UserVisible>	пользовательская видимость
view	реквизит (§5)	<View>	просмотр
edit	реквизит (§5)	<Edit>	редактирование
use	команда (§7)	<Use>	доступность команды

Значение (общее для всех четырёх):

• скаляр false/true → только <xr:Common>, без ролей (массовый случай, особенно userVisible: false);
• объект { "common": <bool>, "roles": { "ИмяРоли": <bool>, … } } → <xr:Common> + по <xr:Value name="Role.ИмяРоли"> на каждое исключение.

Семантика как в конфигураторе (три состояния флага роли): роль, не указанная в roles, наследует common; указанная — задаёт явный true/false (может совпадать с common).

Имя роли — forgiving: принимается без префикса (ПолныеПрава), с Role. или кириллическим Роль.; нормализуется в Role.ИмяРоли.

Отсутствие ключа = полный доступ (платформа тег не пишет) — дефолт не эмитим.

{ "inputField": "Поле", "userVisible": false }                                  // скрыт у всех
{ "name": "Реквизит", "view": false,                                            // не виден…
  "edit": { "common": false, "roles": { "ПолныеПрава": true } } }               // …и редактируем только Полными правами
{ "name": "Команда", "use": { "common": false, "roles": { "Роль.Бухгалтер": true } } }

4.1d. Companion-панели элемента (commandBar / contextMenu)

Командная панель (<AutoCommandBar>) и контекстное меню (<ContextMenu>) элемента — это companion-панели с собственным контентом. Оба несут одну грамматику.

Ключ	XML companion	Forgiving-синонимы (при объект/массив-значении)
commandBar	<AutoCommandBar>	autoCommandBar, AutoCommandBar, autoCmdBar, cmdBar, КоманднаяПанель
contextMenu	<ContextMenu>	ContextMenu, КонтекстноеМеню

Значение (обе формы):

• массив [ … ] → shorthand для { "children": [ … ] };
• объект { "autofill"?: bool, "children": [ … ] } (+ horizontalAlign у commandBar).

children — обычная грамматика кнопок: button (с command/commandName/stdCommand), buttonGroup, popup.

• autofill: false → подавить автозаполнение (тег <Autofill>false</Autofill>); true или отсутствие → автозаполнение (платформенный дефолт, тег не пишется). Платформа Autofill=true не эмитит никогда.
• Отсутствие свойства целиком → пустой companion (как обычно).
• Дин-список-таблица: компилятор по эвристике подавляет её панель (autofill=false), чтобы не дублировать командную панель формы. Чтобы оставить панель таблицы (она автозаполняется) — задайте явно commandBar: { "autofill": true }.

Разведение тип-элемента и панель-свойства — по типу значения: cmdBar: "Имя" (строка) — это отдельный элемент-панель в дереве (§4.3); commandBar: { … } (объект/массив) — companion-панель данного элемента. Поэтому модель может писать панель таблицы любым знакомым словом.

{ "table": "Список", "path": "Список",
  "commandBar": { "autofill": false, "children": [
    { "button": "Создать", "command": "СоздатьЭлемент" } ] },
  "contextMenu": { "children": [
    { "button": "Карта", "commandName": "CommonCommand.КартаМаршрута" } ] } }

4.1e. Оформление элемента (цвета / шрифты / граница)

Прямые свойства оформления элемента. Ключи — англ. camelCase 1:1 с тегами; принимаются рус. синонимы (forgiving). Применимо к полям (input/check/radio/labelField/picField/calendar), декорациям (label), кнопкам (button), группам (group/columnGroup) и таблицам (table); порядок тегов в XML — по базовому типу (профиль), компилятор расставляет сам. (PictureDecoration пока не поддержан — у него XSD расщепляет оформление вокруг <Title>.)

Ключ	Тег	Рус. синоним
textColor / backColor / borderColor	<TextColor>/<BackColor>/<BorderColor>	ЦветТекста / ЦветФона / ЦветРамки
titleTextColor / titleBackColor / titleFont	<Title*> (заголовок колонки)	ЦветТекстаЗаголовка / ЦветФонаЗаголовка / ШрифтЗаголовка
footerTextColor / footerBackColor / footerFont	<Footer*> (подвал колонки)	ЦветТекстаПодвала / ЦветФонаПодвала / ШрифтПодвала
font	<Font>	Шрифт
border	<Border>	Рамка

Цвет — строка verbatim (компилятор не валидирует, эмитит как есть): style:ИмяСтиля (ссылка на элемент стиля конфигурации/платформы), web:Имя (web-палитра, напр. web:FireBrick), win:Имя (системная палитра Windows, напр. win:MenuBar, win:ButtonText, win:DisabledText), #RRGGBB (RGB-hex). Имя должно существовать в своей палитре (несуществующее, напр. win:InactiveTitleBar, или ссылка на отсутствующий style:X — приводит к ошибке загрузки). Префикс sys: в типовых выгрузках не встречается.

Шрифт (font/titleFont/footerFont):

• строка "style:X" → <Font ref="style:X" kind="StyleItem"/> (минимальная форма, платформа её принимает);
• объект — эмитятся только указанные атрибуты (дефолты не досочиняются): { ref?, faceName?, height?, bold?, italic?, underline?, strikeout?, kind?, scale? }. Для kind="Absolute" задают faceName+height; для WindowsFont — ref="sys:…".

Граница (border):

• строка "style:X" (или { ref }) → <Border ref="style:X"/> (граница из стиля);
• объект { width, style } → <Border width="N"><v8ui:style…>СТИЛЬ</v8ui:style></Border>. style — системное перечисление ControlBorderType: Single, Double, Underline, DoubleUnderline, Overline, Embossed, Indented, WithoutBorder.

{ "label": "Внимание!", "textColor": "web:FireBrick",
  "font": { "faceName": "Arial", "height": 12, "bold": true, "kind": "Absolute", "scale": 100 },
  "border": { "width": 1, "style": "Single" } }
{ "input": "Цена", "path": "Объект.Цена", "textColor": "#FF0000", "borderColor": "style:BorderColor" }
{ "labelField": "Код", "цветТекстаЗаголовка": "web:HoneyDew", "border": "style:ControlBorder" }

4.1a. Общие layout-свойства

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

Свойство	XML	Значения
width	<Width>	число
height	<Height>	число (у table → <HeightInTableRows>, высота в строках)
horizontalStretch	<HorizontalStretch>	true/false (эмитится явное значение; отсутствие = дефолт)
verticalStretch	<VerticalStretch>	true/false (аналогично)
autoMaxWidth	<AutoMaxWidth>	false (у input при multiLine подставляется автоматически)
autoMaxHeight	<AutoMaxHeight>	false
maxWidth	<MaxWidth>	число
maxHeight	<MaxHeight>	число
groupHorizontalAlign	<GroupHorizontalAlign>	Left, Center, Right
groupVerticalAlign	<GroupVerticalAlign>	Top, Center, Bottom
horizontalAlign	<HorizontalAlign>	Left, Center, Right
skipOnInput	<SkipOnInput>	true/false (эмитится явное значение, в т.ч. false)
defaultItem	<DefaultItem>	true (элемент активируется по умолчанию)
enableStartDrag	<EnableStartDrag>	true (разрешить начало перетаскивания)
fileDragMode	<FileDragMode>	AsFile/… (режим drag-n-drop файлов)
showInHeader	<ShowInHeader>	bool — показывать в шапке таблицы (поле-колонка)
showInFooter	<ShowInFooter>	bool — показывать в подвале таблицы
autoCellHeight	<AutoCellHeight>	bool — авто-высота ячейки
footerHorizontalAlign	<FooterHorizontalAlign>	Left/Right/Center
headerHorizontalAlign	<HeaderHorizontalAlign>	Left/Right/Center/Auto
headerPicture	<HeaderPicture>	Картинка в шапке колонки. Формат — см. «Картинка-ссылка» ниже
footerPicture	<FooterPicture>	Картинка в подвале колонки. Формат — см. «Картинка-ссылка» ниже

defaultItem/enableStartDrag/fileDragMode/skipOnInput + cell-свойства (showInHeader/showInFooter/autoCellHeight/footerHorizontalAlign/headerHorizontalAlign/headerPicture/footerPicture) — общие для любого поля-колонки (input, label, picField, check).

Картинка-ссылка (headerPicture/footerPicture/valuesPicture)

Картинка с флагом прозрачности. Два формата:

"headerPicture": "CommonPicture.Важность"                       // loadTransparent = false (частый случай)
"headerPicture": { "src": "StdPicture.ExecuteTask", "loadTransparent": true }   // отклонение

• скаляр-строка — ссылка StdPicture.*/CommonPicture.*, loadTransparent=false (дефолт по корпусу: ~64% картинок);
• объект { src, loadTransparent: true } — только когда нужен true (объектная форма существует ровно ради этого отклонения; флаг привязан к конкретной картинке, т.к. на одном поле их бывает несколько).

Не путать с loadTransparent у <Picture> кнопки/команды/попапа (§«button»/§7) — там обратная конвенция (дефолт true, отдельный скаляр-ключ на элементе).

4.2. События элемента и автоименование обработчиков

События элемента описываются мапой events (как у формы):

{ "input": "Контрагент", "path": "Объект.Контрагент",
  "events": { "OnChange": "КонтрагентПриИзменении" } }

Значение — имя процедуры-обработчика. Если вместо имени указать null, имя генерируется автоматически по конвенции 1С <ИмяЭлемента><РусскийСуффикс>:

{ "input": "Контрагент", "path": "Объект.Контрагент",
  "events": { "OnChange": null } }   // → обработчик КонтрагентПриИзменении

Суффиксы для авто-имени:

Событие	Суффикс
OnChange	ПриИзменении
StartChoice	НачалоВыбора
ChoiceProcessing	ОбработкаВыбора
AutoComplete	АвтоПодбор
Clearing	Очистка
Opening	Открытие
Click	Нажатие
OnActivateRow	ПриАктивизацииСтроки
BeforeAddRow	ПередНачаломДобавления
BeforeDeleteRow	ПередУдалением
BeforeRowChange	ПередНачаломИзменения
OnStartEdit	ПриНачалеРедактирования
OnEndEdit	ПриОкончанииРедактирования
Selection	ВыборСтроки
OnCurrentPageChange	ПриСменеСтраницы
TextEditEnd	ОкончаниеВводаТекста

Legacy-формат (принимается, но устарел). Ранее события элемента задавались парой on (массив имён событий) + handlers (переопределение имён): { "on": ["OnChange"], "handlers": { … } }. Компилятор по-прежнему его принимает ради совместимости, но рекомендуемый и единственный эмитируемый формат — мапа events. Новые формы пишите через events.

4.3. Типы элементов

group — UsualGroup

{ "group": "horizontal", "name": "ГруппаШапка", "children": [ ... ] }

Свойство	Тип	Описание
group	string	Ориентация: horizontal, vertical, alwaysHorizontal, alwaysVertical. "" → <Group> не эмитится (тег отсутствовал в исходнике; платформа сериализует «Группировку», только если она задана в конфигураторе — даже явный Vertical хранится, поэтому "" ≠ vertical). Ключ обязателен как тип-маркер группы. (Legacy: collapsible = vertical + behavior:'collapsible')
behavior	string	Поведение (<Behavior>): usual, collapsible, popup. Отсутствие = Авто (дефолт, не эмитится). Свёртываемая/всплывающая несут доп. свойства
collapsed	bool	Свёрнута (у collapsible/popup)
children	array	Вложенные элементы
showTitle	bool	Показывать заголовок группы
representation	string	none, normal, weak, strong
united	bool	Объединение

input — InputField

{ "input": "Организация", "path": "Объект.Организация", "events": { "OnChange": "ОрганизацияПриИзменении" } }

Свойство	Тип	Описание
path	string	DataPath
multiLine	bool	Многострочный режим
passwordMode	bool	Режим пароля
titleLocation	string	none, left, right, top, bottom
choiceButton	bool	Показывать кнопку выбора
clearButton	bool	Показывать кнопку очистки
spinButton	bool	Показывать кнопку прокрутки
dropListButton	bool	Показывать кнопку раскрытия
markIncomplete	bool	Автопометка незаполненных
editMode	string	Режим редактирования: EnterOnInput, Directly
skipOnInput	bool	Пропускать при вводе
inputHint	string	Подсказка ввода (placeholder)
choiceList	array	Список выбора: массив { value, presentation?/title? } — та же грамматика, что у radio (см. ниже)
wrap	bool	Перенос по словам (<Wrap>)
openButton	bool	Кнопка открытия (<OpenButton>)
listChoiceMode	bool	Режим выбора из списка (<ListChoiceMode>)
extendedEditMultipleValues	bool	Расширенное редактирование нескольких значений
chooseType	bool	Выбор типа (<ChooseType>)
choiceButtonRepresentation	string	ShowInInputField, ShowInDropList, ShowInDropListAndInInputField
width	int	Ширина
height	int	Высота
horizontalStretch	bool	Растягивание по горизонтали
verticalStretch	bool	Растягивание по вертикали
autoMaxWidth	bool	Автомаксимальная ширина
autoMaxHeight	bool	Автомаксимальная высота

check — CheckBoxField

{ "check": "ФлагАктивности", "path": "Активен", "events": { "OnChange": "ФлагАктивностиПриИзменении" } }

Свойство	Тип	Описание
path	string	DataPath
checkBoxType	string	Вид флажка. Нет ключа → умный дефолт Auto. "" → не выводить тег (платформа применит своё умолчание). Значения: auto, checkBox, switcher, tumbler
editMode	string	Режим редактирования: EnterOnInput, Directly
titleLocation	string	Расположение заголовка. Нет ключа → умный дефолт Right (флажки почти всегда справа). "" → не выводить тег (платформа применит своё умолчание, Left). Значение (none/left/top/…) → как указано

radio — RadioButtonField

{
  "radio": "СпособКурса",
  "path": "Объект.СпособУстановкиКурса",
  "radioButtonType": "Auto",
  "choiceList": [
    { "value": "Enum.СпособыКурса.EnumValue.Авто",   "presentation": "автоматически" },
    { "value": "Enum.СпособыКурса.EnumValue.Ручной", "presentation": { "ru": "вручную", "en": "manual" } }
  ]
}

Свойство	Тип	Описание
path	string	DataPath
radioButtonType	string	Auto (по умолчанию), RadioButtons, Tumbler
columnsCount	int	Число колонок раскладки
titleLocation	string	Расположение заголовка. Нет ключа → умный дефолт None. "" → не выводить тег (платформа применит своё умолчание). Значение → как указано
choiceList	array	Варианты выбора: массив { value, presentation }

choiceList[*]:

Свойство	Тип	Описание
value	string/number/bool	Значение варианта. Для перечисления — "Enum.ИмяТипа.EnumValue.ИмяЗначения" (xsi:type автоматически: xr:DesignTimeRef / xs:string / xs:decimal / xs:boolean)
presentation	string или object	Текст рядом с переключателем. Строка → ru; объект {ru, en, ...} → мультиязык. Если не задано — выводится из имени значения

label — LabelDecoration

{ "label": "Подсказка", "title": "Выберите параметры", "hyperlink": true }

Свойство	Тип	Описание
title	string/object	Текст надписи. Единая ML-text форма (см. §4.1): строка / {ru,en} / {text, formatted}. У декораций <Title> всегда несёт атрибут formatted (авто-детект по разметке)
hyperlink	bool	Режим гиперссылки
formatted	bool	Back-compat: явный override авто-детекта formatted (раньше — отдельный ключ). Предпочтительно — форма title: {text, formatted}
width	int	Ширина
height	int	Высота
autoMaxWidth	bool	Автомаксимальная ширина
autoMaxHeight	bool	Автомаксимальная высота

labelField — LabelField

{ "labelField": "СтатусОбработки", "path": "Статус" }

Свойство	Тип	Описание
path	string	DataPath
hyperlink	bool	Режим гиперссылки (у LabelField платформенный тег <Hiperlink> — опечатка 1С, компилятор учитывает)
editMode	string	Режим редактирования: EnterOnInput, Directly

table — Table

{
  "table": "Товары", "path": "Объект.Товары",
  "columns": [
    { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
  ]
}

Свойство	Тип	Описание
path	string	DataPath
columns	array	Колонки (элементы input/check/labelField/picField, либо columnGroup для группировки)
representation	string	List, Tree, HierarchicalList
changeRowSet	bool	Разрешить добавление/удаление строк (эмитится явное значение, в т.ч. false)
changeRowOrder	bool	Разрешить перемещение строк (явное значение)
autoInsertNewRow	bool	Автодобавление новой строки
enableDrag	bool	Разрешить перетаскивание из таблицы
rowFilter	null	Отбор строк (nil-плейсхолдер <RowFilter xsi:nil="true"/>); значение всегда null
choiceMode	bool	Режим выбора
useAlternationRowColor	bool	Чередование цвета строк
selectionMode	string	Режим выделения (SingleRow, …)
rowSelectionMode	string	Режим выделения строки (Row, …)
verticalLines / horizontalLines	bool	Линии сетки (эмитится явное false)
initialTreeView	string	ExpandTopLevel, ExpandAllLevels, NoExpand
rowsPicture	string	Картинка строк (CommonPicture.X)
height	int	Высота в строках таблицы
header	bool	Показывать шапку
footer	bool	Показывать подвал
commandBarLocation	string	None, Top, Bottom, Auto
searchStringLocation	string	None, Top, Bottom, CommandBar, Auto
viewStatusLocation	string	None, Top, Bottom, Auto
searchControlLocation	string	None, Top, Bottom, Auto
excludedCommands	string[]	Исключённые стандартные команды таблицы (Add, Delete, MoveUp, SortListAsc, …) → <CommandSet>

Таблица динамического списка

Когда таблица привязана к реквизиту type: "DynamicList" (её path = имя такого реквизита), платформа эмитит блок специфичных свойств. Компилятор генерирует его автоматически с умолчаниями; в DSL указываются только отличия от умолчания (декомпилятор так и поступает). Чистые константы (Period, TopLevelParent) не настраиваются.

Свойство	Тип	Умолчание	Описание
rowPictureDataPath	string	<Список>.DefaultPicture (если есть осн. таблица)	Путь к картинке строки. "" — подавить авто-вывод
autoRefresh	bool	false	Автообновление
autoRefreshPeriod	int	60	Период автообновления, сек
choiceFoldersAndItems	string	Items	Items, Folders, FoldersAndItems
restoreCurrentRow	bool	false	Восстанавливать текущую строку
showRoot	bool	true	Показывать корень
allowRootChoice	bool	false	Разрешить выбор корня
updateOnDataChange	string	Auto	Auto, DontUpdate
allowGettingCurrentRowURL	bool	true	Получение URL текущей строки
userSettingsGroup	string	—	Группа пользовательских настроек
rowsPicture	string	—	Картинка строк (CommonPicture.X) → <RowsPicture>

columnGroup — ColumnGroup

Группа колонок таблицы. Используется только внутри columns таблицы. Допускается вложение columnGroup в columnGroup.

{ "table": "Список", "path": "Список", "columns": [
    { "columnGroup": "horizontal", "name": "ГруппаДата", "title": "Срок", "children": [
        { "input": "ДатаНачала", "path": "Список.ДатаНачала" },
        { "input": "ДатаОкончания", "path": "Список.ДатаОкончания" }
    ]},
    { "columnGroup": "inCell", "name": "ГруппаИсполнитель", "showInHeader": true, "children": [
        { "input": "Исполнитель", "path": "Список.Исполнитель" }
    ]}
]}

Свойство	Тип	Описание
columnGroup	string	Ориентация: horizontal, vertical, inCell (склейка колонок в одной ячейке шапки). "" → <Group> не эмитится (тега не было в исходнике). Ключ обязателен как тип-маркер
name	string	Имя элемента (рекомендуется задавать явно)
title	string/object	Заголовок группы
showTitle	bool	Показывать заголовок
showInHeader	bool	Показывать в шапке таблицы
width	int	Ширина
horizontalStretch	bool	Растягивание
children	array	Колонки внутри группы

pages / page — Pages / Page

{
  "pages": "Страницы", "children": [
    { "page": "Основное", "children": [ ... ] },
    { "page": "Дополнительно", "children": [ ... ] }
  ]
}

Page поддерживает group для задания ориентации содержимого и children для вложенных элементов.

Pages поддерживает pagesRepresentation: None, TabsOnTop, TabsOnBottom, TabsOnLeft, TabsOnRight.

button — Button

{ "button": "Загрузить", "command": "Загрузить", "defaultButton": true }

Свойство	Тип	Описание
command	string	Имя команды формы (→ Form.Command.<name>)
commandName	string	Глобальная команда «как есть» (CommonCommand.X, Catalog.X.Command.Y …) — без обёртки Form.
stdCommand	string	Стандартная команда (→ Form.StandardCommand.<name>; X.Y → Form.Item.X.StandardCommand.Y)
type	string	usual, hyperlink, commandBar
defaultButton	bool	Кнопка по умолчанию
picture	string | object	Ссылка на картинку (StdPicture.Name). Скаляр-строка ИЛИ объект {src, loadTransparent} (прощающий ввод — флаг можно задать прямо в объекте)
loadTransparent	bool	Загружать картинку прозрачной (у <Picture> кнопки/команды/попапа). Дефолт true (эмитится всегда; false — явно). Элемент-уровневый ключ ИЛИ поле объекта picture. Также у command (§7) и popup. ⚠️ Полярность обратна headerPicture/valuesPicture (там дефолт false, см. §4.1)
path	string	DataPath кнопки общей команды (Объект.Ref, Items.X.CurrentData.Поле) — привязка к контексту
representation	string	Auto, Picture, Text, PictureAndText
locationInCommandBar	string	InCommandBar, InAdditionalSubmenu

picture — PictureDecoration

{ "picture": "Логотип", "src": "CommonPicture.Логотип" }

Свойство	Тип	Описание
src или picture (как свойство)	string	Ссылка на картинку
loadTransparent	bool	true → загружать прозрачной. По умолчанию false
hyperlink	bool	Режим гиперссылки
width	int	Ширина
height	int	Высота

picField — PictureField

{ "picField": "Фото", "path": "Фотография" }

Для поля, привязанного к булеву/числу (иконка-индикатор в колонке), задайте картинку значения через valuesPicture — без неё иконка не отрисуется:

{ "picField": "Картинка", "path": "Таблица.Картинка",
  "valuesPicture": "StdPicture.FilterCriterion" }

Свойство	Тип	Описание
valuesPicture	string | object	Картинка значения. Формат картинки-ссылки — см. §4.1 «Картинка-ссылка»
editMode	string	Режим редактирования колонки (EnterOnInput и т.п.)

calendar — CalendarField

{ "calendar": "Дата", "path": "ДатаОтчета",
  "selectionMode": "Interval", "showCurrentDate": false, "widthInMonths": 2 }

Свойство	XML	Значения
selectionMode	<SelectionMode>	Single, Multiple, Interval
showCurrentDate	<ShowCurrentDate>	bool (выводится при наличии ключа)
widthInMonths	<WidthInMonths>	число месяцев по ширине
heightInMonths	<HeightInMonths>	число месяцев по высоте
showMonthsPanel	<ShowMonthsPanel>	bool

Также поддерживается общий titleLocation (none/left/right/top/bottom/auto).

cmdBar — CommandBar

{ "cmdBar": "КоманднаяПанель", "children": [ ... ] }

popup — Popup

{ "popup": "Печать", "picture": "StdPicture.Print", "children": [ ... ] }

buttonGroup — ButtonGroup

Группа кнопок внутри командной панели (autoCmdBar/cmdBar/popup). Значение ключа — имя элемента.

{ "buttonGroup": "ГруппаПереместить", "title": "Переместить", "children": [
    { "button": "ПереместитьВверх", "command": "ПереместитьВверх" },
    { "button": "ПереместитьВниз", "command": "ПереместитьВниз" }
] }

Свойство	Тип	Описание
buttonGroup	string	Имя элемента
title	string/object	Заголовок группы
commandSource	string	Источник команд группы (<CommandSource>): Form, FormCommandPanelGlobalCommands, Item.<ИмяЭлемента>. Также у cmdBar. Эмитится «как есть»
representation	string	Auto, Picture, Text, PictureAndText
children	array	Кнопки (button) внутри группы

autoCmdBar — командная панель формы

Командная панель самой формы (<AutoCommandBar id="-1">). Задаётся как элемент в elements; компилятор автоматически вынимает его из дерева. Нужен только если в панель помещаются явные кнопки/группы или меняется выравнивание/автозаполнение — иначе панель формируется автоматически.

{ "autoCmdBar": "ФормаКоманднаяПанель", "horizontalAlign": "Right", "autofill": false, "children": [
    { "button": "ОК", "command": "ОК", "defaultButton": true },
    { "button": "Отмена", "command": "Отмена" }
] }

Свойство	Тип	Описание
autoCmdBar	string	Имя панели (обычно ФормаКоманднаяПанель)
horizontalAlign	string	Right, Left, Center
autofill	bool	false — отключить автозаполнение стандартными командами
children	array	Кнопки/группы кнопок панели

---

5. Attributes — реквизиты формы

"attributes": [
  { "name": "Объект", "type": "DocumentObject.Реализация", "main": true },
  { "name": "Итого", "type": "decimal(15,2)" },
  { "name": "Таблица", "type": "ValueTable", "columns": [
    { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },
    { "name": "Количество", "type": "decimal(10,3)" }
  ]}
]

Свойство	Тип	Описание
name	string	Имя реквизита (обязательно)
type	string	Тип (shorthand)
main	bool	Основной реквизит формы
title	string/object	Заголовок. Нет ключа → авто-вывод из имени (как у элементов; кроме main). "" → подавить (<Title> не эмитится — так платформа и хранит реквизит без синонима). Строка → ru; объект {ru,en} → мультиязычный. Декомпилятор опускает ключ, когда ru-заголовок совпадает с авто-выводом из имени
view	bool/object	Просмотр по ролям (<View>). См. §4.1c
edit	bool/object	Редактирование по ролям (<Edit>). См. §4.1c
functionalOptions	array	Функциональные опции (<FunctionalOptions><Item>FunctionalOption.X</Item>…). Массив имён; forgiving: "X"/"FunctionalOption.X". Также у колонок (columns[*]) и команд (§7)
useAlways	array	Поля, всегда читаемые (<UseAlways><Field>Имя.Поле</Field>…). Массив коротких имён полей (forgiving: с/без префикса Имя.). Две формы: этот массив на реквизите ИЛИ useAlways: true на колонке (columns[*]) — компилятор сливает. Для дин-списка — только массив (колонки не эмитятся, но формируют <UseAlways>)
savedData	bool	Сохраняемые данные
fillChecking	string	Show, DontShow
columns	array	Колонки для ValueTable/ValueTree ({ name, type, title?, functionalOptions?, useAlways? })
additionalColumns	array	Доп. колонки табличных частей объекта: [{ table: "Объект.ТабЧасть", columns: [<col>] }]. У главного реквизита-объекта; <col> — та же грамматика, что у columns. Эмитятся в <Columns> после прямых колонок
settings	object	Настройки динамического списка (только type: "DynamicList")

settings — динамический список

Для реквизита type: "DynamicList" объект settings описывает источник данных и настройки компоновщика (ListSettings).

{ "name": "Список", "type": "DynamicList", "main": true,
  "settings": {
    "mainTable": "Catalog.Контрагенты",
    "query": "@Список.sql",
    "dynamicDataRead": false,
    "fields": [ { "field": "Отложен", "title": "Отложен" } ]
  } }

Ключ	Тип	Описание
mainTable	string	Основная таблица. Принимает рус-имена метаданных (Справочник.X → Catalog.X)
query	string	Текст запроса (ManualQuery=true). Поддерживает @file.sql (путь относительно JSON)
dynamicDataRead	bool	Динамическое считывание. Умолчание true — указывать только для отключения (false)
fields	array	Явные поля набора (редко): { field, dataPath?, title? } — для переопределения заголовка. Обычно поля выводятся из запроса автоматически
parameters	array	Параметры схемы запроса (DataCompositionSchemaParameter) — см. ниже
order	array	Сортировка списка (см. ниже)
filter	array	Отбор списка (грамматика как в СКД)
conditionalAppearance	array	Условное оформление списка (грамматика как в СКД)

ManualQuery выводится из наличия query — отдельным ключом не задаётся.

Пустой блок настроек компоновщика (ListSettings) генерируется автоматически (каноничный скелет платформы); указывать ничего не нужно.

parameters — параметры схемы дин-списка

Параметры запроса дин-списка — это та же сущность DataCompositionSchemaParameter, что и параметры СКД (&Параметр в тексте запроса). Грамматика идентична параметрам СКД (см. skd-dsl-spec.md): shorthand "Имя [Заголовок]: Тип = Значение @valueList @hidden" или объект. Используй те же ключи — модель переносит знание один-в-один.

"settings": {
  "query": "ВЫБРАТЬ … ГДЕ Товары.Артикул = &Артикул И … ПОДОБНО &Маска",
  "parameters": [
    "Артикул",
    "Маска: string = %",
    { "name": "ВидЦен", "valueListAllowed": true },
    { "name": "Период", "type": "dateTime", "useRestriction": false }
  ]
}

Отличия контекста дин-списка от параметров отчёта СКД (видимы только в дефолтах — модель просто опускает ключ):

Поведение	Дин-список
title	Авто из имени (camelCase → «Заполнена серия»); явный title/[Заголовок] — только для переопределения
useRestriction	Эмитится всегда, умолчание true; для выключения — объект { "useRestriction": false }
value	Умолчание — пустое (xsi:nil), даже при заданном типе

Объектные ключи (как в СКД): name, title, type/valueType, value, valueListAllowed, useRestriction, availableAsField, expression, availableValues ([{ value, presentation }]), inputParameters, denyIncompleteValues, use.

order / filter / conditionalAppearance

Грамматика этих ключей идентична настройкам СКД — см. skd-dsl-spec.md (разделы filter / order / conditionalAppearance). Кратко:

"settings": {
  "mainTable": "Catalog.Контрагенты",
  "order": [ "Дата desc", "Наименование", "Auto" ],
  "filter": [ "Организация = _ @off @user", "Сумма > 1000" ],
  "conditionalAppearance": [
    { "filter": ["Просрочено = true"], "appearance": { "ЦветТекста": "web:Red" } }
  ]
}

• order — строка "Поле" (asc) / "Поле desc" (синонимы убыв/desc, возр/asc) / "Auto", либо объект { field, direction?, use?, viewMode? }.
• filter — shorthand "Поле оператор значение @флаги" (@off, @user, @quickAccess, @normal, @inaccessible; _ = пусто) или объект { field, op, value?, use?, userSettingID? } или группа { group: "And"|"Or"|"Not", items: [...] }.
• conditionalAppearance — объект { selection?, filter?, appearance?, presentation?, viewMode?, userSettingID?, use? }. appearance — словарь «параметр: значение» платформы (ЦветТекста, ЦветФона, Шрифт и т.п.).

userSettingID: "auto" → платформа сгенерирует идентификатор пользовательской настройки. Пустые контейнеры (без правил) эмитируются автоматически.

---

6. Parameters — параметры формы

"parameters": [
  { "name": "Ключ", "type": "DocumentRef.Реализация", "key": true },
  { "name": "Основание", "type": "DocumentRef.Реализация" }
]

Свойство	Тип	Описание
name	string	Имя параметра (обязательно)
type	string	Тип (shorthand)
key	bool	Ключевой параметр

---

7. Commands — команды формы

"commands": [
  { "name": "Печать", "action": "ПечатьОбработка", "shortcut": "Ctrl+P" },
  { "name": "Обновить", "action": "ОбновитьОбработка", "picture": "StdPicture.Refresh" }
]

Свойство	Тип	Описание
name	string	Имя команды (обязательно)
action	string	Имя процедуры-обработчика
title	string	Заголовок
tooltip	string/object	Всплывающая подсказка команды (<ToolTip>)
use	bool/object	Доступность команды по ролям (<Use>). См. §4.1c
functionalOptions	array	Функциональные опции команды (см. §5)
currentRowUse	string	Использование текущей строки: Auto, DontUse, Use
shortcut	string	Клавиатурное сочетание
picture	string	Ссылка на картинку
representation	string	Auto, Picture, Text, PictureAndText

---

8. Система типов (shorthand)

Примитивные типы

DSL	XML
"string"	xs:string (неограниченная)
"string(100)"	xs:string + Length=100
"decimal(15,2)"	xs:decimal + Digits=15, FractionDigits=2, AllowedSign=Any
"decimal(10,0,nonneg)"	xs:decimal + AllowedSign=Nonnegative
"boolean"	xs:boolean
"date"	xs:dateTime + DateFractions=Date
"dateTime"	xs:dateTime + DateFractions=DateTime
"time"	xs:dateTime + DateFractions=Time

Ссылочные типы

DSL	XML
"CatalogRef.Организации"	cfg:CatalogRef.Организации
"DocumentObject.Реализация"	cfg:DocumentObject.Реализация
"EnumRef.СтавкиНДС"	cfg:EnumRef.СтавкиНДС
"DataProcessorObject.ЗагрузкаДанных"	cfg:DataProcessorObject.ЗагрузкаДанных

Платформенные типы

DSL	XML
"ValueTable"	v8:ValueTable
"ValueTree"	v8:ValueTree
"ValueList"	v8:ValueListType
"FormattedString"	v8ui:FormattedString
"Picture"	v8ui:Picture
"DynamicList"	cfg:DynamicList

Наборы типов (TypeSet → <v8:TypeSet>)

«Набор типов» вместо конкретного типа. Развязка с обычным типом — по наличию .Имя:

DSL	XML	Смысл
"DefinedType.ДенежнаяСумма"	<v8:TypeSet>cfg:DefinedType.ДенежнаяСумма</v8:TypeSet>	определяемый тип (синоним ОпределяемыйТип.X)
"Characteristic.Номенклатура"	<v8:TypeSet>cfg:Characteristic.Номенклатура</v8:TypeSet>	характеристика (синоним Характеристика.X)
"AnyRef"	<v8:TypeSet>cfg:AnyRef</v8:TypeSet>	любая ссылка (синоним ЛюбаяСсылка)
"AnyIBRef"	<v8:TypeSet>cfg:AnyIBRef</v8:TypeSet>	любая ссылка ИБ
"CatalogRef" (голый, без .Имя)	<v8:TypeSet>cfg:CatalogRef</v8:TypeSet>	любая ссылка справочника (аналогично DocumentRef, EnumRef, ExchangePlanRef, TaskRef, BusinessProcessRef, ChartOf*Ref)

CatalogRef.Валюты (с .Имя) → обычный <v8:Type>; CatalogRef (голый) → <v8:TypeSet>.

Составные типы

Разделитель " | " (или +). Каждая часть независимо роутится в <v8:Type> или <v8:TypeSet> (можно смешивать):

"type": "CatalogRef.Организации | CatalogRef.ИндивидуальныеПредприниматели"
"type": "CatalogRef.Контрагенты | DefinedType.ДенежнаяСумма"

---

9. Автогенерация

Companion-элементы

Для каждого элемента автоматически создаются служебные вложенные элементы:

Тип элемента	Companions
UsualGroup	ExtendedTooltip
InputField	ContextMenu, ExtendedTooltip
CheckBoxField	ContextMenu, ExtendedTooltip
RadioButtonField	ContextMenu, ExtendedTooltip
LabelDecoration	ContextMenu, ExtendedTooltip
LabelField	ContextMenu, ExtendedTooltip
PictureDecoration	ContextMenu, ExtendedTooltip
PictureField	ContextMenu, ExtendedTooltip
CalendarField	ContextMenu, ExtendedTooltip
Table	ContextMenu, AutoCommandBar, SearchStringAddition, ViewStatusAddition, SearchControlAddition
Pages	ExtendedTooltip
Page	ExtendedTooltip
Button	ExtendedTooltip

Именование: <name>КонтекстноеМеню, <name>РасширеннаяПодсказка, <name>КоманднаяПанель, <name>СтрокаПоиска, <name>СостояниеПросмотра, <name>УправлениеПоиском.

ID

Последовательная нумерация начиная с 1. AutoCommandBar формы всегда имеет id="-1".

Namespace

Все 17 namespace-деклараций добавляются автоматически (version="2.17").

Кодировка

UTF-8 с BOM (как в файлах конфигурации 1С).