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

Другое · 5 мин

Как добавить период в отчет СКД в 1С

Настройка периода в отчете на базе системы компоновки данных 1С: параметры, отбор, программное задание и проверка результата без риска ошибок.

В отчетах, построенных на базе системы компоновки данных 1С, период часто является основным измерением, по которому отбираются движения регистров, документы или остатки. Без корректно заданного периода отчет может вывести пустую таблицу или данные за весь доступный интервал, что затрудняет анализ.

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

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

Что означает период в отчете СКД

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

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

Где задается период в конструкторе отчета

В конструкторе отчета СКД период настраивается в разделе наборов данных или в настройках отчета. Нужно добавить поле даты в отбор и указать сравнение: равно, больше или равно, меньше или равно, либо входит в период. Для диапазона обычно создаются два параметра: ДатаНачала и ДатаОкончания.

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

Сравнение вариантов задания периода

Через параметр отчета

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

Через отбор набора данных

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

Программное задание

Подходит для интеграции и регламентных задач, требует тестирования кода.

Настройка отбора по периодам

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

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

Задание периода программно

Программно период передается через настройки отчета или параметры набора данных перед формированием макета. Примерно это выглядит как заполнение значения параметра «Период» или установка отбора по дате в коде, который вызывает отчет. Точные имена свойств зависят от конфигурации и способа вызова.

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

Порядок добавления периода
  1. 1
    Добавьте поле даты в набор данных отчета.
  2. 2
    Создайте параметр ДатаНачала и ДатаОкончания.
  3. 3
    Настройте отбор по полю Период с оператором между датами.
  4. 4
    Установите значения по умолчанию.
  5. 5
    Проверьте отчет на выбранном интервале.

Пользовательские настройки и динамические списки

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

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

Контрольные точки

Как проверить результат

Отчет за выбранный месяц
Норма

Данные совпадают с первичными документами

Тревожный признак

Пустой отчет или данные за другой период

Границы интервала
Норма

Включены первый и последний день

Тревожный признак

Исключены крайние даты

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

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

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

Итог

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

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

Нужно ли всегда создавать два параметра: начало и конец периода?

Не обязательно. Для отчета за одну дату достаточно одного параметра, для диапазона удобнее два параметра или один период с автоматическим вычислением границ.

Можно ли задать период жестко в тексте запроса?

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

Что делать, если отчет не показывает данные за выбранный период?

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

Отличается ли настройка периода для остатков и движений?

Да. Для остатков важна дата на конец периода, для движений — дата регистрации или движения внутри интервала. Неправильное поле исказит результат.