Ленточный графикLTS

Ленточный график — это график, состоящий из ряда отрезков, размещенных вдоль временной оси. Каждый отрезок соответствует отдельному разрезу. Начало и конец отрезка указывают на моменты начала и завершения отображаемого на графике события. Длина отрезка отражает продолжительность этого события.

Если график охватывает временной интервал, включающий настоящее время, то на графике отображается пунктирная линия — это линия текущего времени.

Настройки виджета

Помимо общих настроек, у виджета есть уникальные.

Настройка данных

Разрез

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

Дополнительные параметры:

• Ширина (в пикселях или процентах, по умолчанию — Авто)
• Отображать (Всегда/По переменной/По формуле)
• Цвет (по умолчанию — отключено):
  • По значениям (подходят правила с режимом Базовый и Настроить)
  • По правилу (подходят только правила по добавленному разрезу)

Время

Этот показатель не отображается в виджете и предназначен для визуализации интервалов длительности.

Параметры показателя:

• Название — при добавлении показателя в названии пишется название выбранной колонки, как в обычном разрезе
• Формула — при настройке показателя можно выбрать колонку или разрез с форматом Date или DateTime
• Тип — время начала или окончания для значений разреза, по умолчанию — время окончания
• Ширина колонок, в px — настройка отвечает за регулировку ширины колонок в пикселях. Минимальное значение — 70 пикселей, максимальное — 350
• Масштаб — отвечает за то, какая единица времени используется в виджете: часы (по умолчанию), дни, недели, месяцы, кварталы или годы. Если при выбранном масштабе отрезки не умещаются целиком, в режиме просмотра внизу виджета появится полоса прокрутки. При выборе формата Неделя над неделями, относящимися к одному месяцу, отображается дополнительная строка с месяцем и годом, к которому неделя относится
• Форматирование — настройка отвечает за формат времени, используемый в заголовках колонок (по умолчанию — Авто)

Длительность

Для этого показателя можно выбрать колонку с числовым форматом.

Параметры показателя:

• Название (по умолчанию присваивается название выбранной колонки)
• Формула

Настройки отображения:

• Метки значений (действуют для каждого значения разреза, по умолчанию выключены. Размер значений зависит от значения, указанного для размера текста)
• Положение меток:
  • Авто
  • Внутри полос
  • Снаружи
• Цвет полос:
  • Авто
  • Базовый
  • По длительности
  • По правилу (подходят правила с режимами Базовый, По мере и Настроить)
  • Настроить

Прогресс

При добавленном показателе Прогресс на отрезках появляется закрашенная часть — прошедшее количество времени для значения разреза. В длине закрашенной части учитываются данные в колонке, указанные для показателя. Незакрашенная часть — количество оставшегося времени.

В показатель Прогресс можно добавить только колонки с числовым форматом.

Параметры показателя:

• Название (по умолчанию присваивается название выбранной колонки)
• Формула

Сортировка

Для виджета применимы общие настройки сортировки.

Настройка отображения

Настройки шапки таблицы

• Фон шапки таблицы: Авто/Базовый
• Толщина шрифта: Обычная/Большая
• Цвет текста: Авто/Базовый

Размер текста

Регулирует размер текста в строках виджета.

Лимит разреза

Отвечает за количество строк, отображаемых в виджете.

Вложенность строк

Если параметр включен, слева от названия строки появляется иконка с плюсом, при нажатии на которую раскрывается иерархия разреза.

Подсказка

Подсказка — это небольшое окно с информацией о событии, которое появляется в режиме просмотра при наведении на отрезок. В подсказке отображается название события, даты его начала и окончания, длительность и прогресс выполнения в процентах (если настроен показатель Прогресс). По умолчанию подсказка включена.

Настройка фильтрации

Для виджета применимы общие настройки фильтрации.

Режим просмотра

Пролистывать страницы можно с помощью панели постраничной навигации, которая расположена в правом нижнем углу виджета. Панель появляется автоматически при превышении значения, заданного в параметре Лимит разреза.

Настройка виджета в YAML

Виджет можно редактировать не только в образе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице. Общие параметры для виджетов описаны на странице Настройка виджетов в YAML.

Настройки данных в YAML

Общие настройки

Разрезы в YAML (ключ dimensions)

Иерархический разрез (ключ hierarchyDimensions)

Время (ключ timeIndicators)

Длительность (ключ durationIndicators)

Прогресс (ключ progressIndicators)

Настройки отображения в YAML

Высота и ширина колонок

Высота и ширина колонок виджета настраиваются в ключе layout (ключи height и width). Чтобы узнать, как использовать эти ключи, обратитесь к статье Настройка образа в YAML.

Другие настройки отображения

Настройки фильтрации в YAML

Пример настроенного виджета в YAML-редакторе

widgets:
  - key: strip-chart (2)
    apiVersion: "17"
    type: STRIP_CHART
    settings:
      titleColor:
        mode: AUTO
      titleSize: 14
      paddings: 8
      titleWeight: NORMAL
      textSize: 12
      filterMode: DEFAULT
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      markdownTextSize: 14
      dimensions:
        - name: Иерархия
          hierarchyDimensions:
            - name: Спринт
              value:
                mode: FORMULA
                formula: '"sprint"."Спринт"'
              dbDataType: String
              formatting:
                value: AUTO
                mode: BASE
              hideEmptyValues: false
              format:
                value: STRING
                mode: BASE
              color:
                mode: DISABLED
              displayCondition:
                mode: DISABLED
            - name: Задача
              value:
                mode: FORMULA
                formula: '"sprint"."Задача"'
              dbDataType: String
              hideEmptyValues: false
              format:
                value: STRING
                mode: BASE
              formatting:
                value: AUTO
                mode: BASE
              color:
                mode: DISABLED
              displayCondition:
                mode: DISABLED
          displayCondition:
            mode: DISABLED
          width:
            value: null
            mode: PERCENT
      filters: []
      displayCondition:
        mode: DISABLED
      timeIndicators:
        - name: Дата и время (Дата события)
          dbDataType: DateTime
          format: DATETIME
          scale: week
          columnWidth: null
          formatting: auto
          formattingTemplate: ""
          rangeSide: START
          value:
            mode: FORMULA
            formula: toDateTime("sprint"."Дата события")
      durationIndicators:
        - name: Длительность
          format: NUMBER
          labelsPosition: OUTSIDE
          color:
            mode: AUTO
          withLabel: true
          value:
            mode: FORMULA
            formula: '"sprint"."Длительность"'
      progressIndicators:
        - name: Прогресс
          format: NUMBER
          value:
            mode: FORMULA
            formula: '"sprint"."Прогресс"'
      withHint: false
      limit: 10
      rowNesting: true
      headColor:
        mode: AUTO
      headWeight: NORMAL
      headTextColor:
        mode: AUTO
      todayLineColor:
        mode: AUTO
    localApiVersion: "2"