Как вывести значение массива в 1С: 5 способов с примерами

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

Мы рассмотрим не только базовые способы вроде Сообщить(), но и более продвинутые техники — преобразование в JSON, использование ТаблицыЗначений, а также нюансы работы с массивами в управляемом и обычном приложении. Особое внимание уделим типичным ошибкам, которые допускают даже опытные разработчики, например, при выводе вложенных массивов или объектов с циклическими ссылками.

1. Базовый вывод массива через Сообщить()

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

🔹 Выводит данные в одну строку без форматирования.
🔹 Не показывает структуру вложенных массивов.
🔹 Ограничена длиной строки (около 1000 символов в управляемом приложении).

Пример кода для одомерного массива:

Массив = Новый Массив;
Массив.Добавить("Яблоко");
Массив.Добавить("Банан");
Массив.Добавить("Апельсин");
Сообщить(Массив); // Выведет: Яблоко,Банан,Апельсин

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

ДвумерныйМассив = Новый Массив;
Строка1 = Новый Массив;
Строка1.Добавить("Иванов");
Строка1.Добавить(1000);
ДвумерныйМассив.Добавить(Строка1);

Для Каждого Строка Из ДвумерныйМассив Цикл
Сообщить(Строка); // Выведет каждую строку отдельно
КонецЦикла;

⚠️ Внимание: В управляемом приложении (тонкий клиент, веб-клиент) функция Сообщить() выводит сообщения в специальное окно, которое может быть скрыто за другими формами. Чтобы не пропустить вывод, используйте комбинацию Ctrl+Alt+M для открытия журнала сообщений.

2. Использование ТаблицыЗначений для наглядного вывода

Если нужно не просто вывести массив, а представить его в удобном для пользователя виде (например, в отчете или на форме), лучше преобразовать его в ТаблицуЗначений. Этот метод подходит для:

📊 Формирования отчетов с данными из массивов.
🖥️ Отображения на формах в пользовательском интерфейсе.
🔄 Экспорта данных в Excel или другие форматы.

Пример преобразования одомерного массива в таблицу:

Массив = Новый Массив;
Массив.Добавить("Товар1");
Массив.Добавить("Товар2");

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Элемент");

Для Каждого Элемент Из Массив Цикл
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Элемент = Элемент;
КонецЦикла;

Таблица.Вывести(); // Покажет таблицу в отдельном окне

Для двумерных массивов можно создать таблицу с несколькими колонками:

Данные = Новый Массив;
Строка1 = Новый Массив;
Строка1.Добавить("Иванов");
Строка1.Добавить(25);
Данные.Добавить(Строка1);

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("ФИО");
Таблица.Колонки.Добавить("Возраст");

Для Каждого Строка Из Данные Цикл
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.ФИО = Строка[0];
НоваяСтрока.Возраст = Строка[1];
КонецЦикла;

3. Вывод массива в отладчике 1С

Отладчик 1С:Предприятие предоставляет мощные инструменты для анализа массивов, включая:

🔍 Просмотр вложенных структур (массивы в массивах, массивы объектов).
📋 Изменение значений "на лету" во время выполнения.
🔄 Пошаговое выполнение кода с наблюдением за изменениями массива.

Чтобы воспользоваться отладчиком:

Установите точку останова на строке после заполнения массива (кликните левее номера строки в конфигураторе).
Запустите код в режиме отладки (F5 или кнопка "Отладка").
Когда выполнение остановится, наведите курсор на переменную массива — появится всплывающая подсказка с его содержимым.
Для детального анализа добавьте переменную в окно Просмотр (клик правой кнопкой → "Добавить просмотр").

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

⚠️ Внимание: В веб-клиенте отладчик работает ограниченно — некоторые функции (например, изменение значений во время выполнения) могут быть недоступны. Для полноценной отладки используйте толстый клиент.

💡

Если массив слишком большой, в отладчике можно использовать фильтрацию по значению. Например, в окне "Просмотр" введите в поле фильтра Значение = "ИскомыйЭлемент", чтобы быстро найти нужную строку.

4. Преобразование массива в JSON для сложных структур

Если массив содержит вложенные объекты, ссылки на справочники или другие сложные данные, лучший способ его вывести — преобразовать в формат JSON. Это позволит:

🌐 Увидеть полную структуру со всеми уровнями вложенности.
📄 Сохранить данные в файл для дальнейшего анализа.
🔄 Передать массив в внешние системы (например, через REST API).

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

Массив = Новый Массив;
Элемент = Новый Структура("Наименование, Количество", "Стул", 5);
Массив.Добавить(Элемент);

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

Сообщить(Результат);
// Выведет: [{"Наименование":"Стул","Количество":5}]

Для чтения JSON из строки обратно в массив:

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

Метод вывода	Подходит для	Ограничения
`Сообщить()`	Быстрая проверка простых массивов	Нет форматирования, ограничение по длине
ТаблицаЗначений	Отчеты, формы, экспорт в Excel	Требует ручного маппинга колонок
Отладчик	Анализ сложных структур, отладка	Не доступен в веб-клиенте полностью
JSON	Сложные вложенные массивы, интеграции	Требует дополнительного кода для преобразования

5. Особенности работы с массивами объектов

Когда массив содержит не примитивные типы (строки, числа), а объекты 1С (например, СправочникСсылка, ДокументОбъект), стандартные методы вывода могут работать некорректно. Например, Сообщить() выведет только идентификатор объекта, а не его данные.

Решения для вывода массивов объектов:

📌 Использовать отладчик — он покажет все свойства объекта.
📌 Создать структуру с нужными полями и выводить её.
📌 Преобразовать объект в строку через методы типа Представление() или Наименование.

Пример вывода массива справочников:

МассивСправочников = Новый Массив;
МассивСправочников.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Стул"));
МассивСправочников.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Стол"));

Для Каждого Элемент Из МассивСправочников Цикл
Если Элемент.ЭтоГруппа() Тогда
Сообщить(Элемент.Наименование + " (Группа)");
Иначе
Сообщить(Элемент.Наименование + " (Элемент)");
КонецЕсли;
КонецЦикла;

⚠️ Внимание: При выводе объектов в JSON возможно зацикливание, если объекты содержат ссылки друг на друга (например, документ ссылается на справочник, а справочник — на этот же документ). В таком случае используйте флаг ЗаписьJSON.СериализоватьНеопределенныеЗначения = Ложь.

Что делать если массив содержит Null?

Если массив содержит значение Null, при выводе через Сообщить() или JSON это может вызвать ошибку. Чтобы избежать проблем, используйте конструкцию Если ЗначениеЗаполнено(Элемент) Тогда перед выводом. Например:

Для Каждого Элемент Из Массив Цикл
Если ЗначениеЗаполнено(Элемент) Тогда
Сообщить(Элемент);
Иначе
Сообщить("Пустое значение");
КонецЕсли;
КонецЦикла;

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

Даже опытные разработчики 1С иногда сталкиваются с проблемами при выводе массивов. Вот самые распространенные ошибки и способы их решения:

🚫 Ошибка "Недопустимое значение типа" — возникает при попытке вывести в Сообщить() объект, который нельзя преобразовать в строку. Решение: используйте методы объекта (например, .Наименование) или преобразуйте в JSON.
🚫 Пустое окно сообщений — в управляемом приложении окно с выводом может быть скрыто. Решение: проверьте журнал сообщений (Ctrl+Alt+M) или используйте Предупреждение() вместо Сообщить().
🚫 Обрезка длинных массивов — Сообщить() ограничивает длину строки. Решение: разбивайте вывод на части или используйте ТаблицуЗначений.
🚫 Зацикливание при сериализации в JSON — происходит, если объекты ссылаются друг на друга. Решение: отключите сериализацию неопределенных значений или напишите кастомный метод преобразования.

Пример обработки ошибки при выводе:

Процедура БезопасныйВыводМассива(Массив)
Попытка
Сообщить(Массив);
Исключение
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.ЗаписатьJSON(Массив);
Сообщить(ЗаписьJSON.Закрыть());
КонецПопытки;
КонецПроцедуры

Используете ли вы правильный метод для типа данных?|Проверяете ли вы массив на пустоту (Массив.Количество() > 0)?|Учитываете ли ограничения управляемого приложения?|Предусмотрели ли обработку исключений для объектов?-->

7. Альтернативные методы: Файлы, Лог, Внешние компоненты

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

📄 Запись в файл — подходит для больших массивов или логов.
📝 Журнал регистрации — запись в системный журнал 1С.
🔌 Внешние компоненты — например, для вывода в Excel через COM-объект.

Пример записи массива в текстовый файл:

Массив = Новый Массив;
Массив.Добавить("Данные1");
Массив.Добавить("Данные2");

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

ЗаписьТекста = Новый ЗаписьТекста;
ЗаписьТекста.Открыть("C:\temp\массив.txt");
ЗаписьТекста.ЗаписатьСтроку(Текст);
ЗаписьТекста.Закрыть();

Пример записи в журнал регистрации:

ЗаписьЖурналаРегистрации("ВыводМассива", УровеньЖурналаРегистрации.Информация, , Текст);

Для работы с Excel через COM:

Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Add();
Лист = Книга.Worksheets(1);

Для i = 0 По Массив.ВГраница() Цикл
Лист.Cells(i+1, 1).Value = Массив[i];
КонецЦикла;

Excel.Visible = Истина;

⚠️ Внимание: При работе с внешними компонентами (например, COM-объектами) в веб-клиенте или тонком клиенте могут возникать ошибки из-за ограничений безопасности. Для таких случаев используйте серверные процедуры или HTTP-сервисы.

💡

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

FAQ: Частые вопросы по выводу массивов в 1С

Как вывести массив в отчет с группировкой?

Для вывода массива с группировкой:

Преобразуйте массив в ТаблицуЗначений.
Добавьте колонку для группировки (например, "Категория").
Используйте Группировка = Новый Группировка("Категория") при формировании отчета.
Выведите таблицу через ТабличныйДокумент с включенной группировкой.

Пример кода для группировки:

Таблица.Колонки.Добавить("Категория");
Таблица.Колонки.Добавить("Элемент");

// Заполнение таблицы данными

Отчет = Новый ТабличныйДокумент;
Отчет.Вывести(Таблица, , , Группировка);

Почему Сообщить() не показывает вложенные массивы?

Функция Сообщить() преобразует массив в строку, но не рекурсивно обрабатывает вложенные структуры. Чтобы увидеть вложенные массивы:

Используйте отладчик (он покажет полную структуру).
Напишите рекурсивную функцию для обхода вложенных массивов.
Преобразуйте массив в JSON — он поддерживает вложенность.

Пример рекурсивного вывода:

Процедура ВывестиМассивРекурсивно(Массив, Уровень = 0)
Для Каждого Элемент Из Массив Цикл
Если ТипЗнч(Элемент) = Тип("Массив") Тогда
ВывестиМассивРекурсивно(Элемент, Уровень + 1);
Иначе
Сообщить(Повтор(Символы.Таб, Уровень) + Элемент);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Как вывести массив в HTML-документ для веб-клиента?

Для вывода массива в веб-клиенте в формате HTML:

Сформируйте HTML-строку с данными массива.
Используйте ПоказатьHTMLДокумент() для отображения.

Пример:

HTML = "";
Для Каждого Элемент Из Массив Цикл
HTML = HTML + "
";
КонецЦикла;
HTML = HTML + "

" + Элемент + "

";

ПоказатьHTMLДокумент(HTML);

Для сложных структур предварительно преобразуйте массив в JSON и используйте JavaScript для визуализации.

Можно ли вывести массив в таблицу на форме?

Да, для этого:

Добавьте на форму элемент ТаблицаФормы.
Свяжите его с реквизитом типа ТаблицаЗначений.
В модуле формы заполните таблицу данными из массива.

Пример:

&НаКлиенте
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Массив = Новый Массив;
Массив.Добавить("Строка1");
Массив.Добавить("Строка2");

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Данные");

Для Каждого Элемент Из Массив Цикл
Строка = Таблица.Добавить();
Строка.Данные = Элемент;
КонецЦикла;

ЭтотОбъект.ТаблицаНаФорме = Таблица;
КонецПроцедуры

Как вывести массив в лог без ограничений по размеру?

Для вывода больших массивов в лог:

Используйте ЖурналРегистрации с разбивкой на части.
Записывайте данные в файл на сервере.
Используйте внешние хранилища (например, базу данных).

Пример записи в файл с разбивкой:

ПутьКФайлу = "C:\Logs\массив.log";
Текст = Новый ЗаписьТекста(ПутьКФайлу, КодировкаТекста.UTF8);

Для i = 0 По Массив.ВГраница() Цикл
Текст.ЗаписатьСтроку(Массив[i]);
Если (i + 1) % 1000 = 0 Тогда // Разбиваем на блоки по 1000 строк
Текст.Закрыть();
Текст = Новый ЗаписьТекста(ПутьКФайлу, КодировкаТекста.UTF8, Истина);
КонецЕсли;
КонецЦикла;

Текст.Закрыть();

Как вывести значение массива в 1С: от простого Сообщить() до JSON