К статье
Практический материал

Другое · 6 мин

Как добавить поле в отчет в 1С

Как добавить поле в отчет 1С: источники данных, схема компоновки, макет и настройки, безопасные правки и проверка результата.

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

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

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

Откуда берется поле в отчете

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

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

Когда достаточно только настроек

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

Порядок добавления существующего поля
  1. 1
    Откройте отчет в режиме настройки или конструктора
  2. 2
    Найдите поле в списке доступных полей набора данных
  3. 3
    Перенесите поле в отображаемые колонки или параметры
  4. 4
    Сохраните настройки и откройте отчет для проверки

Добавить поле через настройки отчета

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

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

Расширить источник данных, если поля нет

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

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

Разница между реквизитом и ресурсом

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

Типичные ошибки
01
Добавили колонку в макет, но не включили поле в набор данных — отчет открывается без данных
02
Правили типовую конфигурацию напрямую — обновление становится сложнее или невозможно
03
Забыли сохранить вариант настроек пользователя — поле пропадает при следующем открытии

Обновить макет и форму отчета

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

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

Безопасные изменения и тестирование

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

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

Контрольные точки

Как проверить результат

Поле видно в списке доступных полей набора данных
Норма

Поле выбрано и отображается в настройках

Тревожный признак

Поля нет в списке или оно серое

Значения заполнены после открытия отчета
Норма

Колонка показывает данные из источника

Тревожный признак

Колонка пустая или отчет не открывается

Отчет работает после сохранения и переоткрытия
Норма

Настройки сохраняются и применяются

Тревожный признак

Поле исчезает при повторном запуске

Проверка результата и частые ошибки

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

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

Итог

Что важно запомнить

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

Нужно ли программировать, чтобы добавить поле?

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

Можно ли редактировать типовой отчет напрямую?

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

Что делать, если поле добавили, но оно пустое?

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

Нужно ли перезапускать 1С после изменений?

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