СКД в 1С: как вывести стандартный период в отчёт

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

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

Что такое стандартный период и чем он отличается от пары дат

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

Пара отдельных параметров «Дата начала» и «Дата окончания» даёт тот же результат по данным, но проигрывает в удобстве: пользователь вынужден каждый раз вводить обе даты вручную. Кроме того, у стандартного периода дата окончания по умолчанию трактуется как конец дня (23:59:59), тогда как при ручном вводе даты окончания пользователь часто указывает 00:00:00 и теряет данные последнего дня.

Способ 1: параметр типа «СтандартныйПериод» в схеме компоновки

Самый прямой способ — завести один параметр типа СтандартныйПериод и в запросе обращаться к его границам. Откройте схему компоновки данных отчёта, перейдите на закладку «Параметры» и добавьте параметр, например Период. В колонке «Тип» выберите «СтандартныйПериод». Флаг «Ограничение доступности» оставьте снятым, чтобы параметр был доступен пользователю.

В тексте запроса набора данных обращайтесь к границам через точку:

ВЫБРАТЬ
Продажи.Номенклатура,
СУММА(Продажи.СуммаОборот) КАК Сумма
ИЗ
РегистрНакопления.Продажи.Обороты(&Период.ДатаНачала, &Период.ДатаОкончания, , ) КАК Продажи
СГРУППИРОВАТЬ ПО
Продажи.Номенклатура

Обратите внимание: конструкция &Период.ДатаНачала в запросе СКД работает не во всех контекстах одинаково. Более надёжный и распространённый приём — использовать виртуальную таблицу с автоматическими параметрами периода (способ 2) либо вычисляемые параметры границ.

Способ 2: стандартные параметры НачалоПериода и КонецПериода

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

Чтобы параметры были видны пользователю, проверьте на закладке «Параметры»: для каждого из них снят флаг «Ограничение доступности», а в колонке «Включать в доступные поля» стоит флаг. Затем откройте закладку «Настройки», выберите режим настройки «Параметры данных» (в расширенном режиме) и убедитесь, что параметры присутствуют и отмечены.

Для отчётов на управляемых формах ключевой шаг — добавить параметры в пользовательские настройки. На закладке «Настройки» внизу перейдите на вкладку «Пользовательские настройки», нажмите «Добавить» и выберите параметры периода. В свойствах элемента установите «Режим редактирования» = «Быстрый доступ» — тогда поле появится прямо на панели отчёта, а не в глубине окна настроек.

1. 1
   Откройте схему компоновки, закладка «Параметры»: проверьте, что параметры периода существуют и доступность не ограничена
2. 2
   На закладке «Настройки» добавьте параметры в пользовательские настройки с режимом «Быстрый доступ»
3. 3
   Задайте значение по умолчанию — например, стандартный период «Этот месяц»
4. 4
   Сформируйте отчёт в режиме предприятия и проверьте, что поле периода видно и влияет на данные

Способ 3: параметр «Период» виртуальной таблицы регистра

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

ВЫБРАТЬ
Курсы.Валюта,
Курсы.Курс
ИЗ
РегистрСведений.КурсыВалют КАК Курсы
ГДЕ
Курсы.Период МЕЖДУ &НачалоПериода И &КонецПериода

Альтернатива — связать параметр «Период» через закладку «Компоновка данных» конструктора запроса: там для виртуальных таблиц можно указать, какое поле отвечает за период, и СКД сама добавит стандартный отбор. Этот механизм называется «периодичность и стандартный период» в настройках набора данных.

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

Программная установка стандартного периода

Когда период нужно задать из кода (например, при открытии отчёта из обработки или по кнопке), используйте объект СтандартныйПериод и установку значения через пользовательские настройки компоновщика:

СтандартныйПериод = Новый СтандартныйПериод;
СтандартныйПериод.Вариант = ВариантСтандартногоПериода.ЭтотМесяц;

Настройки = Отчет.КомпоновщикНастроек.Настройки;
ПараметрПериод = Настройки.ПараметрыДанных.Элементы.Найти("Период");
ПараметрПериод.Значение = СтандартныйПериод;
ПараметрПериод.Использование = Истина;

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

СтандартныйПериод = Новый СтандартныйПериод(ВариантСтандартногоПериода.ПрошлыйКвартал); КомпоновщикНастроек.Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("Период", СтандартныйПериод);

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

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

Когда какой вариант выбирать

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

Частые вопросы