Building Insights Pages¶
An insights page is a dashboard. It holds widgets that each run their own query over your cases or instances and draw the result as a chart, a table or a single number. Insights pages are configured under Configuration → Pages by creating a page of type Insights and adding widgets to its grid.
Anatomy of a widget¶
Every chart widget answers one question, and that question is assembled from four parts.
Data source \ Whether the widget counts cases or instances, and which attribute it looks at. The attribute can be a built-in one such as the workflow state, the assignee or the initiator, or any information you have configured.
Aggregation \ What to do with the values it finds: Group counts how many fall into each value, Total, Average, Minimum and Maximum do the arithmetic on a numeric attribute, and Distinct counts distinct values.
Secondary grouping \ How the result is split a second time. None gives a single set of values. Over time puts time buckets on the axis, controlled by the time interval and the maximum number of intervals. Attribute splits every group by a second attribute, giving one series per value of that attribute.
Visualization \ Which chart type draws the result, plus its options: value type, maximum number of groups, sorting and the chart-specific settings described below.
Filters restrict what the widget looks at, independently of the page it sits on.
Chart types¶
Bar \ Compares one value across categories. The default for "how many cases are in each state". Combine it with Over time to show a number developing over time. A Horizontal orientation, for long category labels, is new in Atfinity 17.
Stacked Bar \ Shows what each category is made of by stacking a second grouping on top of itself, for example cases per month split by assignee. Requires a secondary grouping. The maximum number of subgroups controls how many segments are drawn before the rest is collected into Other.
Line (new in Atfinity 17) \ Connects the data points, which implies they belong to one another. For that reason a line chart always uses the Over time secondary grouping: the axis is time, and the line shows a development. Use it as the alternative to a bar chart when the trend matters more than the individual values. With a secondary attribute it draws one line per value.
Pie \ Shows how a total is divided between categories. Drawn as a donut by default; turning off Show as donut for a full pie is new in Atfinity 17. Best kept to a handful of slices, with the rest collected into Other.
Metric \ A single number, for example the number of open cases. Optionally compares against the previous period, and can carry a unit.
Table \ Not a chart: a list of cases or instances with the columns you choose. Useful when the individual records matter rather than an aggregate.
Value types and labels¶
The value type decides how numbers are written in labels and legends: the plain Amount, the Amount (Percentage) combination, or just the Percentage. The maximum number of groups caps how many categories a chart draws; everything beyond it is added up into a single Other entry so that the total stays correct.
Errors¶
A widget whose configuration cannot produce data is reported as an error on the page and marked with a red icon in its header in the configuration grid. The message names the reason, for example a line chart without the Over time grouping, or an over-time bar chart on an attribute that is not a number. These errors block putting the configuration live.
Insights in documents¶
The same charts exist in ADX, so a document can show the same picture as a dashboard. The difference is where the numbers come from: an insights widget queries them itself, while an ADX chart is a presentation layer that renders whatever the template passes in through Jinja. See Charts for the tags and their attributes.