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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
(Новая страница: «При настройке дашборда можно создать диаграмму Ганта. диагр...»)
 
Строка 1: Строка 1:
 
При настройке [[Платформа 3V/Формы/Дашборд|дашборда]] можно создать диаграмму Ганта. диаграмму Ганта - способ графического отображения данных в виде иллюстрации плана или графика работ.
 
При настройке [[Платформа 3V/Формы/Дашборд|дашборда]] можно создать диаграмму Ганта. диаграмму Ганта - способ графического отображения данных в виде иллюстрации плана или графика работ.
 +
 +
== Описание свойств templateOptions ==
 +
{| class="wikitable"
 +
|-
 +
! Наименование !! Свойство !! Тип !! Описание
 +
|-
 +
| Тип диаграммы || '''type''' || строковый || Выбор типа диаграммы
 +
|-
 +
! colspan="4" style="text-align:center;"| '''Общие настройки'''
 +
|-
 +
| Ширина || '''width''' || числовой || Настройка ширины области диаграммы
 +
|-
 +
| Высота || '''height''' || числовой || Настройка высоты области диаграммы
 +
|-
 +
| Заливка || '''backgroundColor''' || строковый || Настройка цвета фона диаграммы
 +
|-
 +
| Ширина бордюра || '''borderWidth''' || строковый || Настройка толщины границы области диаграммы
 +
|-
 +
| Цвет бордюра || '''borderColor''' || строковый || Настройка цвета границы области диаграммы
 +
|-
 +
! colspan="4" style="text-align:center;"| '''Формат шапки'''
 +
|-
 +
| Ключ|| '''key''' || строковый || Ключ
 +
|-
 +
| Формат || '''format''' || строковый || Настройка формата
 +
|-
 +
| Вывести текущую дату || '''currentDateIndicator''' || логический || Флаг, при включении которого выводится линия на текущей дату
 +
|-
 +
| Ширина линии текущей даты || '''currentDateIndicatorWidth''' || числовой || Настройка ширины линии текущей даты
 +
|-
 +
| Тип линии || '''currentDateIndicatorDashStyle''' || строковый || Настройка типа линии графика
 +
|-
 +
| Цвет линии || '''currentDateIndicatorColor''' || строковый || Настройка цвета линии текущей даты
 +
|-
 +
| Формат || '''currentDateIndicatorFormat''' || строковый || Настройка формата линии текущей даты
 +
|-
 +
| Анимация || '''animation''' || логический || Флаг, при включении которого диаграмма будет строиться с анимацией
 +
|-
 +
| Включить подпись || '''enableDataLabels''' || логический || Флаг, при включении которого будет выводится подпись
 +
|-
 +
| Выводимая колонка || '''enableDataLabelsFormat''' || строковый || 
 +
|-
 +
| Цвет выводимой колонки || '''enableDataLabelsColor''' || строковый || Настройка цвета выводимой колонки
 +
|-
 +
! colspan="4" style="text-align:center;"| '''Настройка заголовка'''
 +
|-
 +
| Заголовок || '''title.text''' || строковый || Задание заголовка диаграммы
 +
|-
 +
| Отступ || '''title.margin''' || числовой || Отступ заголовка диаграммы сверху
 +
|-
 +
| Цвет заголовка || '''title.color''' || строковый || Настройка цвета заголовка
 +
|-
 +
| Размер шрифта || '''title.fontSize''' || строковый || Размер шрифта заголовка диаграммы
 +
|-
 +
| Выравнивание по вертикали || '''title.align''' || строковый || Выравнивание заголовка по вертикали
 +
|-
 +
! colspan="4" style="text-align:center;"| '''Настройка подзаголовка'''
 +
|-
 +
| Заголовок || '''subtitle.text''' || строковый || Задание заголовка диаграммы
 +
|-
 +
| Отступ || '''subtitle.margin''' || числовой || Отступ заголовка диаграммы сверху
 +
|-
 +
| Цвет заголовка || '''subtitle.color''' || строковый || Настройка цвета заголовка
 +
|-
 +
| Размер шрифта || '''subtitle.fontSize''' || строковый || Размер шрифта заголовка диаграммы
 +
|-
 +
| Выравнивание по вертикали || '''subtitle.align''' || строковый || Выравнивание заголовка по вертикали
 +
|-
 +
! colspan="4" style="text-align:center;"|'''Данные'''
 +
|-
 +
| Использовать несколько серий || '''moreSeries''' || логический || Флаг, при включении которого будет возможно использование нескольких серий данных
 +
|-
 +
| Колонка с данными || '''columnName''' || числовой || Задание номера колонки с данными
 +
|-
 +
| Колонка начала времени || '''startDate''' || числовой || Задание номера колонки с датой начала периода
 +
|-
 +
| Колонка завершения времени || '''endDate''' || числовой || Задание номера колонки с датой завершения периода
 +
|-
 +
| Колонка цвета || '''color''' || строковый || Задание цвета периода
 +
|-
 +
! colspan="4" style="text-align:center;"|'''Выводимые колонки'''
 +
|-
 +
| Название || '''nameColumns.label''' || строковый || Задание названия колонки
 +
|-
 +
| Колонка || '''nameColumns.column''' || числовой || Задания номера столбца из отчёта
 +
|-
 +
! colspan="4" style="text-align:center;"|'''Настройка выводимых колонок'''
 +
|-
 +
| Заголовок || '''gridColumns.title''' || строковый || Задание названия колонки
 +
|-
 +
| Формат || '''gridColumns.format''' || числовой || Задания номера столбца из отчёта
 +
|-
  
 
== Пример использования ==
 
== Пример использования ==

Версия 18:53, 18 июля 2021

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

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

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

Кейс: 1 серия без уникальности

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

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

пивот стапель.png














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

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

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

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

Пример JSON источника - отчета
 1   {
 2       "pivotId": 55547,
 3       "parameters": [],
 4       "focusOnFirstCell": false,
 5       "id": 55547,
 6       "name": "План загрузки по договорам",
 7       "isReadOnly": false,
 8       "dataEditRuleIds": [],
 9       "dataEditExpressionIds": [],
10       "beforeSaveDataActions": [],
11       "beforeSaveActions": [],
12       "afterSaveDataActions": [],
13       "afterSaveActions": [],
14       "discriminator": "PivotDataSource"
15   }
Добавить элемент - диаграмма

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






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

Для того, чтобы данные отображались в виде столбцов, требуется добавить номера столбцов отчёта: "columnName" - наименование периода, "startDate" - дата начала периода, "endDate" - окончание периода, "color" - цвет периода.









Пример JSON простой диаграммы Ганта
 1   {
 2           ...
 3           "templateOptions": {
 4             ...
 5               "columnName": 3,
 6               "startDate": 6,
 7               "endDate": 7,
 8               "color": 5
 9             }
10             ...
11   }
Настроить заголовок диаграммы

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

"title": {
             "text": "Test",
             "margin": 20,
             "fontSize": 16,
             "color": null
           },
           "subtitle": {
             "fontSize": 12,
             "text": null,
             "margin": null,
             "color": null
           },

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

Настройка заголовка.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 }


Кейс: 1 серия + уникальность

1 серия + уникальность.png

Кейс: несколько серий без уникальности

несколько серий без уникальности.png

Кейс: несколько серий без уникальности

несколько серий + уникальность.png
Наименование Свойство Тип Описание
Тип диаграммы type строковый Выбор типа диаграммы
Общие настройки
Ширина width числовой Настройка ширины области диаграммы
Высота height числовой Настройка высоты области диаграммы
Заливка backgroundColor строковый Настройка цвета фона диаграммы
Ширина бордюра borderWidth строковый Настройка толщины границы области диаграммы
Цвет бордюра borderColor строковый Настройка цвета границы области диаграммы
Формат шапки
Ключ key строковый Ключ
Формат format строковый Настройка формата
Вывести текущую дату currentDateIndicator логический Флаг, при включении которого выводится линия на текущей дату
Ширина линии текущей даты currentDateIndicatorWidth числовой Настройка ширины линии текущей даты
Тип линии currentDateIndicatorDashStyle строковый Настройка типа линии графика
Цвет линии currentDateIndicatorColor строковый Настройка цвета линии текущей даты
Формат currentDateIndicatorFormat строковый Настройка формата линии текущей даты
Анимация animation логический Флаг, при включении которого диаграмма будет строиться с анимацией
Включить подпись enableDataLabels логический Флаг, при включении которого будет выводится подпись
Выводимая колонка enableDataLabelsFormat строковый
Цвет выводимой колонки enableDataLabelsColor строковый Настройка цвета выводимой колонки
Настройка заголовка
Заголовок title.text строковый Задание заголовка диаграммы
Отступ title.margin числовой Отступ заголовка диаграммы сверху
Цвет заголовка title.color строковый Настройка цвета заголовка
Размер шрифта title.fontSize строковый Размер шрифта заголовка диаграммы
Выравнивание по вертикали title.align строковый Выравнивание заголовка по вертикали
Настройка подзаголовка
Заголовок subtitle.text строковый Задание заголовка диаграммы
Отступ subtitle.margin числовой Отступ заголовка диаграммы сверху
Цвет заголовка subtitle.color строковый Настройка цвета заголовка
Размер шрифта subtitle.fontSize строковый Размер шрифта заголовка диаграммы
Выравнивание по вертикали subtitle.align строковый Выравнивание заголовка по вертикали
Данные
Использовать несколько серий moreSeries логический Флаг, при включении которого будет возможно использование нескольких серий данных
Колонка с данными columnName числовой Задание номера колонки с данными
Колонка начала времени startDate числовой Задание номера колонки с датой начала периода
Колонка завершения времени endDate числовой Задание номера колонки с датой завершения периода
Колонка цвета color строковый Задание цвета периода
Выводимые колонки
Название nameColumns.label строковый Задание названия колонки
Колонка nameColumns.column числовой Задания номера столбца из отчёта
Настройка выводимых колонок
Заголовок gridColumns.title строковый Задание названия колонки
Формат gridColumns.format числовой Задания номера столбца из отчёта