agentleFS
Nikolay-ShirokovNikolay-Shirokov/cc-1c-skills/.claude/skills/form-edit/SKILL.md

form-edit

Skill789 starsChanged 6 months agoMITView on GitHub

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

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/form-edit — Правка формы

Точечно меняет существующий Form.xml по описанию правок в JSON; остальное в файле не трогает. Перенесённый или изменённый элемент сохраняет свой id — обработчики и обращения из модуля продолжают работать.

Команда

ПараметрОбязательныйОписание
FormPathдаПуть к существующему Form.xml
JsonPathдаПуть к JSON с описанием правок
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-edit.ps1" -FormPath "<путь>" -JsonPath "<путь>"

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

КлючПравка
elementsЭлементы: добавить, перенести, изменить, удалить — список операций, по порядку
attributesРеквизиты: добавить, set — изменить, rename — переименовать, remove — удалить; колонка — путём Таблица.Колонка
commandsКоманды: добавить, set, rename, remove
parametersПараметры формы: добавить, set, rename, remove
titleЗаголовок формы (строка или {ru, en}); null — убрать
propertiesСвойства формы: { "windowOpeningMode": "LockOwnerWindow" }; null у свойства — убрать (references/form-properties.md)
eventsОбработчики событий формы: { "OnOpen": "ПриОткрытии" } — повесить или заменить; { "OnOpen": null } — снять; ["OnOpen"] — имя по конвенции (ПриОткрытии)
excludedCommandsИсключить стандартные команды: ["Copy"]; вернуть: { "remove": ["Copy"] }
conditionalAppearanceДобавить правила условного оформления (references/appearance.md)
commandInterfaceДобавить команды в панели формы (references/command-interface.md)

Все ключи необязательны, в одной правке можно сочетать любые. Имена элементов, реквизитов и команд — из /form-info. Для обработчиков событий и команд, которых ещё нет в модуле формы, навык добавляет в Module.bsl пустые процедуры с нужной сигнатурой — остаётся написать тело.

Элементы

Операцию задаёт ключ:

КлючОперация
тип элемента: input, group, table, …Добавить новый элемент
moveПеренести: имя или список имён (встают подряд в этом порядке) вместе с содержимым
setИзменить свойства: имя или список имён
removeУдалить: имя или список имён; группа, страница, таблица — вместе с содержимым

Куда встаёт добавляемый или переносимый элемент:

КлючиКуда
after: "X" / before: "X"Рядом с X, в его группе
into: "G"В конец G — группы, страницы, таблицы, командной панели
into: "G", first: trueВ начало G

Новый элемент без позиции встаёт в конец формы; следующий без позиции — за ним. У move позиция обязательна.

{
  "attributes": [ { "name": "Срочно", "type": "boolean" } ],
  "elements": [
    { "group": "alwaysHorizontal", "name": "ГруппаОтгрузка", "after": "Контрагент" },
    { "move": ["Склад", "Организация"], "into": "ГруппаОтгрузка" },
    { "check": "Срочно", "path": "Срочно", "into": "ГруппаОтгрузка" },
    { "move": "ТоварыСумма", "before": "ТоварыЦена" },
    { "set": "Ответственный", "visible": false },
    { "set": "Контрагент", "title": "Покупатель", "events": { "OnChange": "КонтрагентПриИзменении" } },
    { "remove": "Комментарий" }
  ]
}

Изменение (set)

  • Ключи — свойства элемента, те же, что при добавлении: заголовок, видимость, доступность, размеры, цвета и шрифт, кнопки поля, параметры выбора и т. д. (таблица ниже и справочники).
  • null возвращает свойству значение по умолчанию.
  • Строка в title меняет русский текст, переводы на другие языки остаются.
  • У группы ориентацию меняет group: { "set": "ГруппаШапка", "group": "vertical" }.
  • events — как у формы: имя вешает или заменяет обработчик, null снимает, список событий даёт имена по конвенции. Процедуры отвязанных обработчиков остаются в модуле — навык их перечисляет.
  • Имя, тип элемента, путь к данным и команду кнопки set не меняет: такой элемент удаляют и добавляют заново.

Удаление вместе с реквизитом

Поле и реквизит, к которому оно привязано, удаляются в одной правке:

{
  "elements":   [ { "remove": "Срочно" } ],
  "attributes": [ { "remove": "Срочно" } ]
}

Новый элемент

Ключ — тип элемента, значение — имя; у group значение — ориентация, а имя задаётся в name.

КлючЭлементПодробно
inputПоле вводаinput-fields.md
check / radioФлажок / переключательinput-fields.md
labelFieldПоле-надпись (значение без редактирования)input-fields.md
labelНадпись, текст — в titletooltips-text.md
groupГруппа: vertical / horizontalIfPossible / alwaysHorizontalgroups-pages.md
pages / pageСтраницы / страницаgroups-pages.md
table / columnGroupТаблица / группа колонокtable-advanced.md
button / popup / buttonGroup / cmdBarКнопка / подменю / группа кнопок / командная панельbuttons-commands.md
picture / picFieldКартинка / поле-картинкаpictures.md

Табличный документ, HTML, календарь, диаграммы и другие особые поля — по индексу ниже.

КлючОписание
nameИмя, если отличается от значения ключа типа. Имена в форме уникальны
pathПуть к данным: "Объект.Склад", "ИмяРеквизита"; колонка таблицы — "Объект.Товары.Сумма"
title / tooltipЗаголовок / подсказка (строка или {ru, en})
visible: false / enabled: false / readOnly: trueСкрыть / сделать недоступным / только чтение
eventsОбработчики: { "OnChange": "ИмяПроцедуры" }; имена по конвенции — списком: ["OnChange", "StartChoice"] (элемент списка может задать имя сам: { "event": "Clearing", "handler": "Имя" })
children / columnsВложенные элементы группы или страницы / колонки таблицы

Поле на новом реквизите формы — реквизит и элемент в одной правке:

{
  "attributes": [ { "name": "СуммаИтого", "type": "decimal(15,2)" } ],
  "elements": [ { "input": "СуммаИтого", "path": "СуммаИтого", "readOnly": true, "after": "Контрагент" } ]
}

Колонка в существующую таблицу — элемент рядом с другой колонкой или into таблицы:

{ "input": "ТоварыСкидка", "path": "Объект.Товары.Скидка", "after": "ТоварыЦена" }

Кнопка — в командную панель формы (ФормаКоманднаяПанель) или таблицы (ТоварыКоманднаяПанель); command — команда формы, stdCommand — стандартная ("Close", у таблицы — "Товары.Add"):

{
  "commands": [ { "name": "Пересчитать", "action": "ПересчитатьОбработка" } ],
  "elements": [ { "button": "Пересчитать", "command": "Пересчитать", "into": "ФормаКоманднаяПанель" } ]
}

Свойства командной панели формы — операция autoCmdBar: { "autoCmdBar": "ФормаКоманднаяПанель", "autofill": false } (без стандартных команд), horizontalAlign.

События

Имена регистрозависимы.

Форма: OnCreateAtServer, OnOpen, BeforeClose, OnClose, NotificationProcessing, ChoiceProcessing, OnReadAtServer, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer, BeforeWrite, AfterWrite, FillCheckProcessingAtServer, BeforeLoadDataFromSettingsAtServer, OnLoadDataFromSettingsAtServer, OnSaveDataInSettingsAtServer, URLProcessing, ExternalEvent, OnReopen

input: OnChange, StartChoice, ChoiceProcessing, AutoComplete, TextEditEnd, Clearing, Opening, Creating, EditTextChange, Tuning, StartListChoice check / radio: OnChange table: Selection, OnActivateRow, OnActivateCell, OnActivateField, BeforeAddRow, BeforeDeleteRow, AfterDeleteRow, BeforeRowChange, OnStartEdit, OnEditEnd, BeforeEditEnd, OnChange, ChoiceProcessing, ValueChoice, BeforeExpand, BeforeCollapse, Drag, DragStart, DragCheck, DragEnd; только у таблицы динамического списка — OnGetDataAtServer, URLGetProcessing, BeforeLoadUserSettingsAtServer, OnLoadUserSettingsAtServer, OnSaveUserSettingsAtServer, OnUpdateUserSettingSetAtServer label: Click, URLProcessing labelField: Click, URLProcessing, OnChange picture: Click, Drag, DragCheck picField: Click, OnChange, Drag, DragCheck calendar: OnChange, Selection, OnActivateDate, OnPeriodOutput pages: OnCurrentPageChange spreadsheet: Selection, OnActivate, OnChangeAreaContent, DetailProcessing, AdditionalDetailProcessing html: OnClick, DocumentComplete

У кнопки, страницы, группы колонок, командной панели и подменю событий нет. Click обычной группы и OnHover, OnSelectedRowsSetChange таблицы — только с платформы 8.5.

Реквизиты, команды, параметры

"attributes": [ { "name": "Итого", "type": "decimal(15,2)", "title": "Итого" },
                { "name": "Данные", "type": "ValueTable", "columns": [ { "name": "Сумма", "type": "decimal(15,2)" } ] } ],
"commands":   [ { "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" } ],
"parameters": [ { "name": "Основание", "type": "DocumentRef.Заказ", "key": true } ]

Типы: string, string(100), decimal(15,2), boolean, date, dateTime, CatalogRef.X, DocumentRef.X, EnumRef.X, ValueTable, ValueList, DynamicList, Тип1 | Тип2 — все типы в references/type-system-advanced.md. Остальные ключи реквизитов — attributes-advanced.md, команд — buttons-commands.md.

Изменение и переименование

set меняет существующий реквизит, команду или параметр — ключами, что и при добавлении; null возвращает значение по умолчанию. Колонка таблицы значений — путём Таблица.Колонка. Колонка реквизита формы в табличной части объекта (сам документ или справочник не меняется) — путём Объект.ТабличнаяЧасть.Колонка:

{
  "attributes": [
    { "set": "Данные.Представление", "type": "string" },
    { "name": "Данные.Код", "type": "string(9)" },
    { "remove": "Данные.Устаревшая" },
    { "name": "Объект.Товары.Скидка", "type": "decimal(15,2)" },
    { "set": "Список", "settings": { "query": "ВЫБРАТЬ …" } }
  ],
  "elements": [ { "input": "ТоварыСкидка", "path": "Объект.Товары.Скидка", "after": "ТоварыКоличество" } ],
  "commands": [ { "set": "Загрузить", "action": "ЗагрузитьИзФайла" } ]
}
  • type заменяет тип целиком. Вид реквизита (таблица ↔ значение ↔ динамический список) и тип основного реквизита не меняются.
  • settings у динамического списка меняет только переданные части — остальные настройки списка остаются.

Переименование — rename и to:

{ "attributes": [ { "rename": "Данные", "to": "Строки", "renameInModule": true } ] }

Пути элементов, условное оформление и командный интерфейс формы переходят на новое имя. renameInModule: true переписывает и обращения в Module.bsl; без него навык перечисляет строки модуля, которые надо поправить. Имена элементов и обработчиков не меняются.

Форма расширения

Форма расширения (с <BaseForm>) распознаётся сама. Свои элементы, реквизиты и команды расширения называют с префиксом расширения (Расш1_Метка) и задают им title — иначе заголовок возьмётся из имени вместе с префиксом. Обработчику указывают вид вызова — callType: Before, After или Override; без него — Before:

{
  "events": { "OnCreateAtServer": { "handler": "Расш1_ПриСозданииПосле", "callType": "After" } },
  "elements": [
    { "set": "Банк", "events": { "OnChange": { "handler": "Расш1_БанкПриИзменении", "callType": "Before" } } },
    { "set": "Склад", "events": [ { "event": "OnChange", "callType": "After" } ] }
  ],
  "commands": [
    { "name": "Подбор", "action": "Расш1_ПодборПосле", "callType": "After" },
    { "name": "Запрос", "actions": [
      { "handler": "Расш1_ЗапросПеред", "callType": "Before" },
      { "handler": "Расш1_ЗапросПосле", "callType": "After" } ] }
  ]
}

Имя по конвенции в расширении — с префиксом и видом вызова: Расш1_СкладПриИзмененииПосле. Привязку определяют событие и вид вызова: { "OnChange": null } снимает все привязки события, { "OnChange": { "handler": null, "callType": "After" } } — только After.

Задача → справочник

Под задачу подгрузите файл из references/:

ЗадачаСправочник
Новые группы и поля в стиле типовых: где разместить, имена групп и элементов, ширины полейlayout-patterns.md
Поле ввода, флажок, переключатель: кнопки, список выбора, быстрый выбор, своя форма выбора, маска, формат, пароль, выключатель/тумблер, поле составного типаinput-fields.md
Ограничить выбор отбором, связать поле с другим полем, связь по типуchoice-params.md
Группа и страницы: ориентация, рамка, свёрнутая группа, интервалы, заголовок из данных, значок закладки, мастер по шагамgroups-pages.md
Таблица: колонки и группы колонок, итоги в подвале, дерево, выделение строк, закрепление колонок, поиск, перетаскиваниеtable-advanced.md
Форма списка: источник данных, запрос, отбор, сортировка, группировка, иерархияdynamic-list.md
Кнопки, подменю, команды: картинка кнопки, переключатель в панели, команды таблицы в группе кнопок, своё контекстное меню у поля, команда для текущей строкиbuttons-commands.md
Подсветить цветом, шрифт, рамка, условное оформление (в форме списка — dynamic-list.md)appearance.md
Расширенная подсказка под полем, надпись с выделением или ссылкойtooltips-text.md
Картинка, значок в колонке, иконка по значениюpictures.md
Табличный документ (печатная форма, отчёт на форме)spreadsheet.md
HTML, текстовый документ, индикатор, ползунок, календарь, периодspecial-fields.md
Диаграмма, диаграмма Ганта, планировщикcharts.md
Свойства формы: модальность, размер, прокрутка, Enter, время и проведение документаform-properties.md
Форма отчёта (СКД)report-form.md
Реквизиты: сохранение в настройках, проверка заполнения, функциональные опцииattributes-advanced.md
Типы реквизитов, составные типы и наборыtype-system-advanced.md
Видимость и доступ по ролямroles-access.md
Командный интерфейс формы (переходы, важные команды)command-interface.md
Размеры, выравнивание, фокус по умолчанию, узкие экраныlayout-advanced.md
Какие события есть у элемента или формы, имена обработчиков, с какой платформыevents.md

Workflow

  1. /form-info — структура формы: имена элементов, реквизиты, команды.
  2. Описать правки в JSON.
  3. /form-edit — применить; в выводе — что добавлено, перенесено, изменено и удалено.
  4. /form-validate — проверить форму.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.