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