Виджеты
Виджеты — это компоненты образов, с помощью которых данные получают визуальное представление в виде процессов, диаграмм, показателей и т. д. Виджеты создают картину бизнес-аналитики в Proceset.
Виджеты, которые можно добавить в образ, разделены на категории.
Процессные:
Диаграммы:
- Гистограмма
- Кольцевая диаграмма
- Комбинированная диаграмма
- Ленточный график
- Линейный график
- Столбиковая диаграмма
Таблицы:
KPI:
Вспомогательные:
Настройки виджета
Чтобы настроить виджет, сначала необходимо настроить Модель данных.
У всех виджетов есть общие настройки, доступные для каждого из них, и уникальные, свойственные определенным виджетам. Уникальные настройки каждого виджета описаны на страницах этих виджетов.
Режим настройки виджета активируется:
- При добавлении виджета на холст в визуальном конструкторе
- При клике левой кнопкой мыши по виджету
- При клике по названию виджета на панели образов
Настройки виджета расположены на панели справа во вкладках:
- Настройка данных
- Настройка отображения
- Настройка фильтрации
- Настройка действий (только для виджета Таблица)
Настройка данных
Во вкладке Данные можно настроить разрезы и меры виджета, добавить сортировку и отредактировать ключ. Доступные во вкладке настройки зависят от виджета.
Заголовок
В поле Введите заголовок можно указать название виджета.
Описание
Чтобы добавить описание для виджета, активируйте переключатель рядом с названием настройки. Также в описание можно добавлять меры с помощью кнопки + Мера. Чтобы добавленные меры отображались в описании, в поле описания необходимо указать название меры в фигурных скобках: {Название меры}
. Мера может отображаться в виде положительного или отрицательного индикатора.
- Указать заголовок и описание для виджетов Текст и Кнопка невозможно.
- В описании можно использовать ссылки на переменные в формате
{inputs.Название переменной}
, а также разметку Markdown.
Ниже представлен пример использования переменной в описании.
Расширенный редактор Markdown
Расширенный редактор Markdown можно использовать в названиях образов, описаниях виджетов и в виджете Текст.
Показатели
Для построения виджетов доступно добавление локальных показателей, показателей дашборда и пространства.
Сортировка
Для виджета можно настроить сортировку.
Ключ
В этом поле можно посмотреть и изменить ключ виджета. Ключи виджетов указываются в структуре образа на YAML.
Настройка отображения
Во вкладке Отображение настраивается внешний вид виджета. Для каждого виджета доступны следующие настройки:
- Высота:
- px — высота виджета указывается фиксированно в пикселях
- % — высота виджета динамически рассчитывается относительно экрана, на котором отображается отчет
- Ширина (задается в долях холста или пикселях)
- Расширенные настройки
- Размер заголовка
- Цвет заголовка (доступны режимы Авто и Базовый)
- Толщина шрифта (обычная или большая)
- Текст описания
- Задать размер и цвет заголовка, а также толщину шрифта для виджетов Текст и Кнопка невозможно.
- Для виджета Кнопка невозможно задать размер описания.
- При изменении высоты одного виджета остальные виджеты, для которых задана автоматическая высота, подстраиваются под высоту наибольшего измененного виджета.
Отступы
В параметре задаются отступы от краев виджета до содержимого внутри него, например диаграммы или таблицы.
Чем больше отступы в виджете по горизонтали, тем меньше места занимает содержимое в нем. Например, при увеличении отступов для столбиковой диаграммы элементы внутри нее (заголовки, столбики и т. д.) сдвигаются, как при обычном изменении высоты или ширины виджета. При изменении отступа по вертикали, высота содержимого в виджете не изменяется.
По умолчанию используется минимальная величина отступов — 8 пикселей. Чтобы задать одинаковый отступ со всех сторон, укажите одно значение в поле. Чтобы отступы по сторонам были разными, например 10 пикселей по вертикали, 20 по горизонтали и 5 снизу, то укажите их через запятую: 10, 20, 5.
Чтобы задать одинаковые отступы для всех виджетов в отчете, перейдите во вкладку общих настроек виджетов в образе и укажите нужные значение в параметре Отступы.
Если отступы в образе и в определенных виджетах отличаются, то такие виджеты игнорируют настройки отступов для образа.
Текст описания
Параметр доступен, если во вкладке настроек данных активен переключатель Описание. Параметр регулирует размер текста описания в Markdown. Изменения в размере текста отображаются в режиме редактирования и расширенном редакторе Markdown.
Если размер текста в описании задан через HTML-теги, то к такому тексту не применяется значение, указанное в параметре Текст описания.
Изменение размера текста описания затрагивает все элементы Markdown (например, заголовки, списки, цитаты и т. д.). Размер заголовков изменяется в зависимости от указанного размера текста описания.
Пример: для текста описания указан размер 14. В этом случае для заголовков будут использоваться следующие значения размеров:
- 1-й уровень: 38
- 2-й уровень: 30
- 3-й уровень: 24
- 4-й уровень: 20
- 5-й уровень: 16
Размер текста описания увеличился до 25. В этом случае для расчета значений заголовков в Markdown применяется формула: Текущее значение - Предыдущее значение = Разница для вычисления размера заголовка
. В нашем случае разница составляет 11. Вот как изменятся значения размеров:
- 1-й уровень: 38 + 11 = 49
- 2-й уровень: 30 + 11 = 41 и т. д.
Если новый размер меньше 14, например 10, то при расчете разница вычитается:
- 1-й уровень: 38 - 4 = 34
- 2-й уровень: 30 - 4 = 26 и т. д.
Легенда
Для диаграмм и линейного графика можно включить отображение легенды. В легенде отображаются условные обозначения, используемые в виджете, с пояснениями. Доступные варианты отображения:
- Отключено
- Слева
- Сверху
- Снизу (по умолчанию)
- Справа
Также для легенды задается выравнивание:
- Слева
- По центру (по умолчанию)
- Справа
Настройка фильтрации
Во вкладке Фильтр можно настроить режим фильтрации, включить или выключить игнорирование фильтров, применить состояние для ограничения фильтрации виджетов и предварительно установить фильтр на виджет.
Настройки доступны для следующих виджетов:
- Воронка
- Гистограмма
- Карта процесса
- Кольцевая диаграмма
- Комбинированная диаграмма
- Ленточный график
- Линейный график
- Панель с показателями
- Показатель
- Процентный показатель
- Сводная таблица
- Столбиковая диаграмма
- Сфера процессов
- Таблица
- Текст
- Фильтр
Режим фильтрации и Игнорировать фильтры
Настройка Режим фильтрации отображается только у виджетов, у которых настроен разрез. У настройки 4 режима:
- Базовый — выбирается одно или несколько значений, выбор подтверждается галочкой, остальные значения исчезают
- Единичный выбор — выбирается только одно значение, остальные становятся полупрозрачными
- Отключено — выбор значений по клику невозможен
Виджет, для которого включен параметр Игнорировать фильтры, не перестраивается. Параметр Игнорировать фильтры отменяет только фильтрацию по клику, но не фильтрацию, заданную на уровне образа.
При нажатии на виджет, который игнорирует фильтрацию, у него не отображаются галочка (применить фильтр) и «крестик» (отменить), вкладки фильтров добавляются.
- Клик по значению виджета, которое ранее не было выбрано, добавляет его в фильтр.
- Клик по значению, выбранному ранее, исключит его из фильтра.
Для виджета Фильтр при включенном параметре Игнорировать фильтры поиск происходит следующим образом:
- Выбранные значения не поднимаются в верх списка
- Если значение подходит под условие поиска, то при поиске значение, которое входит в добавленный ранее фильтр, будет выбрано
Если для виджета выключено игнорирование фильтрации и выбран режим:
- Базовый, то к нему применяется фильтрация по разрезу других виджетов. Также к нему можно применить фильтрацию по собственным разрезам
- Единичный выбор, то при фильтрации у него можно выбрать только одно значение разреза. Фильтрацию по собственным разрезам применить невозможно, применяется фильтрация по разрезам других виджетов
- Отключено, то выбрать значения и применить фильтрацию по собственным разрезам невозможно. Применяется фильтрация по разрезам других виджетов
Если для виджета включено игнорирование фильтрации и выбран режим:
- Единичный выбор, то при фильтрации у него можно выбрать только одно значение разреза. Фильтрация по собственным разрезам и по разрезам других виджетов не применяется
- При выделении одного значения того же разреза у другого виджета оно также выделяется у виджета, который игнорирует фильтрацию. При применении фильтрации по одному или нескольким значениям одного разреза у другого виджета, у которого включено игнорирование, значение остается выделенным
- Отключено, то выбрать значения и применить фильтрацию по собственным разрезам невозможно. Фильтрация по разрезам других виджетов не применяется
Предустановленный фильтр
Кнопкой + Фильтр можно предварительно установить фильтр на виджет, который не применится на другие виджеты и который невозможно изменить или удалить в режиме просмотра.
Состояния
Состояния создаются во вкладке Показатели дашборда. Они используются для ограничения фильтрации виджетов. Например, если на двух разных виджетах установлены разные состояния, при фильтрации по клику на другой виджет фильтр не применится.
Чтобы применить состояние к виджету, выберите необходимое из списка.
Настройка действий
Во вкладке Действия можно настроить запуск скрипта из дашборда для виджета Таблица.
Была ли статья полезна?