Тип: ПорядокКомпоновкиДанных. Содержит порядок записей, выводимых в результат. Используется как порядок “по умолчанию” для всех элементов компоновки.
Полное описание, параметры и ограничения
НастройкиКомпоновкиДанных.Порядок (DataCompositionSettings.Order)
НастройкиКомпоновкиДанных (DataCompositionSettings)
Порядок (Order)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: ПорядокКомпоновкиДанных.
Содержит порядок записей, выводимых в результат. Используется как порядок “по умолчанию” для всех элементов компоновки.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Задать независимую сортировку магазинов и товаров
Магазины сортируем по возрастанию, товары — по убыванию. Проверяем направление в двух разных группировках и отсутствие общего порядка в корне настроек.
Где и как запускать
Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.
Подготовка
Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.
Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.
В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.
Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.
Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.
Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.
Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.
Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
Диаграмма.Использование = Истина;
Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбранное.Использование = Истина;
Серия = Диаграмма.Серии.Добавить();
Серия.Имя = "Магазины";
Серия.Использование = Истина;
ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеСерии.Использование = Истина;
Точка = Диаграмма.Точки.Добавить();
Точка.Имя = "Товары";
Точка.Использование = Истина;
ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТочки.Использование = Истина;
ПорядокСерий = Серия.Порядок.Элементы.Добавить(Тип("ЭлементПорядкаКомпоновкиДанных"));
ПорядокСерий.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПорядокСерий.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Возр;
ПорядокСерий.Использование = Истина;
ПорядокТочек = Точка.Порядок.Элементы.Добавить(Тип("ЭлементПорядкаКомпоновкиДанных"));
ПорядокТочек.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПорядокТочек.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв;
ПорядокТочек.Использование = Истина;
Сообщить(Серия.Порядок.Элементы.Количество() = 1);
Сообщить(Точка.Порядок.Элементы.Количество() = 1);
Сообщить(Настройки.Порядок.Элементы.Количество() = 0);
Сообщить(ПорядокСерий.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Возр);
Сообщить(ПорядокТочек.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв);
Серия.Порядок.Элементы.Очистить();
Сообщить(Серия.Порядок.Элементы.Количество() = 0 И Точка.Порядок.Элементы.Количество() = 1);
КонецПроцедурыРазбор по шагам
Добавляем два разных элемента порядка, каждый в собственную коллекцию группировки.
Серия получает поле Магазин и направление Возр; Точка — Наименование и Убыв. Строковые имена направлений не используются.
Корневая сортировка не задаётся. Поэтому отсутствие порядка в Настройки.Порядок не означает отсутствие локальных правил.
Удаляем порядок магазинов, но не товаров; последнее сравнение проверяет область действия очистки.
Как проверить результат
Ожидаются шесть сравнений Истина. В отладчике до очистки у группировок разные поля и направления.
Для осмотра результата скопируйте создание двух порядков перед компоновкой урока вывода, без очистки. При обычном русском сравнении названий ожидайте Север перед Юг, Ручка перед Книга; фактическое сравнение строк зависит от настройки сортировки базы.
Ожидаемый результат
Порядок серий и точек настроен независимо и проверен на уровне собственного дерева.
На что обратить внимание
Порядок элементов дерева настроек и порядок данных группировки — разные операции.
Не заменяйте НаправлениеСортировкиКомпоновкиДанных значением другого одноимённого перечисления.
Сортировка полей не меняет суммы продаж и не записывает данные в базу.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Очистить сортировку Детали и сохранить общий порядок
Количество по убыванию отдельно задаём корню и группировке. Метод очистки одного элемента структуры не удаляет корневую сортировку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.
Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.
Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.
Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Порядок = Настройки.Порядок.Элементы.Добавить(Тип("ЭлементПорядкаКомпоновкиДанных"));
Порядок.Поле = Новый ПолеКомпоновкиДанных("Количество");
Порядок.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв;
Порядок.Использование = Истина;
Порядок = Детали.Порядок.Элементы.Добавить(Тип("ЭлементПорядкаКомпоновкиДанных"));
Порядок.Поле = Новый ПолеКомпоновкиДанных("Количество");
Порядок.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв;
Порядок.Использование = Истина;
Сообщить(Настройки.НаличиеПорядкаУЭлемента(Детали));
Сообщить(Детали.Порядок.Элементы.Количество() = 1);
Настройки.ОчиститьПорядокЭлемента(Детали);
Сообщить(Не Настройки.НаличиеПорядкаУЭлемента(Детали));
Сообщить(Детали.Порядок.Элементы.Количество() = 0);
Сообщить(Настройки.Порядок.Элементы.Количество() = 1);Разбор по шагам
В две отдельные коллекции добавляем по одному ЭлементПорядкаКомпоновкиДанных.
Сортировка убывающая, поле Количество существует в собственном запросе.
Наличие и очистка относятся к Детали, не к таблице значений результата.
После очистки корневой порядок остаётся. Формирование отчёта для проверки порядка строк — отдельный этап.
Как проверить результат
Пять сравнений Истина; собственная сортировка Детали исчезла, корневая сохранилась.
Исходные константные строки не переставлены самим методом очистки настройки.
Ожидаемый результат
Показаны две области порядка и локальная очистка одной.
На что обратить внимание
ПорядокКомпоновкиДанных — настройка, не уже отсортированная ТаблицаЗначений.
ТипУпорядочивания использует НаправлениеСортировкиКомпоновкиДанных, не свойство порядка метаданных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.