Содержит варианты типов дополнения дат в периоде. Например: если в отчете за год нужны данные по месяцам, то следует указать дополнение периода "Месяц".
Полное описание, параметры и ограничения
ТипДополненияПериодаКомпоновкиДанных (DataCompositionPeriodAdditionType)
ТипДополненияПериодаКомпоновкиДанных (DataCompositionPeriodAdditionType)
Доступен, начиная с версии 8.1.
Значения
БезДополнения (None)
Год (Year)
ГодОтНачалаПериода (YearSinceBeginOfPeriod)
ГодОтНачалаПериода445 (YearSinceBeginOfPeriod445)
Декада (TenDays)
День (Day)
ДеньОтНачалаПериода (DaySinceBeginOfPeriod)
Квартал (Quarter)
КварталОтНачалаПериода (QuarterSinceBeginOfPeriod)
КварталОтНачалаПериода445 (QuarterSinceBeginOfPeriod445)
Месяц (Month)
МесяцОтНачалаПериода (MonthSinceBeginOfPeriod)
МесяцОтНачалаПериода445 (MonthSinceBeginOfPeriod445)
Минута (Minute)
МинутаОтНачалаПериода (MinuteSinceBeginOfPeriod)
Неделя (Week)
НеделяОтНачалаПериода (WeekSinceBeginOfPeriod)
Полугодие (HalfYear)
ПолугодиеОтНачалаПериода (HalfYearSinceBeginOfPeriod)
ПолугодиеОтНачалаПериода445 (HalfYearSinceBeginOfPeriod445)
Секунда (Second)
Час (Hour)
ЧасОтНачалаПериода (HourSinceBeginOfPeriod)
Описание:
Содержит варианты типов дополнения дат в периоде. Например: если в отчете за год нужны данные по месяцам, то следует указать дополнение периода "Месяц".
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Данный объект может быть сериализован в/из XML. Может использоваться в реквизитах управляемой формы. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data-composition-system/core}. Имя типа XDTO: DataCompositionPeriodAdditionType.
См. также:
ПолеГруппировкиКомпоновкиДанных, свойство ТипДополнения
ДополнениеПериодаМакетаКомпоновкиДанных, свойство ТипДополнения
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Настроить дополнение группировки Период: БезДополнения
Создаём собственные настройки СКД и реальное поле группировки Период. Конкретный вариант задаёт дополнение дат в указанном диапазоне, но не формирует отчёт сам по себе.
Где и как запускать
Серверная процедура собственной учебной обработки; дополнительные функции размещаются отдельно в том же серверном модуле.
Подготовка
Создайте собственную учебную обработку с серверной процедурой ВыполнитьПример. Основной код без заголовка вставьте в тело этой процедуры.
Каждый урок — отдельная настройка. Код не обращается к данным рабочей конфигурации, не записывает базу и не создаёт внешние файлы.
Для применения создайте собственную схему СКД с полем Период типа Дата. Полученные Настройки относятся именно к полю Период этой схемы; код показывает подготовку настройки, не выдуманный результат отчёта.
Настройки = Новый НастройкиКомпоновкиДанных;
Группировка = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Группировка.Использование = Истина;
Поле = Группировка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
Поле.Использование = Истина;
Поле.Поле = Новый ПолеКомпоновкиДанных("Период");
Поле.ТипДополнения = ТипДополненияПериодаКомпоновкиДанных.БезДополнения;
Поле.НачалоПериода = Дата(2026, 10, 1);
Поле.КонецПериода = Дата(2026, 10, 31, 23, 59, 59);
Сообщить("Настроено дополнение: " + Строка(Поле.ТипДополнения));
Сообщить("Период: октябрь 2026; отчёт ещё не сформирован");Разбор по шагам
Настройки и группировка создаются сами; поле получено из её коллекции Элементы правильного типа.
ПолеКомпоновкиДанных("Период") обозначает имя поля собственной схемы, не имя реквизита формы.
ТипДополнения получает ТипДополненияПериодаКомпоновкиДанных.БезДополнения, а начало и конец задаются настоящими датами. Формирование макета и вывода СКД здесь не выполняется.
Как проверить результат
В сообщении показан выбранный тип дополнения и октябрьский диапазон.
БезДополнения не создаёт отсутствующие даты; другие варианты задают конкретную периодичность дополнения. Не считайте число сообщений числом строк готового отчёта.
Ожидаемый результат
Конкретное значение использовано для настройки реально созданного объекта; результат расчёта не выдумывается.
На что обратить внимание
Это подготовка настройки. Она сама не является рассчитанным отчётом, моделью прогноза или анализом рабочей базы.
Имена полей и источник берутся из подготовки. Не передавайте неизвестный объект и не добавляйте проверку имени конфигурации вместо правильного контекста.
Меняя роль колонки или тип анализа, пересмотрите остальные роли и параметры перед отдельным вызовом Выполнить.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.