Тип: ТипПериодаКомпоновкиДанных. Если поле имеет тип периода Дополнительный, то это говорит о том, что поле не обязательно должно использоваться в компоновке в случае, если в отчете использованы его дочерние периоды. В противном случае использование дочернего поля–периода говорит о необходимости использования в группировке и данного поля.
Полное описание, параметры и ограничения
РольПоляНабораДанныхКомпоновкиДанных.ТипПериода (DataCompositionDataSetFieldRole.PeriodType)
РольПоляНабораДанныхКомпоновкиДанных (DataCompositionDataSetFieldRole)
ТипПериода (PeriodType)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: ТипПериодаКомпоновкиДанных.
Если поле имеет тип периода Дополнительный, то это говорит о том, что поле не обязательно должно использоваться в компоновке в случае, если в отчете использованы его дочерние периоды. В противном случае использование дочернего поля–периода говорит о необходимости использования в группировке и данного поля.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Описать пару остатков и обнаружить неправильное сложение месяцев
Для BOOK январь 10 → 13, февраль 13 → 11. Пара полей имеет общую группу Количество и разные типы остатка.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; настройка схемы не является проведением документов.
Подготовка
В своей отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеРолиПолейСКД. Вставьте полный текст одного урока: процедуру и две функции ниже неё.
Вызовите УчебныеРолиПолейСКД.ВыполнитьПример() из серверной команды собственной обработки. Схема и таблицы остаются на сервере, на клиент выводятся только сообщения.
Товары, даты, остатки и номер 50 заданы собственными константами. Код не читает и не изменяет регистры, план счетов, документы или файлы.
Схема описывается явно: АвтоЗаполнениеДоступныхПолей выключено, каждое поле добавляется через коллекцию Поля. Роль получается из настоящего поля, отдельного конструктора роли нет.
В первом уроке выполняется СКД. Уроки остатков, измерений, периодов и бухгалтерских ролей отдельно проверяют настройку схемы и её исходные строки; это не доказательство корректных итогов рабочего отчёта.
Процедура ВыполнитьПример() Экспорт
Схема = СоздатьУчебнуюСхему("ВЫБРАТЬ ДАТАВРЕМЯ(2026, 1, 1) КАК Период,
| ""BOOK"" КАК Товар, 10 КАК КоличествоНачальныйОстаток,
| 13 КАК КоличествоКонечныйОстаток
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ДАТАВРЕМЯ(2026, 2, 1), ""BOOK"", 13, 11");
Набор = Схема.НаборыДанных.Получить(0);
Период = ДобавитьУчебноеПоле(Набор, "Период", "Дата");
Товар = ДобавитьУчебноеПоле(Набор, "Товар", "Строка");
Начальный = ДобавитьУчебноеПоле(Набор, "КоличествоНачальныйОстаток", "Число");
Конечный = ДобавитьУчебноеПоле(Набор, "КоличествоКонечныйОстаток", "Число");
Период.Роль.НомерПериода = 1;
Период.Роль.ТипПериода = ТипПериодаКомпоновкиДанных.Основной;
Товар.Роль.Измерение = Истина;
РольНачального = Начальный.Роль;
РольНачального.Остаток = Истина;
РольНачального.ТипОстатка = ТипОстаткаКомпоновкиДанных.НачальныйОстаток;
РольНачального.ГруппаОстатка = "Количество";
РольКонечного = Конечный.Роль;
РольКонечного.Остаток = Истина;
РольКонечного.ТипОстатка = ТипОстаткаКомпоновкиДанных.КонечныйОстаток;
РольКонечного.ГруппаОстатка = "Количество";
Сообщить(Товар.Роль.Измерение);
Сообщить(Период.Роль.НомерПериода = 1);
Сообщить(РольНачального.Остаток И РольКонечного.Остаток);
Сообщить(РольНачального.ГруппаОстатка = РольКонечного.ГруппаОстатка);
Сообщить(РольНачального.ТипОстатка <> РольКонечного.ТипОстатка);
Запрос = Новый Запрос(Набор.Запрос);
Строки = Запрос.Выполнить().Выгрузить();
Январь = Строки.Найти(Дата(2026, 1, 1), "Период");
Февраль = Строки.Найти(Дата(2026, 2, 1), "Период");
Сообщить(Строки.Количество() = 2);
Сообщить(Январь.КоличествоКонечныйОстаток = Февраль.КоличествоНачальныйОстаток);
Сообщить(Январь.КоличествоНачальныйОстаток = 10);
Сообщить(Февраль.КоличествоКонечныйОстаток = 11);
Сообщить(Строки.Итог("КоличествоНачальныйОстаток") = 23);
Сообщить("23 — сумма начальных остатков двух месяцев, НЕ начальный остаток всего интервала.");
КонецПроцедуры
Функция СоздатьУчебнуюСхему(ТекстЗапроса)
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеДанные";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Ложь;
Набор.Запрос = ТекстЗапроса;
Возврат Схема;
КонецФункции
Функция ДобавитьУчебноеПоле(Набор, ИмяПоля, ТипПоля)
Поле = Набор.Поля.Добавить(Тип("ПолеНабораДанныхСхемыКомпоновкиДанных"));
Поле.Поле = ИмяПоля;
Поле.ПутьКДанным = ИмяПоля;
Поле.Заголовок = ИмяПоля;
Поле.ТипЗначения = Новый ОписаниеТипов(ТипПоля);
Возврат Поле;
КонецФункцииРазбор по шагам
Обозначить Товар измерением, Период периодом № 1. Это информация для расчёта остатков по товарам и времени.
Назначить обоим числовым полям Остаток и одинаковую ГруппаОстатка. Начальному и конечному полям задать разные ТипОстатка.
Выполнить исходный константный запрос отдельно от СКД. Найти месяцы по дате, не по непредсказуемому порядку выборки.
Проверить непрерывность 13 = 13. Начальный всего интервала 10, конечный 11; механическая сумма начальных значений 23 не является начальным остатком.
Как проверить результат
Десять булевых проверок дают Истина; затем выводится предупреждение про 23.
В отладчике роли пары содержат группу Количество. Здесь ещё нет ресурсов и итоговых группировок СКД: алгоритм итогов не запускается.
Ожидаемый результат
Рабочий код настройки пары остатков и контроль исходных данных до построения итогового отчёта.
На что обратить внимание
Нельзя суммировать остатки одного товара по последовательным датам как обороты.
Для реального регистра нужны его настоящие измерения и периоды, а не эти учебные поля.
Правильные роли не исправляют дубли запроса и неправильные связи наборов данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Описать старший и дочерний периоды отчёта
Месяц получает номер 1, День номер 2. На собственных датах видно, какой период является старшим.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; настройка схемы не является проведением документов.
Подготовка
В своей отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеРолиПолейСКД. Вставьте полный текст одного урока: процедуру и две функции ниже неё.
Вызовите УчебныеРолиПолейСКД.ВыполнитьПример() из серверной команды собственной обработки. Схема и таблицы остаются на сервере, на клиент выводятся только сообщения.
Товары, даты, остатки и номер 50 заданы собственными константами. Код не читает и не изменяет регистры, план счетов, документы или файлы.
Схема описывается явно: АвтоЗаполнениеДоступныхПолей выключено, каждое поле добавляется через коллекцию Поля. Роль получается из настоящего поля, отдельного конструктора роли нет.
В первом уроке выполняется СКД. Уроки остатков, измерений, периодов и бухгалтерских ролей отдельно проверяют настройку схемы и её исходные строки; это не доказательство корректных итогов рабочего отчёта.
Процедура ВыполнитьПример() Экспорт
Схема = СоздатьУчебнуюСхему("ВЫБРАТЬ ДАТАВРЕМЯ(2026, 1, 1) КАК Месяц,
| ДАТАВРЕМЯ(2026, 1, 10) КАК День, 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ДАТАВРЕМЯ(2026, 1, 1), ДАТАВРЕМЯ(2026, 1, 11), 50");
Набор = Схема.НаборыДанных.Получить(0);
Месяц = ДобавитьУчебноеПоле(Набор, "Месяц", "Дата");
День = ДобавитьУчебноеПоле(Набор, "День", "Дата");
Сумма = ДобавитьУчебноеПоле(Набор, "Сумма", "Число");
РольМесяца = Месяц.Роль;
РольМесяца.НомерПериода = 1;
РольМесяца.ТипПериода = ТипПериодаКомпоновкиДанных.Основной;
РольДня = День.Роль;
РольДня.НомерПериода = 2;
РольДня.ТипПериода = ТипПериодаКомпоновкиДанных.Основной;
Сообщить(РольМесяца.НомерПериода < РольДня.НомерПериода);
Сообщить(РольМесяца.ТипПериода = ТипПериодаКомпоновкиДанных.Основной);
РольМесяца.ТипПериода = ТипПериодаКомпоновкиДанных.Дополнительный;
Сообщить(РольМесяца.ТипПериода = ТипПериодаКомпоновкиДанных.Дополнительный);
Сообщить(РольДня.НомерПериода = 2);
Сообщить(Сумма.Роль.НомерПериода = 0);
Запрос = Новый Запрос(Набор.Запрос);
Строки = Запрос.Выполнить().Выгрузить();
Сообщить(Строки.Количество() = 2);
Сообщить(Строки.Итог("Сумма") = 800);
Сообщить(Строки.Найти(Дата(2026, 1, 10), "День").Месяц = Дата(2026, 1, 1));
Сообщить(Строки.Найти(Дата(2026, 1, 11), "День").Месяц = Дата(2026, 1, 1));
КонецПроцедуры
Функция СоздатьУчебнуюСхему(ТекстЗапроса)
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеДанные";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Ложь;
Набор.Запрос = ТекстЗапроса;
Возврат Схема;
КонецФункции
Функция ДобавитьУчебноеПоле(Набор, ИмяПоля, ТипПоля)
Поле = Набор.Поля.Добавить(Тип("ПолеНабораДанныхСхемыКомпоновкиДанных"));
Поле.Поле = ИмяПоля;
Поле.ПутьКДанным = ИмяПоля;
Поле.Заголовок = ИмяПоля;
Поле.ТипЗначения = Новый ОписаниеТипов(ТипПоля);
Возврат Поле;
КонецФункцииРазбор по шагам
Создать поля Месяц и День типа Дата. Поле Сумма не является периодом.
Назначить периоду Месяц номер 1, Дню номер 2. Номера описывают иерархию периодов, а не дату 1-го и 2-го числа.
Сначала описать старший период как Основной, затем намеренно изменить его на Дополнительный. Это разрешает не использовать его в компоновке, когда используется дочерний период.
Проверить два собственных дня 10 и 11 января, общий месяц 1 января и сумму 800. Настройки группировки и итоговый отчёт здесь не строятся.
Как проверить результат
Девять проверок дают Истина.
После изменения РольМесяца.ТипПериода = Дополнительный, номер остаётся 1. У Дня номер 2, у Суммы 0.
Ожидаемый результат
Подготовленные периодные роли собственной схемы без смешивания уровня периода с датой.
На что обратить внимание
При Основной использование дочернего периода требует и старшего в группировке; эта настройка не добавляет пользовательскую группировку самостоятельно.
Если запрос возвращает регистратор и номер строки, надо описывать их реальные уровни, а не слепо копировать Месяц/День.
Этот запуск проверяет описание и исходные даты, не итоговые остатки по периодам.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.