Платформа 3V/Формы/Компоненты/Графики/Гистограмма: различия между версиями
(Полностью удалено содержимое страницы) Метка: очистка |
|||
Строка 1: | Строка 1: | ||
+ | При настройке [[Платформа 3V/Формы/Дашборд|дашборда]] можно создать гистограмму. Гистограмма - способ графического отображения данных в виде столбчатой диаграммы. | ||
+ | == Описание свойств templateOptions == | ||
+ | <div class="NavFrame collapsed"> | ||
+ | <div class="NavHead">Свойства templateOptions</div> | ||
+ | <div class="NavContent"> </br> | ||
+ | |||
+ | {| class="wikitable" style="margin:auto; clear:both;" | ||
+ | |- | ||
+ | ! Наименование !! Свойство !! Тип !! Описание | ||
+ | |- | ||
+ | | Тип диаграммы || '''type''' || строковый || Выбор типа диаграммы | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Заголовок диаграммы''' | ||
+ | |- | ||
+ | | Главный заголовок || '''title''' || строковый || Задание заголовка диаграммы | ||
+ | |- | ||
+ | | Размер шрифта || '''fontSizeTitle''' || строковый || Размер шрифта заголовка диаграммы | ||
+ | |- | ||
+ | | Цвет заголовка || '''titleColor''' || строковый || Настройка цвета заголовка | ||
+ | |- | ||
+ | | Выравнивание по вертикали || '''titleVerticalAlign''' || строковый || Выравнивание заголовка по вертикали | ||
+ | |- | ||
+ | | Отступ сверху || '''titleMargin''' || числовой || Отступ заголовка диаграммы сверху | ||
+ | |- | ||
+ | | Выравнивание по горизонтали || '''titleAlign''' || строковый || Выравнивание заголовка по горизонтали: центр, слева, справа | ||
+ | |- | ||
+ | | Выравнивание по вертикали || '''titleVerticalAlign''' || строковый || Выравнивание заголовка по вертикали: верх, центр, низ | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"|'''Заголовок осей''' | ||
+ | |- | ||
+ | | Заголовок по X || '''textX''' || строковый || Заголовок оси X | ||
+ | |- | ||
+ | | Заголовок по Y || '''textY''' || строковый || Заголовок оси Y | ||
+ | |- | ||
+ | | Включить сортировку || '''dataSorting''' || логический || Флаг, при включении которого к данным применяется сортировка | ||
+ | |- | ||
+ | | Отразить по x || '''xAxisReversed''' || логический || Флаг, при включении которого данные по оси x будут перевернуты | ||
+ | |- | ||
+ | | Отразить по y || '''yAxisReversed''' || логический || Флаг, при включении которого данные по оси y будут перевернуты | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Настройки диаграммы''' | ||
+ | |- | ||
+ | | Показать сетку || '''axisGridLines''' || логический || Флаг, при включении которого данные по оси y будет отображена сетка | ||
+ | |- | ||
+ | | Стиль линий сетки || '''dashStyleAxisGridLines''' || строковый || Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка | ||
+ | |- | ||
+ | | Показать вертикальные линии || '''axisGridLines''' || логический || Флаг, при включении которого по оси y будет отображена сетка | ||
+ | |- | ||
+ | | Цвет вертикальных линий || '''yLineColor''' || строковый || Настройка цвета вертикальных линий | ||
+ | |- | ||
+ | | Цвет линий сетки по X || '''xGridLineColor''' || строковый || Настройка цвета сетки по X | ||
+ | |- | ||
+ | | Цвет линии по X || '''xLineColor''' || строковый || Настройка цвета линии по X | ||
+ | |- | ||
+ | | Цвет линий сетки по Y || '''yGridLineColor''' || строковый || Настройка цвета сетки по X | ||
+ | |- | ||
+ | | Цвет линии по Y || '''yLineColor''' || строковый || Настройка цвета линии по Y | ||
+ | |- | ||
+ | | Ширина диаграммы || '''chartWidth''' || числовой || Настройка ширины области диаграммы | ||
+ | |- | ||
+ | | Высота диаграммы || '''chartHeight''' || числовой || Настройка высоты области диаграммы | ||
+ | |- | ||
+ | | Фон || '''bgColor''' || строковый || Настройка цвета фона диаграммы | ||
+ | |- | ||
+ | | Граница || '''bdWidth''' || строковый || Настройка толщины границы области диаграммы | ||
+ | |- | ||
+ | | Цвет границы || '''bgColor''' || строковый || Настройка цвета границы области диаграммы | ||
+ | |- | ||
+ | | Ширина столбиков || '''colWidth'''|| числовой || Настройка ширины столбиков диаграммы | ||
+ | |- | ||
+ | | Ширина линии графика || '''lineWidth''' || строковый || Настройка ширины линии графика | ||
+ | |- | ||
+ | | Цвет линии графика || '''lineColor''' || строковый || Настройка цвета линии графика | ||
+ | |- | ||
+ | | Вид баров || '''typeBar''' || строковый || Выбор одного из видов баров: Простой, Столбчатая с накоплением, Процент | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Ряды данных''' | ||
+ | |- | ||
+ | | Расположение рядов || '''rowCol'''|| строковый || Выбор расположения рядов: Строка, Столбец | ||
+ | |- | ||
+ | | Номер строка/колонки с заголовками || '''nameColumn''' || строковый || Номер строки/колонки с заголовками | ||
+ | |- | ||
+ | | Номер строка/колонки с подписями || '''nameSing''' || строковый || Номер строки/колонки с подписями | ||
+ | |- | ||
+ | | Скрывать, если данные пустые || '''hideDataIfEmpty''' || логический || Флаг, при включении которого ряды с пустыми данными не отображаются | ||
+ | |- | ||
+ | | Отобразить все данные рядов || '''isAllColumns''' || логический || Флаг, при включении которого отображаются все колонки данными | ||
+ | |- | ||
+ | | Диапазон с данными || '''rowData''' || строковый || Если настройка выше отключена, то должна быть возможность задать диапазон с данными с виде: 1-2 | ||
+ | |- | ||
+ | | Отобразить все ряды || '''isAllRows''' || логический || Флаг, при включении которого отображаются все ряды | ||
+ | |- | ||
+ | | Диапазон с рядами || '''nameColumn''' || строковый || Если настройка выше отключена, то должна быть возможность задать диапазон с рядами с виде: 1-2 | ||
+ | |- | ||
+ | | Скругление углов || '''nameSing''' || строковый || Задание значения скругления углов столбиков диаграммы | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Значение''' | ||
+ | |- | ||
+ | | Отображать максимальные значения || '''showMaxLabels''' || логический || Флаг, при включении которого выводятся максимальные значения | ||
+ | |- | ||
+ | | Отображать значения || '''showLabels''' || логический || Флаг, при включении которого выводятся все значения | ||
+ | |- | ||
+ | | Выравнивание по горизонтали || '''alignLabels''' || строковый || Выравнивание значения по горизонтали: Центр, Слева, Справа | ||
+ | |- | ||
+ | | Выравнивание по вертикали || '''verticalAlignLabels''' || строковый || Выравнивание значения по вертикали: Низ, Центр, Верх | ||
+ | |- | ||
+ | | Цвет значений || '''colorLabels''' || строковый || Настройка цвета текста значений | ||
+ | |- | ||
+ | | Фон значений || '''bgColorLabels''' || строковый || Настройка цвета фона значений | ||
+ | |- | ||
+ | | Контур текста || '''textOutlineLabels''' || логический || Флаг, при включении которого у текста значений будет отображаться контур | ||
+ | |- | ||
+ | | Размер шрифта || '''fontSizeLabels''' || строковый || Настройка размера шрифта значений | ||
+ | |- | ||
+ | | Отступ слева || '''marginLeftLabels''' || числовой || Настройка отступа слева для значений | ||
+ | |- | ||
+ | | Отступ сверху || '''marginTopLabels''' || числовой || Настройка отступа сверху для значений | ||
+ | |- | ||
+ | | Суффикс || '''suffixLabels''' || строковый || Суффикс у значений | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Подписи осей''' | ||
+ | |- | ||
+ | | Отображать подписи || '''showSignatures''' || логический || Флаг, при включении которого отображаются подписи на осях | ||
+ | |- | ||
+ | | Цвет подписи по X || '''xLabelsColor''' || строковый || Настройка цвета подписи по X | ||
+ | |- | ||
+ | | Цвет подписи по Y || '''yLabelsColor''' || строковый || Настройка цвета подписи по Y | ||
+ | |- | ||
+ | | Ограничить подписи || '''shortSignatures''' || логический || Флаг, при включении которого можно ограничить подпись | ||
+ | |- | ||
+ | | Максимальное число символов || '''numberLetters''' || числовой || Настройка количества символов для ограничения подписей | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Легенда''' | ||
+ | |- | ||
+ | | Отображать легенду || '''showLegend''' || логический || Флаг, при включении которого будет отображаться легенда | ||
+ | |- | ||
+ | | Положение || '''positions''' || строковый || Настройка положения легенды: снизу, сверху | ||
+ | |- | ||
+ | | Фон || '''bgColorLegend''' || строковый || Настройка цвета фона легенды | ||
+ | |- | ||
+ | | Граница || '''bdWidthLegend''' || строковый || Настройка ширины границы | ||
+ | |- | ||
+ | | Цвет границы || '''bdColorLegend''' || строковый || Настройка цвета границы | ||
+ | |- | ||
+ | | Отображать тень || '''shadowLegend''' || логический || Флаг, при включении которого у легенды будет отображаться тень | ||
+ | |- | ||
+ | | Радиус скругления символа || '''symbolRadiusLegend''' || числовой || Радиус скругления символа для типов серий. При отрицательном значении выводится квадратный символ | ||
+ | |- | ||
+ | | Выполнить действие при изменении значений || '''doActionOnChangeValue''' || логический || Флаг, включение которого активирует действие при изменении компонента | ||
+ | |- | ||
+ | | CSS классы для компонента || '''className''' || строковый || Описание css классов для компонента | ||
+ | |- | ||
+ | | Описание для шаблона || '''templateDescription''' || строковый || Описание, которое выводится у компонента в режиме шаблона | ||
+ | |- | ||
+ | | Стиль линий сетки || '''dashStyleAxisGridLines''' || строковый || Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка | ||
+ | |- | ||
+ | ! colspan="4" style="text-align:center;"| '''Цвета''' | ||
+ | |- | ||
+ | | Включить градиент || '''colorsGradient''' || логический || Флаг, при включении которого можно задать цвета градиента | ||
+ | |- | ||
+ | | Цвета || '''colors''' || массив || Список заданных цветов | ||
+ | |- | ||
+ | | Цвет || '''color''' || строковый || Настройка цвета для градиента | ||
+ | |} | ||
+ | </div></div> </br> | ||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON гистограммы</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | "key": "1", | ||
+ | "type": "trv-highcharts", | ||
+ | "templateOptions": { | ||
+ | "fontSizeTitle": "20", | ||
+ | "titleAlign": "left", | ||
+ | "dataSorting": false, | ||
+ | "xAxisReversed": false, | ||
+ | "yAxisReversed": false, | ||
+ | "axisGridLines": true, | ||
+ | "dashStyleAxisGridLines": "Solid", | ||
+ | "showYLines": false, | ||
+ | "chartWidth": null, | ||
+ | "chartHeight": null, | ||
+ | "type": "column", | ||
+ | "hardTreeMap": false, | ||
+ | "borderColorTreeMap": "#e6e6e6", | ||
+ | "typeBar": "", | ||
+ | "rowCol": "row", | ||
+ | "pieDir": false, | ||
+ | "pieConnector": false, | ||
+ | "showShadow": false, | ||
+ | "widthShadow": 5, | ||
+ | "opacityShadow": 0.1, | ||
+ | "pieLabelDistance": "30", | ||
+ | "pieInnerSize": "0", | ||
+ | "variablePieSizeByValue": [], | ||
+ | "hideDataIfEmpty": false, | ||
+ | "isAllColumns": true, | ||
+ | "isAllRows": true, | ||
+ | "plotLines": [], | ||
+ | "showMaxLabels": false, | ||
+ | "showLabels": false, | ||
+ | "alignLabels": "center", | ||
+ | "verticalAlignLabels": "bottom", | ||
+ | "colorLabels": "contrast", | ||
+ | "textOutlineLabels": true, | ||
+ | "fontSizeLabels": "11", | ||
+ | "marginLeftLabels": 0, | ||
+ | "marginTopLabels": 0, | ||
+ | "suffixLabels": "", | ||
+ | "showSignatures": true, | ||
+ | "shortSignatures": false, | ||
+ | "numberLetters": 10, | ||
+ | "showLegend": true, | ||
+ | "positions": "bottom", | ||
+ | "bdWidthLegend": 0, | ||
+ | "shadowLegend": false, | ||
+ | "symbolRadiusLegend": 6, | ||
+ | "colorsGradient": false, | ||
+ | "colors": [], | ||
+ | "showCode": false, | ||
+ | "code": "{\n \"title\": {},\n \"chart\": {\n \"type\": \"column\"\n },\n \"xAxis\": {\n \"categories\": [],\n \"title\": {}\n },\n \"yAxis\": {\n \"title\": {}\n },\n \"legend\": {\n \"verticalAlign\": \"bottom\",\n \"borderWidth\": 0,\n \"shadow\": false\n },\n \"plotOptions\": {\n \"series\": {\n \"stacking\": \"\"\n }\n },\n \"series\": [\n {\n \"type\": \"column\",\n \"name\": \"\",\n \"data\": [\n \"{{2:2}}\"\n ]\n }\n ]\n}", | ||
+ | "nameColumn": "1", | ||
+ | "nameSing": "1", | ||
+ | "titleColor": "#888888", | ||
+ | "titleVerticalAlign": "top", | ||
+ | "xGridLineColor": "#000000", | ||
+ | "xLineColor": "#00000", | ||
+ | "yGridLineColor": "#000000", | ||
+ | "yLineColor": "#000000" | ||
+ | }, | ||
+ | "dataSourceId": 309 | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | == Пример использования == | ||
+ | Кейс: Вывести гистограмму, показывающую количество шагов, пройденных за день | ||
+ | [[Файл:Гистограмма3.png|1600px|никакой|центр]] | ||
+ | |||
+ | ====== Создать отчёт с данными, на которых будет строиться гистограмма ====== | ||
+ | [[Файл:Пивот кол-во шагов.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br><br><br><br> | ||
+ | |||
+ | ====== Создать форму ====== | ||
+ | В форму следует добавить источник данных и элемент. | ||
+ | |||
+ | ====== Добавить источник данных - отчет ====== | ||
+ | В форму добавить источник данных - отчет, где "pivotId" - это идентификатор отчета в навигаторе. | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON источника - отчета</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | "pivotId": 100, | ||
+ | "parameters": null, | ||
+ | "focusOnFirstCell": true, | ||
+ | "id": 1, | ||
+ | "name": "Отчет", | ||
+ | "isReadOnly": true, | ||
+ | "dataEditRuleIds": [], | ||
+ | "beforeSaveDataActions": [], | ||
+ | "afterSaveDataActions": [], | ||
+ | "discriminator": "PivotDataSource" | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | ====== Добавить элемент - диаграмма ====== | ||
+ | Добавить в "элементы" диаграмму и задать у нее источник данных - ранее добавленный отчет | ||
+ | |||
+ | [[Файл:источник данный.png|700px|мини|слева]] | ||
+ | |||
+ | <br><br><br><br><br> | ||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | ... | ||
+ | |||
+ | "dataSourceId": 309 | ||
+ | |||
+ | ... | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | ====== Настроить вывод данных ====== | ||
+ | Для того, чтобы данные отображались в виде столбцов, обозначающими кол-во шагов и подписями с датами, необходимо в поле "Расположение рядов" выбрать "столбец" и задать номер строки с подписями | ||
+ | [[Файл:Расположение рядов.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br> | ||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON гистограммы</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | ... | ||
+ | |||
+ | "templateOptions": { | ||
+ | ... | ||
+ | |||
+ | "rowCol": "row", | ||
+ | "nameSing": "1", | ||
+ | |||
+ | ... | ||
+ | }, | ||
+ | |||
+ | ... | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | ====== Настроить заголовок диаграммы ====== | ||
+ | Для того, чтобы создать заголовок достаточно написать его в поле "Главный заголовок". | ||
+ | [[Файл:Настройка заголовка.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br> | ||
+ | Настройка стиля заголовка производится с помощью полей "Размер шрифта" и "Цвет заголовка" | ||
+ | [[Файл:цвет заголовка.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br> | ||
+ | Настройка расположения заголовка производится с помощью полей "Отступ сверху", "Выравнивание по горизонтали" и "Выравнивание по вертикали". | ||
+ | [[Файл:Расположение заголовка.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br> | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON гистограммы</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | ... | ||
+ | |||
+ | "templateOptions": { | ||
+ | ... | ||
+ | |||
+ | "title": "Количество шагов", | ||
+ | "fontSizeTitle": "20", | ||
+ | "titleColor": "#9ed8ed", | ||
+ | "titleMargin": 5, | ||
+ | "titleAlign": "center", | ||
+ | "titleVerticalAlign": "bottom", | ||
+ | |||
+ | ... | ||
+ | }, | ||
+ | |||
+ | ... | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | ====== Настроить сетку ====== | ||
+ | Для того, чтобы отобразить сетку требуется поставить отметку в "Показать сетку". | ||
+ | [[Файл:отображение сетки.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br> | ||
+ | После этого следует настроить цвета отображения сетки. Для того, чтобы одна линия сетки не отображалась нужно настроить ей цвет фона. | ||
+ | [[Файл:цвет сетки.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br> | ||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;">Пример JSON</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | ... | ||
+ | |||
+ | "templateOptions": { | ||
+ | |||
+ | ... | ||
+ | |||
+ | "axisGridLines": true, | ||
+ | "dashStyleAxisGridLines": "Dash", | ||
+ | "xGridLineColor": "#ffffff", | ||
+ | "xLineColor": "#ffffff", | ||
+ | "yGridLineColor": "#6a6a6a", | ||
+ | "yLineColor": "#ffffff", | ||
+ | |||
+ | ... | ||
+ | }, | ||
+ | |||
+ | </syntaxhighlight> | ||
+ | </div></div> | ||
+ | |||
+ | ====== Настроить легенду ====== | ||
+ | |||
+ | Для того, чтобы отобразить сетку следует поставить отметку в "Отображать легенду". Легенду можно расположить сверху и снизу регулируется это полем "Положение". Границу легенды можно задать путем обозначение ее ширины в поле "Граница", её цвет можно настроbть в "Цвет границы". По умолчанию символ в легенде обозначающий цвет данных на диаграмме квадратный, изменить его форму можно в поле "Радиус скругления углов". | ||
+ | [[Файл:Легенда.png|мини|слева]] | ||
+ | <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br> | ||
+ | |||
+ | <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;"> | ||
+ | <div style="font-weight:bold;line-height:1.6;"> Пример JSON гистограммы</div> | ||
+ | <div class="mw-collapsible-content mw-collapsed-content"> | ||
+ | <syntaxhighlight lang="JSON" line> | ||
+ | { | ||
+ | ... | ||
+ | |||
+ | "templateOptions": { | ||
+ | ... | ||
+ | |||
+ | "showLegend": true, | ||
+ | "positions": "bottom", | ||
+ | "bgColorLegend": "#ffffff", | ||
+ | "bdWidthLegend": "1", | ||
+ | "bdColorLegend": "#d2f3ff", | ||
+ | "shadowLegend": false, | ||
+ | "symbolRadiusLegend": "6", | ||
+ | "colorLegend": "#3381be", | ||
+ | |||
+ | ... | ||
+ | } | ||
+ | ... | ||
+ | } | ||
+ | |||
+ | </syntaxhighlight> | ||
+ | </div></div> |
Текущая версия на 08:22, 16 сентября 2021
При настройке дашборда можно создать гистограмму. Гистограмма - способ графического отображения данных в виде столбчатой диаграммы.
Описание свойств templateOptions
Наименование | Свойство | Тип | Описание |
---|---|---|---|
Тип диаграммы | type | строковый | Выбор типа диаграммы |
Заголовок диаграммы | |||
Главный заголовок | title | строковый | Задание заголовка диаграммы |
Размер шрифта | fontSizeTitle | строковый | Размер шрифта заголовка диаграммы |
Цвет заголовка | titleColor | строковый | Настройка цвета заголовка |
Выравнивание по вертикали | titleVerticalAlign | строковый | Выравнивание заголовка по вертикали |
Отступ сверху | titleMargin | числовой | Отступ заголовка диаграммы сверху |
Выравнивание по горизонтали | titleAlign | строковый | Выравнивание заголовка по горизонтали: центр, слева, справа |
Выравнивание по вертикали | titleVerticalAlign | строковый | Выравнивание заголовка по вертикали: верх, центр, низ |
Заголовок осей | |||
Заголовок по X | textX | строковый | Заголовок оси X |
Заголовок по Y | textY | строковый | Заголовок оси Y |
Включить сортировку | dataSorting | логический | Флаг, при включении которого к данным применяется сортировка |
Отразить по x | xAxisReversed | логический | Флаг, при включении которого данные по оси x будут перевернуты |
Отразить по y | yAxisReversed | логический | Флаг, при включении которого данные по оси y будут перевернуты |
Настройки диаграммы | |||
Показать сетку | axisGridLines | логический | Флаг, при включении которого данные по оси y будет отображена сетка |
Стиль линий сетки | dashStyleAxisGridLines | строковый | Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка |
Показать вертикальные линии | axisGridLines | логический | Флаг, при включении которого по оси y будет отображена сетка |
Цвет вертикальных линий | yLineColor | строковый | Настройка цвета вертикальных линий |
Цвет линий сетки по X | xGridLineColor | строковый | Настройка цвета сетки по X |
Цвет линии по X | xLineColor | строковый | Настройка цвета линии по X |
Цвет линий сетки по Y | yGridLineColor | строковый | Настройка цвета сетки по X |
Цвет линии по Y | yLineColor | строковый | Настройка цвета линии по Y |
Ширина диаграммы | chartWidth | числовой | Настройка ширины области диаграммы |
Высота диаграммы | chartHeight | числовой | Настройка высоты области диаграммы |
Фон | bgColor | строковый | Настройка цвета фона диаграммы |
Граница | bdWidth | строковый | Настройка толщины границы области диаграммы |
Цвет границы | bgColor | строковый | Настройка цвета границы области диаграммы |
Ширина столбиков | colWidth | числовой | Настройка ширины столбиков диаграммы |
Ширина линии графика | lineWidth | строковый | Настройка ширины линии графика |
Цвет линии графика | lineColor | строковый | Настройка цвета линии графика |
Вид баров | typeBar | строковый | Выбор одного из видов баров: Простой, Столбчатая с накоплением, Процент |
Ряды данных | |||
Расположение рядов | rowCol | строковый | Выбор расположения рядов: Строка, Столбец |
Номер строка/колонки с заголовками | nameColumn | строковый | Номер строки/колонки с заголовками |
Номер строка/колонки с подписями | nameSing | строковый | Номер строки/колонки с подписями |
Скрывать, если данные пустые | hideDataIfEmpty | логический | Флаг, при включении которого ряды с пустыми данными не отображаются |
Отобразить все данные рядов | isAllColumns | логический | Флаг, при включении которого отображаются все колонки данными |
Диапазон с данными | rowData | строковый | Если настройка выше отключена, то должна быть возможность задать диапазон с данными с виде: 1-2 |
Отобразить все ряды | isAllRows | логический | Флаг, при включении которого отображаются все ряды |
Диапазон с рядами | nameColumn | строковый | Если настройка выше отключена, то должна быть возможность задать диапазон с рядами с виде: 1-2 |
Скругление углов | nameSing | строковый | Задание значения скругления углов столбиков диаграммы |
Значение | |||
Отображать максимальные значения | showMaxLabels | логический | Флаг, при включении которого выводятся максимальные значения |
Отображать значения | showLabels | логический | Флаг, при включении которого выводятся все значения |
Выравнивание по горизонтали | alignLabels | строковый | Выравнивание значения по горизонтали: Центр, Слева, Справа |
Выравнивание по вертикали | verticalAlignLabels | строковый | Выравнивание значения по вертикали: Низ, Центр, Верх |
Цвет значений | colorLabels | строковый | Настройка цвета текста значений |
Фон значений | bgColorLabels | строковый | Настройка цвета фона значений |
Контур текста | textOutlineLabels | логический | Флаг, при включении которого у текста значений будет отображаться контур |
Размер шрифта | fontSizeLabels | строковый | Настройка размера шрифта значений |
Отступ слева | marginLeftLabels | числовой | Настройка отступа слева для значений |
Отступ сверху | marginTopLabels | числовой | Настройка отступа сверху для значений |
Суффикс | suffixLabels | строковый | Суффикс у значений |
Подписи осей | |||
Отображать подписи | showSignatures | логический | Флаг, при включении которого отображаются подписи на осях |
Цвет подписи по X | xLabelsColor | строковый | Настройка цвета подписи по X |
Цвет подписи по Y | yLabelsColor | строковый | Настройка цвета подписи по Y |
Ограничить подписи | shortSignatures | логический | Флаг, при включении которого можно ограничить подпись |
Максимальное число символов | numberLetters | числовой | Настройка количества символов для ограничения подписей |
Легенда | |||
Отображать легенду | showLegend | логический | Флаг, при включении которого будет отображаться легенда |
Положение | positions | строковый | Настройка положения легенды: снизу, сверху |
Фон | bgColorLegend | строковый | Настройка цвета фона легенды |
Граница | bdWidthLegend | строковый | Настройка ширины границы |
Цвет границы | bdColorLegend | строковый | Настройка цвета границы |
Отображать тень | shadowLegend | логический | Флаг, при включении которого у легенды будет отображаться тень |
Радиус скругления символа | symbolRadiusLegend | числовой | Радиус скругления символа для типов серий. При отрицательном значении выводится квадратный символ |
Выполнить действие при изменении значений | doActionOnChangeValue | логический | Флаг, включение которого активирует действие при изменении компонента |
CSS классы для компонента | className | строковый | Описание css классов для компонента |
Описание для шаблона | templateDescription | строковый | Описание, которое выводится у компонента в режиме шаблона |
Стиль линий сетки | dashStyleAxisGridLines | строковый | Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка |
Цвета | |||
Включить градиент | colorsGradient | логический | Флаг, при включении которого можно задать цвета градиента |
Цвета | colors | массив | Список заданных цветов |
Цвет | color | строковый | Настройка цвета для градиента |
1 {
2 "key": "1",
3 "type": "trv-highcharts",
4 "templateOptions": {
5 "fontSizeTitle": "20",
6 "titleAlign": "left",
7 "dataSorting": false,
8 "xAxisReversed": false,
9 "yAxisReversed": false,
10 "axisGridLines": true,
11 "dashStyleAxisGridLines": "Solid",
12 "showYLines": false,
13 "chartWidth": null,
14 "chartHeight": null,
15 "type": "column",
16 "hardTreeMap": false,
17 "borderColorTreeMap": "#e6e6e6",
18 "typeBar": "",
19 "rowCol": "row",
20 "pieDir": false,
21 "pieConnector": false,
22 "showShadow": false,
23 "widthShadow": 5,
24 "opacityShadow": 0.1,
25 "pieLabelDistance": "30",
26 "pieInnerSize": "0",
27 "variablePieSizeByValue": [],
28 "hideDataIfEmpty": false,
29 "isAllColumns": true,
30 "isAllRows": true,
31 "plotLines": [],
32 "showMaxLabels": false,
33 "showLabels": false,
34 "alignLabels": "center",
35 "verticalAlignLabels": "bottom",
36 "colorLabels": "contrast",
37 "textOutlineLabels": true,
38 "fontSizeLabels": "11",
39 "marginLeftLabels": 0,
40 "marginTopLabels": 0,
41 "suffixLabels": "",
42 "showSignatures": true,
43 "shortSignatures": false,
44 "numberLetters": 10,
45 "showLegend": true,
46 "positions": "bottom",
47 "bdWidthLegend": 0,
48 "shadowLegend": false,
49 "symbolRadiusLegend": 6,
50 "colorsGradient": false,
51 "colors": [],
52 "showCode": false,
53 "code": "{\n \"title\": {},\n \"chart\": {\n \"type\": \"column\"\n },\n \"xAxis\": {\n \"categories\": [],\n \"title\": {}\n },\n \"yAxis\": {\n \"title\": {}\n },\n \"legend\": {\n \"verticalAlign\": \"bottom\",\n \"borderWidth\": 0,\n \"shadow\": false\n },\n \"plotOptions\": {\n \"series\": {\n \"stacking\": \"\"\n }\n },\n \"series\": [\n {\n \"type\": \"column\",\n \"name\": \"\",\n \"data\": [\n \"{{2:2}}\"\n ]\n }\n ]\n}",
54 "nameColumn": "1",
55 "nameSing": "1",
56 "titleColor": "#888888",
57 "titleVerticalAlign": "top",
58 "xGridLineColor": "#000000",
59 "xLineColor": "#00000",
60 "yGridLineColor": "#000000",
61 "yLineColor": "#000000"
62 },
63 "dataSourceId": 309
64 }
Пример использования
Кейс: Вывести гистограмму, показывающую количество шагов, пройденных за день
Создать отчёт с данными, на которых будет строиться гистограмма
Создать форму
В форму следует добавить источник данных и элемент.
Добавить источник данных - отчет
В форму добавить источник данных - отчет, где "pivotId" - это идентификатор отчета в навигаторе.
1 {
2 "pivotId": 100,
3 "parameters": null,
4 "focusOnFirstCell": true,
5 "id": 1,
6 "name": "Отчет",
7 "isReadOnly": true,
8 "dataEditRuleIds": [],
9 "beforeSaveDataActions": [],
10 "afterSaveDataActions": [],
11 "discriminator": "PivotDataSource"
12 }
Добавить элемент - диаграмма
Добавить в "элементы" диаграмму и задать у нее источник данных - ранее добавленный отчет
1 {
2 ...
3
4 "dataSourceId": 309
5
6 ...
7 }
Настроить вывод данных
Для того, чтобы данные отображались в виде столбцов, обозначающими кол-во шагов и подписями с датами, необходимо в поле "Расположение рядов" выбрать "столбец" и задать номер строки с подписями
1 {
2 ...
3
4 "templateOptions": {
5 ...
6
7 "rowCol": "row",
8 "nameSing": "1",
9
10 ...
11 },
12
13 ...
14 }
Настроить заголовок диаграммы
Для того, чтобы создать заголовок достаточно написать его в поле "Главный заголовок".
Настройка стиля заголовка производится с помощью полей "Размер шрифта" и "Цвет заголовка"
Настройка расположения заголовка производится с помощью полей "Отступ сверху", "Выравнивание по горизонтали" и "Выравнивание по вертикали".
1 {
2 ...
3
4 "templateOptions": {
5 ...
6
7 "title": "Количество шагов",
8 "fontSizeTitle": "20",
9 "titleColor": "#9ed8ed",
10 "titleMargin": 5,
11 "titleAlign": "center",
12 "titleVerticalAlign": "bottom",
13
14 ...
15 },
16
17 ...
18 }
Настроить сетку
Для того, чтобы отобразить сетку требуется поставить отметку в "Показать сетку".
После этого следует настроить цвета отображения сетки. Для того, чтобы одна линия сетки не отображалась нужно настроить ей цвет фона.
1 {
2 ...
3
4 "templateOptions": {
5
6 ...
7
8 "axisGridLines": true,
9 "dashStyleAxisGridLines": "Dash",
10 "xGridLineColor": "#ffffff",
11 "xLineColor": "#ffffff",
12 "yGridLineColor": "#6a6a6a",
13 "yLineColor": "#ffffff",
14
15 ...
16 },
Настроить легенду
Для того, чтобы отобразить сетку следует поставить отметку в "Отображать легенду". Легенду можно расположить сверху и снизу регулируется это полем "Положение". Границу легенды можно задать путем обозначение ее ширины в поле "Граница", её цвет можно настроbть в "Цвет границы". По умолчанию символ в легенде обозначающий цвет данных на диаграмме квадратный, изменить его форму можно в поле "Радиус скругления углов".
1 {
2 ...
3
4 "templateOptions": {
5 ...
6
7 "showLegend": true,
8 "positions": "bottom",
9 "bgColorLegend": "#ffffff",
10 "bdWidthLegend": "1",
11 "bdColorLegend": "#d2f3ff",
12 "shadowLegend": false,
13 "symbolRadiusLegend": "6",
14 "colorLegend": "#3381be",
15
16 ...
17 }
18 ...
19 }