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

Другое · 8 мин

Как найти элемент на форме в 1С

Как найти элемент на форме в 1С: поиск по имени и свойствам, программный доступ, проверка результата и типичные ошибки в конфигураторе.

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

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

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

Открыть форму в Конфигураторе можно через дерево конфигурации, раздел Формы, двойным кликом по имени формы. На управляемой форме слева отображается иерархия элементов: группы, команды, поля, табличные части. Каждому элементу соответствует свойство Имя, которое используется в программе, и свойство Заголовок или надпись, видимая пользователю.

Чтобы быстро отыскать элемент, используйте поиск по дереву формы или сортировку по имени. Если форма большая, полезно сверяться с модулем формы: там часто встречаются обращения вида Элементы.МоеПоле.Свойство, что сразу подсказывает точное имя. Помните, что имя элемента может содержать латиницу, цифры и нижнее подчёркивание, но не должно совпадать с зарезервированными словами языка.

Программный поиск элемента в модуле формы

В модуле управляемой формы коллекция Элементы предоставляет доступ к элементам по имени. Типичное обращение имеет вид Элементы.МоеПоле.Доступность = Истина или Элементы.МояКнопка.Видимость = Ложь. Если имя неизвестно, можно перебрать коллекцию в цикле и сравнивать свойства Имя, Тип, Заголовок с искомыми значениями.

Программный поиск уместен, когда имя элемента формируется динамически или зависит от условий. Например, в табличной части элементы строк доступны через Элементы.МояТаблица.Строки, а отдельные ячейки — через колонки таблицы. Не следует пытаться получить элемент по тексту заголовка напрямую: заголовок может быть локализован или изменён пользователем, а имя остаётся стабильным.

Поиск по имени через коллекцию Элементы

Если точное имя известно, обращение выполняется напрямую. Перед изменением свойств проверьте, что элемент существует в текущей форме, иначе платформа может выдать исключение. Безопасная проверка заключается в использовании условия Если Элементы.Содержит("ИмяЭлемента") Тогда ... для управляемых форм, где поддерживается такая проверка, либо в обработке ошибки при обращении к отсутствующему элементу.

Перебор элементов при неизвестном имени

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

Отличие имени элемента от реквизита и заголовка

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

Порядок поиска элемента
  1. 1
    Откройте форму в Конфигураторе
  2. 2
    Найдите элемент в дереве или на листе формы
  3. 3
    Скопируйте значение свойства Имя
  4. 4
    Проверьте доступ к элементу из модуля формы

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

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

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

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

Когда стоит остановиться и обратиться за помощью

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

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

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

Частая ошибка — попытка изменить свойство элемента, который находится в неактивной вкладке или в закрытой группе. Элемент существует в коллекции, но его свойства могут быть недоступны для записи до активации вкладки. Другая ошибка — использование русского имени с пробелами в коде без кавычек или неправильного регистра, что приводит к ошибке компиляции или выполнения.

Типичные ошибки
01
Поиск по видимому заголовку вместо внутреннего имени
02
Изменение свойств неактивной вкладки или закрытой группы
03
Прямая правка типового модуля без расширения конфигурации

Также не стоит полагаться на позицию элемента на форме: при изменении разрешённости редактирования или перестроении формы координаты и порядок могут измениться. Надёжнее искать по уникальному имени или по пути к данным, а не по визуальному расположению.

Альтернативы прямого поиска элемента

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

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

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

Элемент найден по имени
Норма

Обращение в коде выполняется без исключения

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

Ошибка отсутствующего элемента или свойства

Изменение сохранено
Норма

Форма открывается и записывается корректно

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

Поле недоступно для сохранения или данные не записываются

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

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

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

Итог

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

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

Чем отличается имя элемента от заголовка?

Имя элемента — технический идентификатор в конфигурации, используемый в коде и в дереве формы. Заголовок — текст, который видит пользователь, и его можно менять без изменения кода. Поэтому ищите элемент по свойству Имя, а не по надписи на экране.

Можно ли получить элемент по тексту кнопки или поля?

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

Что делать, если элемент не найден