Платформа 3V/Формы/Компоненты/Графики/Датчик Спидометр: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 15: Строка 15:
 
| Заголовок || '''title''' || строковый || Задание заголовка диаграммы
 
| Заголовок || '''title''' || строковый || Задание заголовка диаграммы
 
|-
 
|-
| Расположение заголовка || '''titleAlign''' || строковый || Выравнивание заголовка по горизонтали: центр, слева, справа
+
| Расположение заголовка || '''titleAlign''' || строковый || Выравнивание заголовка по горизонтали: По центру, Слева, Справа
 
|-
 
|-
 
| Цвет заголовка || '''titleColor''' || строковый || Настройка цвета заголовка
 
| Цвет заголовка || '''titleColor''' || строковый || Настройка цвета заголовка
Строка 71: Строка 71:
 
! colspan="4" style="text-align:center;"| '''Настройка данных'''
 
! colspan="4" style="text-align:center;"| '''Настройка данных'''
 
|-
 
|-
| Колонка || '''seriesData.col'''|| числовой || Номер колонки
+
| Колонка || '''seriesData.col'''|| числовой || Номер колонки для серии данных
 
|-
 
|-
 
| Название || '''seriesData.name'''|| строковый || Задание названия колонки
 
| Название || '''seriesData.name'''|| строковый || Задание названия колонки
Строка 95: Строка 95:
 
| Радиус (%) || '''seriesData.arrow.radius''' || логический || Настройка длины стрелки в процентах
 
| Радиус (%) || '''seriesData.arrow.radius''' || логический || Настройка длины стрелки в процентах
 
|-
 
|-
| Цвет || '''seriesData.arrow.backgroundColor''' || логический || Настройка цвета стрелки
+
| Цвет || '''seriesData.arrow.backgroundColor''' || строковый || Настройка цвета стрелки
 
|-
 
|-
| Ширина у основания || '''seriesData.arrow.baseWidth''' || логический || Настройка ширины стрелки у основания
+
| Ширина у основания || '''seriesData.arrow.baseWidth''' || числовой || Настройка ширины стрелки у основания
 
|-
 
|-
| Ширина у вершины || '''seriesData.arrow.topWidth''' || логический || Настройки ширины стрелки у её вершины
+
| Ширина у вершины || '''seriesData.arrow.topWidth''' || числовой || Настройки ширины стрелки у её вершины
 
|-
 
|-
| Отступ от точки(края) || '''seriesData.arrow.baseLength''' || логический || Настройка отступа от точки основания
+
| Отступ от точки(края) || '''seriesData.arrow.baseLength''' || числовой || Настройка отступа от точки основания
 
|-
 
|-
| Отступ от точки(основание) || '''seriesData.arrow.rearLength''' || логический || Настройка продолжения стрелки в сторону точки основания
+
| Отступ от точки(основание) || '''seriesData.arrow.rearLength''' || числовой || Настройка продолжения стрелки в сторону точки основания
 
|-
 
|-
 
! colspan="4" style="text-align:center;"| '''Настройка точки'''
 
! colspan="4" style="text-align:center;"| '''Настройка точки'''
 
|-
 
|-
| Радиус точки || '''seriesData.arrow.point.radius''' || логический || Настройка размера точки
+
| Радиус точки || '''seriesData.arrow.point.radius''' || числовой || Настройка размера точки
 
|-
 
|-
| Цвет точки || '''seriesData.arrow.point.color''' || логический || Настройка цвета точки
+
| Цвет точки || '''seriesData.arrow.point.color''' || строковый || Настройка цвета точки
 
|-
 
|-
 
| Редактирование конфигурации || '''chartOptions''' || строковый || Дополнительные настройки из [https://api.highcharts.com/gantt/# highcharts]
 
| Редактирование конфигурации || '''chartOptions''' || строковый || Дополнительные настройки из [https://api.highcharts.com/gantt/# highcharts]

Версия 13:16, 9 августа 2021

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

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


Пример JSON датчика спидометра

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

Кейс: Вывести датчик спидометра, показывающую процент выполнения, где по плану процент выполнения должен быть 42, а фактический процент выполнения 54.

датчик спидометра.png
Создать отчёт с данными, на которых будет строиться датчик спидометра

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

отчёт спидометр.png





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

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

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

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

Пример JSON источника - отчета
Добавить элемент - датчик

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

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




Пример JSON
Настроить тип датчика

В поле "Тип датчика(type)" выбрать значение "Спидометр(solidgauge)".

тип датчика спидометр.png






Настроить вывод данных

Для того, чтобы данные отображались в виде спидометра требуется указать номер строки с данными из отчёта в поле "Строка с данными(rowSolidData)", колонку со значением минимума и максимума в полях "Колонка минимума(colMin)" и "Колонка максимума(colMax)" соответственно. Настройку цвета для графика можно задать в поле "Заливка датчика(fill)".

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

















Пример JSON общей настройки данных
Настроить заливку до значения

Для отображения процента выполнения по плану требуется в области "Настройка данных(seriesData)" добавить серию данных, где в поле "Колонка(col)" указать номер столбца из отчёта со значением планируемого процента выполнения, а в поле "Тип(type)" выбрать значение solidGauge. Задать цвет заливки планируемого процента выполнения можно в поле "Пользовательский цвет(customColor)" или указать номер столбца из отчёта с заданным цветом в поле "Колонка цвета(colColor)".

план.png
















Настроить стрелку

Для настройки стрелки требуется в области "Настройка данных(seriesData)" добавить серию данных, где в поле "Колонка(col)" указать номер столбца из отчёта со значением, на которое должны указывать стрелка, а в поле "Тип(type)" выбрать значение gauge. Чтобы задать длину стрелки в поле "Радиус(radius)" нужно указать процент длины радиуса от внешней линии графика. Для того, чтобы настроить размер точки, из которой выходит стрелка графика следует указать её радиус в поле "Радиус точки(point.radius)".

конструктор стрелка и точка.png





























Настроить заголовок датчика

Для того, чтобы создать заголовок достаточно написать его в поле "Заголовок(title)". Настройка расположения заголовка производится с помощью полей "Расположение заголовка(titleAlign)", "Отступ заголовка(titleMargin)". Настройка стиля заголовка производится с помощью полей "Цвет заголовка(titleColor)" и "Размер заголовка(fontSizeTitle)".

заголовок спид.png

















Пример JSON настройки заголовка
Настроить лейблы

Для того, чтобы настроить подписи на графике нужно поставить отметку в поле "Включить лейблы(yLabelEnabled)". Для задания жирности шрифта нужно использовать поле "Начертание лейблов(yLabelFontWeight)", размер шрифта задаётся в поле "Размер шрифта(yLabelFontSize)", а отступ подписей от границы графика задаётся в поле "Отступ лейблов(yLabelTickDistance)".

включить лейблы спидометр.png


















Для того, чтобы настроить штрихи на графике нужно поставить отметку в поле "Включить тики(yTickEnabled)". Настройка стиля тиков задаётся с помощью полей "Цвет тиков(yLabelTickColor)", "Длина тика(yLabelTickLength)" и"Ширина тика(yLabelTickWidth)". Для того, чтобы задать тики на максимуме и на минимуме требуется установить флаг "yTickAddMinMax": true.

включить тики спидометр.png















Пример JSON настройки лейблов и тиков

Дополнительные настройки chartOptions

Иногда требуются дополнительные настройки диаграммы для этого используется поле "Редактирование конфигурации(chartOptions)".

ред конфиг спидометр.png













Например, для того, чтобы задать расположение графика в компоненте нужно . . . что-то про pane

Пример JSON расположения диаграммы

Дополнительную информацию по chartOptions можно узнать по ссылке.