Где в Конфигураторе искать нужный документ, его код и связи

· 9 мин

Содержание

Документ в конфигураторе 1С 8.3 лежит в дереве метаданных, в ветке Конфигурация → Документы. Откройте дерево командой Конфигурация → Открыть конфигурацию, раскройте ветку «Документы», поставьте курсор в список и начните набирать имя объекта: курсор сам перейдёт к первому совпадению.

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

С чего начать: узнаём точное имя документа

Пока имя неизвестно, поиск по дереву превращается в угадывание. Выясните его одним из трёх способов.

Навигационная ссылка из пользовательского режима

  1. Откройте нужный документ или его список в режиме «1С:Предприятие».
  2. Нажмите Shift+F11 — откроется окно со ссылкой на объект.
  3. Скопируйте ссылку. В ней будет фрагмент вида e1cib/data/Документ.ПоступлениеТоваровУслуг?ref=....

Текст после Документ. и до знака вопроса — это и есть имя объекта в конфигураторе. Для списка ссылка выглядит как e1cib/list/Документ.ИмяДокумента.

💡 Способ работает даже у пользователя без прав на конфигуратор. Попросите бухгалтера прислать ссылку — и вы точно знаете, какой объект открывать.

Функция «Все функции»

В интерфейсе «Такси» меню «Все функции» показывает документы по синонимам, сгруппированные по типам объектов. Если пункта нет, включите его в главном меню (кнопка с тремя полосками): Сервис → Параметры, флажок «Отображать команду «Все функции»». Удобно, когда нужно увидеть полный список документов базы, включая те, что не выведены в разделы.

Отчёт по конфигурации

В конфигураторе выполните Конфигурация → Отчет по конфигурации. Программа сформирует текстовый отчёт со всеми объектами, их именами, синонимами и реквизитами. Нажмите Ctrl+F и найдите синоним — рядом окажется имя.

Что у вас естьКаким способом узнать имя
Доступ к пользовательскому режимуShift+F11 на открытом документе
Только конфигураторОтчёт по конфигурации, поиск по синониму
Скриншот или название из интерфейсаОтчёт по конфигурации или глобальный поиск
Текст ошибки с именем модуляИмя уже в тексте ошибки, например Документ.СчетНаОплатуПокупателю.МодульОбъекта

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

Дерево конфигурации — основной способ навигации. Порядок такой.

  1. Откройте Конфигурация → Открыть конфигурацию, если окно дерева закрыто.
  2. Раскройте ветку «Документы».
  3. Установите курсор на любой документ и начните печатать имя: Реал переведёт к РеализацияТоваровУслуг.
  4. Двойной щелчок открывает окно редактирования объекта с вкладками.

📌 Внутри ветки объекты отсортированы по имени, а не по синониму. Поэтому «Счёт-фактура выданный» ищите на букву С: СчетФактураВыданный.

Отбор по подсистемам

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

⚠️ Отбор не снимается сам. Если позже «пропал» какой-то документ, проверьте, не включён ли отбор.

Журналы документов

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

Документ из расширения

Если объект добавлен расширением, в основном дереве его нет. Откройте Конфигурация → Расширения конфигурации, выберите расширение и в его дереве раскройте «Документы». Заимствованные объекты там помечены особым значком, собственные объекты расширения обычно имеют префикс в имени.

Палитра свойств: имя, синоним и комментарий

Палитра свойств открывается клавишами Alt+Enter на выделенном объекте. Для поиска важны три поля.

  • 🏷 Имя — идентификатор, по которому объект ищется в дереве и в коде.
  • 👁 Синоним — то, что видит пользователь. Если у документа задано представление объекта или представление списка, на экране могут быть ещё и они.
  • 📝 Комментарий — сюда разработчики пишут номер задачи или автора доработки. По нему удобно искать свои изменения.

Синоним бывает обманчив. Пользователь называет документ по заголовку формы, а заголовок формы можно задать отдельно от синонима. Если поиск по синониму в отчёте по конфигурации ничего не дал, ищите заголовок формы глобальным поиском (раздел ниже).

💡 Чтобы перейти от объекта, на котором стоит курсор в модуле, к его месту в дереве, используйте контекстное меню редактора: там есть команда поиска объекта в дереве конфигурации.

Глобальный поиск по всей конфигурации

Глобальный поиск находит текст сразу во всех модулях, формах, макетах и свойствах. Вызов: Правка → Глобальный поиск или Ctrl+Shift+F.

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

Как искать по тексту сообщения

Типичная задача: при проведении документа появляется сообщение, и нужно найти, откуда оно берётся.

  • Возьмите из сообщения 3–4 уникальных слова без чисел и наименований — эти части обычно подставляются в строку программно.
  • Не копируйте фразу целиком: в коде она может быть разбита на части или собрана через СтрШаблон.
  • Если строка находится в общем модуле, поищите имя процедуры, в которой она стоит, — так выйдете на документ, который её вызывает.

Параметры поиска, которые экономят время

ПараметрКогда включать
Учитывать регистрИщете имя переменной, а не слово из текста
Только слово целикомИмя короткое и входит в другие имена, например Склад
Поиск в выбранных объектахУже знаете подсистему или группу документов
Поиск в тексте модулей и в формахИщете обработчик или заголовок элемента

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

Где документ используется: связи и зависимости

Найти объект мало, часто нужно понять, что сломается после его изменения. Для этого есть три инструмента.

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

Щёлкните правой кнопкой по документу в дереве и выберите Поиск ссылок на объект. Конфигуратор покажет, где на него ссылаются:

  • 🔗 реквизиты других объектов с типом ДокументСсылка.ИмяДокумента;
  • 📚 регистры, для которых документ является регистратором;
  • 📒 журналы документов и подсистемы;
  • 🔐 роли с правами на документ;
  • ⚙️ функциональные опции, критерии отбора, последовательности.

Список кликабельный: двойной щелчок ведёт к месту использования. Для регистра это его свойства, для реквизита — сам реквизит.

Вкладки окна редактирования документа

Откройте документ двойным щелчком. Нужные вкладки:

  • Движения — список регистров, по которым документ делает записи при проведении;
  • Ввод на основании — на основании каких объектов создаётся этот документ и какие документы вводятся на основании него;
  • Журналы — в каких журналах он отображается;
  • Права — какие роли и с какими правами имеют к нему доступ.

Где документ упоминается в коде

Поиск ссылок показывает связи метаданных, но не код. Чтобы найти обращения из модулей, запустите глобальный поиск по строке Документы.ИмяДокумента и отдельно по ДокументСсылка.ИмяДокумента. Первая строка найдёт создание и выборку документов через менеджер, вторая — проверки типа и описания типов.

📌 В запросах документ упоминается как Документ.ИмяДокумента без «ы». Ищите и эту форму, иначе пропустите тексты запросов.

Код документа: модули объекта, менеджера и форм

У документа несколько модулей, и логика обычно разбросана между ними.

МодульЧто там искатьКак открыть
Модуль объектаОбработкаПроведения, ОбработкаЗаполнения, ПередЗаписьюКонтекстное меню документа → Открыть модуль объекта
Модуль менеджераПечатные формы, тексты запросов для проведенияКонтекстное меню → Открыть модуль менеджера
Модуль формыРеакция на нажатие кнопок и изменение полейВетка «Формы» → форма → вкладка «Модуль»

Поиск внутри одного модуля

  • Ctrl+F — поиск по тексту текущего модуля, F3 — следующее совпадение.
  • Список процедур и функций модуля позволяет прыгнуть к нужному обработчику без прокрутки. Он вызывается из меню «Текст» или кнопкой на панели редактора.
  • F12 на имени процедуры или функции переходит к её определению, даже если оно в общем модуле.

Типовая цепочка проведения

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

  1. Откройте модуль объекта, найдите процедуру ОбработкаПроведения.
  2. Поставьте курсор на вызываемую процедуру и нажмите F12.
  3. Продолжайте переходить по цепочке, пока не дойдёте до текста запроса или формирования движений.

💡 Если цепочка длинная, проще поставить точку останова в ОбработкаПроведения (F9), запустить отладку (F5) и провести документ . Отладчик пошагово покажет, куда реально уходит выполнение. Отлаживайте в копии базы, а не в рабочей: проведение изменит данные.

Что вы знаете о документе?

Что изменилось в документе: сравнение и история

Иногда задача звучит так: «найдите, что поменяли в документе после обновления». Конфигуратор умеет это показать.

Сравнение конфигураций

  1. Выполните Конфигурация → Сравнить конфигурации.
  2. Выберите, что с чем сравнивать: например, основную конфигурацию с конфигурацией поставщика или с файлом .cf.
  3. В окне результатов включите режим показа только отличий и найдите нужный документ в ветке «Документы».
  4. Отличающиеся свойства, реквизиты и модули отмечены. Для модуля можно открыть построчное сравнение.

Сравнение конфигурации поставщика с основной конфигурацией сразу показывает доработки, сделанные в базе. Это быстрый способ выяснить, типовой ли документ или его меняли.

История в хранилище конфигурации

Если база подключена к хранилищу, откройте Конфигурация → Хранилище конфигурации → Хранилище, выделите документ и вызовите историю. Увидите версии, авторов и комментарии к помещениям. Любые две версии объекта можно сравнить между собой.

Отчёт по конфигурации для «снимка»

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

Частые ситуации, когда документ «не находится»

  • 🔍 Ищете синоним в дереве. Дерево ищет по имени. Узнайте имя через Shift+F11 или отчёт по конфигурации.
  • 🧩 Объект в расширении. Проверьте Конфигурация → Расширения конфигурации.
  • 🗂 Включён отбор по подсистемам. Снимите отбор в меню «Действия» окна конфигурации.
  • 📄 Это не документ. То, что пользователь называет документом, может оказаться справочником, обработкой или внешней печатной формой. В ссылке Shift+F11 тип стоит в начале: Справочник., Обработка. и так далее.
  • 📦 Внешняя обработка. Внешние отчёты и обработки хранятся в файлах .epf и .erf или в справочнике дополнительных отчётов и обработок, а не в дереве конфигурации. Откройте файл через Файл → Открыть.

Коротко о частых вопросах

Можно ли в конфигураторе найти конкретный проведённый документ с номером и датой?
Нет. Конфигуратор работает со структурой, а не с данными. Конкретный документ ищут в пользовательском режиме через список или журнал, либо запросом в консоли запросов.
Чем «Поиск ссылок на объект» отличается от глобального поиска?
Поиск ссылок показывает связи метаданных: реквизиты, регистры, роли, подсистемы. Глобальный поиск ищет текст в модулях и формах. Для полной картины нужны оба.
Как найти форму, которую видит пользователь?
Откройте документ в дереве, раскройте ветку «Формы» и проверьте основные формы на вкладке «Формы» окна редактирования. Если форм несколько, найдите заголовок формы глобальным поиском.
Почему глобальный поиск не находит текст, который точно есть на экране?
Текст может собираться программно из частей, подставляться из макета или приходить из внешней обработки. Ищите по меньшему фрагменту без чисел и имён.
Работают ли эти способы в 1С:EDT?
Логика та же: дерево проекта, поиск по тексту и поиск ссылок. Но команды и окна в EDT другие, это отдельная среда разработки.