Поиск реквизита формы по имени в 1С: от простого к сложному

Работа с формами в 1С:Предприятие — одна из самых частых задач как для начинающих, так и для опытных разработчиков. Нередко возникает ситуация, когда нужно найти конкретный реквизит формы по его имени: будь то поле ввода, флажок, табличная часть или элемент управления. Например, вы получаете ошибку вида "Реквизит формы не найден: 'НомерДокумента'", или вам требуется программно изменить значение элемента, но его имя неизвестно. В таких случаях стандартные методы перебора свойств объекта или поиска по коду могут отнять часы времени.

В этой статье мы разберём 5 рабочих способов найти реквизит формы по имени — от визуальных инструментов платформы 1С 8.3 до программного анализа метаданных. Особое внимание уделим нюансам для разных конфигураций (УТ 11, ERP 2, БП 3.0, ЗУП 3.1) и типичным ошибкам, которые мешают корректному поиску. Вы узнаете, как обойти ограничения встроенных механизмов, где искать скрытые реквизиты, и как автоматизировать процесс для повторяющихся задач.

1. Поиск реквизита через "Все функции" (самый быстрый способ)

Если вам нужно срочно найти реквизит формы без программирования, воспользуйтесь встроенным инструментом "Все функции". Этот метод работает в режиме 1С:Предприятие (не требует конфигуратора) и подходит для большинства типовых конфигураций.

Инструкция:

• 🔍 Откройте форму, в которой нужно найти реквизит (например, документ "РеализацияТоваровУслуг" в УТ 11).
• 🖱️ Нажмите правой кнопкой мыши на любое свободное место формы и выберите "Все функции" (или нажмите Ctrl+Shift+F).
• 📝 В поле поиска введите известное имя реквизита (или его часть). Система покажет все элементы, содержащие введённый текст.
• 🎯 Если реквизит найден, кликните по нему — форма прокрутится к нужному элементу, а внизу отобразится его полное имя (включая путь в иерархии).

⚠️ Внимание: В некоторых конфигурациях (например, ERP 2.5) функция "Все функции" может быть отключена для отдельных форм. В этом случае используйте альтернативные методы из следующих разделов.

2. Использование отладчика для анализа структуры формы

Отладчик 1С — мощный инструмент, который позволяет исследовать структуру формы в реальном времени, включая скрытые реквизиты и динамически создаваемые элементы. Этот метод требует доступа к конфигуратору и базовых знаний языка 1С.

Как найти реквизит через отладчик:

1. Откройте форму в режиме 1С:Предприятие.
2. Установите точку останова на событии формы (например, "ПриОткрытии" или "ПередОткрытием"). Для этого:

   // В модуле формы добавьте временно:
   Процедура ПередОткрытием(Отказ, СтандартнаяОбработка)
   Отказ = Ложь;
   // Точка останова здесь (F9)
   КонецПроцедуры

3. Запустите форму в режиме отладки (F5). Когда выполнение остановится, откройте окно "Локальные переменные" или "Выражения".
4. Введите выражение ЭтаФорма.Элементы или ЭтаФорма.Реквизиты — отладчик покажет полный список с именами.

🔹 Совет: Если реквизит динамический (создан в коде), ищите его в коллекции ЭтаФорма.Элементы после события "ПриСозданииНаКлиенте".

3. Программный поиск реквизитов через метаданные

Если вам нужно найти реквизит формы для всех экземпляров документа/справочника (например, чтобы написать универсальную обработку), используйте программный обход метаданных. Этот метод подходит для автоматизации и работы с большими конфигурациями.

Пример кода для поиска реквизита по имени во всех формах документа "ЗаказПокупателя":

Процедура НайтиРеквизитВФормах(ИмяРеквизита)
Метаданные = Метаданные.Документы.ЗаказПокупателя;
Для Каждого Форма Из Метаданные.Формы Цикл
Для Каждого Реквизит Из Форма.Реквизиты Цикл
Если Реквизит.Имя = ИмяРеквизита Тогда
Сообщить("Найден в форме: " + Форма.Имя);
Сообщить("Тип реквизита: " + ТипЗнч(Реквизит.Тип));
КонецЕсли;
КонецЦикла;
КонецЦикла;
КонецПроцедуры

⚠️ Внимание: В типовых конфигурациях (УТ 11.4, ERP 2.4) некоторые реквизиты формы могут быть скрыты в подсистемах или динамически подгружаться. В этом случае их не будет в метаданных — ищите через ЭтаФорма.Элементы в рантайме.

4. Поиск скрытых и динамических реквизитов

В современных конфигурациях (ERP 2.5, ЗУП 3.1) часть реквизитов формы может быть скрыта (свойство Видимость = Ложь) или динамически создана в обработчиках событий. Стандартные методы их не найдут. Вот как их обнаружить:

• 🔎 Для скрытых реквизитов: В отладчике проверьте коллекцию ЭтаФорма.Элементы на наличие свойства Видимость. Пример:

  Для Каждого Элемент Из ЭтаФорма.Элементы Цикл
  Если Элемент.Видимость = Ложь Тогда
  Сообщить("Скрытый элемент: " + Элемент.Имя);
  КонецЕсли;
  КонецЦикла;

• 🛠️ Для динамических реквизитов: Ищите их в событиях формы "ПриСозданииНаКлиенте" или "ПриАктивизацииСтроки". Часто они создаются через ЭлементыФормы.Добавить().
• 📌 Для реквизитов подсистем: В ERP 2 некоторые элементы хранятся в общих модулях подсистем (например, "ПодсистемаБухгалтерия"). Проверьте модули объектов на наличие процедур вида "ДобавитьЭлементыФормы()".

🔹 Пример из практики: В УТ 11.4 реквизит "СуммаНДС" в форме документа "РеализацияТоваровУслуг" может динамически появляться только при включённой галочке "ВключатьНДС". Его не найти в метаданных — только через анализ кода модуля формы.

5. Поиск реквизитов в типовых конфигурациях (УТ, ERP, БП, ЗУП)

Типовые конфигурации 1С имеют свои особенности хранения реквизитов форм. Вот ключевые нюансы для популярных решений:

• 📦 Управление торговлей 11 (УТ 11):
  • Реквизиты форм документов часто дублируются в общем модуле "ДокументыКлиентСервер".
  • Для поиска по табличным частям используйте ЭтаФорма.Элементы.Товары.Колонки.
• 🏭 ERP Управление предприятием 2:
  • Многие реквизиты хранятся в подсистемах (например, "ПодсистемаПроизводство").
  • Для поиска по формам справочников используйте префиксы: "СправочникОбъект.Форма.Элементы".
• 💰 Бухгалтерия предприятия 3.0 (БП 3.0):
  • Реквизиты бухгалтерских документов часто привязаны к планам счетов. Ищите их через ЭтаФорма.Элементы.СчетДт.Выбор".
  • Для отчётов используйте ЭтаФорма.Элементы.Настройки.Группы.
• 👔 Зарплата и Управление Персоналом 3.1 (ЗУП 3.1):
  • Реквизиты кадровых документов могут быть в модуле "ЗарплатаКадрыПеременные".
  • Для поиска по табелям используйте ЭтаФорма.Элементы.Табель.Колонки.

// Вставить в модуль внешней обработки
Процедура НайтиРеквизитВоВсехФормах(ИмяРеквизита)
Для Каждого Объект Из Метаданные.Объекты Цикл
Если Объект.ЭтоГруппа Тогда Продолжить; КонецЕсли;
Для Каждого Форма Из Объект.Формы Цикл
Для Каждого Реквизит Из Форма.Реквизиты Цикл
Если НРег(Реквизит.Имя) = НРег(ИмяРеквизита) Тогда
Сообщить("Найден в: " + Объект.Имя + " (форма: " + Форма.Имя + ")");
КонецЕсли;
КонецЦикла;
КонецЦикла;
КонецЦикла;
КонецПроцедуры

Пакет = XDTOФабрика.Package("http://v8.1c.ru/8.1/data/core");
ТипОбъекта = Пакет.GetType("CatalogObject.СправочникОбъект");
Для Каждого Свойство Из ТипОбъекта.GetProperties() Цикл
Если Свойство.Name = "Наименование" Тогда
Сообщить("Найдено свойство XDTO: " + Свойство.Name);
КонецЕсли;
КонецЦикла;

Для Каждого Элемент Из ЭтаФорма.Элементы Цикл
Если Найти(НРег(Элемент.Имя), "сумма") > 0 Тогда
Сообщить(Элемент.Имя);
КонецЕсли;
КонецЦикла;

// Поиск по всем формам УНФ
Для Каждого Форма Из Метаданные.Формы Цикл
Если Найти(Форма.Имя, "Документ") > 0 Тогда
Для Каждого Реквизит Из Форма.Реквизиты Цикл
Если Реквизит.Имя = "НужныйРеквизит" Тогда
Сообщить("Найден в: " + Форма.Имя);
КонецЕсли;
КонецЦикла;
КонецЕсли;
КонецЦикла;

Процедура ЭкспортироватьРеквизитыФормы(ИмяФайла)
Текст = Новый ТекстовыйДокумент();
Для Каждого Элемент Из ЭтаФорма.Элементы Цикл
Текст.ДобавитьСтроку(Элемент.Имя + ";" + ТипЗнч(Элемент) + ";" + ?(Элемент.Видимость, "Видимый", "Скрытый"));
КонецЦикла;
Текст.Записать(ИмяФайла, КодировкаТекста.UTF8);
КонецПроцедуры