Другое · 9 мин
Как добавить пользовательское поле в отчет 1С
Пошаговая инструкция, как добавить пользовательское поле в отчет 1С: через регистр сведений, компоновку данных и макет, с проверкой результата и предупреждениями.
Пользовательское поле в отчете 1С позволяет вывести в печатную форму или экранный отчёт информацию, которой нет в стандартном наборе реквизитов. Это может быть дополнительный признак контрагента, расчетное значение, флаг состояния или данные из регистра сведений. Такое поле не появляется само по себе: его нужно описать, связать с объектом и добавить в набор данных отчёта.
Способ добавления зависит от того, какой отчёт используется: стандартный управляемой формы, отчёт на СКД (компоновке данных) или внешняя обработка. В одних случаях достаточно включить поле в настройки, в других — изменить запрос, макет или программный модуль. Неправильная правка может привести к ошибкам выполнения, потере данных при обновлении конфигурации или невозможности открыть отчёт.
Ниже рассмотрены основные сценарии, порядок действий и признаки того, что результат получен верно. Материал ориентирован на самостоятельную работу в типовых конфигурациях, но не заменяет консультацию с администратором системы при изменении объектов метаданных.
Что такое пользовательское поле в отчёте 1С
Пользовательское поле — это реквизит или вычисляемое значение, которое не входит в стандартный состав объекта, но требуется для отражения в отчёте. Оно может храниться в регистре сведений, быть свойством справочника или вычисляться в момент формирования отчёта. Поле не отображается автоматически: его нужно явно добавить в источник данных отчёта.
Отличие пользовательского поля от обычного реквизита в том, что стандартные поля уже присутствуют в конфигурации и доступны без доработки. Пользовательское поле требует действий разработчика или ответственного пользователя: создание реквизита, набор данных, связь с отчётом и проверку прав доступа.
Способы добавления поля в отчёт
Основные способы: через регистр сведений с последующим подключением к отчёту, через настройки компоновки данных (СКД) и через программное изменение макета или модуля отчёта. Выбор зависит от типа отчёта и места хранения данных. Если данные уже есть в информационной базе, достаточно добавить их в набор данных отчёта.
Если данных нет, сначала создаётся реквизит или регистр сведений, заполняется в документах или справочниках, а затем подключается к отчёту. Порядок действий всегда начинается с анализа: где хранятся данные, какой отчёт используется и есть ли права на изменение конфигурации.
Когда подходит регистр сведений
Регистр сведений подходит, когда нужно хранить дополнительную характеристику объекта независимо от документа. Например, флаг «Особый контрагент» или дополнительный реквизит договора. Регистр создаётся в конфигураторе, измерения и ресурсы настраиваются, а данные заполняются документами или обработкой заполнения.
После создания регистра его таблица становится доступной для запроса отчёта. Важно правильно задать измерения, чтобы поле можно было связать с нужным объектом. Иначе в отчёте будут дубли или пустые значения.
Когда подходит компоновка данных
Компоновка данных используется в отчётах управляемой формы и внешних обработках. Поле добавляется в набор данных через конструктор запроса или вручную в тексте запроса. Затем оно переносится в настройки отчёта и доступно для выбора в пользовательских настройках.
Этот способ безопаснее, так как не требует изменения макета в большинстве случаев. Достаточно добавить поле в запрос и включить его в отображение. Если отчёт уже развёрнут у пользователей, изменения могут потребовать обновления настроек.
Добавление через регистр сведений
Сначала в конфигураторе создаётся регистр сведений с измерением «Объект» и ресурсом нужного типа. Регистр подписывается, заполняется данными через документы или отдельную обработку. Проверьте, что данные записываются для нужных объектов и не дублируются.
Затем в отчёте добавляется набор данных на основе регистра. В запросе указывается связь по измерению объекта. Поле переносится в настройки отчёта и макет. После сохранения конфигурации отчёт открывается и проверяется на выбранных данных.
Сравнение вариантов
Подходит для отчётов на компоновке данных, не требует правки макета
Подходит для хранения дополнительных характеристик объектов
Требует программирования, подходит для сложных макетов
Добавление через компоновку данных
Откройте отчёт в конструкторе компоновки данных. Найдите набор данных и добавьте нужное поле в текст запроса или через мастер набора. Если поля нет в таблицах, сначала создайте его в конфигурации, затем подключите к запросу.
После добавления поля в набор данных перенесите его в список отображаемых полей настроек отчёта. Настройте заголовок, формат и порядок следования. Сохраните отчёт и проверьте, что поле отображается с корректными значениями.
Перед изменением отчёта сохраните копию конфигурации и проверьте результат на тестовой базе с разными данными.
Добавление через макет и модуль отчёта
Если отчёт использует макет табличного документа, поле добавляется в область макета, а в модуле отчёта пишется код вывода значения. Этот способ требует знания встроенного языка и понимания структуры макета. Ошибка в коде может привести к неисправности всего отчёта.
Перед правкой макета создайте копию конфигурации или отчёта. Изменяйте только копию, проверяйте на тестовых данных и только потом переносите в рабочую базу. Не правьте объекты поддержки без понимания последствий.
Проверьте запрос и настройки отчёта
Сначала опишите поле, потом подключите к отчёту
Изменение макета может не потребоваться
Работайте на копии конфигурации
Проверка результата и типичные ошибки
После добавления поля откройте отчёт на нескольких объектах с разными данными. Поле должно отображаться, значения должны совпадать с источником, ошибки выполнения не должны возникать. Проверьте права доступа: пользователи без прав на регистр могут не видеть данные.
Частые ошибки: отсутствие связи по измерению, дублирование записей в регистре, неверный тип поля, забытое сохранение конфигурации, изменение поддерживаемого объекта. Если поле не отображается, проверьте набор данных, настройки отчёта и права пользователя.
- 1Определите источник данных и тип отчёта
- 2Создайте реквизит или регистр при необходимости
- 3Добавьте поле в набор данных отчёта
- 4Включите поле в настройки и макет
- 5Сохраните конфигурацию и проверьте отчёт
Ограничения и границы безопасной работы
Не все отчёты можно изменять без риска. Объекты поддержки, стандартные отчёты типовых конфигураций и отчёты с закрытым кодом требуют осторожности. Изменение таких объектов может привести к потере правки при обновлении или блокировке обновления конфигурации.
Безопасная самостоятельная работа возможна при наличии резервной копии, тестовой базы и понимания структуры отчёта. Если не уверены в правке макета или модуля, обратитесь к администратору или партнёру. Не вносите изменения напрямую в рабочую базу без проверки.
Типичные ошибки и как их избежать
Одна из ошибок — добавление поля в макет без включения в набор данных. В этом случае поле будет пустым или не появится. Другая ошибка — отсутствие связи по измерению в регистре, что приводит к дублям или неверным значениям.
Также часто забывают проверить права доступа: поле добавлено, но пользователи не видят данные из-за ограничений на регистр или справочник. Перед массовым использованием отчёта проверьте его под разными ролями.
Как проверить результат
Значение совпадает с источником
Поле пустое или отсутствует
Открывается и формируется
Ошибка выполнения или зависание
Доступ согласно правам
Поле скрыто из-за прав
Как проверить результат
Откройте отчёт на объекте, где заполнено пользовательское поле. Убедитесь, что значение совпадает с источником, формат отображения корректен, ошибок нет. Проверьте отчёт на нескольких записях и под разными правами доступа.
Если поле не отображается, проверьте набор данных, текст запроса и настройки отчёта. Убедитесь, что конфигурация сохранена и отчёт открыт из обновлённой базы. При необходимости очистите кэш или переоткройте отчёт.
Что важно запомнить
Пользовательское поле нужно описать, добавить в набор данных отчёта и включить в настройки или макет, а затем проверить на тестовых данных.
Нужно ли быть программистом, чтобы добавить поле?
Не всегда. Если отчёт использует компоновку данных, достаточно добавить поле в набор и настройки. Для отчётов с программным макетом потребуются знания встроенного языка 1С.
Можно ли добавить поле в любой стандартный отчёт?
Не в любой. Стандартные объекты поддержки и типовые отчёты лучше не изменять напрямую, чтобы не потерять правку при обновлении конфигурации.
Что делать, если поле не отображается после добавления?
Проверьте набор данных, текст запроса, настройки отчёта и права доступа. Убедитесь, что конфигурация сохранена и отчёт открыт из обновлённой базы.
Нужна ли резервная копия перед правкой?
Да. Перед любым изменением объектов конфигурации создайте копию и проверяйте результат на тестовой базе, а не сразу в рабочей.