Show/Hide Toolbars

Руководство администратора

warning_icon Для включения по умолчанию инструмента отображения графиков и диаграмм Apex charts необходимо указать параметр highCharts в пользовательском ключе custom-app-settings

В блоке "График" отображаются сводные данные о задачах в табличном или графическом виде.

Кликните мышью для просмотра изображения в полном размере

Дополнительные настройки блока "График"

Типы графика

Линейная диаграмма

При выборе типа диаграммы "Линейная диаграмма"  или "Линейная диаграмма (область)" отображается дополнительный блок параметров для настройки:

block_graph_linear

Настройки линейных диаграмм

При включенном параметре Отображать значения рядом с точками на графике отображаются значения:

portal_block_edit_graphics-01

Значения отображаются рядом с точками

portal_block_edit_graphics-02

Линейная диаграмма (область)

Столбчатая диаграмма

При выборе типа диаграммы "Столбчатая"  или "Столбчатая (горизонтальная)" отображается дополнительный блок параметров для настройки:

block_graph_histogram

Настройки столбчатых диаграмм

Если включен парметр Сгруппировать столбцы, то столбцы накладываются друг на друга.

Если парметр Включить подписи столбцов включен, то на графике рядом с вершинами столбцов отображаются числовые значения:

block_graph_histogram_view_n

Диаграмма с подписями столбцов

Секторная (круговая) диаграмма

При выборе типа диаграммы "Секторная"  или "Секторная без центра" отображается дополнительный блок параметров для настройки:

block_graph_sect_prop

Настройка круговых (секторных) диаграмм

Параметр Выводить значения вместо процентов определяет формат вывода подписей — в виде % от общего числа или в количественном выражении:

portal_block_edit_graphics-07

Отображение подписей в виде процентов или значений

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

portal_block_edit_graphics-06

Секторная без центра

Таблица

При выборе типа диаграммы "Таблица" отображается дополнительный блок параметров для настройки:

block_graph_table_prop

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

Чтобы при отображении графика в виде таблицы выводилась итоговая строка, отметьте опцию Включить "Итого по таблице".

В поле Текст "Итого по таблице" можно задать надпись, которая будет отображаться в итоговой строке.

block_graph_table

Таблица

Спидометр

При выборе типа диаграммы "Спидометр" отображается дополнительный блок параметров для настройки:

block_graph_speed_prop

Настройки спидометра

Для правильного отображения спидометра надо задать максимальное и минимальное значения шкалы (с помощью смарт-выражений или указав конкретные числовые значения).

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

Диапазоны и цвета

Таблица Задать диапазон, выделенный цветом определяет порядок цветовых диапазонов и их значений. В таблице надо создать необходимое количество записей, состоящих из двух параметров:

цвет в формате html hex (RRGGBB). Например, ff0000 — это красный цвет;

значение, соответствующее максимальному значению данного цветового диапазона.

Например, запись со значениями «ff0000» и «300» означает, что красным будет отображаться диапазон, начинающийся от максимального значения предыдущего диапазона до 300.

Таким образом, максимальное значение всей шкалы определяется значением, заданным в последнем диапазоне.

speed1

Настройки диапазона спидометра

portal_block_edit_graphics-09

Отображение спидометра в пользовательском режиме

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

speed3

Настройки относительного диапазона спидометра

Воронка продаж

warning_icon В источнике данных для графика "Воронка продаж" не должно использоваться агрегирование данных.

При выборе типа диаграммы "Воронка продаж" отображается дополнительный блок параметров для настройки:

block_graph_sales

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

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

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

portal_block_edit_graphics-11

Воронка продаж

Линейная с накоплением

Для правильного отображения диаграммы типа "Линейная с накоплением"  или "Линейная с накоплением (горизонтальная)" в блоке настройки SQL-объекта необходимо заполнить поле Группировать по. В этом поле должен быть указан столбец, по которому осуществляется группировка данных.

Подсчет итогов выполняется по столбцу, указанному в поле "Заголовок" и определяющему значения по оси Х.

Цвета сегментов определяются автоматически.

Пример:

portal_graph_stacked_data

Источник данных

portal_graph_stacked_props

Настройки диаграммы

portal_block_edit_graphics-08

Линейная с накоплением

portal_block_edit_graphics-03

Линейная с накоплением (горизонтальная)

Настройки блока

Параметр

Описание

Шаблон подсказки

Шаблон подсказок, которые всплывают при наведении курсора мыши на область или точку графика.

Подробнее о всплывающих подсказках

Цвет графика

Выбор цвета из палитры.

Если источником данных является SQL-объект (см. ниже), то для задания цвета может использоваться одна из возвращаемых колонок SQL-объекта.

Источник данных

Источником данных для построения графика является смарт-запрос или представление SQL-объект (таблицу, представление или хранимую процедуру). Для выбора нужного режима щелкните мышкой по соответствующей половинке поля; неактивное поле отображается на сером фоне.

Чтобы использовать готовый смарт-запрос, выберите его из выпадающего списка. Чтобы отредактировать выбранный запрос, нажмите иконку button_edit справа от поля выбора, а чтобы создать новый смарт-запрос, нажмите иконку !GreenCross. Откроется окно конструирования смарт-запроса.

На одном графике могут отображаться результаты как одного, так и двух смарт-запросов (каждый своим цветом). Типы графиков должны быть совместимы (например, оба графика должны иметь либо горизонтальную, либо вертикальную направленность). Для графиков типа "Таблица", "Секторная" и "Спидометр" второй график не поддерживается.

Чтобы использовать в качестве источника данных SQL-объект, введите его название. Данные из поля "Заголовок" будут отображаться по оси X, а данные из поля "Значения" — по оси Y.

Требования к SQL-объекту описаны ниже.

Добавить график

По умолчанию в блоке настроек отображаются блоки для настройки одного графика (одной серии значений). По нажатию кнопки Добавить график добавляется блок для настройки еще одного графика.

warning_icon Возможность отображения нескольких серий на одном графике поддерживается только для источников SQL-объектов

Показывать заголовки осей

При включенном параметре для графиков отображаются названия осей

Подпись оси X

Подпись оси Y

Если значения заполнены, то они "подменяют" названия соответствующих параметров смарт-запроса или SQL-view.

Не удалять метрические сокращения

При включенном параметре из подписей к значениям не удаляются сокращения "тыс.", "млн" и т.п.

Показывать легенду

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

Щелкнув на определенный элемент легенды, можно включить\отключить отображение соответствующего элемента на графике

Открывать задачи по клику на диаграмме

При включенном параметре вы сможете просматривать список объектов, которые участвуют в формировании сводного значения для каждой области диаграммы. Если источником данных является SQL View, то эта возможность не поддерживается

Кол-во знаков после запятой, для вывода в тултипе

Если в поле указывается "-1", то количество выводимых знаков определяется автоматически, исходя из значений в источнике данных для конкретного графика.

Начинать ось Y с минимального значения источника

Если настройка активна, вертикальная ось (ось Y) будет начинаться с минимального значения, указанного в исходных данных.

Отображать значения по оси Y зеркально

Если настройка активна, значения по вертикальной оси графика (оси Y) будут отображаться зеркально

Округлять значения оси Y до целых

Если опция включена, все значения на вертикальной оси Y будут округлены до целых чисел, что может повысить читаемость графика и упростить восприятие данных. Если опция выключена, значения будут отображаться с плавающей запятой. Пример: На графике, где значения могут быть от 1.2 до 10.8, при включенной опции они будут отображаться как 1, 2, 3, …, 11

Тип шкалы

Возможные значения:

линейная шкала,

логарифмическая шкала,

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

Максимальное значение по оси X

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

Минимальное значение по оси X

Параметр определяет наименьшее значение по горизонтальной оси (ось X) на графике. Он указывает на самое левое положение точек данных.

Максимальное значение по оси Y

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

Минимальное значение по оси Y

Параметр определяет наименьшее значение по вертикальной оси (ось Y) на графике. Он указывает на самое нижнее положение точек данных.

Цена деления по оси X

Параметр указывает на расстояние между делениями (отметками) по горизонтальной оси (ось X) на графике. Он помогает определить шаг значений по оси X.

Цена деления по оси Y

Параметр указывает на расстояние между делениями (отметками) по вертикальной оси (ось Y) на графике. Он помогает определить шаг значений по оси Y.

Количество значений на оси Y

Настройка определяет, сколько делений или отметок будет отображаться на вертикальной оси Y. Установка подходящего количества значений помогает сделать график более информативным и компактным. Пример: Если установить количество значений на 5, на оси Y будут равномерно распределены 5 меток.

*Для вывода более сложных данных используйте блок Таблица.

Всплывающие подсказки

При наведении курсора мыши на область или точку графика всплывает подсказка. По умолчанию в подсказке отображаются значения по осям X и Y, а также название серии.

portal_block_edit_graphics-05

Всплывающая подсказка по умолчанию

Формат подсказки можно настроить, заполнив поле "Шаблон подсказки". Шаблон задается в формате highcharts отдельно для каждого графика (каждой серии значений). Если задан шаблон, он замещает подсказку по умолчанию. Название точки выводится в подсказке всегда, первой строкой, независимо от настроенного шаблона.

В шаблонах можно использовать текст, обращение к данным и html-теги для форматирования.

Для обращения к данным можно использовать типовые аргументы:

{series.name} — название графика (серии),

{point.name} — название точки,

{point.x} — значение по оси X. Если по оси X отображаются названия, то {point.x} будет выдавать порядковый номер значения в серии, начиная с 0,

{point.y} — значение по оси Y,

{point.percentage} — процент значения по оси Y от общего суммарного значения (для секторных диаграмм),

{point.total} — общее суммарное значение (для секторных диаграмм).

Числовые поля могут иметь модификатор .f, который определяет число десятичных знаков после запятой:

{point.y:.1f} или {point.percentage:.2f} — вывод значения с точностью до 1 или 2 знаков после запятой.

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

warning_icon Названия типовых аргументов зарезервированы — если хранимая процедура возвращает столбец с именем, совпадающим с именем типового аргумента (например, y или total), значения такого столбца будут замещены значениями типового аргумента

Примеры подсказок:

Шаблон

График

<b>{point.y}</b>

block_graph_tooltips_2

{point.y}<br/><b>{point.percentage:.0f}% от общего числа</b>

block_graph_tooltips_3

{point.y} с кодом {point.code}

block_graph_tooltips_4

Пример создания и настройки виджета График:

Виджет График (6:49 мин.)

Использование SQL объектов

В качестве источника данных для графика можно использовать SQL-объект: хранимую процедуру, представление (view) или таблицу.

warning_icon Обратите внимание: у PostgreSQL имеется своя специфика работы с хранимыми процедурами — как правило они используются для выполнения обновления данных. Для получения значений рекомендуется использовать пользовательские функции или представления.

Кликните мышью для просмотра изображения в полном размере

Окно настройки источника данных SQL

Поле

Описание

Выбор источника данных

SQL Объект

SQL-процедура

Заголовок

Текстовая колонка с названиями, которые будут отображаться по оси X

Значения

Числовая колонка со значениями, которые будут отображаться по оси Y на первом графике

Цвета

Текстовая колонка с кодами цветов в HEX-формате (6 символов) или HTML-формате (предопределенные цвета, такие как blue, red и т.п.).

Например, для белого цвета: FFFFFF или white

Колонка для функции Drilldown

Колонка, по которой настраивается детализация (поле может быть пустым)

Группировать по

Колонка, по которой группируются данные для получения промежуточных итогов (поле может быть пустым)

Кол-во строк которые нужно игнорировать

Если SQL-объект содержит итоговые строки, которые не должны отображаться на графике, укажите количество таких строк (поле может быть пустым)

Настроить таблицу детализации

Если для графика включена возможность детализации данных (параметр Открывать детализацию по клику на графике), то необходимо настроить параметры детализации. Для этого перейдите по ссылке Настроить таблицу детализации. Работа с этой таблицей аналогична настройке блока "Таблица".

Отображение нескольких серий на одном графике

По кнопке Добавить график отобразится окно для настройки новой серии значений. Укажите название, тип графика, шаблон подсказки и цвет графика. Включите настройку "Использовать данные из SQL-view (третий столбец)" и выберите столбец со значениями для серии.

Кликните мышью для просмотра изображения в полном размере

Настойка еще одной серии на графике

warning_icon Не все типы графиков совместимы и могут выводиться в одном портальном блоке. Например, линейная и столбчатая диаграммы совместимы, а линейная и секторная — нет.

Конструктор смарт-запросов

Нажав значок button_edit или !GreenCross справа от поля выбора смарт-запроса, вы перейдете в окно конструирования смарт-запроса:

portal_smart

Окно конструктора смарт-запросов

Параметр

Описание

Имя

Название запроса

Категория

Категория, по которой строится запрос

Условие отбора задач

Смарт-выражение, которое определяет условие отбора задач.

С помощью выпадающего списка можно выбрать готовое смарт-выражение или создать новое

Выражение для заголовков

Смарт-выражение, которое определяет значения по оси Х (для запросов с агрегированием — поля группировки, аналог GROUP BY в языке SQL).

С помощью выпадающего списка можно выбрать готовое смарт-выражение или создать новое

Выражение для значений

Смарт-выражение, которое определяет значения по оси Y, то есть выводимые результаты.

С помощью выпадающего списка можно выбрать готовое смарт-выражение или создать новое.

При установленном способе агрегирования Count (см. след. пункт) параметр не отображается

Агрегировать значения

Способ агрегирования значений. Возможные значения:

без агрегирования,

Avg (среднее),

Count (количество),

Min (минимальное значение),

Max (максимальное значение),

Sum (сумма)

Сортировать

Возможные значения:

без сортировки,

по заголовкам,

по значениям

Возвращать записей

Количество записей, возвращаемых смарт-запросом. Если поле пустое, то число возвращаемых записей не ограничено, в противном случае будут возвращено указанное количество записей (первых в зависимости от сортировки)