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

Другое · 7 мин

Хранение структуры в реквизите формы 1С

Как создать реквизит формы типа «Структура» в 1С, записывать и читать значение, когда оно сохраняется в базе, а когда теряется, и какие ошибки избежать.

Реквизит формы в 1С:Предприятии может иметь тип «Структура», что позволяет временно держать набор именованных значений в памяти открытой формы. Это удобно для промежуточных расчетов, наборов отборов, временных настроек или собранных из нескольких полей данных, которые ещё не нужно записывать в базу.

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

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

Когда реквизит формы типа «Структура» подходит

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

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

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

Реквизит формы типа «Структура»

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

Реквизит объекта или табличная часть

Подходит для постоянного хранения; требует записи объекта в базу.

Регистр сведений или временное хранилище

Подходит для доступа из нескольких форм и сеансов; сложнее в настройке.

Создание реквизита и задание типа

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

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

Пример инициализации при открытии формы

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

Порядок создания реквизита
  1. 1
    Открыть форму в конфигураторе и добавить реквизит
  2. 2
    Указать тип «Структура» или совместимый общий тип
  3. 3
    Дать реквизиту понятное имя
  4. 4
    Инициализировать структуру при открытии формы
  5. 5
    Проверить работу на целевой базе

Запись и чтение структуры в коде формы

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

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

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

Срок жизни и запись в базу данных

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

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

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

Ограничения и типичные ошибки

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

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

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

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

Альтернативы и выбор способа хранения

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

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Что произойдёт со структурой при закрытии формы?

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

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

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

Когда лучше выбрать таблицу значений вместо структуры?

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