Тип: Строка. Исходный текст запроса построителя отчета.
Полное описание, параметры и ограничения
ПостроительОтчета.Текст (ReportBuilder.Text)
ПостроительОтчета (ReportBuilder)
Текст (Text)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Исходный текст запроса построителя отчета.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Построить отчёт запросом только к собственным параметрам
Контраст с табличным источником: Текст запроса, структура Параметры, автозаполнение настроек, ПолучитьЗапрос и Результат.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Учебная внешняя обработка с пустой управляемой основной формой. Создайте команду УчебныйПример, кнопку команды и назначьте действие УчебныйПример.
Вставьте полный модуль урока: клиентский обработчик и серверную функцию. Каждый урок — отдельная копия модуля.
Откройте EPF в тонком клиенте Windows. Данные Книга/Ручка/Коробка создаются только в памяти; запрос урока с параметрами не читает таблицы базы.
ПостроительОтчета — существующий API для изучения/сопровождения старого кода. Это не СистемаКомпоновкиДанных и не рекомендация заменять ею современные отчёты.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = СформироватьУчебныйОтчет();
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Учебный ПостроительОтчета");
КонецПроцедуры
&НаСервере
Функция СформироватьУчебныйОтчет()
Построитель = Новый ПостроительОтчета;
Построитель.Текст = "ВЫБРАТЬ &Название КАК Наименование, &Количество КАК Количество";
Построитель.Параметры.Вставить("Название", "Учебная книга");
Построитель.Параметры.Вставить("Количество", 3);
Построитель.АвтоДетальныеЗаписи = Ложь;
Построитель.ВыводитьДетальныеЗаписи = Истина;
Построитель.ВыводитьЗаголовокОтчета = Истина;
Построитель.ВыводитьОбщиеИтоги = Ложь;
Построитель.ВыводитьПодвалОтчета = Ложь;
Построитель.ВыводитьПодвалТаблицы = Ложь;
Построитель.ВыводитьШапкуТаблицы = Истина;
Построитель.ОтображатьСостояние = Ложь;
Построитель.ОбрабатыватьПрерываниеПользователя = Истина;
Построитель.ТекстЗаголовка = "Учебный отчёт — вымышленные данные";
Построитель.ЗаполнитьНастройки();
Запрос = Построитель.ПолучитьЗапрос();
ПроверочныйРезультат = Запрос.Выполнить();
ПроверочныеСтроки = ПроверочныйРезультат.Выгрузить();
Сообщить(ПроверочныеСтроки.Количество() = 1);
Сообщить(ПроверочныеСтроки.Получить(0).Наименование = "Учебная книга");
Сообщить(ПроверочныеСтроки.Получить(0).Количество = 3);
Построитель.Выполнить();
Строки = Построитель.Результат.Выгрузить();
Сообщить(Строки.Количество() = 1);
Сообщить(Строки.Получить(0).Количество = 3);
ТабДок = Новый ТабличныйДокумент;
Построитель.Вывести(ТабДок);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Запрос ВЫБРАТЬ использует два параметра и не имеет ИЗ: никакие таблицы информационной базы не читаются.
Параметры у построителя — Структура; заполняем их до получения/выполнения запроса.
ЗаполнитьНастройки применяется к Текст, в отличие от урока с ИсточникДанных.
ПолучитьЗапрос доступен, поскольку ИсточникДанных не установлен. Для проверки выполняем полученный Запрос.
Выполнить у построителя формирует его Результат; проверяем его независимо. Вывести затем формирует табличный документ.
Как проверить результат
Пять сравнений Истина: в обоих результатах одна строка Учебная книга с количеством 3.
В отчёте два собственных поля, никаких данных рабочего справочника.
Измените параметр количества на 4: оба результата и вывод поменяются; соответствующие контрольные сравнения также измените.
Ожидаемый результат
Разобраны запросный режим и два разных результата без зависимости от конфигурации базы.
На что обратить внимание
Параметры запроса — не подстановка произвольного SQL/BSL в текст.
ПолучитьЗапрос нельзя использовать при установленном ИсточникДанных.
Запрос выполняется дважды только для сравнения API в уроке; в рабочем решении не повторяйте тяжёлый запрос без причины.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.