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

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

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

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

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

Разрез

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

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

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

Время

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

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

• Название — при добавлении показателя в названии пишется название выбранной колонки, как в обычном разрезе
• Формула — при настройке показателя можно выбрать колонку или разрез с форматом Date или DateTime
• Тип — время начала или окончания для значений разреза, по умолчанию — время окончания

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

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

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

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

Параметры отображения длительности:

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

Прогресс

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

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

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

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

Сортировка

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

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

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

Регулирует размер текста в строках виджета (по умолчанию — 12).

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

Отвечает за количество отображаемых в виджете строк (по умолчанию — 10).

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

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

Подсказка

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

Ширина колонок

Настройка регулирует ширину колонок в пикселях (по умолчанию — авто). Минимальное значение — 70 пикселей, максимальное — 350.

Постраничная навигация

При включенной постраничной навигации внизу виджета появится переключатель страниц. По умолчанию в виджете отображается 5 строк. Количество страниц зависит от значения, заданного в параметре Лимит разреза. Например, при лимите разреза равном 20 и количестве видимых строк равном 5 в переключателе появится 4 страницы.

Масштаб

Масштаб отвечает за то, какая единица времени используется в виджете: часы (по умолчанию), дни, недели, месяцы, кварталы или годы. Если при выбранном масштабе отрезки не умещаются целиком, в режиме просмотра внизу виджета появится полоса прокрутки.

Форматирование

Настройка отвечает за формат времени, используемый в заголовках колонок (по умолчанию — авто).

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

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

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

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

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

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

Разрезы (ключи dimensions и hierarchyDimensions)

Чтобы добавить разрез, используйте ключ dimensions. Поддерживаются следующие ключи:

Чтобы добавить иерархический разрез, используйте ключ hierarchyDimensions. Поддерживаются следующие ключи:

В ключе value в виде формулы задается используемый разрез. Пример:

value:
  mode: FORMULA
  formula: '"progress_example"."Дата события"'

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

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

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

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

Расширенные настройки

Чтобы использовать расширенные настройки, используйте ключ appearance. Доступны следующие ключи:

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

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

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

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

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

- key: strip-chart-beta
    apiVersion: "7"
    type: STRIP_CHART
    settings:
      title: Заголовок
      titleSize: 14
      titleColor:
        mode: AUTO
      titleWeight: NORMAL
      showMarkdown: true
      markdownMeasures:
        - name: Среднее user_id
          value:
            mode: TEMPLATE
            dbType: CH
            tableName: activity_0
            columnName: user_id
            templateName: avg
          dataType: FLOAT
          format: NUMBER
          formatting: AUTO
          displaySign: NONE
          displayCondition:
            mode: DISABLED
      markdownText: Описание виджета
      textSize: 12
      dimensions:
        - name: Иерархия
          hierarchyDimensions:
            - name: Отдел
              value:
                mode: FORMULA
                formula: '"progress_example"."Отдел"'
              dataType: STRING
              format: STRING
              formatting: AUTO
              displayCondition:
                mode: DISABLED
              color:
                mode: DISABLED
              width:
                value: null
                mode: PIXEL
            - name: Сотрудник
              value:
                mode: FORMULA
                formula: '"progress_example"."Сотрудник"'
              dataType: STRING
              format: STRING
              formatting: AUTO
              displayCondition:
                mode: DISABLED
              color:
                mode: DISABLED
              width:
                value: null
                mode: PIXEL
          displayCondition:
            mode: DISABLED
          color:
            mode: DISABLED
          width:
            value: 70
            mode: PIXEL
      filters: []
      displayCondition:
        mode: DISABLED
      timeIndicators:
        - name: Дата (Дата события)
          dataType: DATE
          format: DATE
          rangeSide: START
          value:
            mode: FORMULA
            formula: '"progress_example"."Дата события"'
      durationIndicators:
        - name: Длительность
          format: NUMBER
          color:
            mode: BASE
            value: "#078936"
          withLabel: true
          value:
            mode: FORMULA
            formula: '"progress_example"."Длительность"'
      progressIndicators:
        - name: Прогресс
          format: NUMBER
          value:
            mode: FORMULA
            formula: '"progress_example"."Прогресс"'
      withHint: true
      limit: 10
      withPagination: true
      scale: day
      formatting: auto
      formattingTemplate: ""
      filterMode: DEFAULT
      pageSize: 2
      columnWidth: 70
      sorting: []
      appearance:
        enabled: true
        horizontalPaddings: "40"
        verticalPaddings: "40"
        cornerRadius: "7"