Как сериализовать массив в 1С

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

В платформе 1С:Предприятие нет единственного «правильного» способа: выбор зависит от того, куда уходят данные. Для обмена с веб-сервисами и REST API стандартом де-факто стал JSON, для обмена между информационными базами 1С удобен механизм XDTO, а для временного хранения внутри одной базы часто используют ЗначениеВСтрокуВнутр. Каждый вариант имеет ограничения по типам данных, объёму и переносимости.

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

Как выбрать способ сериализации под задачу

Прежде чем писать код, ответьте на два вопроса: кто будет читать сериализованные данные и какие типы лежат в массиве. Если читатель — внешняя система (сайт, мобильное приложение, другой язык программирования), единственный осмысленный вариант — JSON или XML, потому что внутренние форматы 1С никто кроме 1С не поймёт.

Если данные остаются внутри экосистемы 1С, появляется выбор. Массив с простыми типами (строки, числа, даты, булево) сериализуется любым способом. Массив со ссылками на объекты базы данных корректно перенесёт только XDTO-сериализатор или внутренний формат — JSON без дополнительной обработки превратит ссылку в нечитаемое представление.

Сериализация массива в JSON через ЗаписьJSON

Объект ЗаписьJSON последовательно формирует JSON-документ. Для массива используются методы ЗаписатьНачалоМассива() и ЗаписатьКонецМассива(), а каждый элемент записывается через ЗаписатьЗначение(). Метод подходит для строк, чисел, булевых значений и дат (дата сериализуется в формате ISO 8601).

Функция МассивВJSON(МассивДанных)

	Запись = Новый ЗаписьJSON;
	Запись.УстановитьСтроку();

	Запись.ЗаписатьНачалоМассива();
	Для Каждого Элемент Из МассивДанных Цикл
		Запись.ЗаписатьЗначение(Элемент);
	КонецЦикла;
	Запись.ЗаписатьКонецМассива();

	Возврат Запись.Закрыть();

КонецФункции

Вызов МассивВJSON(Массив) для массива из трёх строк вернёт текст вида ["Первый","Второй","Третий"]. Обратите внимание: Закрыть() одновременно завершает запись и возвращает сформированную строку — отдельно получать текст не нужно.

Сериализация массива структур

На практике в массиве чаще лежат не скалярные значения, а структуры — например, строки табличной части или результата запроса. Здесь удобна функция ЗаписатьJSON(), которая умеет сериализовать структуры и соответствия целиком:

Запись = Новый ЗаписьJSON;
Запись.УстановитьСтроку();
ЗаписатьJSON(Запись, МассивСтруктур);
СтрокаJSON = Запись.Закрыть();

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

Чтение JSON обратно в массив

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

Чтение = Новый ЧтениеJSON;
Чтение.УстановитьСтроку(СтрокаJSON);
Результат = ПрочитатьJSON(Чтение);
Чтение.Закрыть();

Если ТипЗнч(Результат) = Тип("Массив") Тогда
	// работаем с массивом
КонецЕсли;

Функция ПрочитатьJSON возвращает массив, структуру или скалярное значение в зависимости от содержимого строки. Всегда проверяйте тип результата через ТипЗнч(), прежде чем обращаться к элементам: если внешняя система прислала объект вместо массива, обращение по индексу вызовет ошибку исполнения.

Сериализация через XDTO для обмена между базами 1С

Объект СериализаторXDTO преобразует значения 1С, включая ссылки, таблицы значений и массивы, в XML-документ, который другая база 1С сможет прочитать без дополнительной настройки. Это стандартный способ для интеграций «1С-1С».

Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
СериализаторXDTO.ЗаписатьXML(Запись, МассивДанных);
СтрокаXML = Запись.Закрыть();

// Обратное чтение:
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(СтрокаXML);
ВосстановленныйМассив = СериализаторXDTO.ПрочитатьXML(Чтение);
Чтение.Закрыть();

Главное преимущество способа — полная поддержка типов платформы: ссылки восстанавливаются по GUID, если в базе-приёмнике есть те же объекты, либо превращаются в битые ссылки, что легко диагностируется. Недостаток — многословный XML и невозможность прочитать результат средствами, не знающими схему XDTO платформы.

ЗначениеВСтрокуВнутр для хранения внутри базы

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

СтрокаВнутр = ЗначениеВСтрокуВнутр(МассивДанных);
// ... сохранение в реквизит или параметр
ВосстановленныйМассив = ЗначениеИзСтрокиВнутр(СтрокаВнутр);

Если задача — просто положить массив в реквизит справочника или документа, часто вообще не нужна строка: используйте тип реквизита ХранилищеЗначения и методы Новый ХранилищеЗначения(Массив) и Получить(). Это надёжнее и не требует ручной сериализации.

Проверка результата и типичные ошибки

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

Отдельно проверяйте поведение на граничных случаях: пустой массив, массив с Неопределено и NULL, массив с кириллицей и спецсимволами. JSON корректно экранирует кавычки и переводы строк автоматически, но только если вы пользуетесь объектом ЗаписьJSON, а не собираете строку конкатенацией.

Производительность и ограничения по объёму

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

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

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