Хранение нескольких значений в одном реквизите 1С: от массивов до таблиц значений

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

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

1. Стандартные типы данных для множественных значений

Платформа 1С из коробки предоставляет три основных типа для хранения нескольких значений: Массив, СписокЗначений и ТаблицаЗначений. Каждый из них имеет свои особенности и область применения.

Массив — самый простой и легковесный вариант. Подходит для хранения однотипных данных (чисел, строк, ссылок), когда порядок элементов важен, а дополнительные свойства не нужны. Например, список идентификаторов документов или кодов номенклатуры. Основное ограничение: отсутствие именованных колонок и встроенных методов поиска.

• ✅ Плюсы: минимальные накладные расходы, высокая скорость доступа по индексу
• ❌ Минусы: нет методов поиска, сложно модифицировать (требуется создавать новый массив)
• 🔹 Пример: МассивТоваров = Новый Массив; МассивТоваров.Добавить(СсылкаНаТовар1);

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

ТаблицаЗначений — самый мощный встроенный инструмент, фактически представляющий собой динамическую таблицу с колонками разного типа. Позволяет хранить структурированные данные (например, спецификацию товара с полями "Номенклатура", "Количество", "Цена"), поддерживает сортировку, фильтрацию и агрегатные функции. Минус — высокая ресурсоемкость при больших объемах данных.

2. Работа с массивами: примеры и подводные камни

Массивы в 1С создаются динамически и могут содержать элементы любого типа, включая другие массивы (многомерные структуры). Основные методы работы:

• 📌 Добавить() — добавляет элемент в конец
• 🔍 Найти() — возвращает индекс элемента (или -1)
• 🗑️ Удалить() — удаляет элемент по индексу
• 🔄 Вставить() — вставляет элемент по указанному индексу

Пример создания и заполнения массива с проверкой на дубли:

МассивКодов = Новый Массив;
МассивКодов.Добавить("001");
МассивКодов.Добавить("002");

// Проверка на существование элемента
Если МассивКодов.Найти("001") <> -1 Тогда
Сообщить("Код уже существует!");
КонецЕсли;

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

⚠️ Внимание: При сериализации массивов в хранилище (например, через ЗаписатьJSON()) теряется информация о типах данных. Число 123 после чтения может стать строкой "123". Всегда проверяйте типы после десериализации.

3. СписокЗначений: когда нужны "человеческие" названия

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

Создание и заполнение списка:

СписокКонтрагентов = Новый СписокЗначений;
СписокКонтрагентов.Добавить(Значение, Представление);

// Пример с ссылкой на справочник
СписокКонтрагентов.Добавить(
Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка"),
"ООО Ромашка (основной поставщик)"
);

Ключевые методы:

Особенность СпискаЗначений: при изменении Представления элемента автоматически обновляется отображение во всех связанных формах. Это удобно для динамического интерфейса, но может вызвать задержки при работе с большими списками (1000+ элементов).

4. ТаблицаЗначений: структурированное хранение данных

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

• 📋 Спецификация документа (товары, количества, цены)
• 📊 История изменений реквизита (дата, пользователь, старое/новое значение)
• 🔧 Набор параметров настройки (имя параметра, значение, описание)

Создание таблицы с колонками:

ТаблицаПараметров = Новый ТаблицаЗначений;
ТаблицаПараметров.Колонки.Добавить("ИмяПараметра", Новый ОписаниеТипов("Строка"));
ТаблицаПараметров.Колонки.Добавить("Значение");
ТаблицаПараметров.Колонки.Добавить("Описание", Новый ОписаниеТипов("Строка",,,,"М"));

// Добавление строки
НоваяСтрока = ТаблицаПараметров.Добавить();
НоваяСтрока.ИмяПараметра = "Цвет";
НоваяСтрока.Значение = "Красный";
НоваяСтрока.Описание = "Основной цвет упаковки";

Для работы с ТаблицейЗначений полезно знать:

• 🔢 Колонки можно добавлять динамически во время выполнения
• 🔍 Поддерживаются методы НайтиСтроки(), Свернуть(), Итоги()
• 📎 Можно привязывать к элементам управления формы (поле табличного документа)
• ⚡ Для ускорения поиска используйте индексы: Таблица.Индексы.Добавить("ИндексПоКоду", Новый ИндексКолонок("Код"))

⚠️ Внимание: При передаче ТаблицыЗначений между клиентом и сервером (например, в веб-клиенте) происходит полная передача всех данных. Для больших таблиц (1000+ строк) это может вызвать задержки. В таких случаях передавайте только идентификаторы строк или используйте серверные процедуры для обработки.

5. Альтернативные подходы: хранилище значений и внешние системы

Когда встроенных типов недостаточно (например, нужно хранить сложные объекты или большие объемы данных), на помощь приходят альтернативные решения:

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

• 📦 Сохранения состояния формы между сеансами
• 🔄 Передачи сложных структур между базой и внешними системами
• 💾 Архивирования данных с возможностью восстановления

Пример работы с хранилищем:

// Сохранение данных
ДанныеДляСохранения = Новый Структура("Параметр1, Параметр2", 123, "Тест");
Хранилище = Новый ХранилищеЗначения(ДанныеДляСохранения, Новый СжатиеДанных);
Объект.РеквизитХранилище = Хранилище;

// Чтение данных
ВосстановленныеДанные = (Объект.РеквизитХранилище).Получить();

Для интеграции с внешними системами или хранения больших объемов данных (например, логов изменений) можно использовать:

• 🗃️ Внешние хранилища: файлы на диске, SQL-базы, MongoDB
• ☁️ Облачные сервисы: 1С:Линк, Yandex Object Storage
• 🔗 Специализированные обработки: например, "Хранилище дополнительных реквизитов" от 1С-Битрикс

Выбор метода зависит от задачи:

6. Оптимизация производительности при работе с множественными значениями

Неправильное использование реквизитов с несколькими значениями — частая причина тормозов в 1С. Основные правила оптимизации:

1. Выбор типа данных:

• 🚀 Для небольших списков (до 100 элементов) — Массив или СписокЗначений
• 📊 Для структурированных данных (100–1000 строк) — ТаблицаЗначений с индексами
• 🗃️ Для больших объемов (1000+ строк) — внешние хранилища

2. Работа с формами:

• 🔄 Отключайте автоматическое обновление формы при изменении данных (АвтоОбновление = Ложь)
• 📱 Для мобильного клиента минимизируйте количество колонок в таблицах
• 🔍 Используйте серверные процедуры для фильтрации больших списков

3. Сериализация и передача данных:

• 📦 Для передачи между клиентом и сервером используйте ХранилищеЗначения со сжатием
• 🔗 При работе с веб-сервисами передавайте данные порциями (пагинация)
• 🗜️ Избегайте передачи целых ТаблицЗначений — передавайте только измененные строки

Пример оптимизированного кода для работы с большой таблицей:

// Плохо: передача всей таблицы на клиент
Форма.Элементы.ТаблицаДокументов.Значение = ПолнаяТаблицаДокументов;

// Хорошо: передача только видимых строк с пагинацией
ТекущаяСтраница = Форма.Элементы.ТаблицаДокументов.ТекущаяСтраница;
Форма.Элементы.ТаблицаДокументов.Значение =
ПолучитьСтраницуДокументов(ТекущаяСтраница, РазмерСтраницы);

⚠️ Внимание: В конфигурациях с управляемыми формами избегайте хранения больших ТаблицЗначений в реквизитах формы. Это приводит к увеличению размера состояния формы и замедлению работы. Вместо этого загружайте данные порциями по запросу пользователя.

7. Типичные ошибки и как их избежать

Опыт показывает, что 80% проблем с реквизитами, хранящими несколько значений, связаны с типичными ошибками проектирования. Рассмотрим самые распространенные:

1. Использование строки вместо специализированного типа

Частая ошибка новичков — хранить список значений в одной строке через разделитель (например, "значение1;значение2;значение3"). Это приводит к:

• 🔍 Сложности поиска и модификации отдельных элементов
• 🐞 Ошибкам при наличии разделителя в самих значениях
• 📈 Неконтролируемому росту размера реквизита

2. Хранение больших бинарных данных в реквизитах

Сохранение файлов (PDF, изображения) прямо в реквизитах типа ХранилищеЗначения раздувает базу данных и замедляет резервное копирование. Правильный подход:

• 🗃️ Хранить файлы во внешнем хранилище (файловая система, S3)
• 🔗 В реквизите сохранять только ссылку (путь или URL)

3. Отсутствие контроля типов в массивах

Поскольку массивы в 1С не типизированы, легко допустить ошибку, добавив в массив строк число или объект. Это приведет к исключениям при обработке. Решение:

// Проверка типа перед добавлением
Если ТипЗнч(НовоеЗначение) = Тип("Строка") Тогда
МассивСтрок.Добавить(НовоеЗначение);
Иначе
Сообщить("Ошибка: ожидалась строка!");
КонецЕсли;

4. Избыточная денормализация данных

Хранение дублирующей информации в реквизитах (например, копирование данных из справочника в документ) приводит к:

• 🔄 Проблемам с актуальностью данных
• 📈 Увеличению размера базы
• 🔧 Усложнению поддержки

Используйте ссылки на объекты вместо дублирования данных, а для кэширования часто используемой информации применяйте механизм ПланыОбмена или РегистрыСведений.

8. Практический пример: хранение истории изменений документа

Рассмотрим реальную задачу: нужно хранить историю изменений реквизита СуммаДокумента с указанием даты, пользователя и старого/нового значения. Оптимальное решение — использовать ТаблицуЗначений в реквизите документа.

Шаг 1. Добавление реквизита

В конфигураторе создаем реквизит ИсторияИзмененийСуммы типа ТаблицаЗначений со следующими колонками:

• 📅 ДатаИзменения (Тип: Дата)
• 👤 Пользователь (Тип: Ссылка на Справочник.Пользователи)
• 💰 СтараяСумма (Тип: Число)
• 💵 НоваяСумма (Тип: Число)

Шаг 2. Заполнение истории при изменении

В модуле документа добавляем обработчик события ПередЗаписью():

Процедура ПередЗаписью(Отказ, РежимЗаписи)
Если ЗначениеЗаполнено(СуммаДокумента) И ЭтоИзменение() Тогда
Если НЕ ЗначениеЗаполнено(ИсторияИзмененийСуммы) Тогда
ИсторияИзмененийСуммы = Новый ТаблицаЗначений;
// Настройка колонок (см. Шаг 1)
КонецЕсли;

НоваяСтрока = ИсторияИзмененийСуммы.Добавить();
НоваяСтрока.ДатаИзменения = ТекущаяДата();
НоваяСтрока.Пользователь = ТекущийПользователь();
НоваяСтрока.СтараяСумма = СтараяСумма; // Сохраненное значение
НоваяСтрока.НоваяСумма = СуммаДокумента;
КонецЕсли;
КонецПроцедуры

Шаг 3. Отображение истории в форме

В форме документа добавляем табличное поле, привязанное к реквизиту ИсторияИзмененийСуммы. Для удобства можно добавить кнопку "Показать историю", которая будет открывать отдельную форму с детализацией:

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

Добавлен реквизит типа ТаблицаЗначений|Настроены колонки (Дата, Пользователь, СтараяСумма, НоваяСумма)|Реализован обработчик ПередЗаписью()|Добавлено табличное поле в форму|Предусмотрена очистка истории при необходимости-->

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

FAQ: Частые вопросы по работе с реквизитами

Если ИсторияИзмененийСуммы.Количество() > 10 Тогда
ИсторияИзмененийСуммы.Удалить(ИсторияИзмененийСуммы[0]); // Удаляем самую старую запись
КонецЕсли;

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ТаблицаЗначений.ЗаписатьJSON(ЗаписьJSON);
Результат = ЗаписьJSON.Закрыть();
ЗаписатьФайл("C:\Backup\таблица.json", Результат);

ТекстОтчета = "";
Для Каждого Элемент Из СписокТоваров Цикл
ТекстОтчета = ТекстОтчета + Элемент.Представление + Символы.ПС;
КонецЦикла;