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

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

Где встречается строка или шаблон — text; только в макетах и СКД — sources.
Найти объект или метод по части имени — symbol; все объекты вида — type без query.
Перед переименованием или удалением — references: точные ссылки и те, что нужно проверить глазами.
Кто вызывает метод, одним уровнем по тексту — calls; дерево вызовов с неявными связями — code_graph.

Соседние инструменты домена «Сквозные»

validateRПроверяет проект или один объект — ошибки и предупреждения EDT, проверки по стандартам ИТС (структура модулей, обмен данными, запросы, права ролей), недостижимый код. Умеет сохранить базовый уровень и потом показывать только новые проблемы.platform_docsRСправка синтакс-помощника платформы 1С карточками — тип со всеми членами, метод с синтаксисом, параметрами и возвращаемым значением, свойство; полнотекстовый поиск и дерево разделов. Плюс описание метода вашего проекта и тип выражения в модуле.

Операции

Операции search
operation	Что делает	Нужно передать
`text`по умолчанию	Подстрока или регулярное выражение по файлам проектов. Совпадения сгруппированы по адресу файла (`Catalog.X.Form.Y · form (3)`); в макетах и СКД к строке добавляется место внутри — `.Cell.RnCm`, `.DataSet.X.Field.Y`; в правах — `.Rights::Catalog.Y · Read`.	`query`; по желанию `regex`, `case_sensitive`, `sources`, `path_includes`, `context`
`symbol`	Объекты метаданных и методы по подстроке имени; методы — в виде `Модуль::Метод`, готовом для `references`. Значения перечислений и предопределённые элементы — по явному `symbol_kinds`.	`query`, или `type`, или `symbol_kinds`
`references`	Все ссылки на цель: секция `certain` — точные ссылки, которые затронет переименование или удаление; `possible` — совпадения в строках и метапрограммировании для ручной проверки.	`project`, `target`
`calls`	Места вызова `Модуль.Метод(` по тексту, один уровень.	`query` — имя метода

Параметры

Параметры search
Параметр и тип	Обязательный	Описание	По умолчанию
`projects`массив (строка)	нет	Список проектов. По умолчанию — все открытые проекты рабочей области.	—
`project`строка	для `references`	Один проект вместо списка `projects`; для `references` обязателен.	—
`operation`строка	нет	Операция инструмента — значения и их смысл в таблице «Операции».значения: text · symbol · references · calls	`text`
`query`строка	нет	Строка поиска для `text`, `symbol`, `calls`. Для `symbol` можно не задавать, если задан `type` или `symbol_kinds`: тогда — полный список объектов вида; методы без `query` не перечисляются.	—
`target`строка	для `references`	Для `references`: `Catalog.Контрагенты` (объект), `CommonModule.X::Метод` (метод), `Catalog.X.Attribute.Y` (реквизит, измерение, ресурс). Тип — по-русски или по-английски.	—
`regex`булево	нет	Для `text`: считать `query` регулярным выражением.	`false`
`case_sensitive`булево	нет	Учитывать регистр.	`false`
`sources`массив (строка)	нет	Для `text`: наборы файлов — `code`, `forms`, `metadata`, `templates` (макеты), `dcs` (схемы и настройки компоновки), `rights`, `all` (плюс встроенная справка). По умолчанию — всё, кроме справки.значения: code · forms · metadata · templates · dcs · rights · all	—
`symbol_kinds`массив (строка)	нет	Для `symbol`: `top` — объекты метаданных, `method` — методы, `enum_value` — значения перечислений, `predefined` — предопределённые элементы. По умолчанию `top` и `method`.значения: top · method · enum_value · predefined	—
`type`строка	нет	Для `symbol`: вид объектов — `Справочник`, `ОбщийМодуль`, `Документ` или `Catalog`, `CommonModule`…	—
`path_includes`строка	нет	Подстрока пути файла относительно проекта, например `src/CommonModules/`.	—
`context`целое	нет	Для `text`: сколько строк контекста до и после совпадения, 0–10; совпавшая строка отмечается `►`.	`0`
`limit`целое	нет	Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000.	`200`
`offset`целое	нет	Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка `lines: …` в конце ответа.	`0`
`filter`строка	нет	Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения.	—

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

Адреса

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

Адреса search
Адрес	Что адресует
`Catalog.Контрагенты`	ссылки на справочник
`Catalog.Контрагенты.Attribute.ИНН`	ссылки на реквизит
`CommonModule.ОбщегоНазначения::ЗначениеРеквизитаОбъекта`	ссылки на метод

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

Бесплатный инструмент: работает без ключа. Дайджест > Σ N matches · M files · <проект> · K ms; при 300 и более совпадениях — секция Top loci, где совпадений больше всего.

аргументы search

{
  "operation": "text",
  "project": "УТ2020",
  "query": "ВызватьИсключение\\s*\\(",
  "regex": true,
  "path_includes": "src/CommonModules/"
}

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

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

failed · неизвестная операция

Операция с опечаткой — ответ перечисляет допустимые и предлагает ближайшие.

ответ инструмента

### 🔴 search — `txt`

- **status:** 🔴 failed
- **message:** Unknown operation: txt
- **fix_hint:** supported: text, symbol, references, calls

#### Did you mean

- text
- symbol
- references
- calls

Долгий первый поиск ссылок

Сразу после запуска EDT references ждёт индекс ссылок — Таймаут первого поиска ссылок.

failed · Unknown operation

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

Ограничения

Не больше 1000 совпадений за вызов — сузьте query, sources или path_includes; превышение отмечено в ответе.
Совпадения внутри строковых литералов в references попадают в possible — их нужно проверить глазами.
Файлы макетов и схем больше 2 МБ не размечаются местом внутри файла; файлы прав — до 16 МБ.