Определяет варианты использования агрегата регистра накопления при выполнении запроса.
Полное описание, параметры и ограничения
ИспользованиеАгрегатаРегистраНакопления (AccumulationRegisterAggregateUse)
ИспользованиеАгрегатаРегистраНакопления (AccumulationRegisterAggregateUse)
Доступен, начиная с версии 8.2.
Значения
Авто (Auto)
Всегда (Always)
Описание:
Определяет варианты использования агрегата регистра накопления при выполнении запроса.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Возможен обмен с сервером. Сериализуется.
См. также:
АгрегатРегистраНакопления, свойство Использование
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Прочитать настройку своего агрегата: ИспользованиеАгрегатаРегистраНакопления.Авто
Агрегат берётся из конкретного собственного оборотного регистра; периодичность и использование читаются из его описания, не выдаются за суммы продаж.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте собственный оборотный регистр накопления УчебныеОборотыКниг: измерение КодКниги Строка 40, ресурс Количество Число 12.2. Регистраторы и реальные движения для этого чтения метаданных не нужны.
В настройках агрегатов регистра создайте один собственный агрегат по КодКниги. Для опыта задайте Использование = Авто там, где параметр доступен в Конфигураторе. Код только читает описание; агрегат не создаётся через Новый.
Основной блок — тело собственной серверной процедуры / кнопки обычной формы, толстый клиент. Не изменяйте настройки агрегатов рабочего регистра ради опыта.
Регистр = Метаданные.РегистрыНакопления.УчебныеОборотыКниг;
Если Регистр.Агрегаты.Количество() = 0 Тогда
Сообщить("Создайте собственный агрегат в Конфигураторе");
Возврат;
КонецЕсли;
Агрегат = Регистр.Агрегаты.Получить(0);
Если Агрегат.Использование = ИспользованиеАгрегатаРегистраНакопления.Авто Тогда
Сообщить("У собственного агрегата выбранная настройка: Авто");
Иначе
Сообщить("Фактическая настройка: " + Строка(Агрегат.Использование));
КонецЕсли;
Сообщить("Измерений агрегата: " + Строка(Агрегат.Измерения.Количество()));Разбор по шагам
Подготовьте свой оборотный регистр и один агрегат.
Получите агрегат из метаданных по действительному индексу 0.
Сравните документированное свойство и состав измерений без записи или перестроения агрегатов.
Как проверить результат
Периодичность относится к агрегату, а не к частоте запуска отчёта. Непериодический / Авто не подменяются календарным месяцем в коде.
Использование Авто / Всегда — политика применения. Чтение метаданных не доказывает, что конкретный запрос действительно использовал этот агрегат.
Ожидаемый результат
Сравнено реальное значение собственного описания без фиктивных сумм и изменения хранения.
На что обратить внимание
Отсутствие агрегатов обрабатывается отдельно, не как значение Авто.
BSL, запись движений и перестроение агрегатов при сборке HTML не выполнялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.