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