Значения параметров вывода для группировок диаграмм. Содержит значения следующих параметров: 1. КоличествоЗаписей (RecordsCount) - количество записей, которое необходимо выводить в группировке (тип Число); 2. ПроцентЗаписей (RecordsPercent) - процент от общего количества записей, выводимый в группировке (тип Число).
Полное описание, параметры и ограничения
ЗначенияПараметровВыводаГруппировкиДиаграммыКомпоновкиДанных (DataCompositionChartGroupOutputParameterValues)
ЗначенияПараметровВыводаГруппировкиДиаграммыКомпоновкиДанных (DataCompositionChartGroupOutputParameterValues)
Доступен, начиная с версии 8.1.
Свойства:
ДоступныеПараметры (AvailableParameters)
Элементы (Items)
Методы:
НайтиЗначениеПараметра (FindParameterValue)
ПолучитьИдентификаторПоОбъекту (GetIDByObject)
ПолучитьОбъектПоИдентификатору (GetObjectByID)
УстановитьЗначениеПараметра (SetParameterValue)
Описание:
Значения параметров вывода для группировок диаграмм.
Содержит значения следующих параметров:
1. КоличествоЗаписей (RecordsCount) - количество записей, которое необходимо выводить в группировке (тип Число);
2. ПроцентЗаписей (RecordsPercent) - процент от общего количества записей, выводимый в группировке (тип Число).
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Данный объект может быть сериализован в/из XML. Может использоваться в реквизитах управляемой формы. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data-composition-system/settings}. Имя типа XDTO: ChartGroupOutputParameterValues.
См. также:
ГруппировкаТаблицыКомпоновкиДанных, свойство ПараметрыВывода
ГруппировкаДиаграммыКомпоновкиДанных, свойство ПараметрыВывода
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Задать заголовок диаграммы и лимит выводимых групп
У диаграммы задаём тип и заголовок, а у группы серий — КоличествоЗаписей и ПроцентЗаписей. Находим конкретные параметры и проверяем их значения, не смешивая лимит с отбором продаж.
Где и как запускать
Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.
Подготовка
Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.
Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.
В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.
Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.
Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.
Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.
Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.
Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
Диаграмма.Использование = Истина;
Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбранное.Использование = Истина;
Серия = Диаграмма.Серии.Добавить();
Серия.Имя = "Магазины";
Серия.Использование = Истина;
ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеСерии.Использование = Истина;
Точка = Диаграмма.Точки.Добавить();
Точка.Имя = "Товары";
Точка.Использование = Истина;
ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТочки.Использование = Истина;
Диаграмма.ПараметрыВывода.УстановитьЗначениеПараметра("Заголовок", "Сравнение магазинов");
Диаграмма.ПараметрыВывода.УстановитьЗначениеПараметра("ТипДиаграммы", ТипДиаграммы.Гистограмма);
Серия.ПараметрыВывода.УстановитьЗначениеПараметра("КоличествоЗаписей", 1);
Серия.ПараметрыВывода.УстановитьЗначениеПараметра("ПроцентЗаписей", 100);
Заголовок = Диаграмма.ПараметрыВывода.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("Заголовок"));
Лимит = Серия.ПараметрыВывода.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("КоличествоЗаписей"));
Процент = Серия.ПараметрыВывода.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("ПроцентЗаписей"));
Если Заголовок = Неопределено ИЛИ Лимит = Неопределено ИЛИ Процент = Неопределено Тогда
ВызватьИсключение "Не найдены собственные параметры вывода";
КонецЕсли;
Сообщить(Заголовок.Значение = "Сравнение магазинов");
Сообщить(Лимит.Значение = 1 И Процент.Значение = 100);
Сообщить(Серия.ПараметрыВывода.Элементы.Количество() = 2);
Сообщить(Серия.Отбор.Элементы.Количество() = 0);
Сообщить(ТипЗнч(Серия.ПараметрыВывода.ДоступныеПараметры) = Тип("ДоступныеПараметрыКомпоновкиДанных"));
Сообщить(ТипЗнч(Диаграмма.ПараметрыВывода.ДоступныеПараметры) = Тип("ДоступныеПараметрыКомпоновкиДанных"));
КонецПроцедурыРазбор по шагам
Типы контейнеров параметров диаграммы и группировки различны. Заголовок ставим только там, где он описан в справке.
КоличествоЗаписей ограничивает число выводимых групп, а ПроцентЗаписей задаёт процент. Значение 100 не задаёт условие на поле Сумма.
УстановитьЗначениеПараметра принимает имя строкой; для НайтиЗначениеПараметра создаём ПараметрКомпоновкиДанных.
До чтения Значение проверяем результат поиска. Затем проверяем локальные значения и пустой отбор.
ДоступныеПараметры и Элементы — разные понятия: описания разрешённых параметров и фактически заданные значения.
Как проверить результат
Ожидаются шесть сравнений Истина. В группе заданы ровно два значения параметров вывода.
Лимит 1 сам по себе не означает магазин с наибольшей суммой. Для задачи топ-1 добавьте порядок по Сумма по убыванию и проверьте итог отдельной компоновкой.
Ожидаемый результат
Настроены и найдены параметры в их собственных контейнерах, без выдуманного заголовка группировки диаграммы.
На что обратить внимание
У группы диаграммы нет параметра Заголовок: не копируйте настройки обычной группировки без проверки типа.
Ограничение вывода не удаляет продажи из источника и не заменяет отбор.
Состав доступных параметров не равен количеству заданных значений; фиксированное число доступных описаний не предполагается.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Подготовить топ-1 магазинов по сумме, а не по алфавиту
Комбинируем порядок по ресурсу Сумма по убыванию с лимитом одного магазина. Для собственных данных ожидаемый лидер Север — 800, а не Юг — 500.
Где и как запускать
Полный код серверного общего модуля УчебныеДиаграммы85. ВыполнитьПример() вызывается из собственного серверного обработчика учебной команды. Код не запускается автоматически в справочнике.
Подготовка
Работайте в отдельной учебной базе на платформе 8.5.1.1343. Справочники, документы, регистры и готовые макеты не нужны.
Создайте общий модуль УчебныеДиаграммы85: Сервер — Да, Клиент — Нет, Привилегированный — Нет. Полностью вставьте код одного урока, а не оборачивайте его второй процедурой.
В своей учебной обработке добавьте команду. Из её серверного обработчика вызовите УчебныеДиаграммы85.ВыполнитьПример();. Не вызывайте серверные объекты СКД непосредственно из тонкого клиента.
Запрос содержит только три собственные константные строки: Север/Книга — 750, Север/Ручка — 50, Юг/Книга — 500. Продажи Севера — 800, Юга — 500, общая сумма — 1300.
Серии будут магазинами, точки — товарами, ресурс — суммой продаж. Значение Книга складывается до 1250, Ручка — до 50. Количество единиц по всем строкам — 6, а число строк источника — 3.
Каждый урок запускайте отдельно: он заново создаёт схему и настройки в памяти. Упражнения с настройками не формируют отчёт; отдельный урок показывает компоновку и вывод.
Для просмотра объектов поставьте точку останова перед последними Сообщить. ТабличныйДокумент результата урока вывода находится в серверной переменной Результат; код не печатает, не сохраняет файл и не открывает окно клиента.
Запуск в 1С здесь не проверялся. Приведены ожидаемые проверки собственной задачи, а не доказательство успешного формирования отчёта в любой конфигурации.
Процедура ВыполнитьПример() Экспорт
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныеПродажи";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "СвоиТриСтроки";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Север"" КАК Магазин,
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Север"", ""Ручка"", 1, 50
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Юг"", ""Книга"", 2, 500";
Для Каждого ИмяРесурса Из СтрРазделить("Сумма,Количество", ",") Цикл
Ресурс = Схема.ПоляИтога.Добавить();
Ресурс.ПутьКДанным = ИмяРесурса;
Ресурс.Выражение = "Сумма(" + ИмяРесурса + ")";
КонецЦикла;
Настройки = Схема.НастройкиПоУмолчанию;
Диаграмма = Настройки.Структура.Добавить(Тип("ДиаграммаКомпоновкиДанных"));
Диаграмма.Имя = "УчебныеПродажиПоМагазинам";
Диаграмма.Использование = Истина;
Выбранное = Диаграмма.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных("Сумма");
Выбранное.Использование = Истина;
Серия = Диаграмма.Серии.Добавить();
Серия.Имя = "Магазины";
Серия.Использование = Истина;
ПолеСерии = Серия.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеСерии.Поле = Новый ПолеКомпоновкиДанных("Магазин");
ПолеСерии.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеСерии.Использование = Истина;
Точка = Диаграмма.Точки.Добавить();
Точка.Имя = "Товары";
Точка.Использование = Истина;
ПолеТочки = Точка.ПоляГруппировки.Элементы.Добавить(Тип("ПолеГруппировкиКомпоновкиДанных"));
ПолеТочки.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПолеТочки.ТипГруппировки = ТипГруппировкиКомпоновкиДанных.Элементы;
ПолеТочки.Использование = Истина;
ПорядокЛидеров = Серия.Порядок.Элементы.Добавить(Тип("ЭлементПорядкаКомпоновкиДанных"));
ПорядокЛидеров.Поле = Новый ПолеКомпоновкиДанных("Сумма");
ПорядокЛидеров.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв;
ПорядокЛидеров.Использование = Истина;
Серия.ПараметрыВывода.УстановитьЗначениеПараметра("КоличествоЗаписей", 1);
Лимит = Серия.ПараметрыВывода.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("КоличествоЗаписей"));
Если Лимит = Неопределено Тогда
ВызватьИсключение "Не найден лимит собственного топа";
КонецЕсли;
Сообщить(ПорядокЛидеров.Поле = Новый ПолеКомпоновкиДанных("Сумма"));
Сообщить(ПорядокЛидеров.Использование И ПорядокЛидеров.ТипУпорядочивания = НаправлениеСортировкиКомпоновкиДанных.Убыв);
Сообщить(Серия.Порядок.Элементы.Количество() = 1);
Сообщить(Лимит.Значение = 1);
Сообщить(Серия.Отбор.Элементы.Количество() = 0);
КонецПроцедурыРазбор по шагам
Сумма — ресурс с выражением Сумма(Сумма). Лидер выбирается по сумме магазина, не по отдельной продаже.
Порядок создаём внутри серии магазинов и направляем по убыванию агрегированного ресурса.
Лимит КоличествоЗаписей ставим в параметрах этой же группировки. Он не задаёт порог Сумма > 1.
Проверяем обе составляющие топа: поле и направление порядка, а также найденное значение лимита.
Чтобы сформировать диаграмму, перенесите настройку перед компоновкой урока вывода. Этот урок ещё не запускает процессор.
Как проверить результат
Ожидаются пять сравнений Истина. Суммы собственной задачи: Север 750 + 50 = 800, Юг 500.
Для проверки измените продажу Юга с 500 на 900 и сформируйте результат в учебной базе: ожидаемый лидер станет Юг. Контрольную сумму исходного запроса в уроке вывода также обновите до 1700.
Ожидаемый результат
Подготовлена проверяемая настройка топ-1 с сортировкой по нужному ресурсу.
На что обратить внимание
Лимит без порядка не гарантирует выбор максимальной суммы.
Если суммы равны, одно поле сортировки не задаёт однозначный порядок лидеров: добавьте дополнительное поле.
Фактический топ проверяется по результату компоновки, а не только по значениям настроек.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.