Во всех командах ниже {python} означает python в Windows и python3 в macOS/Linux/WSL. Выбирай команду сразу по текущей ОС, не запускай оба варианта.

Создание формы интерфейса в 1С:Элемент

Шаг 0: Определи что нужно создать

Уточни у пользователя имя объекта, если оно не указано.

Шаги 1 и 2: выполни параллельно

Шаг 1 — Загрузи спецификацию. Прочитай нужные файлы из references/:

• При создании ФормаОбъекта → прочитай references/ФормаОбъекта.md
• При создании ФормаСписка → прочитай references/ФормаСписка.md
• При создании ФормаОтчета → прочитай references/ФормаОтчета.md
• При запросе настроек «Избранного» на target 10.0+ → прочитай references/favorites-10.md; в обычные формы свойство не добавляй
• Читай references/elements.md только если нужны нестандартные элементы: вложенные файлы, изображения, сворачиваемые блоки, статусы с цветом, надписи/labels, кнопки действий, вкладки (Страницы) — иначе пропусти
• Для ПанельТегов, ПанельЭтапов, КанбанДоска или ГеографическаяКарта на target 10.0+ читай references/components-10.md. На более старом target эти компоненты не генерируй.
• Для КомпонентОбсуждения.ОтображатьЗаголовок, программного выбора раздела ШаблонФормыСРазделами или вложенных узлов встроенных веб-страниц на target 10.0+ читай references/ui-deltas-10.md. Встроенные веб-страницы размещаются в компоненте приложения (Приложение.yaml), а не в форме объекта; если пользователь просит кастомное меню без существующей команды или компонента, оставь стандартное меню и сообщи, какие элементы нужно определить.

Шаг 2 — Анализ объекта. Вызови скилл xbsl-form-info:

{python} skills/xbsl-form-info/scripts/form_info.py --name <ИмяОбъекта> --root . --target-version <ЦелеваяВерсия>

Из результата возьми: - object_path — папка куда класть файлы форм (путь там, где живёт объект) - object_file — имя файла объекта (нужен для обновления в шаге 6) - object_type — тип объекта - namespace — пространство имён (vendor::project::subsystem), используется в типах ФормаСписка - fields — список реквизитов с именами и типами (используй их — не придумывай!) - tc — список табличных частей - suggested_layout — рекомендация: simple / panels / tabs / report (для объектов типа Отчет) - existing_forms — какие формы уже существуют (для Отчет содержит ключ ФормаОтчета) - is_hierarchical — true если справочник имеет Иерархический: Истина - hierarchy_kind — ИерархияГруппИЭлементов или ИерархияЭлементов для иерархического справочника; на target 10.0 при отсутствии Иерархия.Вид применяется первый вид по умолчанию - parent_reference_type — тип системного реквизита Родитель для формы элемента; при группах это <Справочник>.Группы.Ссылка?, при иерархии элементов — <Справочник>.Ссылка? - additional_hierarchies — список доп. иерархий [{name, field}] (паттерн Б, пуст при А) - report_params — параметры ПараметрыЗапроса и Макет.Параметры ([{name, type}] или [{name, type, required}] для параметров макета); для совпадающих имён параметр макета задаёт тип и обязательность - data_source_kind — Таблица или Запрос (только для объектов типа Отчет) - data_source — имя таблицы источника (только для объектов типа Отчет с ВидИсточникаДанных: Таблица)

Если у реквизита объекта на target 10.0+ задана ВажностьПриОтображении, учитывай её только при решении, нужен ли реквизит в автоматически построенном интерфейсе. Пользовательская форма управляется собственным Содержимое: не копируй это свойство в ПолеВвода и не скрывай явно запрошенное поле без согласования с задачей.

Иерархический справочник: если is_hierarchical: true или additional_hierarchies не пуст — используй соответствующий вид из references/ФормаСписка.md для ФормаСписка. Тип поля Родитель в форме элемента бери из parent_reference_type. Подробности в references/ФормаОбъекта.md.

Если скрипт вернул error: - сообщи пользователю текст ошибки; - если в ответе есть matches — покажи кандидатов и попроси уточнить проект/подсистему; - не создавай и не обновляй формы, пока пользователь не уточнит нужный объект.

Шаг 3: Проверь существующие формы

Если в existing_forms есть ненулевые значения — сообщи пользователю какие формы уже существуют и спроси: перезаписать или пропустить? Не создавай файл без явного подтверждения.

Шаг 4: Сгенерируй UUID

Нужен 1 UUID на каждую форму (только для тех, которые будут созданы). Вызови скилл xbsl-uuid с нужным числом (1 или 2).

Шаг 5: Создай файлы форм

Для каждой создаваемой формы создай файл в object_path.

Именование файлов

Заголовок формы

• ФормаОбъекта → единственное число: Сотрудник, Заказ покупателя, Контрагент
• ФормаСписка → множественное/название объекта: Сотрудники, Заказы покупателей

Важные правила

• ВключатьВАвтоИнтерфейс: Ложь — всегда указывай в обеих формах
• Для ФормаСписка: используй namespace из скрипта для типов (<ns>::<ИмяОбъекта>ФормаСписка.ДанныеСтрокиСписка)
• Для ФормаСписка: динамический список описывается в секции Свойства внизу файла (не внутри Содержимое), таблица ссылается на него через Источник: =Список
• Колонки в ФормаСписка используют Значение: =ДанныеСтроки.Данные.<Поле> (не ПолеЗначения)
• suggested_layout из скрипта определяет шаблон: simple → ПроизвольныйШаблонФормы, panels → панели (Группа), tabs → вкладки (РазделФормы)

Шаг 6: Обнови объектный YAML

После создания файлов форм обязательно обнови файл объекта (object_path/object_file). Добавь или дополни секцию Интерфейс.

Секция добавляется сразу после строки ОбластьВидимости (или после Ид/Имя, если ОбластьВидимости отсутствует), до Реквизиты / ВидИсточникаДанных.

Для Справочника, Документа, РегистрСведений и других:

Интерфейс:
    ВключатьВАвтоИнтерфейс: Истина
    ИспользоватьСозданиеПриВводе: Истина   # только для Справочника
    Объект:
        Форма: <ИмяОбъекта>ФормаОбъекта    # только если создаётся/существует ФормаОбъекта
    Список:
        Форма: <ИмяОбъекта>ФормаСписка     # только если создаётся/существует ФормаСписка

Для объекта типа Отчет:

Структура внутри Интерфейс плоская — без подсекций Объект/Список:

Интерфейс:
    ВключатьВАвтоИнтерфейс: Истина
    Форма: <ИмяОтчета>ФормаОтчета

Правила: - Если уже есть секция Интерфейс, обнови только нужные поля, не перезаписывай остальные. - Для Отчет проверяй Интерфейс.Форма отдельно от Интерфейс.ВключатьВАвтоИнтерфейс; пользовательская форма необязательна. - Макет.Параметры[].Обязательный: Истина проверяет построение отчёта при пустом значении. Покажи этот параметр в форме, если пользователь просит управление им; не добавляй выдуманное свойство обязательности в ПолеВвода. - ИспользоватьСозданиеПриВводе: Истина — только для Справочник; для Документ, Отчет и других типов не добавляй - Добавляй только те подсекции (Объект, Список), формы для которых существуют или создаются