Содержит значение параметра макета.
Полное описание, параметры и ограничения
ЗначениеПараметраМакетаКомпоновкиДанных (DataCompositionTemplateParameterValue)
ЗначениеПараметраМакетаКомпоновкиДанных (DataCompositionTemplateParameterValue)
Доступен, начиная с версии 8.1.
Свойства:
Значение (Value)
Имя (Name)
Описание:
Содержит значение параметра макета.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Данный объект может быть сериализован в/из XML. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data-composition-system/composition-template}. Имя типа XDTO: ParameterValue.
См. также:
ЗначенияПараметровМакетаКомпоновкиДанных, метод Добавить
ЗначенияПараметровМакетаКомпоновкиДанных, метод Вставить
ЗначенияПараметровМакетаКомпоновкиДанных, метод Получить
ЗначенияПараметровМакетаКомпоновкиДанных, метод Удалить
ЗначенияПараметровМакетаКомпоновкиДанных, метод Индекс
ЗначенияПараметровМакетаКомпоновкиДанных, метод Сдвинуть
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Связать параметры и области настоящих элементов результата СКД
Из каждого реального события получаем его имена параметров и описания областей. Число описаний и имена диагностируем отдельно от результирующих значений двух продаж.
Где и как запускать
Полный серверный общий модуль УчебныйПотокСКД85. Свой константный источник проходит компоновку и полный ручной вывод в ТаблицаЗначений.
Подготовка
В отдельной пустой учебной базе 8.5.1.1343 создайте общий модуль УчебныйПотокСКД85: Сервер — Да, Клиент — Нет, Глобальный — Нет, Вызов сервера — Нет, Привилегированный — Нет.
Вставьте весь приведённый модуль одного урока. В своей учебной обработке создайте управляемую форму, команду и клиентский обработчик, вызывающий свою процедуру &НаСервереБезКонтекста. Её тело: УчебныйПотокСКД85.ВыполнитьПример();.
Схема, настройки, макет и процессоры создаются в коде. Собственный Local-запрос состоит из двух константных строк: Книга — 3 штуки, цена 250, сумма 750; Ручка — 1, 50, 50. Всего 2 позиции, 4 единицы и 800.
Генератор макета выбран для коллекции значений. Результат — серверная ТаблицаЗначений в памяти, не табличный документ окна и не объект рабочей конфигурации.
Для исследования поставьте точку останова внутри Пока перед ВывестиЭлемент. В переменной Элемент находится реально полученный элемент потока; изучите его ТипЭлемента, Макет, Макеты и ЗначенияПараметров.
На завершении смотрите Итог и Диагностика либо переменные урока. ТаблицаЗначений не возвращается прямо в тонкий клиент; код не печатает, не пишет файл, не меняет базу и не использует сеть.
Каждый запуск заново создаёт свои объекты. Не подключайте другой исчерпанный процессор и не меняйте чужой макет ради повторения урока.
Запуск в 1С не проверялся. Статические проверки не доказывают фактическую последовательность всех элементов генератора; контрольные действия выполните только на своей учебной базе.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
ПараметровВПотоке = 0;
ОписанийВПотоке = 0;
Компоновщик = Новый КомпоновщикМакетаКомпоновкиДанных;
Макет = Компоновщик.Выполнить(Схема, Настройки, , ,
Тип("ГенераторМакетаКомпоновкиДанныхДляКоллекцииЗначений"));
Процессор = Новый ПроцессорКомпоновкиДанных;
Процессор.Инициализировать(Макет);
Приемник = Новый ТаблицаЗначений;
Вывод = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений;
Вывод.ОтображатьПроцентВывода = Ложь;
Вывод.УстановитьОбъект(Приемник);
Вывод.НачатьВывод();
КоличествоЭлементов = 0;
Элемент = Процессор.Следующий();
Пока Элемент <> Неопределено Цикл
Если ТипЗнч(Элемент) <> Тип("ЭлементРезультатаКомпоновкиДанных") Тогда
ВызватьИсключение "Ожидался элемент собственного потока компоновки";
КонецЕсли;
КоличествоЭлементов = КоличествоЭлементов + 1;
Для Каждого Параметр Из Элемент.ЗначенияПараметров Цикл
ПараметровВПотоке = ПараметровВПотоке + 1;
Сообщить("Параметр: " + Параметр.Имя + "; тип значения: " + Строка(ТипЗнч(Параметр.Значение)));
КонецЦикла;
Для Каждого Описание Из Элемент.Макеты Цикл
ОписанийВПотоке = ОписанийВПотоке + 1;
Сообщить("Область: " + Описание.Имя);
Сообщить("Тип макета области: " + Строка(ТипЗнч(Описание.Макет)));
Сообщить("Описаний параметров области: " + Строка(Описание.Параметры.Количество()));
КонецЦикла;
Вывод.ВывестиЭлемент(Элемент);
Элемент = Процессор.Следующий();
КонецЦикла;
Итог = Вывод.ЗакончитьВывод();
Если ТипЗнч(Итог) <> Тип("ТаблицаЗначений") Тогда
ВызватьИсключение "Свой генератор должен вернуть таблицу значений";
КонецЕсли;
Сообщить(КоличествоЭлементов > 0);
Сообщить(Итог.Количество() = 2);
Сообщить(Итог.Итог("Количество") = 4);
Сообщить(Итог.Итог("Сумма") = 800);
Сообщить("Параметров во всём потоке: " + Строка(ПараметровВПотоке));
Сообщить("Описаний областей во всём потоке: " + Строка(ОписанийВПотоке));
КонецПроцедурыРазбор по шагам
Собственная схема создаёт Local-источник и две константные продажи; поля выбираются явно, детальные записи включены.
Компоновщик получает эти настройки и точный ГенераторМакетаКомпоновкиДанныхДляКоллекцииЗначений. Выбор генератора связан с конечным видом приёмника.
Свой процессор инициализируется реальным макетом. Собственный вывод получает пустую ТаблицаЗначений и НачатьВывод до первого элемента.
Следующий возвращает элемент или Неопределено. Перед чтением свойств проверяем тип; внутри полного цикла не пропускаем ни одного элемента.
После диагностики передаём исходный элемент ВывестиЭлемент без изменения. ЗакончитьВывод вызывается после завершения потока; только теперь проверяем готовую таблицу.
В ЗначенияПараметров каждое имя связано с конкретным произвольным значением. Для безопасной диагностики выводим его ТипЗнч, а не принудительно строкуем неизвестный составной объект.
Макеты содержит настоящие ОписаниеМакетаОбластиМакетаКомпоновкиДанных. Их Макет — объект области разных допустимых видов, а не строковое имя Элемент.Макет.
Параметры описания области и ЗначенияПараметров события — разные коллекции: первая описывает параметры области, вторая хранит передаваемые значения.
Нулевое число параметров или областей у отдельного структурного события не считается ошибкой. Их итоговые количества не привязываем к двум исходным продажам.
Как проверить результат
Четыре контрольных сравнения результата Истина. После них выводятся реально подсчитанные количества параметров и областей, без обещания фиксированных чисел.
Найдите в отладчике хотя бы один выдаваемый генератором элемент с описанием области или параметром; его наличие и состав проверяйте на своём стенде.
Просмотр параметров не должен менять две итоговые строки и сумму 800. Вызов ВывестиЭлемент сохранён для каждого события.
Ожидаемый результат
Показаны реальные связи события, имён параметров и объектов областей, с сохранением полного вывода отчёта.
На что обратить внимание
Элемент потока не равен строке исходного запроса. Структурные события, параметры и области макета могут давать другое число элементов, чем число позиций.
ЗначенияПараметров и Макеты — readonly-ссылки на коллекции. Их нельзя присваивать вместо массивов или структур.
Имя макета и параметры принадлежат связанному скомпилированному макету. Не вставляйте произвольное имя области в реально выводимый элемент.
ПроцентВывода — значение события, не число строк и не гарантия измеренного прогресса браузера. В этом уроке не задаём его искусственно.
Все объекты созданы своим запуском в памяти. Примеры не выполнялись в 1С; проверяйте ожидаемый результат на учебном стенде.
Не путайте Элемент.Макет (Строка) с Описание.Макет (объект области). Нельзя присваивать им значения одного вида по сходству имён.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Задать именованные значения параметров собственного черновика макета
Параметры макета — коллекция элементов Имя/Значение, не структура и не SQL-параметры. Здесь исследуется только эта часть черновика.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; не клиентский модуль формы.
Подготовка
Собственная учебная база 8.5.1.1343. Создайте общий модуль УчебныеКоллекцииСКД с флагом Сервер. Вставьте полный текст одного урока с процедурой ВыполнитьПример() Экспорт.
Из серверной команды своей обработки вызовите УчебныеКоллекцииСКД.ВыполнитьПример(). Таблицы значений и служебные объекты макета остаются на сервере.
Книга / 3 / 750 и Ручка / 1 / 50 — вымышленные собственные данные. Ни справочники, ни документы, ни регистры базы, ни внешние сервисы не читаются.
Различайте схему, настройки, скомпилированный макет и результат. Урок составления отдельной коллекции не называется готовым рабочим отчётом.
В уроке описания расшифровки временное хранилище заполняется только новым собственным объектом, в одном вызове. В конце удаляется ровно этот созданный адрес, включая обработку ошибки.
Не заменяйте собственный новый макет текущим рабочим отчётом: Очистить, Удалить и Сдвинуть в этих уроках относятся к собственной памяти.
Процедура ВыполнитьПример() Экспорт
Макет = Новый МакетКомпоновкиДанных;
Параметры = Макет.ЗначенияПараметров;
Название = Параметры.Добавить();
Название.Имя = "УчебноеНазвание";
Название.Значение = "Книга";
Количество = Параметры.Вставить(0);
Количество.Имя = "УчебноеКоличество";
Количество.Значение = 3;
Сообщить(Параметры.Количество() = 2);
Сообщить(Параметры.Найти("УчебноеНазвание") = Название);
Сообщить(Параметры.Найти("УчебноеКоличество").Значение = 3);
Сообщить(Параметры.Индекс(Количество) = 0);
Сообщить(Параметры.Получить(0).Имя = "УчебноеКоличество");
Параметры.Сдвинуть(Количество, 1);
Сообщить(Параметры.Получить(1) = Количество);
Параметры.Удалить(Название);
Сообщить(Параметры.Количество() = 1);
Сообщить(Параметры.Найти("УчебноеНазвание") = Неопределено);
Параметры.Очистить();
Сообщить(Параметры.Количество() = 0);
КонецПроцедурыРазбор по шагам
Создаём новый собственный макет без схемы и получаем его коллекцию ЗначенияПараметров.
Добавляем строковое УчебноеНазвание и вставляем числовое УчебноеКоличество в начало.
Найти использует имя, Индекс/Получить — позицию. Значение может иметь разный тип.
Сдвигаем число, удаляем название и проверяем отсутствие; затем очищаем собственную коллекцию.
Этот черновик не передаём процессору: для готового отчёта нужны согласованные наборы, тело и области макета.
Как проверить результат
Девять проверок Истина: имена, значения, позиции, удаление и пустая коллекция.
Код не обещает две строки отчёта: он учит конкретной коллекции параметров, а не выполняет незаполненный макет.
Ожидаемый результат
Разобрана реальная коллекция параметров нового собственного макета.
На что обратить внимание
Создать параметр не означает связать его с выражением ячейки или запроса.
Не очищайте параметры скомпилированного рабочего макета перед выполнением.
Строка УчебноеНазвание — имя параметра, Книга — его значение.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.