Платформа 3V/Формы/Компоненты/Графики/Гистограмма

Материал из 3v-wiki
< Платформа 3V‎ | Формы‎ | Компоненты‎ | Графики
Версия от 08:22, 16 сентября 2021; A.kazanceva (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

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

Описание свойств templateOptions


Пример JSON гистограммы
 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         }

Пример использования

Кейс: Вывести гистограмму, показывающую количество шагов, пройденных за день

никакой
Создать отчёт с данными, на которых будет строиться гистограмма
Пивот кол-во шагов.png














Создать форму

В форму следует добавить источник данных и элемент.

Добавить источник данных - отчет

В форму добавить источник данных - отчет, где "pivotId" - это идентификатор отчета в навигаторе.

Пример JSON источника - отчета
 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     }
Добавить элемент - диаграмма

Добавить в "элементы" диаграмму и задать у нее источник данных - ранее добавленный отчет

источник данный.png






Пример JSON
1 {      
2       ...   
3 
4       "dataSourceId": 309
5      
6       ...
7 }
Настроить вывод данных

Для того, чтобы данные отображались в виде столбцов, обозначающими кол-во шагов и подписями с датами, необходимо в поле "Расположение рядов" выбрать "столбец" и задать номер строки с подписями

Расположение рядов.png











Пример JSON гистограммы
 1 {
 2           ...
 3 
 4           "templateOptions": {
 5            ...
 6 
 7             "rowCol": "row",            
 8             "nameSing": "1",
 9 
10            ...
11           },
12 
13           ...
14 }
Настроить заголовок диаграммы

Для того, чтобы создать заголовок достаточно написать его в поле "Главный заголовок".

Настройка заголовка.png




















Настройка стиля заголовка производится с помощью полей "Размер шрифта" и "Цвет заголовка"

цвет заголовка.png





















Настройка расположения заголовка производится с помощью полей "Отступ сверху", "Выравнивание по горизонтали" и "Выравнивание по вертикали".

Расположение заголовка.png











Пример JSON гистограммы
 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 }
Настроить сетку

Для того, чтобы отобразить сетку требуется поставить отметку в "Показать сетку".

отображение сетки.png








После этого следует настроить цвета отображения сетки. Для того, чтобы одна линия сетки не отображалась нужно настроить ей цвет фона.

цвет сетки.png






















Пример JSON
 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ть в "Цвет границы". По умолчанию символ в легенде обозначающий цвет данных на диаграмме квадратный, изменить его форму можно в поле "Радиус скругления углов".

Легенда.png






















Пример JSON гистограммы
 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 }