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

Другое · 8 мин

Передача параметров в отчёт на СКД в 1С

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

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

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

Ниже рассмотрены основные способы передачи параметров в отчёт на СКД, порядок их проверки и типичные ситуации, когда изменение параметра не влияет на вывод. Материал носит прикладной характер и не привязан к конкретной конфигурации или версии платформы.

Откуда берутся параметры отчёта на СКД

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

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

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

Параметр виден в форме отчётаСкорее всего, это параметр отчёта или настройки компоновки

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

Параметр есть в схеме СКДВозможно, это параметр набора данных

Убедитесь, что он заполнен перед выполнением запроса

Отчёт не реагирует на значениеПараметр не связан с отбором или не передан в набор данных

Проверьте связь параметров и порядок формирования отчёта

Как задать параметры в интерфейсе 1С

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

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

Порядок действий
  1. 1
    Откройте отчёт и дождитесь формы параметров
  2. 2
    Заполните необходимые отборы и нажмите сформировать
  3. 3
    Проверьте, что в результате применились заданные фильтры
  4. 4
    При отсутствии эффекта сверьте параметры со схемой компоновки данных

Передача параметров программно

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

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

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

Параметры наборов данных и внешних источников

Наборы данных на СКД могут использовать параметры, которые передаются в текст запроса или в источник данных. Такие параметры не всегда дублируются на форме отчёта. Их значения могут приходить из внешней обработки, из параметров сеанса или из заполнения перед выполнением отчёта.

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

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

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

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

Альтернативы и границы самостоятельной работы

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

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

Типичные ошибки
01
Имя параметра в коде не совпадает с именем в схеме СКД, значение игнорируется
02
Значение передано после начала формирования отчёта и не применяется к выборке
03
Пустой параметр воспринимается как отсутствие фильтра, отчёт выводит лишние данные

Что делать, если параметр не применяется

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

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

Итог

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

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

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

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

Почему отчёт не реагирует на изменение параметра?

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

Можно ли изменить параметр уже после открытия отчёта?

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

Что проверить, если в отчёте пустая выборка?

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