Программное добавление поля в СКД 1С: 5 проверенных способов

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

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

Материал актуален для платформы 1С:Предприятие 8.3 (включая последние релизы 2026 года) и подходит для большинства типовых конфигураций: Бухгалтерия 3.0, УТ 11, ЗУП 3.1 и других. Если вы работаете со старшими версиями (8.2 или ниже), некоторые методы могут потребовать адаптации.

1. Подготовка: что нужно знать перед изменением СКД

Прежде чем приступать к программным изменениям, важно понять архитектуру СКД. Система компоновки данных в 1С состоит из трёх ключевых компонентов:

• 📄 Схема компоновки данных — XML-описание структуры отчёта (поля, параметры, настройки)
• 🔧 Настройки компоновки — пользовательские фильтры, группировки, порядок колонок
• 📊 Результат компоновки — итоговый dataset, который выводится в таблицу или диаграмму

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

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

Перед началом работ проверьте:

• 🔍 Версию платформы (в Справка → О программе)
• 📋 Права доступа (нужен режим Конфигуратор с правами администратора)
• 💾 Резервную копию базы (обязательно!

2. Способ 1: Добавление поля через конструктор отчётов

Самый простой метод — использовать встроенный конструктор СКД. Он подходит для разовых изменений и не требует написания кода. Рассмотрим пошаговую инструкцию:

1. Откройте отчёт в режиме 1С:Предприятие (не конфигуратор!).
2. Перейдите в Все действия → Изменить вариант отчёта.
3. В открывшемся окне выберите вкладку Настройки → Поля.
4. Нажмите Добавить поле и выберите источник данных (таблицу или запрос).
5. Укажите имя поля (например, СуммаНДС) и при необходимости задайте псевдоним для отображения.
6. Сохраните изменения и обновите отчёт.

Этот способ имеет ограничения:

• 🚫 Не подходит для динамических полей (например, рассчитываемых на лету)
• 🔄 Изменения сохраняются только в текущем варианте отчёта
• 🛠️ Нельзя автоматизировать для массового применения

3. Способ 2: Модификация схемы компоновки через код

Для программного добавления поля необходимо работать с объектом СхемаКомпоновкиДанных. Основные шаги:

1. Получите схему компоновки из отчёта:

СхемаКомпоновки = Отчет.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");

2. Найдите коллекцию полей:

Поля = СхемаКомпоновки.Поля;

3. Добавьте новое поле:

НовоеПоле = Поля.Добавить();
НовоеПоле.Имя = "МоеНовоеПоле";
НовоеПоле.Заголовок = "Наименование для отображения";
НовоеПоле.ТипЗначения = Тип("Число");

4. Сохраните изменения и обновите отчёт:

Отчет.МодифицироватьСхемуКомпоновки(СхемаКомпоновки);

Пример добавления вычисляемого поля, которое рассчитывает процент выполнения плана:

НовоеПоле = Поля.Добавить();
НовоеПоле.Имя = "ПроцентВыполнения";
НовоеПоле.Заголовок = "Выполнение, %";
НовоеПоле.ТипЗначения = Тип("Число");
НовоеПоле.Выражение = "Выручка / ПланВыручки * 100";

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

Имеется резервная копия базы|Отчёт не используется в регламентных задачах|Поле не дублирует существующие данные|Тип значения поля соответствует данным источника-->

4. Способ 3: Использование расширений конфигурации

Если вы работаете с типовыми конфигурациями (например, 1С:Бухгалтерия 3.0), прямой модификации схемы компоновки следует избегать. Вместо этого используйте расширения:

1. Создайте новое расширение в конфигураторе (Файл → Новое расширение).
2. В дереве объектов найдите нужный отчёт и добавьте его в расширение.
3. Переопределите процедуру ПриКомпоновкеРезультата:

Процедура ПриКомпоновкеРезультата(ДанныеРасшифровки, ДанныеСтроки, СтандартнаяОбработка)
Если СтандартнаяОбработка Тогда
// Добавляем новое поле в результат компоновки
ДанныеСтроки.Колонки.Добавить("МоеНовоеПоле", Тип("Строка"));
КонецЕсли;
КонецПроцедуры

Преимущества этого метода:

• 🔄 Сохраняется поддержка типовой конфигурации
• 🛡️ Изменения не затираются при обновлении
• 🔧 Можно гибко настраивать логику добавления полей

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

5. Способ 4: Динамическое добавление полей через параметры

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

Пример: добавим поле СкидкаПостоянногоКлиента только если пользователь имеет роль "Менеджер по продажам":

Процедура ПриКомпоновкеДанных(СхемаКомпоновкиДанных, ДанныеРасшифровки, СтандартнаяОбработка)
Если Пользователь.Роли.Найти("МенеджерПоПродажам") <> Неопределено Тогда
Поля = СхемаКомпоновкиДанных.Поля;
НовоеПоле = Поля.Добавить();
НовоеПоле.Имя = "СкидкаПостоянногоКлиента";
НовоеПоле.Выражение = "ЕСЛИ Клиент.ЭтоГруппа() ТОГДА 0 ИНАЧЕ Клиент.ПостояннаяСкидка КОНЕЦЕСЛИ";
КонецЕсли;
КонецПроцедуры

Этот метод удобен для:

• 👥 Персонализации отчётов под роли пользователей
• 📅 Временных полей (например, акционных скидок)
• 🔄 Динамических расчётов, зависящих от внешних данных

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

6. Способ 5: Внешние обработки для массового добавления полей

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

1. Создайте новую обработку в конфигураторе (Файл → Новая обработка).
2. Добавьте реквизит типа СхемаКомпоновкиДанных.
3. Напишите универсальную функцию для добавления поля:

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

4. Сохраните обработку в файл (.epf) и подключите её к нужным базам.

Пример вызова функции для добавления поля ПрибыльНаЕдиницу:

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

Преимущества внешних обработок:

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

При программном добавлении полей в СКД разработчики часто сталкиваются с следующими проблемами:

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

НовоеПоле.ТипЗначения = Тип("Число");  // А не просто "Число"

• 🔴 Конфликт имён полей — если поле с таким именем уже существует, произойдёт ошибка. Используйте уникальные имена или проверяйте наличие:

Если Поля.Найти("МоеПоле") = Неопределено Тогда
// Добавляем поле
КонецЕсли;

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

Если ПраваДоступа.ПроверкаПрав("Документ.ЗаказКлиента", "Чтение") Тогда
// Добавляем поле
КонецЕсли;

8. Продвинутые техники: вычисляемые поля и группировки

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

НовоеПоле = Поля.Добавить();
НовоеПоле.Имя = "СреднийЧек";
НовоеПоле.Заголовок = "Средний чек, руб.";
НовоеПоле.ТипЗначения = Тип("Число");
// Используем агрегатную функцию
НовоеПоле.Выражение = "СУММА(СуммаДокумента) / КОЛИЧЕСТВО(Документ)";

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

Группировка = СхемаКомпоновки.Группировки.Добавить();
Группировка.Поле = Поля.Найти("Регион");
Группировка.Тип = ТипГруппировкиКомпоновкиДанных.Иерархия;

Если требуется условное форматирование (например, подсветка ячеек), используйте свойство УсловноеОформление:

Условие = НовоеПоле.УсловноеОформление.Добавить();
Условие.Выражение = "СуммаДолга > 10000";
Условие.Оформление.ЦветТекста = ВебЦвет.Красный;

Важно: вычисляемые поля с комплексными выражениями (вложенные ЕСЛИ, агрегатные функции) могут значительно увеличивать время формирования отчёта. Для оптимизации используйте предварительные запросы или кэширование.

FAQ: Ответы на частые вопросы

Компоновщик = Новый КомпоновщикНастроекКомпоновкиДанныхДляМобильногоПриложения;
Настройки = Компоновщик.Выполнить(СхемаКомпоновки, НастройкиКомпоновки, ДанныеРасшифровки);

Процедура ПриКомпоновкеДанныхНаСервере(СхемаКомпоновкиДанных, ДанныеРасшифровки, СтандартнаяОбработка)
Если Не СтандартнаяОбработка Тогда
// Добавляем поле на сервере
Поля = СхемаКомпоновкиДанных.Поля;
НовоеПоле = Поля.Добавить();
НовоеПоле.Имя = "СерверноеПоле";
КонецЕсли;
КонецПроцедуры

XMLСхема = Новый ЗаписьXML;
СхемаКомпоновки.Записать(XMLСхема);

XMLЧтение = Новый ЧтениеXML;
XMLЧтение.ОткрытьФайл("C:\schema.xml");
НоваяСхема = Новый СхемаКомпоновкиДанных;
НоваяСхема.Прочитать(XMLЧтение);