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

Другое · 7 мин

Как перебрать реквизиты формы в 1C

Как перебрать реквизиты формы в 1C: способы получения списка, примеры кода, различия обычных и управляемых форм, проверка и типичные ошибки.

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

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

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

Что считать реквизитами формы и где они хранятся

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

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

Визуальный элементЕсть в коллекции Элементы

Проверяется наличие элемента с таким именем на форме

Скрытый реквизитНе отображается на форме

Доступен по имени в модуле формы, но не в коллекции элементов

Реквизит объектаПривязан к данным

Изменение может затрагивать базу данных при записи

Способы получения списка реквизитов для перебора

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

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

Пример перебора реквизитов в модуле формы

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

Для Каждого Имя Из СписокИмен Цикл
Значение = ЗначениеИзРеквизитаФормы(Имя);
Если Значение = Неопределено Тогда
Продолжить;
КонецЕсли;
// обработка значения
КонецЦикла;

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

Порядок действий
  1. 1
    Определить список имён реквизитов для обработки
  2. 2
    Выбрать место выполнения кода: клиент или сервер
  3. 3
    Проверить доступность реквизита для чтения и записи
  4. 4
    Перебрать имена циклом и получить значения
  5. 5
    При необходимости записать значения обратно и проверить результат

Отличия обычных и управляемых форм

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

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

Типичные ошибки
01
Изменение реквизита, доступного только для чтения, не даёт эффекта
02
Обращение к отсутствующему имени вызывает ошибку выполнения
03
Смешение реквизитов формы и реквизитов связанного объекта

Проверка результата и типичные ошибки

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

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

Сравнение вариантов

Прямое обращение по имени

Подходит для одного или нескольких известных реквизитов; ограничен фиксированным набором полей

Перебор по списку имён

Удобен для группы однородных реквизитов; требует актуализации списка при изменении формы

Перебор по коллекции элементов

Охватывает только визуальные поля; не подходит для скрытых и вычисляемых реквизитов

Когда перебор не нужен и альтернативы

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

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

Итог

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

Перебор реквизитов формы возможен по известному списку имён или по элементам управления; способ зависит от типа формы и контекста выполнения, а результат нужно проверять после записи.

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

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

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

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

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

Безопасно ли менять значения реквизитов во время перебора?

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

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

Да, если реквизит связан с данными объекта, запись может подчиняться правам пользователя и правилам записи объекта. Проверка результата после записи поможет обнаружить отказ в сохранении.