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