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