При разработке отчетов в системе 1С с использованием Системы Компоновки Данных (СКД) мы часто сталкиваемся с необходимостью вывода начальных и конечных остатков. Если источником данных является стандартный регистр накопления или бухгалтерии, СКД предоставляет удобные и встроенные механизмы для этого. Однако ситуация усложняется, когда данные для отчета поступают из внешнего источника, например, из файла, загруженного в набор данных типа "Объект", или из временной таблицы, не связанной напрямую с регистрами 1С. В таких случаях стандартные подходы, такие как простые агрегатные функции или функции ВычислитьВыражение, могут давать неверные или неполные результаты, особенно при больших объемах данных или сложной структуре группировок.
В этой статье мы подробно разберем, как правильно настроить СКД для корректного расчета начальных и конечных остатков, когда наш набор данных является "Объектом", и как использовать специализированные механизмы СКД для достижения требуемого результата.
Когда мы работаем с наборами данных СКД типа "Объект", это означает, что данные загружаются в СКД из какого-либо источника, который не является непосредственно базой данных 1С (например, из временной таблицы, выгрузки в файл, программно сформированной коллекции и т.п.). В таком случае СКД не может автоматически определить семантику полей как "Остаток" или "Оборот" и применить к ним свои встроенные алгоритмы расчета остатков по периодам. Поэтому нам потребуется вручную указать СКД, как интерпретировать эти поля, используя механизм ролей полей.
Авторы часто пытаются решить эту задачу, используя вычисляемые поля с функциями типа ВычислитьВыражение("Поле", , ,"Последняя"). Хотя этот подход может сработать для небольшого количества записей или при простых группировках, он часто приводит к ошибкам или неполным данным при увеличении объема информации или усложнении структуры отчета. Причина в том, что "Последняя" запись в контексте агрегированных данных на разных уровнях группировки может быть неопределенной или некорректно интерпретироваться СКД.
Давайте рассмотрим правильный подход, основанный на настройке ролей полей.
Прежде чем мы приступим к настройке СКД, нам необходимо убедиться, что наша внешняя таблица или коллекция данных (которая будет использоваться как набор данных типа "Объект") содержит все необходимые поля для расчета остатков. От качества и полноты данных на этом этапе зависит успешность всей затеи.
Крайне желательно, чтобы в исходных данных присутствовало поле с максимально возможной детализацией времени. Часто для корректного расчета остатков по периодам СКД требует наличие поля, которое может быть интерпретировано как ПериодСекунда. Это позволяет системе точно позиционировать записи во времени и правильно учитывать остатки на определенный момент.
Если в нашей внешней таблице нет такого поля, мы можем добавить его при формировании этой таблицы. Например, можно сгенерировать уникальный момент времени для каждой записи, если это применимо к логике наших данных. Для УТ 10.3 и БП 3.0, если мы формируем данные через запрос, мы можем добавить в SELECT соответствующее поле, например, из даты документа и момента времени.
Очевидно, нам потребуется поле, которое непосредственно содержит значение остатка – количество, сумма или иное числовое значение, которое мы хотим агрегировать. Давайте назовем его, например, КоличествоКонечныйОстатокПрофи или СуммаОстатка.
Если наша задача – сверка бухгалтерских остатков или остатков, связанных с конкретными счетами (как в случае сверки между УТ и БП), нам обязательно потребуется поле, которое содержит информацию о счете. Например, СчетБухгалтерскогоУчета. Это поле будет использоваться СКД для правильной агрегации и интерпретации остатков по правилам бухгалтерского учета (дебет/кредит).
Не забудем включить все необходимые аналитики, по которым мы хотим видеть остатки: Номенклатура, Склад, Характеристика и так далее. Эти поля будут использоваться для группировок в отчете.
Убедитесь, что все эти поля имеют корректные типы данных в источнике, чтобы избежать проблем при их загрузке в СКД.
Теперь, когда наши данные подготовлены, перейдем в конструктор схемы компоновки данных и настроим наш набор данных.
Добавим новый набор данных типа "Объект". В поле "Имя объекта" укажем имя нашей внешней таблицы или коллекции, которую мы передаем в отчет. Если данные формируются запросом во временную таблицу, то здесь мы указываем имя этой временной таблицы.
Перейдем на закладку "Поля" в настройках набора данных. Нам нужно будет добавить все поля, которые присутствуют в нашем внешнем источнике.
Для каждого поля обязательно укажем его корректный тип значения. Это очень важно! Например, для поля КоличествоКонечныйОстатокПрофи тип должен быть "Число", для ДатаДок — "Дата", для Номенклатура — ссылка на справочник "Номенклатура". Несоответствие типов данных может привести к тому, что СКД не сможет правильно обрабатывать поля, вычислять агрегаты или связывать данные.
Это самый важный шаг для работы с остатками из внешнего набора данных. Для полей, которые представляют собой остатки (например, КоличествоНачальныйОстаток, КоличествоКонечныйОстатокПрофи), нам необходимо назначить специальную роль "Остатки". Эта роль говорит СКД, что данное поле является остатком, и позволяет применять к нему специализированные алгоритмы.
Разберем подробнее настройку роли "Остатки":
В этом параметре следует определить тип остатка. Для бухгалтерского учета нам необходимо выбрать "Дебетовый остаток" или "Кредитовый остаток" в зависимости от того, как мы интерпретируем значения в нашем поле остатка. Например, если положительное значение поля КоличествоКонечныйОстатокПрофи означает дебетовый остаток (т.е., наличие товара на складе, актива), то мы выберем "Дебетовый остаток". Если же оно может означать как дебет, так и кредит (например, для денежных счетов), то выбор будет зависеть от требуемой логики. Эта настройка позволяет СКД правильно обрабатывать знак остатка и агрегировать его по правилам бухгалтерского учета, что критично для сверок.
Если в наших данных присутствует поле, содержащее информацию о счете (например, СчетБухгалтерскогоУчета), необходимо указать имя этого поля в данном параметре. СКД будет использовать это поле для корректной связи остатков с соответствующими счетами при группировках и расчетах. Это особенно важно для отчетов, где требуется детализация или агрегация остатков по счетам.
После назначения роли "Остатки" и заполнения ее параметров для соответствующих полей, СКД будет понимать, как работать с этими данными, как с остатками, даже если они приходят из внешнего источника.
Теперь, когда СКД знает, какие поля являются остатками, мы можем перейти на закладку "Ресурсы" и определить, как эти остатки будут агрегироваться и рассчитываться в нашем отчете.
Добавим поля, которые мы определили как остатки (например, КоличествоНачальныйОстаток и КоличествоКонечныйОстатокПрофи), в список ресурсов нашего отчета.
Для полей остатков в качестве агрегатной функции используем Сумма. Благодаря тому, что мы корректно настроили роли полей на предыдущем шаге, СКД сама будет знать, как правильно суммировать эти остатки по выбранным периодам и уровням группировки.
Пример настройки ресурса для конечного остатка:
Сумма(КоличествоКонечныйОстатокПрофи)
Если у нас есть отдельное поле для начального остатка, мы настроим его аналогично:
Сумма(КоличествоНачальныйОстаток)
Важно: СКД часто ожидает "пару" ресурсов для начальных и конечных остатков, даже если мы используем одно и то же поле в основе, но с разными вычисляемыми выражениями или логикой в самом наборе данных. Убедимся, что оба типа остатков представлены в ресурсах, если они нам нужны.
Убедимся, что для наших ресурсов установлен флаг "Автоматический расчет итогов", и при необходимости настроим параметры расчета для полей, участвующих в группировках.
После этих настроек, СКД сможет корректно агрегировать и выводить начальные и конечные остатки на всех уровнях группировки в нашем отчете, даже когда данные поступают из внешнего источника.
Как мы уже упоминали, многие разработчики сталкиваются с трудностями при попытке использовать функции типа ВычислитьВыражение с параметром "Последняя" для получения остатков на группировках из внешних данных. Давайте подробнее проанализируем, почему этот подход часто не работает и почему он менее надежен, чем использование ролей полей.
Функция ВычислитьВыражение("Поле", , ,"Последняя") предназначена для получения значения поля из последней записи в текущем контексте группировки. Однако в СКД контекст "последней" записи может быть неоднозначным или некорректно определяться при сложных группировках или большом объеме данных. Особенно это проявляется при:
Именно поэтому использование специализированных ролей полей "Остатки" (как описано в Шаге 2) является гораздо более надежным, производительным и правильным подходом для СКД при работе с остатками из внешних наборов данных. Роли предоставляют СКД явные указания на семантику данных, позволяя ей применять свои внутренние, оптимизированные механизмы для расчета остатков, которые учитывают все нюансы группировок и периодов.
После всех выполненных настроек необходимо тщательно проверить корректность работы отчета. Сформируем отчет и внимательно проанализируем полученные начальные и конечные остатки. Если мы столкнемся с некорректными результатами или проблемами, обратим внимание на следующие моменты:
Если проблема проявляется только при большом количестве записей (как в исходной теме), возможно, дело в производительности запроса или в сложности расчетов. Убедимся, что формирование внешней таблицы данных происходит максимально эффективно.
ПериодСекунда:
Как мы уже упоминали, поле ПериодСекунда (или аналогичное поле с высокой детализацией времени) критично для СКД при расчете остатков по периодам. Проверим, что это поле присутствует в данных, корректно заполнено и имеет соответствующий тип в наборе данных СКД.
Иногда некорректная настройка группировок в отчете может мешать правильному агрегированию остатков. Проверим, что группировки настроены логично и соответствуют нашим требованиям по детализации отчета.
Ещё раз убедимся, что для всех полей в наборе данных СКД указаны абсолютно корректные типы значений. Даже незначительное несоответствие (например, число вместо строки) может привести к непредсказуемым ошибкам.
Внимательно перепроверим выбранный "Бух. тип" для роли "Остатки" (Дебетовый/Кредитовый остаток). Ошибочный выбор может привести к инверсии знаков или некорректной агрегации.
Получение начальных и конечных остатков в СКД из внешних наборов данных – это задача, требующая внимательного и глубокого понимания механизмов Системы Компоновки Данных. Отход от стандартного использования регистров требует от нас использования специфических настроек, таких как назначение ролей полям "Остатки" с указанием "Бух. типа" и "Поля счета". Этот подход является гораздо более надежным и корректным, чем попытки "вытащить" последний остаток с помощью функции ВычислитьВыражение на высоких уровнях группировки.
Следуя этим шагам, мы сможем добиться точных и полных расчетов начальных и конечных остатков в наших отчетах СКД, даже при работе со сложными внешними источниками данных.