ИспользованиеПараметраКомпоновкиДанных.Авто: свой отчёт по книгам

Точное имя параметра / свойство схемы и собственный источник передаются настоящему конвейеру формирования СКД.

Подготовка

1. В своей учебной конфигурации создайте Отчеты → УчебныеКнигиСКД. У отчёта откройте ОсновнаяСхемаКомпоновкиДанных и сохраните её макетом ОсновнаяСхемаКомпоновкиДанных.

2. В конструкторе СКД создайте источник Local и набор-запрос Книги. Вставьте приведённый запрос двух константных строк; это не чтение рабочих справочников. Доступные поля Наименование, Количество, Сумма заполните автоматически.

3. В настройках схемы создайте вариант Подробно: выбраны Наименование, Количество, Сумма; структура — группировка Детальные записи. Второй вариант Кратко: Наименование и Сумма, также Детальные записи. Первым оставьте Подробно; у обоих задайте понятное представление.

4. В схеме на вкладке Ресурсы добавьте Количество с выражением Сумма(Количество) и Сумма с выражением Сумма(Сумма). Существующие варианты Подробно / Кратко не заменяйте.

5. Добавьте вариант УчебныеИтоги: структура — группировка по Наименование с детальными записями внутри; в выбранных полях Наименование, Количество и Сумма. В порядке укажите Наименование по возрастанию. Наименование сделайте узкой колонкой ширины 12 для опыта с длинным текстом.

6. Для диаграмм добавьте отдельный вариант УчебнаяДиаграмма: структура — Диаграмма, точки по Наименование, ресурсы Количество и Сумма; тип Гистограмма. Это два условных показателя разных единиц — опыт оформления, не готовый управленческий график.

7. Создайте обычную форму собственной обработки в толстом клиенте. Основной полный обработчик назначьте кнопке ПоказатьПример. Две дополнительные процедуры / функции разместите отдельно в том же модуле.

8. Схема берётся из собственного общего макета отчёта. Названия вариантов и полей — контракт подготовки, а не проверка имени конфигурации / версии платформы. Макет обратно в конфигурацию не записывается.

9. В своей копии схемы замените запрос набора Книги дополнительным запросом с настоящим параметром МинимумКоличества. Автоматически заполните три поля и параметр. Параметр Число 10.0, начальное значение 0.

10. Существующий вариант УчебныеИтоги оставьте. Код получает уже существующий параметр схемы по имени и меняет его Использование до инициализации компоновщика.

Процедура ПоказатьПример(Кнопка)
    Схема = Отчеты.УчебныеКнигиСКД.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");
    Параметр = Схема.Параметры.Найти("МинимумКоличества");
    Если Параметр = Неопределено Тогда
        ВызватьИсключение "Добавьте параметр собственного запроса МинимумКоличества";
    КонецЕсли;
    Параметр.Использование = ИспользованиеПараметраКомпоновкиДанных.Авто;
    Компоновщик = УчебныйКомпоновщик(Схема, "УчебныеИтоги");
    Настройки = Компоновщик.Настройки;
    Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("МинимумКоличества", 4);
    ВывестиУчебнуюКомпоновку(Схема, Настройки);
    Сообщить("Применён режим: Авто");
КонецПроцедуры

ВЫБРАТЬ Книги.Наименование, Книги.Количество, Книги.Сумма
ИЗ
    (ВЫБРАТЬ "Учебная книга" КАК Наименование, 3 КАК Количество, 750 КАК Сумма
    ОБЪЕДИНИТЬ ВСЕ
    ВЫБРАТЬ "Учебная тетрадь", 5, 200) КАК Книги
ГДЕ Книги.Количество >= &МинимумКоличества

Функция УчебныйКомпоновщик(Схема, ИмяВарианта)
    Источник = Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема);
    Компоновщик = Новый КомпоновщикНастроекКомпоновкиДанных;
    Компоновщик.Инициализировать(Источник);
    Для Каждого Вариант Из Схема.ВариантыНастроек Цикл
        Если Вариант.Имя = ИмяВарианта Тогда
            Компоновщик.ЗагрузитьНастройки(Вариант.Настройки);
            Возврат Компоновщик;
        КонецЕсли;
    КонецЦикла;
    ВызватьИсключение "Создайте собственный вариант схемы: " + ИмяВарианта;
КонецФункции

Процедура ВывестиУчебнуюКомпоновку(Схема, Настройки)
    Расшифровка = Новый ДанныеРасшифровкиКомпоновкиДанных;
    КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
    Макет = КомпоновщикМакета.Выполнить(Схема, Настройки, Расшифровка);
    Процессор = Новый ПроцессорКомпоновкиДанных;
    Процессор.Инициализировать(Макет, , Расшифровка);
    Лист = Новый ТабличныйДокумент;
    Вывод = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    Вывод.УстановитьДокумент(Лист);
    Вывод.Вывести(Процессор);
    Сообщить("Макетов областей: " + Строка(Макет.Макеты.Количество()));
    Сообщить("Элементов расшифровки: " + Строка(Расшифровка.Элементы.Количество()));
    Лист.Показать("Собственная компоновка учебных книг");
КонецПроцедуры

Разбор по шагам

1. Подготовьте собственную схему и указанный вариант.

2. Примените режим к реальному параметру / группировке.

3. Передайте изменённую схему и настройки в формирование и сравните результат.

Как проверить результат

1. В запросе используется настоящий &МинимумКоличества. Значение 4 устанавливается в полные настройки и включает использование значения: в результате остаётся тетрадь с количеством 5.

2. Авто определяет необходимость параметра из настроек; Всегда считает его используемым всегда. В этом запросе параметр обязателен, поэтому оба режима дают одинаковый отбор — различие поведения здесь не выдумывается.

Ожидаемый результат

Режим используется в настоящем выводе двух учебных строк, без записи настроек рабочей базы.

На что обратить внимание

1. ПараметрыВывода и ПараметрыДанных — разные коллекции. УстановитьЗначениеПараметра не создаёт неизвестное имя для маскировки ошибки.

2. BSL, формирование отчёта и печать при сборке HTML не выполнялись.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.