Линейный графикLTS
Линейный график — это вид графика, который используется для отображения данных, изменяющихся во времени или пространстве. Он представляет собой набор точек, соединенных линиями, и позволяет визуализировать тенденции и изменения данных.
Настройки виджета
Помимо общих настроек, у виджета есть уникальные.
Настройка данных
У виджета есть две группы разрезов: Разрез 1 и Разрез 2. В каждую группу можно добавить несколько разрезов. В разрезах можно скрыть пустые значения, добавить действия по клику и настроить параметр Отображать (Всегда/По переменной/По формуле). Также в виджет можно добавлять меры. Дополнительно для меры можно задать толщину линий, включить метки значений и указать их размер.
Отображение режимов настройки цвета в разрезах и мерах зависит от конфигурации виджета.
| 1 разрез | 2 разреза | |
|---|---|---|
| 1 мера | Для разреза: Настройка цветов недоступна Для меры доступны правила с режимом: 1. Базовый | Для Разреза 1: Настройка цветов недоступна Для Разреза 2 доступны режимы: 1. Отключено 2. По значениям (для значений доступны правила с базовым режимом) 3. По правилу (для значений доступны правила по разрезу, который добавлен в виджет) Для меры: Настройка цветов недоступна | 
| Несколько мер | Для разреза: Настройка цветов недоступна Для меры доступны правила с режимом: 1. Базовый | Для меры: Настройка цветов недоступна | 
Настройка отображения
Размер текста
Регулирует размер текста в виджете, кроме значений меток для мер.
Лимит разреза и лимит второго разреза
Регулирует количество столбиков на диаграмме.
Скрыть пустые значения
Включите, чтобы пустые значения не отображались на диаграмме.
Подсказка
Если включить подсказку, то в режиме просмотра при наведении на столбик появится окошко с подробной информацией об отображаемых данных.
Тип
Регулирует отображение линий: обычные, в виде области или с накоплением. Дополнительно можно включить сглаживание линий, метки итоговых значений для столбиков и настроить размер текста для этих меток.
Легенда
Подробности работы с легендой описаны на странице Виджеты.
Ось X
Для оси X можно включить отображение заголовка, а также настроить поворот и высоту меток.
Ось Y
Для оси Y можно включить отображение заголовка, указать ширину меток и диапазон.
- Значения оси Y на графике начинаются не с 0, а с минимального, которое берется из мер.
- Если диапазон меньше значения меры, то график масштабируется до необходимого диапазона. Значения, которые не входят в диапазон, отображаются без точек за границей видимой части графика.
- Отображение обеих осей можно включить или отключить.
Опорные линии
Опорные линии служат визуальными ориентирами для заданных значений на графике. Подробная информация о настройках и использовании опорных линий приведена на странице Виджеты.
Настройка фильтрации
Для виджета доступны стандартные настройки фильтрации.
- Фильтр, настроенный в виджете, невозможно удалить в режиме просмотра.
- Если к виджету применить фильтр по клику в режиме просмотра, то выделяются выбранные точки на линии.
Подробнее о виджете Линейный график в видеокурсе.
Настройка виджета в YAML
Виджет можно редактировать не только в образе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице. Общие параметры для виджетов описаны на странице Настройка виджетов в YAML.
Настройки данных в YAML
| Ключ | Тип | Определение | 
|---|---|---|
| title | string | Заголовок | 
| showMarkdown | boolean | Описание | 
| markdownText | string | Текст описания | 
| markdownMeasures | — | Меры в описании | 
| dimensionsFirstGroup | — | Разрез 1 | 
| dimensionsSecondGroup | — | Разрез 2 | 
| measures | — | Меры | 
| sorting | — | Сортировка | 
Разрез 1 (ключ dimensionsFirstGroup)
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название разреза | 
| value | — | Формула разреза | 
| dbDataType | enum | Тип данных разреза | 
| format | enum | Формат | 
| formatting | enum | Форматирование | 
| formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM(Настроить) | 
| hideEmptyValues | boolean | Скрыть пустые значения | 
| hierarchyDimensions | — | Разрезы иерархии Если добавлен этот параметр, то показатель определяется как иерархия | 
| onClick | — | Действия по клику Если разрез иерархический, параметр не применяется | 
| displayCondition | — | Отображать (условие отображения) | 
| arrayNesting | boolean | Вложенность массива | 
Иерархический разрез для Разреза 1 (ключ hierarchyDimensions)
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название разреза | 
| value | — | Формула разреза | 
| dbDataType | enum | Тип данных разреза | 
| format | enum | Формат | 
| formatting | enum | Форматирование | 
| formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM(Настроить) | 
| hideEmptyValues | boolean | Скрыть пустые значения | 
| onClick | — | Действия по клику | 
| displayCondition | — | Отображать (условие отображения) | 
| arrayNesting | boolean | Вложенность массива | 
Разрез 2 (ключ dimensionsSecondGroup)
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название разреза | 
| value | — | Формула разреза | 
| dbDataType | enum | Тип данных разреза | 
| format | enum | Формат | 
| formatting | enum | Форматирование | 
| formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM(Настроить) | 
| hideEmptyValues | boolean | Скрыть пустые значения | 
| hierarchyDimensions | — | Разрезы иерархии Если добавлен этот параметр, то показатель определяется как иерархия | 
| onClick | — | Действия по клику Если разрез иерархический, параметр не применяется | 
| color | — | Цвет: - DISABLED— отключено- VALUES— по значениям- RULE— по правилуПараметр не применяется если: 1. Показатель иерархический 2. В первую группу не добавлен разрез | 
| displayCondition | — | Отображать (условие отображения) | 
| arrayNesting | boolean | Вложенность массива | 
Иерархический разрез для Разреза 2 (ключ hierarchyDimensions)
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название разреза | 
| value | — | Формула разреза | 
| dbDataType | enum | Тип данных разреза | 
| format | enum | Формат | 
| formatting | enum | Форматирование | 
| formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM(Настроить) | 
| hideEmptyValues | boolean | Скрыть пустые значения | 
| onClick | — | Действия по клику | 
| color | — | Цвет: - DISABLED— отключено- VALUES— по значениям- RULE— по правилуПараметр не применяется, если не добавлен разрез в первую группу | 
| displayCondition | — | Отображать (условие отображения) | 
| arrayNesting | boolean | Вложенность массива | 
Меры в YAML (ключ measures)
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название меры | 
| value | — | Формула меры | 
| dbDataType | enum | Тип данных меры | 
| format | enum | Формат | 
| formatting | enum | Форматирование | 
| formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM(Настроить) | 
| lineThickness | enum | Толщина линий: - THIN— малая- THICK— большая | 
| showLabels | — | Метки значений | 
| color | — | Цвет: - AUTO— авто- BASE— базовый- RULE— по правилуНе отображается, если разрезы добавлены в обе группы | 
| displayCondition | — | Отображать (условие отображения) | 
Показывать метки значений (ключ showLabels)
| Ключ | Тип | Определение | 
|---|---|---|
| enabled | boolean | Метки вкл/выкл | 
| size | number | Размер меток | 
Настройки отображения в YAML
| Ключ | Тип | Определение | 
|---|---|---|
| paddings | string | Отступы по сторонам | 
| titleSize | number | Размер заголовка | 
| titleColor | — | Цвет заголовка: - AUTO— авто- BASE— базовый | 
| titleWeight | enum | Толщина заголовка: - NORMAL— обычная- BOLD— большая | 
| markdownTextSize | number | Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание | 
| textSize | number | Размер текста | 
| firstDimensionLimit | number | Лимит Разреза 1 | 
| secondDimensionLimit | number | Лимит Разреза 2 | 
| hideEmptyValues | boolean | Скрыть пустые значения | 
| showHint | boolean | Подсказка | 
| chartType | enum | Тип: - LINE— обычные линии- AREA— в виде области- STACKED_AREA— с накоплением | 
| lineSmoothing | boolean | Сглаживание линий | 
| legend | — | Легенда | 
| showTotalLabels | — | Метки итоговых значений Только для типа STACKED_AREA(с накоплением) | 
| xAxis | — | Настройки оси X | 
| yAxis | — | Настройки оси Y | 
Метки итоговых значений (ключ showTotalLabels)
| Ключ | Тип | Определение | 
|---|---|---|
| enabled | boolean | Итоговые метки вкл/выкл | 
| size | number | Размер меток | 
Настройки оси X (ключ xAxis)
| Ключ | Тип | Определение | 
|---|---|---|
| enabled | boolean | Ось X вкл/выкл | 
| rotation | number | Поворот меток | 
| height | number | Высота меток | 
| showTitle | boolean | Заголовок | 
Настройки оси Y (ключ yAxis)
| Ключ | Тип | Определение | 
|---|---|---|
| enabled | boolean | Ось Y вкл/выкл | 
| width | number | Ширина меток | 
| showTitle | boolean | Заголовок | 
| rangeSwitch | boolean | Диапазон вкл/выкл | 
| range | — | Значения диапазона | 
Опорные линии (ключ referenceLines)
Чтобы добавить на ось Y опорные линии, используйте ключ referenceLinesEnabled. 
| Ключ | Тип | Определение | 
|---|---|---|
| referenceLinesEnabled | boolean | Переключатель Опорные линии | 
В блоке с ключом referenceLines используются ключи из таблицы ниже.
| Ключ | Тип | Определение | 
|---|---|---|
| name | string | Название | 
| color | — | Блок для настройки цвета опорной линии. В ключе modeуказывается режим:- AUTO— авто- BASE— базовыйЕсли указан режим BASE, то в ключеvalueв двойных кавычках указывается HEX-код цвета, например"#e51320" | 
| type | enum | Тип линии - SOLID— сплошная- DOTTER— пунктирная | 
| dashLength | number | Длина тире. Ключ настраивается только при использовании пунктирной опорной линии ( DOTTER) | 
| thickness | number | Толщина опорной линии. Минимальное значение — 0, максимальное —20 | 
| formula | string | Формула. Указывается в двойных кавычках, например "400" | 
Значения диапазона в YAML (ключ range)
| Ключ | Тип | Определение | 
|---|---|---|
| min | number | Минимальное значение | 
| max | number | Максимальное значение | 
Настройки фильтрации в YAML
| Ключ | Тип | Определение | 
|---|---|---|
| filterMode | enum | Режим фильтрации: - DEFAULT— базовый- SINGLE— единичный выбор- DISABLED— отключено | 
| ignoreFilters | boolean | Игнорировать фильтры | 
| filters | — | Фильтры | 
| aggregateFilters | — | Агрегатные фильтры | 
| stateName | string | Состояние | 
Пример настроенного виджета в YAML-редакторе
- key: LINE_CHART
    apiVersion: "16"
    type: LINE_CHART
    settings:
      displayCondition:
        mode: DISABLED
      textSize: 12
      xAxis:
        showTitle: false
        enabled: true
      lineSmoothing: true
      showMarkdown: false
      ignoreFilters: false
      markdownMeasures: []
      legend:
        position: BOTTOM
        align: CENTER
      dimensionsFirstGroup:
        - displayCondition:
            mode: DISABLED
          dbDataType: STRING
          onclick: []
          name: События
          format: STRING
          value:
            mode: FORMULA
            formula: '"event_log"."event_name"'
          formatting: AUTO
          onClick: []
      filters: []
      titleSize: 14
      title: ""
      filterMode: DEFAULT
      yAxis:
        rangeSwitch: false
        showTitle: false
        range: {}
        enabled: true
      measures:
        - displayCondition:
            mode: DISABLED
          color:
            mode: BASE
            value: "#00d2d3"
          lineThickness: THIN
          dbDataType: STRING
          name: count (distinct incident_id)
          format: NUMBER
          value:
            mode: TEMPLATE
            templateName: countDistinct
            dbType: CH
            tableName: case_table
            columnName: incident_id
          formatting: AUTO
          valueLabel:
            size: 12
            enabled: true
          showLabels:
            enabled: true
            size: 12
      dimensionsSecondGroup: []
      markdownText: ""
      stateName: null
      sorting: []
      chartType: AREA
      stateGuid: f12c435a-43b8-4f98-8fc5-220adba5ffcb
      secondDimensionLimit: 50
      firstDimensionLimit: 15
      showTotalLabels:
        size: 12
        enabled: false
      titleColor:
        mode: AUTO
      titleWeight: NORMAL
Была ли статья полезна?