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