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

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

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

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

Что такое хранилище значения и зачем оно нужно

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

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

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

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

Как создать реквизит с типом «ХранилищеЗначения»

Чтобы хранить данные в объекте конфигурации, нужно добавить реквизит соответствующего типа. В конфигураторе откройте объект (справочник, документ, регистр сведений), добавьте реквизит и в свойстве «Тип» выберите ХранилищеЗначения. Для этого типа не задаются длина или состав — ограничений по типам внутри контейнера нет.

На практике хранилище чаще всего добавляют в:

• справочники — например, реквизит «ФайлКартинки» в «Номенклатура»;
• регистры сведений — измерение «Объект», ресурс «Данные» типа ХранилищеЗначения (классический паттерн для присоединённых файлов);
• константы — глобальные настройки в виде структуры;
• планы обмена и задачи — для передачи параметров.

Для регистра сведений с хранилищем важно правильно выбрать измерения: по ним будет выполняться поиск и отбор данных. Само хранилище не может быть измерением — только ресурсом или реквизитом.

Как записать значение в хранилище

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

// Сохранение картинки в реквизит справочника
ДвоичныеДанные = Новый ДвоичныеДанные("C:\Images\photo.jpg");
ОбъектТовара = Справочники.Номенклатура.НайтиПоКоду("000001").ПолучитьОбъект();
ОбъектТовара.ФайлКартинки = Новый ХранилищеЗначения(ДвоичныеДанные, Новый СжатиеДанных(9));
ОбъектТовара.Записать();

Аналогично сохраняется таблица значений или структура с настройками:

// Сохранение настроек в константу
Настройки = Новый Структура;
Настройки.Вставить("Колонка1", "Артикул");
Настройки.Вставить("Ширина", 120);
Константы.НастройкиОтчета.Установить(Новый ХранилищеЗначения(Настройки));

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

Как прочитать и извлечь данные из хранилища

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

// Извлечение картинки из реквизита
Хранилище = ТоварСсылка.ФайлКартинки;
ДвоичныеДанные = Хранилище.Получить();
Если ДвоичныеДанные <> Неопределено Тогда
    ДвоичныеДанные.Записать("C:\Temp\photo.jpg");
КонецЕсли;

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

Ограничения и особенности хранилища значения

Несмотря на универсальность, у типа есть жёсткие ограничения, которые нужно учитывать при проектировании:

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

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

Типичные ошибки при работе с хранилищем

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

Как проверить результат и очистить хранилище

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

Чтобы очистить хранилище, присвойте реквизиту пустое значение и запишите объект:

ОбъектТовара.ФайлКартинки = Новый ХранилищеЗначения(Неопределено);
ОбъектТовара.Записать();

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

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