Временное хранилище в 1С: что это такое и как с ним работать

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

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

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

Что такое временное хранилище и как оно устроено

Физически временное хранилище — это область памяти (или дискового пространства) на сервере 1С, куда платформа складывает сериализованные значения. Каждое помещённое значение получает уникальный адрес — строку вида GUID, по которой платформа находит данные при обратном обращении.

Важно понимать: хранилище находится на сервере. Когда клиент (тонкий, веб или толстый) получает адрес временного хранилища, сами данные к нему не передаются — передаётся только «ссылка» на них. Реальное значение клиент получит только после вызова ПолучитьИзВременногоХранилища() или при отображении, например, картинки по адресу в элементе формы.

Для работы с хранилищем используются три глобальных метода:

• ПоместитьВоВременноеХранилище(Значение, ИдентификаторФормы) — помещает значение и возвращает адрес;
• ПолучитьИзВременногоХранилища(Адрес) — извлекает значение по адресу;
• УдалитьИзВременногоХранилища(Адрес) — принудительно освобождает данные.

Зачем нужен механизм: типовые сценарии

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

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

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

Срок жизни данных и идентификатор формы

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

Если передать УникальныйИдентификатор формы, данные будут храниться до закрытия этой формы — это самый распространённый и безопасный вариант для реквизитов формы типа «АдресКартинки» или «АдресФайла». Если передать Неопределено, данные живут только до конца текущего вызова сервера: после возврата управления на клиент адрес станет недействительным. Есть также вариант передать пустой уникальный идентификатор — тогда данные живут в течение сеанса.

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

Практический пример: передача файла с клиента на сервер

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

&НаКлиенте
Процедура ЗагрузитьКартинку(Команда)
	НачатьПомещениеФайла(
		Новый ОписаниеОповещения("ПослеПомещенияФайла", ЭтотОбъект),
		, , Истина, УникальныйИдентификатор);
КонецПроцедуры

&НаКлиенте
Процедура ПослеПомещенияФайла(Результат, Адрес, ВыбранноеИмяФайла, Доп) Экспорт
	Если Результат Тогда
		АдресКартинки = Адрес; // реквизит формы, хранит адрес
	КонецЕсли;
КонецПроцедуры

&НаСервере
Процедура СохранитьНаСервере()
	ДвоичныеДанные = ПолучитьИзВременногоХранилища(АдресКартинки);
	// дальше - запись в реквизит объекта типа ХранилищеЗначения
КонецПроцедуры

Обратите внимание на два момента. Во-первых, в НачатьПомещениеФайла последним параметром передаётся УникальныйИдентификатор формы — благодаря этому адрес останется действительным, пока форма открыта, и картинку можно будет показать в элементе «Поле картинки» просто присвоив адрес реквизиту. Во-вторых, на сервере данные извлекаются один раз — при сохранении — и записываются уже в постоянное место (реквизит объекта, регистр сведений).

1. 1
   На клиенте вызвать НачатьПомещениеФайла с УникальныйИдентификатор формы
2. 2
   В оповещении сохранить полученный адрес в реквизит формы
3. 3
   На сервере получить данные через ПолучитьИзВременногоХранилища(Адрес)
4. 4
   Записать данные в базу (ХранилищеЗначения) или обработать
5. 5
   При необходимости удалить данные: УдалитьИзВременногоХранилища(Адрес)

Временное хранилище и фоновые задания

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

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

Типичные ошибки и как их диагностировать

Самая массовая ошибка — «Ошибка при вызове метода контекста (ПолучитьИзВременногоХранилища)» или пустое значение по адресу. Причины почти всегда в сроке жизни: данные помещены без идентификатора формы, форма была закрыта и открыта заново (идентификатор сменился), либо адрес потерян при сериализации формы.

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

Ограничения и альтернативы

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

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

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

Частые вопросы о временном хранилище 1С