Immutable. This exact content is served forever at /api/v1/blob/0bd9fcdf446f094a.
---
name: meta-add
description: Создать и при необходимости сразу настроить один объект метаданных 1С через атомарную типизированную операцию.
argument-hint: <sourceSet> <kind> <name> [operations] [dryRun]
allowed-tools:
- Read
- Glob
---
# /unica:meta-add — создание объекта метаданных
## MCP routing
- Preferred path: use MCP `unica` tool `unica.meta.add`.
- Передайте логический набор исходников `sourceSet`, поддерживаемый вид `kind`,
имя `name`, при необходимости непустой массив `operations` и `dryRun`.
- Вызов по умолчанию строит preview. Передавайте `dryRun: false` только когда
пользователь явно попросил применить изменение.
- Когда объект должен быть настроен уже при создании, передайте `operations`
того же закрытого типизированного контракта, что у `unica.meta.edit`. Шаблон,
операции, дочерние ресурсы и регистрация публикуются одной транзакцией.
- Источник `EventSubscription` задаётся при создании тем же вариантом
`editRelations`, что и при последующем редактировании: `relation: "source"`,
`mode: "replace"` и типизированный массив `targets`. Отдельного шестого
значения `op` для источника нет. Передайте `Event` и `Handler` через
`setProperties` в том же вызове, если итоговой связке не подходит выбранный
минимальным шаблоном обработчик. Явный `Handler` не требует наличия отдельной
двухпараметрической процедуры-заглушки.
- Для изменений уже существующего объекта используйте `unica.meta.edit`.
- Успешный и предметно неуспешный `tools/call` возвращает `structuredContent`;
`isError == !structuredContent.ok`. Читайте проверку из
`structuredContent.data.validation`; `content[0].text` не является вторым
контрактом результата.
- Preview описывает изменение семантическими
`structuredContent.data.effects`, а не возвращает полный XML объекта.
- `sourceSet` — это имя набора исходников из `v8project.yaml`, а не
константа. Получите его через `unica.view {}`; `"main"` в примерах
ниже — иллюстрация, а не значение по умолчанию.
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.meta.add",
"arguments": {
"cwd": "<workspace>",
"sourceSet": "main",
"kind": "Catalog",
"name": "НовыйСправочник",
"operations": [
{
"op": "setProperties",
"values": {"Comment": "Создан и настроен одним вызовом"}
},
{
"op": "add",
"collection": "attributes",
"elements": [
{
"name": "ВнешнийИдентификатор",
"type": {
"variants": [
{"kind": "uuid"}
]
},
"required": true
}
]
}
],
"dryRun": true
}
}
}
```
### Создать подписку с типизированным источником
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.meta.add",
"arguments": {
"cwd": "<workspace>",
"sourceSet": "main",
"kind": "EventSubscription",
"name": "ПередЗаписьюНоменклатуры",
"operations": [
{
"op": "editRelations",
"relation": "source",
"mode": "replace",
"targets": [
{
"kind": "object",
"metadataPath": "Catalog.Номенклатура"
}
]
},
{
"op": "setProperties",
"values": {
"Event": "BeforeWrite",
"Handler": "CommonModule.ОбработчикиПодписок.ПередЗаписьюНоменклатуры"
}
}
],
"dryRun": true
}
}
}
```
Объект каталога передаёт событию `BeforeWrite` параметр `Cancel`; обработчик
должен быть экспортной процедурой `(Source, Cancel)` в общем модуле с явными
`Global=false`, `Server=true`. Пустой итоговый `Source`, примитивы, ссылки,
неизвестное событие или несовместимая сигнатура отклоняются до публикации.
Имена, синонимы, представления и правила заполнения сверяйте с
[общими соглашениями Unica](../../references/platform/metadata-conventions.md).
Полный список `kind` берите из опубликованной схемы `unica.meta.add`: схема
является контрактом, поэтому перечень не дублируется в скилле.