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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 152: Строка 152:
  
 
====== Настроить вывод данных ======
 
====== Настроить вывод данных ======
Для того, чтобы данные отображались в виде столбцов, требуется добавить номера столбцов отчёта: "columnName" - наименование периода, "startDate" - дата начала периода, "endDate" - окончание периода, "color" - цвет периода.
+
Для того, чтобы данные отображались в виде столбцов, требуется добавить номера столбцов отчёта: "columnName" - наименование периода, "startDate" - дата начала периода, "endDate" - окончание периода, "color" - цвет периода(опционально).
 
<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 class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
Строка 169: Строка 169:
 
             ...
 
             ...
 
   }
 
   }
 +
</syntaxhighlight>
 +
</div></div>
 +
 +
Для таблицы слева:
 +
В nameColumns есть возможность задать некоторые названия для вытащенных колонок, в дальнейшем в gridColumn нужно задать заголовки и объявить называния колонок, которые были заданы в nameColumns в формате {point.label}, где label - объявленное название.
 +
 +
<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>
 +
        "data": {
 +
          "columnName": 2,
 +
          "startDate": 3,
 +
          "endDate": 4,
 +
          "color": null,
 +
          "nameColumns": [
 +
            {
 +
              "label": "step",
 +
              "column": 2,
 +
              "percent": false,
 +
              "colorPercentColumn": null
 +
            },
 +
            {
 +
              "label": "date",
 +
              "column": 5,
 +
              "percent": false,
 +
              "colorPercentColumn": null
 +
            }
 +
          ]
 +
        },       
 +
        "gridColumns": [
 +
          {
 +
            "format": "{point.step}",
 +
            "title": "Этап"
 +
          },
 +
          {
 +
            "format": "{point.date}",
 +
            "title": "Дата старта"
 +
          }
 +
        ]
 
</syntaxhighlight>
 
</syntaxhighlight>
 
</div></div>
 
</div></div>

Версия 19:04, 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   }

Для таблицы слева: В nameColumns есть возможность задать некоторые названия для вытащенных колонок, в дальнейшем в gridColumn нужно задать заголовки и объявить называния колонок, которые были заданы в nameColumns в формате {point.label}, где label - объявленное название.

Пример JSON объявления таблицы
 1          "data": {
 2           "columnName": 2,
 3           "startDate": 3,
 4           "endDate": 4,
 5           "color": null,
 6           "nameColumns": [
 7             {
 8               "label": "step",
 9               "column": 2,
10               "percent": false,
11               "colorPercentColumn": null
12             },
13             {
14               "label": "date",
15               "column": 5,
16               "percent": false,
17               "colorPercentColumn": null
18             }
19           ]
20         },        
21         "gridColumns": [
22           {
23             "format": "{point.step}",
24             "title": "Этап"
25           },
26           {
27             "format": "{point.date}",
28             "title": "Дата старта"
29           }
30         ]
Настроить заголовок диаграммы

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

"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 числовой Задания номера столбца из отчёта