Сериализация в 1С: что это и как применяется

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

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

На практике с сериализацией сталкиваются в трёх ситуациях: при обмене между конфигурациями (например, выгрузка из УТ в БП), при интеграции через HTTP-сервисы и REST API, а также при сохранении настроек и сложных структур данных в хранилище значений или файлы.

Где в 1С применяется сериализация

Основные сценарии, в которых без сериализации не обойтись:

• Обмен данными между информационными базами (РИБ, планы обмена, универсальный формат EnterpriseData).
• Интеграция с внешними системами через HTTP-сервисы, веб-сервисы (SOAP) и REST API.
• Сохранение произвольных структур данных в хранилище значений, файлы или строковые реквизиты.
• Передача данных между клиентом и сервером, между сеансами, через очереди сообщений.
• Выгрузка отчётов, печатных форм и настроек в файлы для переноса между базами.

Типичный пример: база Управление торговлей должна передать заказ на сайт интернет-магазина. Объект «Заказ клиента» нельзя «отправить» напрямую — его преобразуют в JSON-строку, передают по HTTP, а на стороне сайта строка разбирается обратно в структуру данных.

Основные форматы и механизмы сериализации в 1С

Платформа предлагает несколько штатных способов, каждый со своей областью применения.

Выбор зависит от приёмника данных. Если обмен идёт только между базами 1С, удобны внутренние функции или СериализаторXDTO — они сохраняют типы платформы без потерь. Если приёмник — внешняя система, стандартом де-факто стал JSON: он компактнее XML и нативно поддерживается большинством языков.

Как сериализовать объект в JSON

Наиболее востребованная задача — сформировать JSON из структуры или соответствия. Для этого используются объекты ЗаписьJSON и ЧтениеJSON встроенного языка.

Структура = Новый Структура;
Структура.Вставить("Номер", "000000001");
Структура.Вставить("Дата", Формат(ТекущаяДатаСеанса(), "ДФ=yyyy-MM-dd"));
Структура.Вставить("Сумма", 1500.50);

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

Обратная операция — чтение строки JSON в структуру:

Чтение = Новый ЧтениеJSON;
Чтение.УстановитьСтроку(СтрокаJSON);
Данные = ПрочитатьJSON(Чтение, Истина); // Истина — читать в соответствие
Чтение.Закрыть();

Параметр «Истина» в ПрочитатьJSON означает чтение в соответствие, а не в структуру. Это удобно, когда имена ключей могут содержать символы, недопустимые для имён свойств структуры (например, дефисы или пробелы).

Сериализация объектов платформы через XDTO

Когда нужно сериализовать ссылку на справочник, документ или набор записей с сохранением типов 1С, применяется объект СериализаторXDTO. Он преобразует значения платформы в XML-элементы и обратно.

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

// Обратное восстановление
ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.УстановитьСтроку(СтрокаXML);
Если СериализаторXDTO.ВозможностьЧтенияXML(ЧтениеXML) Тогда
    ВосстановленнаяСсылка = СериализаторXDTO.ПрочитатьXML(ЧтениеXML);
КонецЕсли;

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

Сохранение данных в хранилище значений

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

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

Проверка результата сериализации

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

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

1. 1
   Определите приёмника: база 1С или внешняя система — от этого зависит формат.
2. 2
   Составьте структуру передаваемых данных и договоритесь о формате дат и идентификаторов.
3. 3
   Реализуйте сериализацию (ЗаписатьJSON или СериализаторXDTO) и оберните в попытку/исключение.
4. 4
   Реализуйте десериализацию на стороне приёмника с проверкой обязательных полей.
5. 5
   Протестируйте на копии базы: сформируйте строку, прочитайте обратно, сверьте данные.

Частые вопросы о сериализации в 1С