Удаляет элемент из коллекции.
Синтаксис
Удалить(<Элемент>)Полное описание, параметры и ограничения
ЗначенияПолейРасшифровкиКомпоновкиДанных.Удалить (DataCompositionDetailsFieldValues.Delete)
ЗначенияПолейРасшифровкиКомпоновкиДанных (DataCompositionDetailsFieldValues)
Удалить (Delete)
Доступен, начиная с версии 8.1.
Синтаксис:
Удалить(<Элемент>)
Параметры:
<Элемент> (обязательный)
Тип: ЗначениеПоляРасшифровкиКомпоновкиДанных.
Удаляемый элемент.
Описание:
Удаляет элемент из коллекции.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Собрать поля расшифровки вымышленной строки Книга
Коллекция хранит имя поля, его значение и признак иерархической записи. Значения не взяты из рабочего отчёта.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; не клиентский модуль формы.
Подготовка
Собственная учебная база 8.5.1.1343. Создайте общий модуль УчебныеКоллекцииСКД с флагом Сервер. Вставьте полный текст одного урока с процедурой ВыполнитьПример() Экспорт.
Из серверной команды своей обработки вызовите УчебныеКоллекцииСКД.ВыполнитьПример(). Таблицы значений и служебные объекты макета остаются на сервере.
Книга / 3 / 750 и Ручка / 1 / 50 — вымышленные собственные данные. Ни справочники, ни документы, ни регистры базы, ни внешние сервисы не читаются.
Различайте схему, настройки, скомпилированный макет и результат. Урок составления отдельной коллекции не называется готовым рабочим отчётом.
В уроке описания расшифровки временное хранилище заполняется только новым собственным объектом, в одном вызове. В конце удаляется ровно этот созданный адрес, включая обработку ошибки.
Не заменяйте собственный новый макет текущим рабочим отчётом: Очистить, Удалить и Сдвинуть в этих уроках относятся к собственной памяти.
Процедура ВыполнитьПример() Экспорт
Поля = Новый ЗначенияПолейРасшифровкиКомпоновкиДанных;
Название = Поля.Добавить();
Название.Поле = "Наименование";
Название.Значение = "Книга";
Название.Иерархия = Ложь;
Сумма = Поля.Добавить();
Сумма.Поле = "Сумма";
Сумма.Значение = 750;
Сумма.Иерархия = Ложь;
Количество = Поля.Вставить(1);
Количество.Поле = "Количество";
Количество.Значение = 3;
Количество.Иерархия = Ложь;
Сообщить(Поля.Количество() = 3);
Сообщить(Поля.Найти("Сумма") = Сумма);
Сообщить(Поля.Найти("Наименование").Значение = "Книга");
Сообщить(Поля.Индекс(Количество) = 1);
Сообщить(Поля.Получить(1).Поле = "Количество");
Сообщить(Количество.Значение = 3);
Сообщить(НЕ Количество.Иерархия);
Поля.Сдвинуть(Сумма, -1);
Сообщить(Поля.Получить(1).Поле = "Сумма");
Поля.Удалить(Количество);
Сообщить(Поля.Количество() = 2);
Сообщить(Поля.Найти("Количество") = Неопределено);
Для Каждого ЗначениеПоля Из Поля Цикл
Сообщить(СтрШаблон("Поле %1: %2", ЗначениеПоля.Поле, ЗначениеПоля.Значение));
КонецЦикла;
Поля.Очистить();
Сообщить(Поля.Количество() = 0);
КонецПроцедурыРазбор по шагам
Создаём два поля Наименование/Книга и Сумма/750, затем вставляем Количество/3 в позицию 1.
Найти ищет по строковому имени Поле; это не ПолеКомпоновкиДанных и не UUID.
Иерархия выключена явно: вымышленная строка не является иерархическим итогом.
Сдвинуть меняет порядок служебных полей, не значение суммы. Удалить принимает элемент.
После чтения собственных полей очищаем только свою новую коллекцию.
Как проверить результат
Одиннадцать булевых проверок Истина; до очистки сообщения Наименование/Книга и Сумма/750.
После удаления Количество поиск возвращает Неопределено, после Очистить количество 0.
Ожидаемый результат
Создан содержательный набор значений для учебной расшифровки.
На что обратить внимание
Коллекция сама не открывает документ или рабочую расшифровку.
Иерархия — признак значения, не создание иерархического справочника.
Не используйте Очистить на данных расшифровки рабочего отчёта без понимания его жизненного цикла.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.