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

Другое · 7 мин

Реквизит формы и реквизита объекта в 1С: основные отличия

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

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

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

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

Откуда берётся реквизит и где он живёт

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

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

В чём различие в хранении и жизненном цикле

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

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

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

Реквизит объекта

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

Реквизит формы

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

Как создать каждый тип реквизита

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

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

Доступ в модулях и на форме

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

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

Типичные ошибки
01
Считать реквизит формы полем базы данных и пытаться отображать его в списке без привязки к объекту
02
Удалять реквизит объекта без поиска ссылок в модулях и формах, что может привести к ошибкам компиляции

Когда использовать реквизит формы, а когда объекта

Сценарий: данные должны храниться и использоваться повторно

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

Сценарий: временный расчёт или настройка внутри формы

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

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

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

Где отображается реквизит
Норма

В свойствах конфигурируемого объекта и доступен во многих формах

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

Только в редакторе одной формы и отсутствует в объекте

Сохранение значения
Норма

Значение остаётся после записи и переоткрытия

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

Значение пропадает при закрытии формы

Риски и проверка перед изменением

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

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

Итог

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

Главное различие — место хранения и срок жизни: реквизит объекта описывает структуру и сохраняется в базе, реквизит формы существует только на форме, пока не привязан к объекту.

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

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

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

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

Безопасно ли удалять объектный реквизит, если он не используется на формах?

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

Нужно ли перезапускать 1С после добавления объектного реквизита?

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

Может ли один объектный реквизит отображаться на нескольких формах по-разному?

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