Как сохранить значение реквизита формы в 1С на обычных формах

В обычных формах 1С (платформа 8.2–8.3, режим обычного приложения) реквизиты формы существуют только в памяти: после закрытия формы их значения теряются. Чтобы пользователь при следующем открытии видел ранее введённые данные — например, выбранный период, склад, настройки отбора — значения нужно сохранить в хранилище настроек и восстановить при открытии формы.

Платформа предлагает два основных механизма: универсальные процедуры СохранитьЗначение() и ВосстановитьЗначение(), которые пишут данные в хранилище общих настроек, и встроенное автосохранение реквизитов формы через свойство СохранениеЗначенийПриЗакрытии. Оба подхода работают без изменения конфигурации базы данных и не требуют создания отдельных таблиц.

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

Где физически хранятся сохранённые значения

Оба механизма используют хранилище общих настроек — стандартное системное хранилище, которое платформа ведёт автоматически. В файловой базе настройки лежат в таблице хранения настроек внутри файла базы, в клиент-серверном варианте — в соответствующей таблице СУБД. Доступ к ним из кода идёт через объект ХранилищеОбщихНастроек, но процедуры СохранитьЗначение() и ВосстановитьЗначение() являются удобной обёрткой над ним.

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

Способ 1: СохранитьЗначение и ВосстановитьЗначение

Универсальный способ, работающий в любом месте кода. В обработчике ПриЗакрытии формы (или по кнопке «Сохранить настройки») вызывается сохранение, а в обработчике ПриОткрытии — восстановление. Ключом служит произвольная строка, которая должна быть уникальной, чтобы не пересечься с настройками других форм.

Типовой код модуля формы выглядит так:

Процедура ПриОткрытии()
СохраненноеЗначение = ВосстановитьЗначение("МояФорма_Склад");
Если СохраненноеЗначение <> Неопределено Тогда
Склад = СохраненноеЗначение;
КонецЕсли;
КонецПроцедуры

Процедура ПриЗакрытии()
СохранитьЗначение("МояФорма_Склад", Склад);
КонецПроцедуры

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

Если нужно сохранить несколько реквизитов, есть два варианта: вызывать СохранитьЗначение() для каждого с отдельным ключом или упаковать значения в структуру либо список значений и сохранить одним ключом. Второй подход компактнее и упрощает очистку настроек целиком.

// Сохранение группы реквизитов одним ключом
Настройки = Новый Структура;
Настройки.Вставить("Склад", Склад);
Настройки.Вставить("Организация", Организация);
СохранитьЗначение("МояФорма_Настройки", Настройки);

Способ 2: автосохранение реквизитов без кода

У обычной формы есть свойство «Сохранение значений при закрытии» (СохранениеЗначенийПриЗакрытии). Если установить его в Истина, платформа сама сохранит помеченные реквизиты при закрытии формы и восстановит при следующем открытии. Какие именно реквизиты сохранять, задаётся в конфигураторе: палитра свойств формы → кнопка «Сохранение значений» → отметить нужные реквизиты флажками.

То же самое можно сделать программно:

Процедура ПередОткрытием(Отказ, СтандартнаяОбработка)
СохранениеЗначенийПриЗакрытии = Истина;
СохраняемыеЗначения.Вставить("Склад", Истина);
СохраняемыеЗначения.Вставить("Организация", Истина);
КонецПроцедуры

Этот способ предпочтителен, когда нужно просто «запомнить» содержимое формы между сеансами без дополнительной логики. Ограничение: автосохранение срабатывает только при закрытии формы штатным способом. Если сеанс завершён аварийно, последние изменения не сохранятся — это справедливо и для первого способа, если сохранение вызывается в ПриЗакрытии.

Сохранение табличных частей и сложных значений

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

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

Проверка результата и отладка

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

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

Очистка и перенос сохранённых настроек

Накопленные настройки иногда нужно удалить — например, после изменения структуры сохраняемых данных, когда старый формат вызывает ошибки. Удаление выполняется через ХранилищеОбщихНастроек.Удалить() с указанием ключа объекта и пользователя, либо через стандартную обработку управления настройками, если она есть в конфигурации. При обновлении формата настроек хорошей практикой является добавление версии в ключ: "МояФорма_Настройки_2" — тогда старые данные просто перестанут использоваться.

Имейте в виду: при копировании базы настройки копируются вместе с ней, а при загрузке данных через выгрузку бизнес-данных (например, конвертацией) — обычно нет. Если пользователи жалуются на «слетевшие» настройки после переезда базы, причина, скорее всего, в этом.

Когда обычные механизмы не подходят

Хранилище настроек предназначено для пользовательских предпочтений, а не для бизнес-данных. Если значение должно быть общим для всех пользователей, иметь историю изменений или участвовать в отчётах — сохраняйте его в регистр сведений, константу или справочник. Настройки в хранилище могут быть очищены администратором или потеряны без последствий для учёта, и закладываться на их постоянство нельзя.

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

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