1С СКД: как установить дату в отчете

В системе компоновки данных (СКД) дата задаётся через параметры отчёта, и именно от правильной настройки этих параметров зависит, за какой период будут выбраны данные. Самая частая задача — добавить в отчёт параметры «НачалоПериода» и «КонецПериода», связать их со стандартным периодом и сделать так, чтобы пользователь мог менять даты перед формированием отчёта.

Есть несколько уровней установки даты: в схеме компоновки на вкладке «Параметры», в настройках отчёта на вкладке «Параметры данных», в отборе самого запроса и программно — через объект настроек компоновщика. Каждый способ решает свою задачу: одни подходят для разработчика, другие — для конечного пользователя.

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

Как работают параметры даты в СКД

СКД не «знает» про даты сама по себе — она передаёт значения параметров в запрос, а запрос уже отбирает записи по условию. Если в тексте запроса есть конструкция вида ГДЕ Продажи.Период МЕЖДУ &НачалоПериода И &КонецПериода, то значения параметров определяют границы выборки. Без такого условия параметр даты ничего не фильтрует.

Поэтому установка даты всегда состоит из двух частей: объявление параметра в схеме компоновки и использование его в запросе или в отборе. Пропуск любой из частей — самая частая причина «не работающего» периода.

Создание параметров НачалоПериода и КонецПериода

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

Далее в тексте запроса добавьте условие на период. Для виртуальных таблиц регистров удобнее передавать параметры в параметры виртуальной таблицы: РегистрНакопления.Продажи.Обороты(&НачалоПериода, &КонецПериода, , ). Это эффективнее, чем фильтрация в ГДЕ, потому что ограничение применяется на уровне выборки виртуальной таблицы.

Чтобы конец периода включал весь последний день, в параметрах виртуальных таблиц дата окончания трактуется как граница, включающая указанный момент. Если вы фильтруете через ГДЕ по реальной таблице, используйте функцию КОНЕЦПЕРИОДА(&КонецПериода, ДЕНЬ), иначе записи за последний день после полуночи потеряются.

1. 1
   Откройте схему компоновки, вкладка «Параметры», добавьте НачалоПериода и КонецПериода с типом «Дата»
2. 2
   В запросе добавьте условие по периоду или передайте параметры в виртуальную таблицу регистра
3. 3
   На вкладке «Настройки» → «Параметры» включите параметры в пользовательские настройки
4. 4
   Сформируйте отчёт и проверьте, что данные соответствуют выбранному периоду

Использование стандартного периода

Вместо двух отдельных дат удобно добавить один параметр Период с типом «СтандартныйПериод». Тогда пользователь сможет выбрать «Этот месяц», «Прошлый квартал» и другие готовые интервалы, а также задать произвольные даты в одном диалоге. Это заметно удобнее для конечных пользователей.

Чтобы запрос получил границы стандартного периода, в выражениях параметров укажите: для НачалоПериода — &Период.ДатаНачала, для КонецПериода — &Период.ДатаОкончания. Либо передавайте границы в коде при программной установке настроек.

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

Значения даты по умолчанию

На вкладке «Параметры» у каждого параметра есть колонка «Значение» и «Выражение». Чтобы при открытии отчёта период уже был заполнен, задайте выражение на языке выражений компоновки. Например, для начала текущего месяца доступны функции работы с датами, а для «сегодня» — функция ТекущаяДатаСеанса() недоступна в выражениях СКД, поэтому часто используют программную установку в событии «ПриКомпоновкеРезультата» или в модуле формы отчёта.

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	Настройки = Отчет.КомпоновщикНастроек.Настройки;
	Параметр = Настройки.ПараметрыДанных.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("НачалоПериода"));
	Если Параметр <> Неопределено Тогда
		Параметр.Значение = НачалоМесяца(ТекущаяДатаСеанса());
		Параметр.Использование = Истина;
	КонецЕсли;
КонецПроцедуры

Программная установка даты

Когда отчёт формируется из кода (например, по кнопке в обработке или регламентным заданием), даты устанавливаются через коллекцию ПараметрыДанных настроек компоновщика. Найдите параметр по имени, присвойте значение и обязательно установите Использование = Истина — без этого параметр считается отключённым и в запрос не передаётся.

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

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

После настройки сформируйте отчёт за заведомо известный период, где есть данные, и сверьте итоги с аналогичным типовым отчётом. Если данные не совпадают — проверяйте границы периода: чаще всего теряется последний день из-за отсутствия КОНЕЦПЕРИОДА или неверного времени в дате окончания.

FAQ