КоллекцияЭлементовОтбораКомпоновкиДанных.Удалить

Методы · Delete

Удаляет элемент из коллекции.

Синтаксис

Удалить(<Элемент>)
Полное описание, параметры и ограничения

КоллекцияЭлементовОтбораКомпоновкиДанных.Удалить (DataCompositionFilterItemCollection.Delete)

КоллекцияЭлементовОтбораКомпоновкиДанных (DataCompositionFilterItemCollection)

Удалить (Delete)

Доступен, начиная с версии 8.1.

Синтаксис:
Удалить(<Элемент>)
Параметры:

<Элемент> (обязательный)
Тип: ЭлементОтбораКомпоновкиДанных, ГруппаЭлементовОтбораКомпоновкиДанных.
Удаляемый элемент.
Описание:

Удаляет элемент из коллекции.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Ограничить данные серий только магазином Север

В собственную группировку магазинов добавляем условие Магазин = Север. Проверяем условие и показываем отличие локального отбора от корневого отбора всего отчёта.

Где и как запускать

Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.

Подготовка

  1. Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.

  2. Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.

  3. В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.

  4. Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.

  5. Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.

  6. Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.

  7. Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.

  8. Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.

Процедура ВыполнитьПример() Экспорт
    Схема = Новый СхемаКомпоновкиДанных;
    Источник = Схема.ИсточникиДанных.Добавить();
    Источник.Имя = "УчебныеПродажи";
    Источник.ТипИсточникаДанных = "Local";
    Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
    Набор.Имя = "СвоиТриСтроки";
    Набор.ИсточникДанных = Источник.Имя;
    Набор.АвтоЗаполнениеДоступныхПолей = Истина;
    Набор.Запрос = "ВЫБРАТЬ
    |    ""Север"" КАК Магазин,
    |    ""Книга"" КАК Наименование,
    |    3 КАК Количество,
    |    750 КАК Сумма
    |ОБЪЕДИНИТЬ ВСЕ
    |ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
    |ОБЪЕДИНИТЬ ВСЕ
    |ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
    Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
        Ресурс = Схема.ПоляИтога.Добавить();
        Ресурс.ПутьКДанным = ИмяРесурса;
        Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
    КонецЦикла;
    Настройки = Схема.НастройкиПоУмолчанию;
    Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
    Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
    Диаграмма.Использование = Истина;
    Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
    Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
    Выбранное.Использование = Истина;
    Серия = Диаграмма.Серии.Добавить();
    Серия.Имя = "Магазины";
    Серия.Использование = Истина;
    ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
    ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
    ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
    ПолеСерии.Использование = Истина;
    Точка = Диаграмма.Точки.Добавить();
    Точка.Имя = "Товары";
    Точка.Использование = Истина;
    ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
    ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
    ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
    ПолеТочки.Использование = Истина;
    Условие = Серия.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
    Условие.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Магазин");
    Условие.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
    Условие.ПравоеЗначение = "Север";
    Условие.Использование = Истина;
    Сообщить(Серия.Отбор.Элементы.Количество() = 1);
    Сообщить(Настройки.Отбор.Элементы.Количество() = 0);
    Сообщить(Точка.Отбор.Элементы.Количество() = 0);
    Сообщить(Условие.Использование И Условие.ПравоеЗначение = "Север");
    Условие.Использование = Ложь;
    Сообщить(Не Условие.Использование);
    Сообщить(Серия.Отбор.Элементы.Количество() = 1);
    Серия.Отбор.Элементы.Удалить(Условие);
    Сообщить(Серия.Отбор.Элементы.Количество() = 0);
КонецПроцедуры

Разбор по шагам

  1. ЛевоеЗначение — объект ПолеКомпоновкиДанных, а ПравоеЗначение — строка Север из своей задачи.

  2. Включаем условие в отборе Серия. Проверяем, что корень и группировка точек не получили этот элемент.

  3. Выключение Использование оставляет правило в коллекции. Отдельно проверяем флаг и сохранённое количество 1.

  4. Удалить получает сам объект условия и уменьшает коллекцию до 0. Исходные три строки запроса этим не изменяются.

Как проверить результат

  1. Ожидаются семь сравнений Истина. Объясните различие состояний: условие включено, условие выключено, условие удалено.

  2. Чтобы увидеть локальный отбор при формировании, вставьте его создание из этого урока перед компоновкой урока вывода, без последующих выключения и удаления. Проверьте Север: Книга 750, Ручка 50, вместе 800.

Ожидаемый результат

Создан, отключён и удалён локальный отбор собственной группировки без изменения глобальных настроек.

На что обратить внимание

  1. Не обещайте отбор всего отчёта при изменении только Серия.Отбор.

  2. Выключение правила не очищает коллекцию; количество элементов не является количеством применяемых условий.

  3. Пример настройки не доказывает выполнение фильтрации: это проверяется отдельной компоновкой.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.