Как в СКД работает пользовательское поле и пользовательское выражение

1️⃣ Как кратко ответить

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

2️⃣ Подробное объяснение темы

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

Пользовательское поле

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

Пример использования

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

Пользовательское выражение

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

• Операторы (например, +, -, *, /)
• Функции (например, СУММА, СРЗНАЧ, ЕСЛИ)
• Ссылки на другие поля набора данных

Пример выражения

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

Сумма + Налог

Как это работает

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

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

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

Пример кода

Рассмотрим пример, где создается пользовательское поле для вычисления "Сумма с налогом":

// Создаем пользовательское поле
ПользовательскоеПоле = Новый Структура;
ПользовательскоеПоле.Вставить("Имя", "СуммаСНалогом");
ПользовательскоеПоле.Вставить("Выражение", "Сумма + Налог");
​
// Добавляем пользовательское поле в набор данных
НаборДанных.ПользовательскиеПоля.Добавить(ПользовательскоеПоле);

• Новый Структура: Создает новую структуру для хранения параметров пользовательского поля.
• Вставить("Имя", "СуммаСНалогом"): Устанавливает имя пользовательского поля.
• Вставить("Выражение", "Сумма + Налог"): Устанавливает выражение для вычисления значения поля.
• НаборДанных.ПользовательскиеПоля.Добавить(ПользовательскоеПоле): Добавляет созданное пользовательское поле в набор данных отчета.

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