Skill v1.0.0

name: xbsl-form-info description: > Анализ объекта конфигурации 1С:Элемент: возвращает object_path, fields, tc, namespace, suggested_layout, existing_forms. Используется скиллами xbsl-form-add и xbsl-file-add перед созданием или изменением форм и реквизитов. Вызывай этот скилл всякий раз, когда нужно узнать структуру объекта (реквизиты, ТЧ, пространство имён, существующие формы) перед добавлением компонентов интерфейса или реквизитов-вложений. compatibility: Requires Python 3. metadata: version: "1.0.0"

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

Назначение

Запускает scripts/form_info.py и возвращает JSON-структуру с данными об объекте конфигурации.

Команда

{python} skills/xbsl-form-info/scripts/form_info.py --name <ИмяОбъекта> --root . --target-version 10.0

--target-version определяет вид иерархии по умолчанию, когда Иерархия.Вид не задан: с 10.0 — ИерархияГруппИЭлементов, до 10.0 — ИерархияЭлементов. По умолчанию CLI использует 10.0.

Возвращает JSON

{
  "object_path": "/path/to/subsystem",
  "object_file": "Сотрудники.yaml",
  "object_type": "Справочник",
  "namespace": "vendor::project::subsystem",
  "field_count": 7,
  "tc_count": 1,
  "fields": [{"name": "Имя", "type": "Строка"}],
  "tc": [{"name": "Навыки"}],
  "suggested_layout": "panels",
  "existing_forms": {
    "ФормаОбъекта": "СотрудникиФормаОбъекта.yaml",
    "ФормаСписка": null
  },
  "is_hierarchical": false,
  "hierarchy_kind": null,
  "parent_reference_type": null,
  "additional_hierarchies": [],
  "report_params": [],
  "data_source_kind": null,
  "data_source": null
}

Варианты suggested_layout

Обработка ошибок

• Объект не найден: {"error": "...", "searched_in": "..."}
• Найдено несколько объектов: {"error": "...", "matches": [...]}