mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-09-20 09:15:52 +03:00
form-add отказывал видом объекта 'Table', хотя платформа такие формы делает, а в DSL таблицы есть слоты defaultObjectForm/defaultRecordForm/defaultListForm/defaultChoiceForm. Инструкция при этом обещала обратное — строка исправлена. Таблица — единственный вид, чьи ссылки трёхчастные: слот ExternalDataSource.<И>.Table.<Т>.Form.<Ф>, главный реквизит ExternalDataSourceTableObject.<И>.<Т>, MainTable динамического списка ExternalDataSource.<И>.Table.<Т>. Имя источника в файле таблицы не хранится — берётся из пути ExternalDataSources/<И>/Tables/<Т>.xml, единственное место, где навык смотрит на путь. Набор назначений зависит от вида данных таблицы — замерено загрузками на 8.3.24.1691: ObjectData даёт Object/List/Choice, NonobjectData — Record/List/Choice. Неверная пара схемой формы не отвергается: она валит загрузку ВСЕЙ конфигурации «Исключением XDTO при чтении файла» без указания причины, поэтому form-add проверяет её сам и объясняет, а без -Purpose у таблицы с составным ключом основной становится форма записи. form-validate: типы ExternalDataSourceTable* добавлены в список известных cfg-префиксов — иначе корректная форма получала предупреждение «unrecognized cfg prefix». Проверено: form-add и form-validate зелёные в обоих рантаймах, гарды прошли (в том числе check-form-purposes: спека и оба порта сходятся), снэпшот eds-table-forms принят платформой, формы всех четырёх назначений загружены в базу и выгружены обратно со ссылками без потерь. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NBsZA5cr2WFThtgp7i5WVi
99 lines
5.5 KiB
Markdown
99 lines
5.5 KiB
Markdown
---
|
|
name: form-add
|
|
description: Добавить пустую управляемую форму к объекту 1С. Используй когда нужно создать у объекта новую форму
|
|
argument-hint: <ObjectPath> <FormName> [-Purpose <Purpose>] [-Synonym <Synonym>] [-SetDefault]
|
|
allowed-tools:
|
|
- Bash
|
|
- Read
|
|
- Write
|
|
- Edit
|
|
- Glob
|
|
- Grep
|
|
---
|
|
|
|
# /form-add — Добавление формы к объекту конфигурации
|
|
|
|
Создаёт управляемую форму (metadata XML + Form.xml + Module.bsl) и регистрирует её в корневом XML объекта конфигурации (Document, Catalog, InformationRegister и др.).
|
|
|
|
## Usage
|
|
|
|
```
|
|
/form-add <ObjectPath> <FormName> [-Purpose <Purpose>] [-Synonym <Synonym>] [-SetDefault]
|
|
```
|
|
|
|
| Параметр | Обязательный | По умолчанию | Описание |
|
|
|-------------|:------------:|--------------|----------------------------------------------|
|
|
| ObjectPath | да | — | Путь к XML-файлу объекта (Documents/Док.xml) |
|
|
| FormName | да | — | Имя формы (ФормаДокумента) |
|
|
| Purpose | нет | основная форма вида | Назначение формы — см. таблицу ниже: у справочника это форма объекта, у регистра сведений — форма записи, у журнала — форма списка |
|
|
| Synonym | нет | = FormName | Синоним формы |
|
|
| -SetDefault | нет | авто | Сделать основной. Без флага основной становится первая форма каждого назначения |
|
|
|
|
## Команда
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
|
|
```
|
|
|
|
## Purpose — назначение формы
|
|
|
|
| Purpose | Какая форма | Становится основной |
|
|
|---------|-------------|---------------------|
|
|
| Object | форма объекта (элемента, документа, обработки) | да |
|
|
| List | форма списка | да |
|
|
| Choice | форма выбора | да |
|
|
| Folder | форма группы | да |
|
|
| FolderChoice | форма выбора группы | да |
|
|
| Record | форма записи | да |
|
|
| RecordSet | форма набора записей | нет — в платформе нет такого свойства |
|
|
| Save | форма сохранения настроек | да |
|
|
| Load | форма загрузки настроек | да |
|
|
| Custom | произвольная форма, без привязки к объекту | нет |
|
|
|
|
### Что доступно типу объекта
|
|
|
|
| Тип объекта | Назначения |
|
|
|-------------|------------|
|
|
| Catalog, ChartOfCharacteristicTypes | Object, Folder, List, Choice, FolderChoice, Custom |
|
|
| Document, ChartOfAccounts, ChartOfCalculationTypes, ExchangePlan, BusinessProcess, Task | Object, List, Choice, Custom |
|
|
| DataProcessor, Report, ExternalDataProcessor, ExternalReport | Object, Custom |
|
|
| InformationRegister | Record, List, RecordSet, Custom |
|
|
| AccumulationRegister, AccountingRegister, CalculationRegister | List, RecordSet, Custom |
|
|
| DocumentJournal, FilterCriterion | List, Custom |
|
|
| Enum | List, Choice, Custom |
|
|
| SettingsStorage | Save, Load, Custom |
|
|
| Table (таблица внешнего источника) | `tableDataType=ObjectData` — Object, List, Choice, Custom; `NonobjectData` — Record, List, Choice, Custom |
|
|
|
|
Недопустимое сочетание отклоняется со списком доступных для этого типа. У константы собственных
|
|
форм нет — для неё используется общая форма (`CommonForm`).
|
|
|
|
Таблица внешнего источника адресуется файлом таблицы:
|
|
`ExternalDataSources/<Источник>/Tables/<Таблица>.xml`. Ссылки в такой форме трёхчастные;
|
|
без `-Purpose` берётся форма объекта, а у таблицы с составным ключом — форма записи.
|
|
|
|
## Примеры
|
|
|
|
```
|
|
# Форма документа
|
|
/form-add Documents/АвансовыйОтчет.xml ФормаДокумента -Purpose Object
|
|
|
|
# Форма списка каталога
|
|
/form-add Catalogs/Контрагенты.xml ФормаСписка -Purpose List
|
|
|
|
# Форма записи регистра сведений
|
|
/form-add InformationRegisters/КурсыВалют.xml ФормаЗаписи -Purpose Record
|
|
|
|
# Форма выбора с синонимом
|
|
/form-add Catalogs/Номенклатура.xml ФормаВыбора -Purpose Choice -Synonym "Выбор номенклатуры"
|
|
|
|
# Установить как форму по умолчанию
|
|
/form-add Documents/Заказ.xml ФормаДокументаНовая -Purpose Object -SetDefault
|
|
```
|
|
|
|
## Workflow
|
|
|
|
1. `/form-add` — создать каркас формы
|
|
2. `/form-compile` или `/form-edit` — наполнить Form.xml элементами
|
|
3. `/form-validate` — проверить корректность
|
|
4. `/form-info` — проанализировать результат
|