Где находится временное хранилище в 1С и как с ним работать

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

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

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

Где физически находится временное хранилище

В клиент-серверном варианте работы данные временного хранилища размещаются в памяти рабочего процесса сервера 1С:Предприятия (rphost.exe). Это обычная область оперативной памяти, выделенная процессом. Никаких файлов на диске сервера и записей в базе данных при этом не создаётся: после перезапуска службы сервера 1С всё содержимое хранилища безвозвратно теряется.

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

Практическое следствие: нельзя «зайти в папку» и посмотреть содержимое хранилища, нельзя скопировать его сторонними средствами. Единственный легальный способ доступа — встроенный язык 1С: методы ПоместитьВоВременноеХранилище(), ПолучитьИзВременногоХранилища(), УдалитьИзВременногоХранилища() и ЭтоАдресВременногоХранилища().

Как поместить данные и получить адрес

Базовый сценарий выглядит так: значение (двоичные данные, картинка, таблица значений, результат запроса) передаётся в метод ПоместитьВоВременноеХранилище(), а платформа возвращает строку-адрес. Этот адрес сохраняют в реквизите формы, параметре или переменной и используют для последующего чтения.

&НаСервере
Функция СохранитьФайл(ДвоичныеДанные)
    Адрес = ПоместитьВоВременноеХранилище(ДвоичныеДанные, УникальныйИдентификаторФормы);
    Возврат Адрес;
КонецФункции

&НаКлиенте
Процедура ЗагрузитьФайл(Команда)
    ДвоичныеДанные = Новый ДвоичныеДанные("C:\Документы\отчет.pdf");
    АдресХранилища = СохранитьФайл(ДвоичныеДанные);
КонецПроцедуры

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

Получение данных выполняется зеркальным методом ПолучитьИзВременногоХранилища(Адрес). Если адрес недействителен или срок жизни истёк, метод вернёт Неопределено. Перед получением полезно проверять адрес функцией ЭтоАдресВременногоХранилища().

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

Срок жизни данных и когда они удаляются

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

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

Кроме автоматической очистки, данные всегда можно удалить явно методом УдалитьИзВременногоХранилища(Адрес). Это рекомендуется делать с крупными объектами — файлами, большими таблицами значений, — чтобы не держать память рабочего процесса сервера дольше необходимого.

Типичные сценарии использования

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

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

Хранение картинок и данных в форме

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

Возврат результата из фонового задания

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

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

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

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

Как проверить, что всё работает правильно

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

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

FAQ