Добавление реквизита в отчет 1С: руководство

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

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

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

Подготовка к модификации отчета

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

Откройте конфигурацию в режиме Конфигуратор. Найдите нужный объект метаданных в дереве конфигурации. Это может быть отчет, обработка или даже форма документа, если речь идет о печатной форме. Двойной клик откроет окно редактирования объекта.

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

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

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

Работа со схемой компоновки данных

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

Выберите основной набор данных. Обычно он имеет имя Основной или ДанныеОтчета. В свойствах набора данных найдите поле Запрос. Если запрос текстовый, вам потребуется отредактировать его текст. Если запрос построен конструктором, откройте конструктор запросов для добавления необходимых таблиц и полей.

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

ВЫБРАТЬ
Номенклатура.Ссылка КАК Номенклатура,
Номенклатура.Артикул КАК Артикул,
Номенклатура.Вес КАК ВесТовара
ИЗ
Справочник.Номенклатура КАК Номенклатура

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

Настройка полей и параметров вывода

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

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

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

Используйте возможности форматирования для улучшения восприятия. Например, для денежных сумм можно задать формат ЧЦ=15; ЧДЦ=2, что обеспечит вывод двух знаков после запятой и разделителей тысяч.

Группировки и детализация данных

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

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

Уровень вложенности	Тип группировки	Влияние на итог
Верхний уровень	Группировка	Разбивает весь отчет на крупные блоки
Средний уровень	Подгруппировка	Детализирует данные внутри родительской группы
Нижний уровень	Детальные записи	Выводит конкретные документы или позиции
Колонки	Перекрестная группировка	Создает матричную структуру отчета

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

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

Секрет производительности

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

Программная доработка и обработчики

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

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

• 🚀 Используйте встроенные функции СКД для форматирования дат и строк без написания кода.
• 🛠 Применяйте условное оформление для выделения цветом строк с особыми значениями нового реквизита.
• 📊 Для сложных алгоритмов создавайте отдельные обработки и вызывайте их из отчета.

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

⚠️ Внимание: Интерфейс и возможности СКД могут отличаться в разных версиях платформы 1С (8.2, 8.3, 8.3.20+). Всегда сверяйте доступность функций в справке по вашей конкретной версии платформы.

Тестирование и отладка изменений

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

Обратите внимание на производительность. Добавление сложных вычисляемых полей или Join-ов к большим таблицам может замедлить формирование отчета в разы. Используйте Консоль запросов для анализа времени выполнения основного запроса отчета.

Убедитесь, что новый реквизит корректно ведет себя при выгрузке в другие форматы (Excel, PDF, MXL). Иногда верстка печатной формы нарушается из-за слишком длинных заголовков или специфических символов в данных.

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

Можно ли добавить реквизит в отчет без права на изменение конфигурации?

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

Почему новый реквизит не виден в списке полей?

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

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

Вы можете добавить поле в запросе с выражением, например КОЛИЧЕСТВО * ЦЕНА КАК Сумма. Либо используйте вкладку "Вычисляемые поля" в схеме компоновки данных, где можно задать формулу, использующую другие поля отчета.

Влияет ли добавление реквизита на скорость работы 1С?

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