metadata_action

A · действиепо подпискеизменяет проект

Заимствует объект базовой конфигурации в расширение или снимает заимствование. Заимствование — законный способ дорабатывать объект, закрытый поставщиком.

Когда использовать

Нужно доработать объект типовой конфигурации на поддержке — заимствуйте его в расширение и правьте там.
Нужны права на заимствованные объекты в роли расширения — заимствуйте роль: у неё сразу появляется документ прав, дальше rights_write.
Заимствование больше не нужно — unadopt. Необратимо: локальные изменения объекта в расширении теряются.

Соседние инструменты домена «Метаданные»

metadata_readRпосмотреть объект базовой конфигурации перед заимствованием metadata_writeWсоздать, изменить или удалить узел — в том числе в заимствованном объекте metadata_graphRкто использует объект

Операции

Операции metadata_action
operation	Что делает	Нужно передать
`adopt`	Заимствует объект базовой конфигурации в расширение. Для роли дополнительно создаёт документ прав расширения.	`project` — проект расширения; `fqn` — объект базовой конфигурации
`unadopt`	Снимает заимствование. Необратимо: изменения объекта в расширении теряются. После снятия рекомендуется `project_action` с операцией `clean`.	`project` — проект расширения; `fqn`

Параметры

Параметры metadata_action
Параметр и тип	Обязательный	Описание	По умолчанию
`project`строка	да	Проект расширения: заимствование и снятие работают в нём.	—
`operation`строка	да	Операция инструмента — значения и их смысл в таблице «Операции».значения: adopt · unadopt	—
`fqn`строка	да	Объект базовой конфигурации: `Document.РеализацияТоваровУслуг`, `Catalog.Номенклатура`, `Role.<Роль>`. Тип — по-русски или по-английски.	—
`title`строка	нет	Необязательная подпись вызова до 40 символов: клиент показывает её в шапке карточки вызова. На результат не влияет.	—

Таблица собрана из схемы инструмента, которую получает агент при подключении.

Адреса

Адреса metadata_action
Адрес	Что адресует
`Document.РеализацияТоваровУслуг`	документ базовой конфигурации
`Catalog.Номенклатура`	справочник базовой конфигурации
`Role.<Роль>`	роль — вместе с документом прав

Пример вызова и ответа

аргументы metadata_action

{ "project": "УТ2020.<Расширение>", "operation": "adopt", "fqn": "Document.РеализацияТоваровУслуг" }

Пример ответа в подготовке Устройство ответа — на странице Формат ответов.

Отказы и ошибки

Проект — не расширение

project должен быть проектом расширения, а fqn — объектом его базовой конфигурации. Список проектов и их типы — project_read.

failed · Unknown operation

Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: adopt, unadopt.

failed · лицензия

Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.

Ограничения

Режим поддержки не блокирует заимствование: это штатный способ дорабатывать закрытые объекты.
unadopt необратим — сделайте снапшот перед вызовом.