Побочный и промежуточный выход в 1С: ключевые различия и практические примеры

В работе с 1С:Предприятие часто возникает путаница между терминами "побочный выход" и "промежуточный выход". Оба понятия связаны с обработкой данных в отчётах, но применяются в разных сценариях и решают различные задачи. Непонимание их особенностей может привести к ошибкам в конфигурации, некорректным отчётам или избыточным нагрузкам на систему.

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

Особое внимание уделим типичным ошибкам, которые допускают разработчики при настройке выходов, и покажем, как избежать распространённых проблем — от неверного группирования данных до избыточного потребления ресурсов сервера.

1. Что такое побочный выход в 1С и зачем он нужен

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

Типичные сценарии применения побочных выходов:

• 📊 Анализ промежуточных данных — например, подсчёт количества строк до группировки или проверка уникальности значений.
• 🔍 Отладка отчётов — вывод служебной информации для диагностики ошибок в компоновке.
• 📈 Подготовка данных для визуализации — формирование массивов для графиков или диаграмм, которые не входят в основной отчёт.
• 🔄 Оптимизация запросов — получение статистики по времени выполнения отдельных этапов компоновки.

Важно понимать, что побочный выход не изменяет структуру основного отчёта и не влияет на его визуальное представление. Его данные доступны только в коде через объект КомпоновщикМакета.ПобочныеДанные.

2. Промежуточный выход: когда и как используется

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

Основные случаи применения:

• 🔄 Трансформация данных — например, конвертация валют, округление чисел или замена кодов на наименования.
• 📊 Фильтрация строк — исключение записей, не соответствующих дополнительным критериям (которые нельзя задать в основном запросе).
• 🔗 Объединение данных из разных источников — сведение информации из нескольких таблиц перед группировкой.
• 📈 Расчёт производных показателей — вычисление процентов, дельт или других производных величин на основе исходных данных.

Промежуточный выход настраивается в схеме компоновки данных через свойство ПромежуточныйВыход и требует написания обработчика на встроенном языке. Его ключевое отличие от побочного — изменение данных, которые потом попадут в итоговый отчёт.

3. Ключевые различия: побочный vs промежуточный выход

Чтобы окончательно разграничить эти понятия, рассмотрим их основные отличия в виде таблицы:

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

4. Как настроить побочный выход: пошаговая инструкция

Рассмотрим процесс настройки побочного выхода на примере отчёта по продажам. Предположим, нам нужно получить список всех менеджеров, участвующих в сделках, но не выводить их в основном отчёте.

Шаг 1. Открытие схемы компоновки данных

Перейдите в конструктор схемы компоновки данных вашего отчёта (например, через Отчёты → Продажи → Изменить схему компоновки).

Шаг 2. Добавление побочного выхода

В дереве схемы найдите раздел Настройки → Побочные выходы и добавьте новый элемент. Задайте ему имя, например, СписокМенеджеров.

Шаг 3. Определение структуры данных

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

Шаг 4. Использование данных в коде

После формирования отчёта побочные данные можно получить так:

ПобочныеДанные = Отчет.КомпоновщикМакета.ПобочныеДанные;
СписокМенеджеров = ПобочныеДанные.СписокМенеджеров.Выгрузить();

Указан корректный источник данных|

Заданы все необходимые поля|

Побочный выход не дублирует основной запрос|

Данные используются в коде после формирования отчёта-->

5. Настройка промежуточного выхода с примерами кода

Промежуточный выход требует больше усилий для настройки, но даёт гибкость в обработке данных. Рассмотрим пример, где нам нужно заменить коды номенклатуры на их наименования перед группировкой в отчёте.

Шаг 1. Создание обработчика

В схеме компоновки данных перейдите в раздел Настройки → Промежуточный выход и создайте обработчик события ПриПромежуточномВыходе.

Шаг 2. Написание кода трансформации

В обработчике добавьте следующий код:

Процедура ПриПромежуточномВыходе(Данные, Параметры)
Для Каждого Строка Из Данные Цикл
Если ЗначениеЗаполнено(Строка.Номенклатура) Тогда
Строка.Номенклатура = Справочники.Номенклатура.НайтиПоКоду(Строка.Номенклатура).Наименование;
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Шаг 3. Проверка результата

После применения этого кода в отчёте вместо кодов номенклатуры будут отображаться их наименования. Важно убедиться, что:

• 🔄 Все коды корректно заменяются (нет пустых значений).
• 📊 Группировка в отчёте работает с новыми данными.
• ⚡ Производительность не упала критично (промежуточный выход может замедлить формирование).

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

При работе с побочными и промежуточными выходами разработчики часто сталкиваются с одними и теми же проблемами. Рассмотрим наиболее распространённые из них и способы их решения.

Ошибка 1: Избыточные данные в побочном выходе

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

Ошибка 2: Зацикливание в промежуточном выходе

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

Ошибка 3: Игнорирование производительности

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

Ошибка 4: Несоответствие типов данных

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

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

7. Оптимизация работы с большими данными

При работе с крупными отчётами (тысячи строк) побочные и промежуточные выходы могут стать узким местом. Вот несколько рекомендаций по оптимизации:

1. Используйте серверные процедуры

Переносите сложную логику обработки данных на сервер. Это снизит нагрузку на клиентскую часть и ускорит формирование отчёта. Пример:

Процедура ПриПромежуточномВыходе(Данные, Параметры) Экспорт
// Код выполняется на сервере
Данные = Сервер.ОбработатьДанные(Данные);
КонецПроцедуры

2. Ограничивайте объём побочных данных

Если побочный выход нужен только для подсчёта количества строк, не извлекайте все поля — достаточно одного служебного поля. Например:

ПобочныйВыход.ДобавитьПоле("КоличествоСтрок", Новый ОписаниеТипов("Число"));

3. Кэшируйте часто используемые данные

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

СправочникНоменклатуры = Справочники.Номенклатура.Выбрать();
Пока СправочникНоменклатуры.Следующий() Цикл
КэшНоменклатуры.Добавить(СправочникНоменклатуры.Код, СправочникНоменклатуры.Наименование);
КонецЦикла;

4. Разбивайте большие отчёты на части

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

⚠️ Внимание: При работе с очень большими данными (миллионы записей) промежуточный выход может привести к переполнению памяти. В таких случаях целесообразно перенести логику обработки в отдельный фоновый процесс или использовать механизмы 1С:DataEngine для пакетной обработки.

8. Практическое применение: примеры из реальных задач

Рассмотрим несколько реальных кейсов, где побочные и промежуточные выходы помогают решить бизнес-задачи.

Кейс 1: Анализ продаж по регионам с побочным выходом

Задача: формировать отчёт по продажам с группировкой по менеджерам, но параллельно получать распределение продаж по регионам для отдельного анализа.

Решение: в побочном выходе извлекаем поле Регион и строим сводную таблицу по нему, не затрагивая основной отчёт.

Кейс 2: Замена кодов на наименования в отчёте по складским остаткам

Задача: в отчёте по остаткам хранятся коды номенклатуры, но пользователям нужно видеть наименования.

Решение: в промежуточном выходе заменяем коды на наименования через справочник номенклатуры.

Кейс 3: Фильтрация строк по дополнительным критериям

Задача: в отчёт по заказам должны попадать только те строки, где сумма превышает 10 000 рублей, но это условие нельзя задать в основном запросе из-за сложной логики.

Решение: в промежуточном выходе добавляем проверку и удаляем строки, не соответствующие критерию.

Кейс 4: Подготовка данных для диаграмм

Задача: в отчёте нужно показать таблицу продаж и отдельно диаграмму по топ-5 товарам. Данные для диаграммы не должны дублироваться в таблице.

Решение: основные данные идёт в отчёт, а топ-5 товаров извлекаем в побочном выходе и передаём в модуль визуализации.

Эти примеры показывают, что правильное применение побочных и промежуточных выходов позволяет гибко управлять данными без дублирования логики в основных запросах.

FAQ: Частые вопросы по побочным и промежуточным выходам

Сообщить(Отчет.КомпоновщикМакета.ПобочныеДанные.Выгрузить());