Добавление вычисляемой колонки в СКД: программный подход

Разработка отчетов в платформе 1С:Предприятие 8 часто требует гибкости, которую не всегда могут обеспечить стандартные конструкторы. Когда пользователю необходимо вывести специфические расчетные показатели или скомбинировать данные из разных источников, на помощь приходит механизм Системы Компоновки Данных (СКД). Умение управлять структурой отчета на уровне кода является ключевым навыком для разработчика 1С.

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

Рассмотрим основные подходы к решению этой задачи. Мы разберем работу с объектом КомпоновщикНастроек, манипуляции с макетом и особенности вычисляемых полей. Понимание этих принципов позволит вам создавать по-настоящему мощные аналитические инструменты.

Базовые принципы работы с компоновщиком настроек

Любое изменение структуры отчета начинается с получения доступа к объекту настроек. В типовой форме отчета этот объект обычно доступен через свойство КомпоновщикНастроек. Именно здесь хранится описание того, какие поля будут выведены и как они будут сгруппированы.

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

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

Ниже приведен пример получения доступа к настройкам и подготовки к добавлению поля:

Настройки = ЭлементыФормы.Отчет.КомпоновщикНастроек;
Макет = Настройки.Макет;

Создание вычисляемого поля в коде

Самый распространенный сценарий — необходимость вывести колонку, значение которой рассчитывается на лету. Это может быть процент выполнения плана, маржинальность или сложный рейтинг клиента. Для этого используется объект ПолеКомпоновкиДанных.

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

• 📌 Имя поля должно быть уникальным в рамках всего макета отчета.
• 📌 Заголовок поля задается отдельно и может содержать пробелы и спецсимволы.
• 📌 Видимость поля управляется свойством Использование.

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

НовоеПоле = Новый ПолеКомпоновкиДанных;
НовоеПоле.Поле = Новый ПолеМакетаКомпоновкиДанных("Выч_Прибыль");
НовоеПоле.Заголовок = "Расчетная прибыль";
НовоеПоле.Выражение = "СуммаПродаж - Себестоимость";
Макет.Поля.Добавить(НовоеПоле);

Настройка свойств и форматирования колонки

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

Часто возникает необходимость скрыть колонку по умолчанию, оставив пользователю возможность включить её через настройки. Для этого используется свойство Использование. Установив значение Ложь, вы скроете поле из видимой части отчета, но оно останется доступным для выбора.

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

Свойство	Тип значения	Описание
Заголовок	Строка	Текст, отображаемый в шапке колонки
Формат	Строка	Параметры форматирования (ЧЦ=10, ЧДЦ=2)
Использование	Булево	Видимость поля в отчете
ГоризонтальноеВыравнивание	Перечисление	Лево, Право, Центр, Авто

Секрет форматирования дат

используйте строку 'ДФ="dd.MM.yyyy"' для получения привычного формата даты в колонке.

Интеграция с событиями получения данных

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

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

Неэффективные алгоритмы внутри цикла могут критически замедлить формирование большого отчета. Оптимизация кода в этом месте — приоритетная задача.

⚠️ Внимание: Избегайте выполнения тяжелых запросов к базе данных внутри события получения данных для каждой строки. Это может привести к зависанию системы при формировании отчета за большой период.

Для передачи рассчитанного значения в колонку используется метод УстановитьЗначение объекта СтрокаДанныхРасширения. Имя поля должно строго соответствовать тому, которое вы создали в макете.

Процедура КомпоновщикНастроекПриПолученииДанныхРасширения(ОбработчикКомпоновкиДанных, СтрокаДанныхРасширения, СтандартнаяОбработка)
ЗначениеПрибыли = РассчитатьМаржинальность(СтрокаДанныхРасширения);
СтрокаДанныхРасширения.УстановитьЗначение("Выч_Прибыль", ЗначениеПрибыли);
КонецПроцедуры

Управление порядком и группировкой колонок

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

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

Для программной перестановки используется метод Вставить с указанием индекса или метод изменения свойства Порядок. Также можно использовать перетаскивание через объект настроек, но код надежнее фиксирует требования бизнеса.

Рассмотрим пример перемещения созданной колонки на вторую позицию в отчете:

Индекс = 1; // Вторая позиция (нумерация с 0)
ПолеДляПеремещения = Макет.Поля.Найти("Выч_Прибыль");
Если ПолеДляПеремещения <> Неопределено Тогда
Макет.Поля.Удалить(ПолеДляПеремещения);
Макет.Поля.Вставить(Индекс, ПолеДляПеремещения);
КонецЕсли;

Обработка ошибок и отладка структуры

При программном изменении структуры отчета ошибки могут возникать на этапе компиляции модуля или во время выполнения. Самая частая проблема — несоответствие имени поля в коде и в макете. Регистрозависимость здесь не играет роли, но опечатки фатальны.

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

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

⚠️ Внимание: Интерфейс и методы объекта КомпоновщикНастроек могут незначительно отличаться в разных версиях платформы 1С. Всегда проверяйте синтаксис-помощник для вашей конкретной версии конфигурации.

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

Часто задаваемые вопросы (FAQ)

Можно ли добавить колонку, если отчет формируется на основе нескольких наборов данных?

Да, это возможно. Однако поле должно быть привязано к конкретному набору данных или быть общим вычисляемым полем. Убедитесь, что имя набора данных указано корректно при создании пути к полю.

Почему добавленная программно колонка не видна в настройках отчета для пользователя?

Проверьте свойство Использование у добавленного поля. Если оно установлено в Ложь, поле скрыто. Также убедитесь, что вы сохранили изменения в объекте КомпоновщикНастроек перед выводом формы.

Как удалить программно добавленную колонку?

Найдите поле в коллекции Макет.Поля по имени и вызовите метод Удалить. Пример: Макет.Поля.Удалить(Макет.Поля.Найти("ИмяПоля")).

Влияет ли добавление вычисляемой колонки на производительность запроса к базе?

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