Как в 1С обернуть JSON в квадратные скобки и правильно сформировать массив

При работе с внешними API и интеграциями программисты часто сталкиваются с ситуацией, когда стандартная сериализация объекта 1С (например, Структура или Соответствие) выдает JSON-объект, ограниченный фигурными скобками {}, в то время как принимающая сторона ожидает массив, обернутый в квадратные скобки [].

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

Способ 1. Использование объекта Массив (рекомендуемый подход)

Самый правильный и логичный способ получить квадратные скобки в JSON — это использовать высокоуровневую сериализацию объекта Массив. В 1С платформа автоматически интерпретирует Массив как коллекцию элементов, которая в формате JSON всегда обрамляется символами []. Даже если в массиве всего один элемент (ваше Соответствие или Структура), итоговая строка будет иметь нужный вид.

Давайте рассмотрим этот метод на конкретном примере кода:

// 1. Подготавливаем настройки записи
тПараметрыJSON = Новый ПараметрыЗаписиJSON(ПереносСтрокJSON.Авто, " ", Истина);  
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку(тПараметрыJSON); 

// 2. Создаем данные (объект)
СоответствиеJason = Новый Соответствие;
СоответствиеJason.Вставить("id", "9339101");
СоответствиеJason.Вставить("pipeline_id", 3959986);
СоответствиеJason.Вставить("status_id", 37773055);

// 3. Оборачиваем объект в массив
МассивСоответствий = Новый Массив;
МассивСоответствий.Добавить(СоответствиеJason);

// 4. Записываем весь массив целиком
ЗаписатьJSON(ЗаписьJSON, МассивСоответствий);

// 5. Получаем результат
СтрокаJS = ЗаписьJSON.Закрыть();

Почему это лучше? Используя этот метод, мы доверяем платформе 1С управление синтаксисом. Она сама расставит запятые, если элементов в массиве станет больше одного, и корректно обработает вложенность.

Способ 2. Ручная склейка строк (быстрый, но опасный метод)

Иногда разработчики прибегают к простой конкатенации строк, добавляя символы "[" и "]" к уже сформированной строке JSON. Рассмотрим, как это выглядит в коде:

// Формируем обычный JSON объект
ЗаписатьJSON(ЗаписьJSON, СоответствиеJason);
СтрокаJS = ЗаписьJSON.Закрыть();

// Добавляем скобки вручную
СтрокаJS = "[" + СтрокаJS + "]";

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

1. Риск невалидности: Если исходная строка окажется пустой или будет содержать системные ошибки, ручная вставка скобок может создать невалидную структуру, которую не примет ни один парсер.
2. Проблемы с потоками: Этот метод работает только со строками в памяти. Если вы записываете JSON напрямую в файл на диске для экономии ресурсов, «дописать» скобки в начало уже созданного файла будет технически сложно и неэффективно.
3. Человеческий фактор: Легко ошибиться с пробелами или кодировкой при сложной сборке строки из разных фрагментов.

Способ 3. Низкоуровневая запись через Streaming API

Для формирования сложных структур или при работе с очень большими объемами данных, когда нельзя поместить все объекты в один Массив из-за ограничений оперативной памяти, следует использовать методы прямой записи. Этот подход позволяет нам «диктовать» платформе каждый шаг формирования файла.

Разберем процесс по шагам:

1. Вызываем ЗаписьJSON.ЗаписатьНачалоМассива() — это принудительно ставит открывающую скобку [.
2. В цикле или последовательно записываем объекты с помощью ЗаписатьНачалоОбъекта() и ЗаписатьКонецОбъекта().
3. Завершаем процесс методом ЗаписьJSON.ЗаписатьКонецМассива() — это ставит закрывающую скобку ].

Такой потоковый метод гарантирует минимальное потребление памяти и максимальную гибкость управления структурой файла.

Важные технические нюансы

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

1. Соответствие против Структуры

В примере выше использовалось Соответствие. Важно понимать разницу:

• Соответствие (Map): позволяет использовать любые типы в качестве ключей (даже числа или ссылки), но оно не гарантирует порядок ключей. Если принимающая сторона требует, чтобы id всегда шел первым, Соответствие может вас подвести, так как при сериализации порядок ключей случаен.
• Структура (Structure): ключи должны быть только строками-идентификаторами (без пробелов, не с цифры). Она работает быстрее и чаще используется для простых JSON-объектов.

2. Обработка дат

Часто при передаче данных в JSON возникают ошибки с форматом даты. В 1С через ПараметрыЗаписиJSON можно настроить ВариантЗаписиДатыJSON. Рекомендуется использовать ВариантЗаписиДатыJSON.ISO, так как это международный стандарт, который понимают практически все современные веб-сервисы.

3. Автоматическое преобразование имен

Если в вашей базе 1С поля называются на русском языке (например, ИдентификаторЗаказа), а API требует order_id, вам не обязательно переименовывать ключи вручную в коде. Можно использовать функцию преобразования имен свойств в настройках ПараметрыЗаписиJSON, которая будет автоматически менять названия полей в момент записи.

4. Сериализация сложных объектов (XDTO)

Если вам нужно передать в JSON не просто набор полей, а целый объект метаданных (например, документ или справочник), метод ЗаписатьJSON не справится напрямую. В этом случае мы сначала используем СериализаторXDTO, чтобы превратить объект 1С в структуру, пригодную для записи в JSON.

Итоги

Мы выяснили, что наиболее надежным способом обернуть JSON в массив является использование объекта Массив, в который помещается ваше Соответствие. Это избавляет от ошибок ручного формирования строки и делает код понятным для других разработчиков. При работе с большими данными всегда отдавайте предпочтение Streaming API (методы ЗаписатьНачалоМассива), чтобы обеспечить высокую производительность системы.