Где в Конфигураторе искать нужный документ, его код и связи
Содержание
Документ в конфигураторе 1С 8.3 лежит в дереве метаданных, в ветке Конфигурация → Документы. Откройте дерево командой Конфигурация → Открыть конфигурацию, раскройте ветку «Документы», поставьте курсор в список и начните набирать имя объекта: курсор сам перейдёт к первому совпадению.
Частая ошибка — искать в дереве то название, которое видно пользователю, например «Реализация (акт, накладная, УПД)». В дереве стоит имя объекта, а не синоним: тот же документ называется РеализацияТоваровУслуг. Поэтому сначала узнайте точное имя, а потом ищите. Ниже — способы для разных исходных данных: известно имя, видна только форма в пользовательском режиме, есть фрагмент кода или нужно понять, кто и где использует документ.
С чего начать: узнаём точное имя документа
Пока имя неизвестно, поиск по дереву превращается в угадывание. Выясните его одним из трёх способов.
Навигационная ссылка из пользовательского режима
- Откройте нужный документ или его список в режиме «1С:Предприятие».
- Нажмите
Shift+F11— откроется окно со ссылкой на объект. - Скопируйте ссылку. В ней будет фрагмент вида
e1cib/data/Документ.ПоступлениеТоваровУслуг?ref=....
Текст после Документ. и до знака вопроса — это и есть имя объекта в конфигураторе. Для списка ссылка выглядит как e1cib/list/Документ.ИмяДокумента.
💡 Способ работает даже у пользователя без прав на конфигуратор. Попросите бухгалтера прислать ссылку — и вы точно знаете, какой объект открывать.
Функция «Все функции»
В интерфейсе «Такси» меню «Все функции» показывает документы по синонимам, сгруппированные по типам объектов. Если пункта нет, включите его в главном меню (кнопка с тремя полосками): Сервис → Параметры, флажок «Отображать команду «Все функции»». Удобно, когда нужно увидеть полный список документов базы, включая те, что не выведены в разделы.
Отчёт по конфигурации
В конфигураторе выполните Конфигурация → Отчет по конфигурации. Программа сформирует текстовый отчёт со всеми объектами, их именами, синонимами и реквизитами. Нажмите Ctrl+F и найдите синоним — рядом окажется имя.
| Что у вас есть | Каким способом узнать имя |
|---|---|
| Доступ к пользовательскому режиму | Shift+F11 на открытом документе |
| Только конфигуратор | Отчёт по конфигурации, поиск по синониму |
| Скриншот или название из интерфейса | Отчёт по конфигурации или глобальный поиск |
| Текст ошибки с именем модуля | Имя уже в тексте ошибки, например Документ.СчетНаОплатуПокупателю.МодульОбъекта |
Поиск документа в дереве метаданных конфигурации
Дерево конфигурации — основной способ навигации. Порядок такой.
- Откройте
Конфигурация → Открыть конфигурацию, если окно дерева закрыто. - Раскройте ветку «Документы».
- Установите курсор на любой документ и начните печатать имя:
Реалпереведёт кРеализацияТоваровУслуг. - Двойной щелчок открывает окно редактирования объекта с вкладками.
📌 Внутри ветки объекты отсортированы по имени, а не по синониму. Поэтому «Счёт-фактура выданный» ищите на букву С: СчетФактураВыданный.
Отбор по подсистемам
В типовых конфигурациях документов сотни. Сузьте дерево: в командной панели окна конфигурации откройте меню Действия → Отбор по подсистемам и отметьте нужную подсистему, например «Продажи» или «Банк и касса». В дереве останутся только объекты, включённые в эти подсистемы.
⚠️ Отбор не снимается сам. Если позже «пропал» какой-то документ, проверьте, не включён ли отбор.
Журналы документов
Если документ видно в журнале, а не в разделе, загляните в ветку Журналы документов. В свойствах журнала перечислены все документы, которые он объединяет. Это быстрый путь от экранного журнала к конкретным объектам.
Документ из расширения
Если объект добавлен расширением, в основном дереве его нет. Откройте Конфигурация → Расширения конфигурации, выберите расширение и в его дереве раскройте «Документы». Заимствованные объекты там помечены особым значком, собственные объекты расширения обычно имеют префикс в имени.
Палитра свойств: имя, синоним и комментарий
Палитра свойств открывается клавишами Alt+Enter на выделенном объекте. Для поиска важны три поля.
- 🏷 Имя — идентификатор, по которому объект ищется в дереве и в коде.
- 👁 Синоним — то, что видит пользователь. Если у документа задано представление объекта или представление списка, на экране могут быть ещё и они.
- 📝 Комментарий — сюда разработчики пишут номер задачи или автора доработки. По нему удобно искать свои изменения.
Синоним бывает обманчив. Пользователь называет документ по заголовку формы, а заголовок формы можно задать отдельно от синонима. Если поиск по синониму в отчёте по конфигурации ничего не дал, ищите заголовок формы глобальным поиском (раздел ниже).
💡 Чтобы перейти от объекта, на котором стоит курсор в модуле, к его месту в дереве, используйте контекстное меню редактора: там есть команда поиска объекта в дереве конфигурации.
Глобальный поиск по всей конфигурации
Глобальный поиск находит текст сразу во всех модулях, формах, макетах и свойствах. Вызов: Правка → Глобальный поиск или Ctrl+Shift+F.
- Введите строку: имя документа, фрагмент синонима или текст сообщения, которое видит пользователь.
- Укажите, где искать: во всей конфигурации или в выбранных объектах.
- Нажмите «Искать».
- Результаты появятся в окне «Результаты поиска». Двойной щелчок по строке открывает модуль или форму прямо на найденном месте.
Как искать по тексту сообщения
Типичная задача: при проведении документа появляется сообщение, и нужно найти, откуда оно берётся.
- Возьмите из сообщения 3–4 уникальных слова без чисел и наименований — эти части обычно подставляются в строку программно.
- Не копируйте фразу целиком: в коде она может быть разбита на части или собрана через
СтрШаблон. - Если строка находится в общем модуле, поищите имя процедуры, в которой она стоит, — так выйдете на документ, который её вызывает.
Параметры поиска, которые экономят время
| Параметр | Когда включать |
|---|---|
| Учитывать регистр | Ищете имя переменной, а не слово из текста |
| Только слово целиком | Имя короткое и входит в другие имена, например Склад |
| Поиск в выбранных объектах | Уже знаете подсистему или группу документов |
| Поиск в тексте модулей и в формах | Ищете обработчик или заголовок элемента |
Набор флажков в окне зависит от версии платформы. Если нужного флажка нет, ищите по всей конфигурации и сужайте результаты вручную.
Где документ используется: связи и зависимости
Найти объект мало, часто нужно понять, что сломается после его изменения. Для этого есть три инструмента.
Поиск ссылок на объект
Щёлкните правой кнопкой по документу в дереве и выберите Поиск ссылок на объект. Конфигуратор покажет, где на него ссылаются:
- 🔗 реквизиты других объектов с типом
ДокументСсылка.ИмяДокумента; - 📚 регистры, для которых документ является регистратором;
- 📒 журналы документов и подсистемы;
- 🔐 роли с правами на документ;
- ⚙️ функциональные опции, критерии отбора, последовательности.
Список кликабельный: двойной щелчок ведёт к месту использования. Для регистра это его свойства, для реквизита — сам реквизит.
Вкладки окна редактирования документа
Откройте документ двойным щелчком. Нужные вкладки:
- Движения — список регистров, по которым документ делает записи при проведении;
- Ввод на основании — на основании каких объектов создаётся этот документ и какие документы вводятся на основании него;
- Журналы — в каких журналах он отображается;
- Права — какие роли и с какими правами имеют к нему доступ.
Где документ упоминается в коде
Поиск ссылок показывает связи метаданных, но не код. Чтобы найти обращения из модулей, запустите глобальный поиск по строке Документы.ИмяДокумента и отдельно по ДокументСсылка.ИмяДокумента. Первая строка найдёт создание и выборку документов через менеджер, вторая — проверки типа и описания типов.
📌 В запросах документ упоминается как Документ.ИмяДокумента без «ы». Ищите и эту форму, иначе пропустите тексты запросов.
Код документа: модули объекта, менеджера и форм
У документа несколько модулей, и логика обычно разбросана между ними.
| Модуль | Что там искать | Как открыть |
|---|---|---|
| Модуль объекта | ОбработкаПроведения, ОбработкаЗаполнения, ПередЗаписью | Контекстное меню документа → Открыть модуль объекта |
| Модуль менеджера | Печатные формы, тексты запросов для проведения | Контекстное меню → Открыть модуль менеджера |
| Модуль формы | Реакция на нажатие кнопок и изменение полей | Ветка «Формы» → форма → вкладка «Модуль» |
Поиск внутри одного модуля
Ctrl+F— поиск по тексту текущего модуля,F3— следующее совпадение.- Список процедур и функций модуля позволяет прыгнуть к нужному обработчику без прокрутки. Он вызывается из меню «Текст» или кнопкой на панели редактора.
F12на имени процедуры или функции переходит к её определению, даже если оно в общем модуле.
Типовая цепочка проведения
В типовых конфигурациях на БСП модуль объекта часто содержит лишь короткий вызов. Сам алгоритм проведения уходит в модуль менеджера или в общий модуль. Порядок поиска:
- Откройте модуль объекта, найдите процедуру
ОбработкаПроведения. - Поставьте курсор на вызываемую процедуру и нажмите
F12. - Продолжайте переходить по цепочке, пока не дойдёте до текста запроса или формирования движений.
💡 Если цепочка длинная, проще поставить точку останова в ОбработкаПроведения (F9), запустить отладку (F5) и провести документ
. Отладчик пошагово покажет, куда реально уходит выполнение. Отлаживайте в копии базы, а не в рабочей: проведение изменит данные.
Что изменилось в документе: сравнение и история
Иногда задача звучит так: «найдите, что поменяли в документе после обновления». Конфигуратор умеет это показать.
Сравнение конфигураций
- Выполните
Конфигурация → Сравнить конфигурации. - Выберите, что с чем сравнивать: например, основную конфигурацию с конфигурацией поставщика или с файлом
.cf. - В окне результатов включите режим показа только отличий и найдите нужный документ в ветке «Документы».
- Отличающиеся свойства, реквизиты и модули отмечены. Для модуля можно открыть построчное сравнение.
Сравнение конфигурации поставщика с основной конфигурацией сразу показывает доработки, сделанные в базе. Это быстрый способ выяснить, типовой ли документ или его меняли.
История в хранилище конфигурации
Если база подключена к хранилищу, откройте Конфигурация → Хранилище конфигурации → Хранилище, выделите документ и вызовите историю. Увидите версии, авторов и комментарии к помещениям. Любые две версии объекта можно сравнить между собой.
Отчёт по конфигурации для «снимка»
Отчёт по конфигурации, сохранённый до и после доработки, тоже годится для сравнения: два текстовых файла легко сличить любой программой сравнения. Пригодится, когда хранилища нет, а сравнивать конфигурации долго.
Частые ситуации, когда документ «не находится»
- 🔍 Ищете синоним в дереве. Дерево ищет по имени. Узнайте имя через
Shift+F11или отчёт по конфигурации. - 🧩 Объект в расширении. Проверьте
Конфигурация → Расширения конфигурации. - 🗂 Включён отбор по подсистемам. Снимите отбор в меню «Действия» окна конфигурации.
- 📄 Это не документ. То, что пользователь называет документом, может оказаться справочником, обработкой или внешней печатной формой. В ссылке
Shift+F11тип стоит в начале:Справочник.,Обработка.и так далее. - 📦 Внешняя обработка. Внешние отчёты и обработки хранятся в файлах
.epfи.erfили в справочнике дополнительных отчётов и обработок, а не в дереве конфигурации. Откройте файл черезФайл → Открыть.