График

Общая информация

График в наглядной форме отображает множественные данные из системы. С помощью графика можно отобразить, например, распределение контрагентов по типам (рис. 1). График может отображать информацию в виде диаграмм разных типов, либо в виде реестра данных. Подробнее о графиках можно узнать из статьи "Блок итогов «График»", а о их настройке — из статьи "Настройка блока итогов «График»".

Рис. 1 — Пример блока итогов "График"

Классы, реализующие функциональность графиков

ChartViewModel — модель представления графиков.

ChartViewConfig — генерирует конфигурацию представления модуля графика.

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

ChartDesigner — схема представления страницы редактирования графиков.

ChartModuleHelper — используется для формирования запроса с помощью объекта Terrasoft.EntitySchemaQuery.

ChartDrillDownProvider — содержит методы для работы с функциональностью углубления в элементы (для работы с сериями в графиках).

Параметры настройки графика

Для настройки графика необходимо в конфигурацию модулей виджетов добавить конфигурационный JSON-объект с настройками свойств графика. Конфигурация модуля виджета определяется свойством Items объекта SysDashboard. Подробнее об объекте SysDashboard и его свойствах можно узнать из статьи "Виджеты итогов".

В конфигурационном JSON-объекте с настройками виджета необходимо установить значение "Chart" свойству widgetType. Кроме того, свойству parameters нужно присвоить объект с необходимыми параметрами. Возможные параметры графика приведены в таблице 1.

Табл. 1. — Параметры настройки графика

Название	Тип	Описание
seriesConfig	object	Настройки вложенного графика из серии.
orderBy	string	Поле сортировки.
orderDirection	string	Направление сортировки.
caption	string	Заголовок графика.
sectionId	string	Идентификатор раздела.
xAxisDefaultCaption	string	Заголовок оси X по умолчанию.
yAxisDefaultCaption	string	Заголовок оси Y по умолчанию.
primaryColumnName	string	Название первичной колонки. По умолчанию первичной является колонка Id.
yAxisConfig	object	Массив настроек подписи оси Y.
schemaName	string	Объект, по которому строится график.
sectionBindingColumn	string	Колонка связи с разделом.
func	string	Агрегирующая функция.
type	string	Тип графика.
XAxisCaption	string	Заголовок оси X.
YAxisCaption	string	Заголовок оси Y.
xAxisColumn	string	Колонка группировки оси X.
yAxisColumn	string	Колонка группировки оси Y.
styleColor	string	Цвет графика.
filterData	object	Настройка фильтрации.