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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Метка: изменение цели перенаправления
 
(не показано 7 промежуточных версий 2 участников)
Строка 1: Строка 1:
Диаграмма - это графическое представление данных, которое необходимо для визуализации информации и упрощения анализа.
+
#redirect [[Платформа_3V/Формы/Компоненты/Графики]]
 
 
== Создание диаграммы==
 
 
 
Создание любого вида диаграммы подразумевает под собой выполнение следующих шагов:
 
 
 
==== Создать отчёт ====
 
Для вывода диаграммы нужны данные, для которых изначально следует создать [[Платформа_3V/Отчет|'''отчёт''']].
 
[[Файл:Создание пивота.gif|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 
В отчёт необходимо вывести данные в определенном виде. Более подробно о требованиях к отчетам для определенных типов диаграмм, вы найдете в соответствующих статьях с их описанием.
 
[[Файл:добавление справочника в пивот.gif|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br>
 
 
 
==== Добавить источник данных ====
 
В форму, в которой собираем дашборд, необходимо добавить [[Платформа 3V/Формы/Источники данных/Отчет|'''источник данных - отчёт''']]. В соответствии с разметкой формы <br>
 
Шаблон источника данных:
 
<syntaxhighlight lang="JSON" line>
 
{
 
  ...
 
 
 
  "entryDataSources": [
 
    {
 
      "pivotId": 1,
 
      "parameters": [],
 
      "focusOnFirstCell": true,
 
      "id": 1,
 
      "name": "",
 
      "isReadOnly": true,
 
      "dataEditRuleIds": [],
 
      "beforeSaveDataActions": [],
 
      "afterSaveDataActions": [],
 
      "discriminator": "PivotDataSource"
 
    }
 
  ],
 
    ...
 
}
 
</syntaxhighlight>
 
 
 
'''pivotId''' - идентификатор отчёта в навигаторе, а '''id''' - присваиваемый идентификатор источника данных в рамках формы.<br>
 
 
 
==== Создать диаграмму ====
 
Шаблон элемента управления:
 
<syntaxhighlight lang="JSON" line>
 
{
 
    ...
 
 
 
  "uiSources": [
 
    {
 
      "pivotSourceId": 1,
 
      "doActionOnChangeFocusedCell": true,
 
      "doActionOnChangeCellValue": false,
 
      "id": 1,
 
      "caption": "",
 
      "enable": false,
 
      "visible": true,
 
      "hint": null,
 
      "uiDataSource": null,
 
      "doActionOnChangeValue": false,
 
      "enableRuleIds": [],
 
      "visibleRuleIds": [],
 
      "access": {
 
        "read": {
 
          "roles": [],
 
          "inversion": false,
 
          "default": true
 
        },
 
        "edit": {
 
          "roles": [],
 
          "inversion": false,
 
          "default": true
 
        }
 
      },
 
      "isValueChanged": false,
 
      "expressionId": null,
 
      "discriminator": "PivotSourceEntry"
 
    }
 
  ] 
 
    ...
 
}
 
</syntaxhighlight>
 
 
 
В форме можно добавить элемент типа "Диаграмма", которая имеет следующую структуру:
 
<syntaxhighlight lang="JSON" line>
 
{
 
      "key": "1",
 
      "type": "...",
 
      "templateOptions": { 
 
      ...
 
      },
 
      "dataSourceId": 1
 
}
 
</syntaxhighlight>
 
{| class="wikitable"
 
! colspan="2" | '''Описание свойств дашборда'''
 
|-
 
! Свойство !! Описание
 
|-
 
| key || Идентификатор компонента карточки
 
|-
 
| type || trv-highcharts
 
|-
 
| templateOptions || Свойства настройки компонента (для каждого типа диаграммы свои).
 
|-
 
| dataSourceId || Идентификатор действия
 
|}
 
 
 
Для того, чтобы элемент мог взаимодействовать с источником необходимо добавить элемент управления. <br>
 
 
 
В '''templateOptions''' выбирается тип диаграммы:
 
<syntaxhighlight lang="JSON" line>
 
{
 
      "templateOptions": { 
 
      ...
 
      "type": "",
 
      ...
 
      },         
 
}
 
</syntaxhighlight>
 
 
 
Тип диаграммы может быть:
 
{| class="wikitable"
 
|-
 
!colspan="2"|type
 
|-
 
! Permissions !! Определение
 
|-
 
| column || [[Платформа 3V/Формы/Дашборд/Гистограмма|'''Гистограмма''']]
 
|-
 
| pie|| Круговая
 
|-
 
| variablepie || Улитка
 
|-
 
| bar || Линейная
 
|-
 
| line || График
 
|-
 
| area || Область
 
|-
 
| areaspline || Линейная с областью
 
|-
 
| treemap || Дерево
 
|-
 
| trv-highcharts-gantt || [[Платформа_3V/Формы/Диаграммы/Диаграмма_Ганта|'''Диаграмма Ганта''']]
 
|}
 

Текущая версия на 08:29, 16 сентября 2021