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

Другое · 8 мин

Создание реквизита формы в 1С

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

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

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

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

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

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

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

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

Маршрут решения

Как выбрать место хранения

Значение нужно только пока открыта формаСоздайте реквизит формы
Данные должны сохраняться и быть видны в отчётахИспользуйте реквизит объекта, регистр или документ
Не уверены, где хранитьСначала проверьте задачу на тестовой копии конфигурации

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

Создавайте реквизит формы, если значение нужно только во время работы с формой: например, временный фильтр, промежуточная сумма, признак «показать дополнительные поля» или выбор из вспомогательного списка. Такие данные не должны попадать в отчёты после закрытия окна.

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

Порядок действий
  1. 1
    Откройте нужную форму в редакторе конфигурации
  2. 2
    Создайте реквизит формы, укажите имя и тип данных
  3. 3
    Добавьте реквизит на форму или используйте в модуле
  4. 4
    Сохраните конфигурацию
  5. 5
    Обновите базу данных конфигурации и проверьте форму

Порядок создания реквизита в форме

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

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

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

Типы данных и клиентский или серверный контекст

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

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

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

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

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

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

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

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

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

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

Поле доступно и принимает значения

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

Поле отсутствует или неактивно

Модуль формы обращается к реквизиту
Норма

Процедуры выполняются без ошибок

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

Ошибка компиляции или выполнения

База обновлена после сохранения
Норма

Изменения видны пользователям

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

Старый вариант формы без нового реквизита

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

Ограничения и безопасные изменения конфигурации

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

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

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

Подходит для временных и интерфейсных данных, не сохраняется после закрытия

Реквизит объекта или регистр

Подходит для постоянного хранения, требует больше этапов настройки

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

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

Итог

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

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

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

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

Можно ли использовать реквизит формы в других формах?

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

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

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

Что делать, если форма перестала открываться после изменений?

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