Разработка отчетов в системе 1С:Предприятие часто требует гибкого подхода к выбору временных отрезков. Стандартные настройки не всегда покрывают потребности бизнеса, когда необходимо анализировать данные за нестандартные промежутки времени. Именно здесь на помощь приходит механизм Системы Компоновки Данных (СКД), позволяющий программисту или аналитику создать полностью кастомизированный выбор дат.

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

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

Создание параметров даты в схеме компоновки

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

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

  • 📅 Тип значения должен быть установлен в Дата для одиночных точек времени.
  • 📆 Alternatively, можно использовать тип ИнтервалДат, если вы хотите, чтобы пользователь выбирал период одним элементом управления.
  • ⚙️ Обязательно задайте значение по умолчанию, например, начало текущего месяца, чтобы отчет открывался с актуальными данными.

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

⚠️ Внимание: Если вы используете тип «ИнтервалДат», убедитесь, что в запросе вы правильно распаковываете этот интервал на отдельные даты начала и конца, иначе фильтр может не сработать корректно.

📊 Какой тип периода вы чаще используете в отчетах?
Один параметр (Дата)
Два параметра (Начало и Конец)
Интервал дат
Готовые варианты (Месяц, Квартал)
Не использую периоды

Использование параметров в тексте запроса

Сами по себе созданные параметры не будут влиять на выборку данных, пока они не будут интегрированы в текст запроса. В языке запросов 1С параметры обозначаются знаком амперсанда &. Вам необходимо добавить условие в секцию ГДЕ вашего запроса, чтобы отфильтровать записи по введенным датам.

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

ВЫБРАТЬ

РеализацияТоваровУслуг.Ссылка КАК Ссылка,


РеализацияТоваровУслуг.Дата КАК Дата,


РеализацияТоваровУслуг.Сумма КАК Сумма


ИЗ


Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг


ГДЕ


РеализацияТоваровУслуг.Дата МЕЖДУ &НачалоПериода И &КонецПериода

В данном примере используются два параметра, которые мы создали ранее. Оператор МЕЖДУ является наиболее эффективным способом фильтрации по диапазону дат, так как он позволяет базе данных использовать индексы по полю даты. Это существенно ускоряет формирование отчета при больших объемах данных.

Иногда возникает необходимость использовать вычисляемые периоды. Например, если пользователь выбрал дату, а отчет должен строиться за 30 дней до этой даты. В таком случае в тексте запроса можно использовать функции работы с датами, такие как НАЧАЛОПЕРИОДА или арифметические операции.

💡

Используйте оператор МЕЖДУ вместо конструкций С БОЛЬШИМ РАВНО И С МЕНЬШИМ РАВНО. Это делает код более читаемым и гарантирует оптимальное использование индексов СУБД.

Настройка вариантов периода и стандартных интервалов

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

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

Наименование варианта Описание логики Пример использования
ТекущийМесяц Первый день текущего месяца по сегодня Оперативный контроль продаж
ПрошлыйКвартал Полный предыдущий квартал Квартальная отчетность
СНачалаГода С 1 января текущего года по текущую дату Накопительные итоги
Последние30Дней Динамический интервал в 30 дней назад Анализ недавней активности

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

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

⚠️ Внимание: При использовании варианта периода «СНачалаГода» учитывайте переход на новый год. Логика должна корректно определять текущий год, иначе в январе отчет может показать данные за прошлый год или пустой результат.

Расширенные возможности: сдвиги и вычисляемые даты

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

Вы можете создать дополнительные параметры, значения которых вычисляются на основе основных дат. Например, параметр НачалоПрошлогоГода может быть вычислен как ГОД(&НачалоПериода) - 1. Такие вычисления можно производить как в тексте запроса, так и в выражениях СКД.

  • 🔄 Используйте функцию ДОБАВИТЬКДАТЕ для сдвига периода на нужное количество месяцев или лет.
  • 📊 Для сравнения периодов создайте два отдельных запроса или используйте объединения, передавая в них разные параметры дат.
  • ⏳ Помните, что сложные вычисления дат в условии ГДЕ могут ухудшить производительность, старайтесь вычислять границы периода до выполнения основного запроса.

Также стоит обратить внимание на работу с временем. По умолчанию дата в 1С включает время. Если вы выбираете период по дату включительно, убедитесь, что время конца периода установлено на конец дня (23:59:59), либо используйте функцию КОНЕЦПЕРИОДА.

Как обрабатывать високосные годы?

При сдвиге дат на год (например, с 29 февраля) система автоматически корректно обработает високосные годы, сдвигая дату на 28 февраля, если 29-е число в целевом году отсутствует. Однако при ручных вычислениях через сложение дней нужно быть внимательным.

Вывод параметров на форму отчета и оформление

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

Вы можете настроить внешний вид полей ввода дат. Например, добавить подсказки или изменить порядок следования элементов. Для параметра типа ИнтервалДат система автоматически создаст удобный календарь с выбором начала и конца.

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

&НаКлиенте

Процедура ПередЗаписьюНаКлиенте(Отказ, РежимЗаписи)


Если Период.Начало = Неопределено Тогда


Период.Начало = НачалоМесяца(ТекущаяДата());


КонецЕсли;


КонецПроцедуры

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

💡

Всегда устанавливайте значения по умолчанию для параметров периода. Это избавит пользователей от ошибок при первом запуске отчета и ускорит работу.

Типичные ошибки и способы их устранения

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

Другая частая ошибка связана с часовыми поясами. В распределенных базах данных или при работе через веб-клиент время может сохраняться в UTC, а отображаться в локальном времени пользователя. Это приводит к сдвигу периода на несколько часов и потере части документов, созданных в пограничное время.

  • ❌ Ошибка: Использование строковых представлений дат в запросе вместо параметров. Это делает запрос уязвимым к инъекциям и ломает перекомпиляцию.
  • ❌ Ошибка: Игнорирование времени в дате конца периода. Документ, созданный в 18:00 в последний день месяца, может не попасть в выборку, если конец периода установлен на 00:00.
  • ❌ Ошибка: Отсутствие индексации по полям даты в больших таблицах регистра, что приводит к полному сканированию таблицы при каждом запуске.

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

⚠️ Внимание: Интерфейс и возможности СКД могут незначительно отличаться в различных версиях платформы 1С (8.2, 8.3, 8.3.20+). Всегда сверяйте доступные функции в справке по вашей конкретной версии платформы, особенно если вы используете новые типы данных или функции.

FAQ: Часто задаваемые вопросы по периодам в 1С

Как сделать так, чтобы период выбирался одним полем, а не двумя?

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

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

Скорее всего, проблема в времени. Если дата конца периода установлена на 00:00:00, то документы, созданные днем позже, не попадут в выборку. Используйте функцию КОНЕЦПЕРИОДА или явно устанавливайте время 23:59:59 для даты конца.

Можно ли передать период из внешней обработки в отчет СКД?

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

Как настроить период "С начала года до текущей даты" автоматически?

Создайте вариант периода или используйте вычисляемые поля. Установите начало периода равным НАЧАЛОГОДА(ТекущаяДата()), а конец периода равным ТекущаяДата(). Это можно сделать в модуле формы перед открытием отчета.

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

Проверьте настройки макета СКД. Убедитесь, что параметр добавлен в список отображаемых параметров и не скрыт через условия видимости. Также проверьте, что версия схемы компоновки данных сохранена и обновлена в объекте отчета.