К статье
Практический материал

Разработка и Конфигурация · 12 мин

Как найти документ в конфигураторе 1С

Как найти документ в конфигураторе 1С: поиск по дереву метаданных, глобальный поиск Ctrl+Shift+F, поиск ссылок и функциональных опций. Практические советы.

В конфигураторе 1С документом называют объект метаданных — описание структуры документа в дереве конфигурации, а не конкретную проведённую запись вроде «Реализация товаров № 125». Найти нужный объект документа можно несколькими способами: через дерево метаданных, глобальный поиск по конфигурации, поиск ссылок на объект и через настройку фильтрации дерева. Выбор способа зависит от того, что известно: имя объекта, синоним, фрагмент кода или только то, что документ где-то используется.

Быстрее всего работает глобальный поиск по сочетанию Ctrl+Shift+F — он ищет по именам, синонимам, модулям и текстам кода всей конфигурации. Если имя документа известно точно, достаточно отфильтровать дерево конфигурации. Сложнее, когда нужно понять, в каких подсистемах, журналах и отчётах задействован конкретный документ — тогда помогает поиск ссылок на объект метаданных.

Перед любыми изменениями найденного документа убедитесь, что конфигурация находится на поддержке и вы понимаете последствия правки: изменение типового объекта затруднит последующие обновления. Ниже разобраны все рабочие способы поиска с условиями выбора и проверкой результата.

Где в дереве конфигурации находятся документы

Откройте конфигуратор, загрузите нужную информационную базу и вызовите дерево конфигурации через меню «Конфигурация — Открыть конфигурацию» или кнопку на панели инструментов. Если конфигурация закрыта, пункт «Открыть конфигурацию» будет единственным доступным — после открытия появится дерево метаданных.

В дереве найдите ветку «Документы» — она располагается на верхнем уровне, между «Справочники» и «Журналы документов». Раскройте её двойным щелчком или значком «плюс»: внутри перечислены все виды документов конфигурации в алфавитном порядке по имени объекта, а не по синониму, который видит пользователь.

Это важный нюанс: пользовательский документ «Реализация товаров и услуг» в дереве может называться РеализацияТоваровУслуг без пробелов. Если вы ищете глазами по синониму, документ легко «потерять». В таком случае надёжнее использовать фильтр или поиск, описанные ниже.

Быстрый поиск по имени через фильтр дерева

Если конфигурация большая (в типовых решениях сотни документов), прокручивать ветку вручную неудобно. Нажмите в дереве конфигурации кнопку «Действия» (или щёлкните правой кнопкой мыши по корню дерева) и выберите «Отбор по подсистемам» либо используйте строку поиска в панели дерева — в современных версиях платформы над деревом есть поле для ввода подстроки.

Начните вводить часть имени документа, например «реализ». Дерево автоматически отфильтруется и покажет только подходящие объекты: РеализацияТоваровУслуг, РеализацияОтгруженныхТоваров и другие. Двойной щелчок по объекту откроет окно редактирования с закладками «Данные», «Движения», «Проведение» и другими.

Фильтр работает и по другим веткам дерева одновременно, поэтому в результатах могут появиться справочники, отчёты и обработки с похожими именами. Ориентируйтесь на пиктограмму объекта и ветку, в которой он находится.

Порядок действий
  1. 1
    Откройте конфигуратор и дерево конфигурации (Конфигурация — Открыть конфигурацию)
  2. 2
    Раскройте ветку «Документы» или установите курсор на корень дерева
  3. 3
    Введите часть имени документа в поле поиска над деревом
  4. 4
    Дважды щёлкните по найденному объекту, чтобы открыть его свойства
  5. 5
    Проверьте на вкладке «Данные» реквизиты и убедитесь, что это нужный документ

Глобальный поиск по конфигурации (Ctrl+Shift+F)

Глобальный поиск — основной инструмент, когда точного имени документа вы не знаете или нужно найти упоминания документа в коде. Нажмите Ctrl+Shift+F или выберите «Правка — Глобальный поиск по текстам». В поле «Что искать» введите имя, синоним или фрагмент кода, например Документы.РеализацияТоваровУслуг.

В параметрах поиска укажите область: «Вся конфигурация» или «Текущий объект». Полезные опции — «Искать в синонимах» и «Учитывать регистр». Если ищете русское название вроде «Поступление товаров», включите поиск по синонимам, иначе поиск пройдёт только по именам объектов и текстам модулей.

Результат появится в окне «Результаты поиска» в виде списка: объект метаданных, модуль, строка кода. Двойной щелчок по строке открывает соответствующий модуль или объект в нужной позиции. По клавише F3 можно переходить к следующему найденному вхождению.

Поиск по представлению документа

Когда известно только пользовательское название, введите его в глобальный поиск с включённым поиском по синонимам. Например, по строке «Счёт на оплату покупателю» поиск найдёт объект СчетНаОплатуПокупателю и все места, где этот синоним встречается в коде и макетах.

Поиск по фрагменту кода

Если вы видели в отладчике или в сообщении об ошибке фрагмент вроде Документы.ЗаказКлиента.НайтиПоНомеру, вставьте его в глобальный поиск — так вы найдёте и сам объект, и все процедуры, где он используется. Это самый надёжный способ при разборе чужого кода.

Глобальный поиск по большой конфигурации может занимать заметное время. Сузьте область поиска до конкретной ветки (например, только «Документы») или отключите поиск в макетах и картинках — это заметно ускорит работу.
ПЗ
Практическое замечание

Поиск ссылок на объект документа

Частая задача — узнать, где конкретный документ используется: в каких журналах он регистрируется, в какие подсистемы входит, какие отчёты и процедуры к нему обращаются. Для этого в дереве конфигурации щёлкните правой кнопкой по документу и выберите «Поиск ссылок на объекты».

Конфигуратор построит список всех объектов метаданных, где на документ есть ссылка: журналы документов, критерии отбора, подсистемы, последовательности, модули, формы других объектов. Двойной щелчок по строке результата открывает соответствующий объект.

Есть и обратная операция — «Поиск ссылок в объекте». Она показывает, на какие метаданные ссылается сам документ: справочники в реквизитах, регистры в движениях, перечисления. Это полезно перед удалением или переименованием объекта, чтобы оценить масштаб затронутых мест.

Как найти документ по подсистеме и функциональным опциям

В типовых конфигурациях документы распределены по подсистемам («Продажи», «Закупки», «Склад» и т.д.). Если вы знаете, к какому разделу относится документ, откройте дерево конфигурации, нажмите кнопку «Действия» и выберите «Отбор по подсистемам». Отметьте нужную подсистему — дерево покажет только входящие в неё объекты, включая документы.

Другой вариант — открыть саму подсистему (ветка «Общие — Подсистемы»), перейти на закладку «Состав» и посмотреть список документов. Это удобно, когда нужно проверить, включён ли документ в интерфейс пользователей: если объекта нет ни в одной подсистеме, он не отображается в панели разделов.

Учтите, что видимость документа в режиме «Предприятие» может дополнительно управляться функциональными опциями. Если документ есть в подсистеме, но пользователи его не видят, проверьте вкладку «Функциональные опции» в свойствах документа и значения соответствующих констант в базе.

Маршрут решения

Как выбрать способ поиска

Известно точное имя объектаИспользуйте фильтр дерева конфигурации или ветку «Документы»
Известно только пользовательское названиеГлобальный поиск Ctrl+Shift+F с включённым поиском по синонимам
Нужно найти все места использования документаКонтекстное меню объекта — «Поиск ссылок на объекты»
Нужно найти документы конкретного раздела учётаОтбор дерева по подсистемам или состав подсистемы
Известен фрагмент кода или сообщение об ошибкеГлобальный поиск по тексту кода по всей конфигурации

Как проверить, что найден нужный документ

После поиска убедитесь, что объект именно тот, который вы искали. Откройте документ двойным щелчком и сверьте синоним на закладке «Основные» — он должен совпадать с названием, которое видят пользователи. На закладке «Данные» проверьте реквизиты шапки и табличные части: их состав должен соответствовать ожидаемому документу.

Дополнительная проверка — закладка «Движения»: там перечислены регистры, по которым документ проводится. Например, у документа реализации обычно есть движения по регистрам продаж и взаиморасчётов. Если движения не соответствуют смыслу документа, вероятно, вы открыли похожий, но другой объект.

Наконец, сравните поведение в режиме «Предприятие»: откройте список документов этого вида и убедитесь, что форма списка и форма документа совпадают с теми, что дорабатываются в конфигураторе. В расширенных конфигурациях формы могут быть переопределены расширением — проверьте ветку «Расширения конфигурации».

Контрольные точки

Как проверить результат

Синоним объекта
Норма

Совпадает с названием документа в режиме «Предприятие»

Тревожный признак

Синоним другой — найден похожий, но не тот объект

Состав реквизитов
Норма

Реквизиты и табличные части соответствуют форме документа у пользователя

Тревожный признак

Набор полей отличается — возможно, форма переопределена расширением

Движения по регистрам
Норма

Регистры соответствуют учётному смыслу документа

Тревожный признак

Движений нет или они чужие — объект выбран неверно

Наличие в подсистемах
Норма

Документ входит в ожидаемый раздел интерфейса

Тревожный признак

Документа нет ни в одной подсистеме — пользователи его не видят

Типичные ошибки при поиске документов

Самая частая ошибка — поиск документа по синониму в дереве конфигурации, где объекты отсортированы по внутреннему имени. Пользователь ищет «Авансовый отчёт» глазами по букве «А», а объект называется АвансовыйОтчет и может стоять не там, где ожидается, из-за другого написания. Используйте фильтр или глобальный поиск.

Вторая ошибка — путать объект метаданных с данными. Конфигуратор показывает структуру документа, а сами проведённые документы с номерами и датами находятся в режиме «Предприятие». Если нужно найти конкретный документ по номеру, делайте это в пользовательском режиме через список документов или полнотекстовый поиск.

Третья ошибка — игнорировать расширения. Если конфигурация доработана расширениями, нужный документ или его форма могут находиться в расширении, а не в основной конфигурации. Откройте «Конфигурация — Расширения конфигурации» и проверьте состав заимствованных объектов.

Типичные ошибки
01
Искать в дереве по пользовательскому синониму — объекты отсортированы по внутреннему имени без пробелов, поиск глазами не срабатывает
02
Искать конкретный проведённый документ в конфигураторе — данные с номерами и датами находятся только в режиме «Предприятие»
03
Не проверять расширения конфигурации — доработанная форма или сам объект могут быть заимствованы в расширение
04
Править типовой документ без снятия копии — при обновлении конфигурации изменения будут потеряны или заблокируют обновление

Частые вопросы

Как найти документ в конфигураторе, если известен только его номер?

Никак — по номеру ищутся данные, а конфигуратор работает со структурой метаданных. Откройте режим «Предприятие», перейдите в список документов нужного вида и используйте поиск по номеру или полнотекстовый поиск по базе. В конфигураторе можно найти только вид документа, к которому эта запись относится.

Почему глобальный поиск не находит документ по русскому названию?

По умолчанию поиск идёт по именам объектов и текстам модулей, а внутренние имена пишутся без пробелов и часто сокращённо. В параметрах глобального поиска включите поиск по синонимам — тогда по строке «Поступление товаров» будет найден объект с именем ПоступлениеТоваровУслуг.

Как узнать, в каких журналах отображается документ?

Щёлкните правой кнопкой по документу в дереве конфигурации и выберите «Поиск ссылок на объекты». В результатах будут перечислены все журналы документов, критерии отбора и подсистемы, где зарегистрирован этот вид документа. Двойной щелчок по строке открывает нужный журнал.

Документ есть в конфигурации, но пользователи его не видят. Что проверить?

Проверьте три вещи: входит ли документ в состав хотя бы одной подсистемы, не ограничена ли его видимость функциональной опцией (закладка «Функциональные опции» в свойствах объекта) и есть ли у роли пользователя права на просмотр этого документа. Чаще всего причина — отсутствие объекта в подсистеме или выключенная функциональная опция.

Как найти документ, доработанный через расширение конфигурации?

Откройте «Конфигурация — Расширения конфигурации», выберите активное расширение и посмотрите его дерево: заимствованные документы отображаются в ветке «Документы» расширения. Глобальный поиск можно выполнять и по расширению, выбрав его в параметрах области поиска.

Можно ли найти документ по кнопке в интерфейсе пользователя?

Напрямую из режима «Предприятие» — нет. Косвенный способ: посмотрите заголовок формы документа или списка, затем в конфигураторе выполните глобальный поиск по этому синониму с включённым поиском по синонимам. Для команд интерфейса дополнительно проверьте состав подсистемы, соответствующей разделу, где расположена кнопка.

Итог

Что важно запомнить

Документы в конфигураторе находятся в ветке «Документы» дерева конфигурации и отсортированы по внутреннему имени. Быстрый поиск — фильтр дерева или Ctrl+Shift+F с поиском по синонимам; все места использования объекта показывает «Поиск ссылок на объекты». Перед правкой или удалением документа проверьте ссылки на него, расширения и сделайте резервную копию базы.