При разработке отчетов на Системе компоновки данных (СКД) программисты часто сталкиваются с неприятной особенностью: документы, записанные в последнюю секунду периода (например, в 23:59:59), не попадают в виртуальную таблицу остатков. Это происходит потому, что платформа 1С воспринимает параметр даты как «момент времени на начало этой секунды». Если документ записан «внутри» или «в конце» этой секунды, он оказывается за рамками выборки.
В этой статье мы подробно проанализируем ситуацию, выясним причины такого поведения системы и рассмотрим несколько надежных способов решения проблемы: от программной установки параметров до настройки самой схемы компоновки.
Разберем природу типа Дата в 1С:Предприятие. Дата содержит время с точностью до секунды. Однако в рамках одной секунды может существовать множество событий (документов), каждое из которых имеет свой уникальный Момент времени. Момент времени — это комбинация даты, времени и ссылки на объект, что позволяет системе однозначно выстроить последовательность документов в БД.
Когда мы передаем в виртуальную таблицу остатков параметр &КонецПериода со значением 31.12.2023 23:59:59, платформа интерпретирует это как запрос остатков «на начало» указанной секунды. В результате все движения, совершенные в эту самую секунду, игнорируются. Наша задача — заставить СКД учитывать все движения включая последнюю секунду.
Наиболее точный и «каноничный» способ — это использование объекта Граница. Этот объект позволяет явно указать системе, нужно ли включать движения, попадающие ровно на указанный момент. Мы можем передать в качестве параметра виртуальной таблицы не просто дату, а объект Новый Граница(Дата, ВидГраницы.Включая).
Так как в интерфейсе пользователя или в настройках параметров СКД нельзя напрямую создать объект Граница, нам придется прибегнуть к программной обработке в модуле объекта отчета. Рассмотрим, как это реализовать в процедуре ПриКомпоновкеРезультата.
Пошаговый алгоритм реализации:
ПериодДата (доступный пользователю, тип Дата) и КонецПериода (скрытый, который мы будем подставлять в виртуальную таблицу).Проанализируем пример кода:
Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
// 1. Отключаем стандартную обработку, если планируем выводить отчет полностью программно,
// либо оставляем Истина, если просто меняем параметры.
// 2. Находим нужный нам параметр в настройках компоновщика
ПараметрКонецПериода = КомпоновщикНастроек.Настройки.ПараметрыДанных.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("КонецПериода"));
ПараметрПользователя = КомпоновщикНастроек.Настройки.ПараметрыДанных.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("ПериодДата"));
Если ПараметрКонецПериода <> Неопределено И ПараметрПользователя <> Неопределено Тогда
// Формируем границу на конец дня выбранной пользователем даты
КонечнаяДата = КонецДня(ПараметрПользователя.Значение);
ПараметрКонецПериода.Значение = Новый Граница(КонечнаяДата, ВидГраницы.Включая);
ПараметрКонецПериода.Использование = Истина;
КонецЕсли;
КонецПроцедуры
Этот метод гарантирует, что любые документы, созданные в 23:59:59, будут учтены в остатках. Важно помнить, что если ваш отчет использует СтандартныйПериод, то из него нужно извлекать ДатаОкончания.
Если мы не хотим писать программный код и стремимся решить задачу средствами только визуального конструктора СКД, стоит обратить внимание на таблицу ОстаткиИОбороты. В отличие от простой таблицы Остатки, она обладает механизмом дополнения периодов.
Рассмотрим, как настроить эту таблицу для получения корректного конечного остатка:
РегистрНакопления.ИмяРегистра.ОстаткиИОбороты.ДвиженияИГраницыПериода.При использовании этого метода СКД автоматически выстраивает временную шкалу запроса так, что конечный остаток периода рассчитывается с учетом всех документов включительно по указанную дату. Это избавляет нас от необходимости манипуляций с объектом Граница.
Это популярный «хак», который часто встречается в старых разработках. Суть проста: если 23:59:59 не включает документы, давайте возьмем начало следующего дня — 00:00:00.
В выражении параметра СКД на закладке «Параметры» мы можем написать следующее:
ДобавитьКДате(КонецПериода(&КонецПериода, "ДЕНЬ"), "СЕКУНДА", 1)
Рассмотрим плюсы и минусы этого подхода:
00:00:00 следующего дня (например, регламентные операции или результаты программного переноса данных), они попадут в отчет за прошлый период.Выясним причину, почему это происходит. Таблица остатков на 00:00:00 следующего дня фактически показывает состояние «на начало дня». Таким образом, документы текущего дня (старого периода) учтены, но грань между периодами становится размытой. Мы рекомендуем использовать этот метод с осторожностью.
Если вы работаете в конфигурации на базе Библиотеки стандартных подсистем (БСП), например, в 1С:ERP, КА или БП 3.0, у вас есть возможность использовать готовые серверные функции прямо в выражениях СКД. Это позволяет получить объект Граница без написания кода в модуле отчета.
Посмотрим, как это выглядит. В поле «Выражение» для параметра &КонецПериода на закладке «Параметры» можно прописать вызов функции общего модуля:
ОбщегоНазначенияКлиентСервер.ПолучитьГраницу(КонецПериода(&КонецПериода, "ДЕНЬ"), ВидГраницы.Включая)
Этот способ объединяет в себе преимущества первого и третьего методов: мы получаем математически точную Границу, но при этом не загромождаем модуль объекта программным кодом, сохраняя отчет легким в поддержке.
Проанализируем еще один нюанс: параметр СтандартныйПериод. Часто в отчетах используется один параметр типа СтандартныйПериод вместо двух отдельных дат. В этом случае СКД автоматически создает два внутренних значения: &Период.ДатаНачала и &Период.ДатаОкончания.
Если вы используете &Период.ДатаОкончания напрямую в параметрах виртуальной таблицы, обязательно проверьте настройки на вкладке «Параметры» СКД. По умолчанию 1С может подставлять дату окончания периода как начало последнего дня, если не указано иное. Всегда используйте конструкцию КонецПериода(&Период.ДатаОкончания, "ДЕНЬ") в поле выражения, чтобы гарантированно получить время 23:59:59, а затем преобразуйте её в границу одним из вышеописанных способов.
Мы рассмотрели несколько стратегий получения остатков. Подведем итоги выбора лучшего решения:
Используя эти методы, мы обеспечим высокую точность отчетов и избежим расхождений в данных, которые так часто пугают пользователей при закрытии периода.