Тип: ЗначенияПараметровМакетаКомпоновкиДанных. Значения для параметров макета.
Полное описание, параметры и ограничения
ЭлементРезультатаКомпоновкиДанных.ЗначенияПараметров (DataCompositionResultItem.ParameterValues)
ЭлементРезультатаКомпоновкиДанных (DataCompositionResultItem)
ЗначенияПараметров (ParameterValues)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: ЗначенияПараметровМакетаКомпоновкиДанных.
Значения для параметров макета.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 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С; проверяйте ожидаемый результат на учебном стенде.
Не путайте Элемент.Макет (Строка) с Описание.Макет (объект области). Нельзя присваивать им значения одного вида по сходству имён.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Создать собственный черновик элемента, не выдавая его за готовую строку
Конструктор создаёт пустой собственный контейнер. Сравниваем его с первым настоящим событием, копируем только скалярные сведения и намеренно не подменяем им реальный поток.
Где и как запускать
Полный серверный общий модуль УчебныйПотокСКД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;
Элемент = Процессор.Следующий();
Пока Элемент <> Неопределено Цикл
Если ТипЗнч(Элемент) <> Тип("ЭлементРезультатаКомпоновкиДанных") Тогда
ВызватьИсключение "Ожидался элемент собственного потока компоновки";
КонецЕсли;
КоличествоЭлементов = КоличествоЭлементов + 1;
Если Не Скопировано Тогда
Сообщить(Черновик.ЗначенияПараметров.Количество() = 0);
Сообщить(Черновик.Макеты.Количество() = 0);
Черновик.Макет = Элемент.Макет;
Черновик.ПроцентВывода = Элемент.ПроцентВывода;
Черновик.РасположениеВложенныхЭлементов = Элемент.РасположениеВложенныхЭлементов;
Черновик.ТипЭлемента = Элемент.ТипЭлемента;
Скопировано = Истина;
Сообщить(Черновик.Макет = Элемент.Макет И Черновик.ТипЭлемента = Элемент.ТипЭлемента);
Сообщить(Черновик.ПроцентВывода = Элемент.ПроцентВывода);
КонецЕсли;
Вывод.ВывестиЭлемент(Элемент);
Элемент = Процессор.Следующий();
КонецЦикла;
Итог = Вывод.ЗакончитьВывод();
Если ТипЗнч(Итог) <> Тип("ТаблицаЗначений") Тогда
ВызватьИсключение "Свой генератор должен вернуть таблицу значений";
КонецЕсли;
Сообщить(КоличествоЭлементов > 0);
Сообщить(Итог.Количество() = 2);
Сообщить(Итог.Итог("Количество") = 4);
Сообщить(Итог.Итог("Сумма") = 800);
Сообщить(Скопировано);
КонецПроцедурыРазбор по шагам
Собственная схема создаёт Local-источник и две константные продажи; поля выбираются явно, детальные записи включены.
Компоновщик получает эти настройки и точный ГенераторМакетаКомпоновкиДанныхДляКоллекцииЗначений. Выбор генератора связан с конечным видом приёмника.
Свой процессор инициализируется реальным макетом. Собственный вывод получает пустую ТаблицаЗначений и НачатьВывод до первого элемента.
Следующий возвращает элемент или Неопределено. Перед чтением свойств проверяем тип; внутри полного цикла не пропускаем ни одного элемента.
После диагностики передаём исходный элемент ВывестиЭлемент без изменения. ЗакончитьВывод вызывается после завершения потока; только теперь проверяем готовую таблицу.
Новый ЭлементРезультатаКомпоновкиДанных создаёт свой объект без источника и готовой таблицы. Проверяем две изначально пустые коллекции.
Только при первом реальном событии копируем четыре скалярных свойства в свой черновик. Их значения получены от собственного генератора, не выдуманы.
Коллекции параметров и описаний не копируются. Поэтому черновик — частичная диагностическая заготовка, не функциональная копия элемента.
ВывестиЭлемент получает исходный Элемент, никогда Черновик. Конструктор сам не создаёт третью продажу и не привносит новую строку результата.
Флаг Скопировано проверяет, что настоящий поток был прочитан. Пример не учит отправлять неполный контейнер на вывод.
Как проверить результат
При первом событии четыре сравнения Истина; после полного вывода ещё пять: поток есть, две строки, четыре единицы, сумма 800, скалярные сведения скопированы.
В отладчике черновик содержит значения первого события, но его коллекции остаются пустыми. Не объявляйте это полной копией.
Поиск ВывестиЭлемент(Черновик) в модуле ничего не находит: неполная заготовка не участвует в генерации результата.
Ожидаемый результат
Конструктор изучен в законченной задаче сравнения собственных объектов без фиктивного вывода неполного элемента.
На что обратить внимание
Элемент потока не равен строке исходного запроса. Структурные события, параметры и области макета могут давать другое число элементов, чем число позиций.
ЗначенияПараметров и Макеты — readonly-ссылки на коллекции. Их нельзя присваивать вместо массивов или структур.
Имя макета и параметры принадлежат связанному скомпилированному макету. Не вставляйте произвольное имя области в реально выводимый элемент.
ПроцентВывода — значение события, не число строк и не гарантия измеренного прогресса браузера. В этом уроке не задаём его искусственно.
Все объекты созданы своим запуском в памяти. Примеры не выполнялись в 1С; проверяйте ожидаемый результат на учебном стенде.
Для реального синтетического элемента требуется согласованный макет, параметры и области. Простое копирование четырёх свойств не доказывает пригодность для вывода.
Ожидаемую пустоту нового контейнера нужно проверить в своей реализации 8.5.1.1343; статические проверки не заменяют эту проверку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.