Добавление диаграмм

Построение диаграмм

Добавление диаграмм на страницу возможно с помощью макроса diag. Макрос отображает диаграмму, основываясь на заданных пользователем входных данных. Кроме того, возможно задание в качестве входных данных результата выборки из базы, формируемое макросом dataset.

Данные для диаграммы передаются макросу diag с помощью параметра data. Настройки отображения данных задаются с помощью параметра options. Синтаксис, подробное описание и примеры этих параметров описаны здесь.

Возможны следующие варианты входных данных:

1. Строка со значениями для построения диаграммы

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

{diag:data="[[[1, 20], [2, 22.5], [3, 30]]]"}

Результат:

2. Имя JSON объекта, содержащего данные

Этот способ подходит для описания сложных и/или больших по объему входных данных

{json:name="data1"}
[
	{ "label": "IE",  "data": 24.43},
	{ "label": "Firefox",  "data": 42.9},
	{ "label": "Chrome",  "data": 25.6},
	{ "label": "Safari",  "data": 4.1},
	{ "label": "Opera",  "data": 2.6}
]
{json}

{json:name="options1"}
{
	"series": {
		"pie": { 
			"show": true
		}
	}
}
{json}

{diag:data="data1"|options="options1"}

Результат:

3. Имя набора данных, формируемого по результатам запроса к базе данных

В таком варианте данные для построения диаграммы берутся непосредственно из базы данных, с использованием макроса dataset (набор данных).
Project Kaiser позволяет строить два вида диаграмм, основанных на наборах данных:

1. График - для отображения развития процеса во времени. Входные данные представляют собой набор координат точек, соединяемые линией на графике.
2. Круговая диаграмма - для отображения вклада каждого значения в общую сумму.

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

• набору данных должен быть присвоен идентификатор (ID), например "dataset1". Этот идентификатор используется для указания набора данных в макросе diag;
  
• набор данных должен быть группирован по полю assignee_name (имя исполнителя);
• В заголовке (или нижнем колонтитуле) группировки необходимо добавить два вычисляемых поля:
• avg (среднее) поля assignee_name (имя исполнителя) - для отображения имени исполнителя в данной группировке. Необходимо присвоить этому полю id="label", чтобы на диаграмме это поле использовалось в качестве наименования значения;
• count (количество) assignee_name (имя исполнителя) - для отображения количества задач в данной группировке. Необходимо присвоить этому полю id="data",чтобы на диаграмме это поле испольвалось в качестве числового значения;
• тело набора данных (dbody) не должно ничего содержать
  

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

{dataset:name="com.triniforce.document.datasets.meta.Tasks"|id="dataset1"}
	{param:name="parent_id"|value="13751"}
	{group-by:field="assignee_name"}
		{header}
			{afield:name="assignee_name"|func="avg"|id="label"}, {afield:name="assignee_name"|func="count"|id="data"}
		{header}
		{dbody}
		{dbody}
	{group-by}
{dataset}

{json:name="options1"}
{
	"series": {
		"pie": { 
			"show": true
		}
	}
}
{json}

{diag:data="dataset1"|options="options1"|width="250px"|height="160px"}

Результат: