metadata_graph — Документация Кванты

metadata_graph

R · чтениепо подпискене изменяет проект

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

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

Перед удалением объекта или сужением типа реквизита — увидеть всех, кого это заденет.
Новый объект выглядит готовым — секция Not filled покажет, что он вне подсистем, без прав в ролях или не используется в коде.
Регистр: какие документы его пишут и какие запросы, включая виртуальные таблицы, его читают — data_flow.
Кто вызывает конкретный метод — это code_graph; где встречается имя в тексте — search.

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

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

Операции

Операции metadata_graph
operation	Что делает	Нужно передать
`used_by`по умолчанию	Входящие связи, сгруппированные по роли источника: тип реквизита, состав подсистем, планов обмена и функциональных опций, владелец справочника, движения документов, права ролей с набором прав, формы, командный интерфейс и упоминания в коде. Длинные группы сворачиваются с указателем на `search` с операцией `references`.	`project`, `target`
`data_flow`	Только для регистров: кто пишет (документы-регистраторы, наборы записей) и кто читает (таблицы запросов, включая виртуальные).	`project`, `target` — регистр

Параметры

Параметры metadata_graph
Параметр и тип	Обязательный	Описание	По умолчанию
`project`строка	да	Идентификатор проекта рабочей области EDT — имя из ответа project_read (например, УТ2020). Для расширения — проект расширения.	—
`target`строка	да	Объект: `Catalog.Контрагенты`, `AccumulationRegister.ТоварыНаСкладах` или реквизит `Catalog.Контрагенты.Attribute.ИНН`. Тип — по-русски или по-английски.	—
`operation`строка	нет	Операция инструмента — значения и их смысл в таблице «Операции».значения: used_by · data_flow	`used_by`
`code`булево	нет	Искать упоминания в модулях, схемах компоновки и макетах (`Справочники.Имя` и т. п.). Это самая долгая часть ответа; `false` — только структурные связи.	`true`
`title`строка	нет	Необязательная подпись вызова до 40 символов: клиент показывает её в шапке карточки вызова. На результат не влияет.	—
`limit`целое	нет	Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000.	`200`
`offset`целое	нет	Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка `lines: …` в конце ответа.	`0`
`filter`строка	нет	Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения.	—

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

Адреса

Цель задаётся параметром target, а не fqn: объект или реквизит.

Адреса metadata_graph
Адрес	Что адресует
`Catalog.Контрагенты`	справочник целиком
`Catalog.Контрагенты.Attribute.ИНН`	один реквизит
`AccumulationRegister.ТоварыНаСкладах`	регистр: для `data_flow`

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

аргументы metadata_graph

{ "project": "УТ2020", "operation": "used_by", "target": "Catalog.Контрагенты" }

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

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

Объект не найден

Адрес не совпадает с объектом проекта — ответ предлагает ближайшие имена.

failed · Unknown operation

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

failed · лицензия

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

Ограничения

Пустой результат всегда с секцией Checked: где именно искали. «Ссылок нет» без области проверки инструмент не утверждает.
Связи из расширений помечены значком 🧩 и именем проекта: расширение заимствует объект под тем же адресом.
Упоминания в коде ищутся по полным обращениям (Справочники.Контрагенты), а не по голому имени — иначе было бы много ложных совпадений.