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