Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

An indicator drill allows you to further analyse an indicator. Indicator drill consists of an array of blocks. These blocks can be displayed either after clicking on an indicator, or directly on a dashboard.

...

It is possible to display any block directly on a dashboard by setting the onDashboard property to true (see examples below). The block will be accessible and controllable without having to drill down on the indicator.

...

Additionally, it is possible to add annotations. Annotations are basically events that can be displayed in the timeSeries graph. The data for annotations are stored in a specific date subtype dataset, named e.g. "events". This dataset must contain a foreign key property containing id of the object to which the event relates to - in this case shops. It also must be linke to the dim_dates dataset of the date dimension, and contain a description of the event (which also must be in the featureTitle property). The visual representation of such timeSeries block can be found below.

Code Block
titleEvents dataset syntax
collapsetrue
{
    "name": "events",
    "type": "dataset",
    "title": "Events",
    "properties": {
        "featureTitle": {
            "type": "property",
            "value": "description"
        }
    },
    "ref": {
        "type": "dwh",
        "subtype": "date",
        "table": "events",
        "primaryKey": "id",
        "categorizable": false,
        "fullTextIndex": false,
        "properties": [
            {
                "filterable": false,
                "name": "id",
                "title": "Id",
                "column": "id",
                "type": "integer"
            },
            {
                "filterable": false,
                "name": "shop_id",
                "title": "Shop id",
                "column": "shop_id",
                "type": "integer",
                "foreignKey": "shops"
            },
            {
                "filterable": false,
                "name": "date_iso",
                "title": "Date iso",
                "column": "date_iso",
                "type": "date",
                "foreignKey": "dim_dates"
            },
            {
                "filterable": false,
                "name": "description",
                "title": "Description",
                "column": "description",
                "type": "string"
            }
        ]
    }
}

...

Distribution also has a description, which is not configurable through metadata, but is compiled from the properties of its paired indicator, according to this formula: "Distribution of indicator.title in granularity"

KeyTypeOptionalityDescriptionConstraints
typestring

Status
colourRed
titlerequired

type identifier, always distribution

[distribution]
onDashboardboolean
Status
colourGreen
titleoptional
determines if the block should be displayed directly on a dashboard[true, false]

...

Ranking also has a description, which is not configurable through metadata, but is compiled from the properties of its paired indicator, according to this formula: "Rank of object according to indicator.title" (note: object in this case is either a polygon from a certain granularity, or a marker).

KeyTypeOptionalityDescriptionConstraints
typestring

Status
colourRed
titlerequired

type identifier, always ranking

[ranking]
onDashboardboolean
Status
colourGreen
titleoptional
determines if the block should be displayed directly on a dashboard[true, false]
featureTypestring
Status
colourGreen
titleoptional

specifies which feature type should be ranked by default

default = granularity

[granularity, markers]
directionstring
Status
colourGreen
titleoptional

specifies the direction of ranked objects

default = desc

[asc, desc]

...

Time series also has a description, which is not configurable through metadata, but is compiled from the properties of its paired indicator, according to this formula: "Progress of indicator.title from view.content.filterGroup.globalDate.startDate to view.content.filterGroup.globalDate.endDate"

KeyTypeOptionalityDescriptionConstraints
typestring

Status
colourRed
titlerequired

type identifier, always timeSeries

[timeSeries]
onDashboardboolean
Status
colourGreen
titleoptional
determines if the block should be displayed directly on a dashboard[true, false]
defaultPeriodstring
Status
colourGreen
titleoptional
specifies the default period dataset selected by default/rest/projects/$projectId/md/datasets?name={datasetName}
additionalSeriesarray
Status
colourGreen
titleoptional
array of additionalSeries objects
annotationsarray
Status
colourGreen
titleoptional
array of annotations objects

...

Contains link to an additional time series indicator. See the syntax example above.

KeyTypeOptionalityDescriptionConstraints
indicatorstring

Status
colourRed
titlerequired

URL link to the indicator object

/rest/projects/$projectId/md/indicators?name={indicatorName}

...

Contains link to a dataset with annotation data. See the syntax example above.

KeyTypeOptionalityDescriptionConstraints
datasetstring

Status
colourRed
titlerequired

URL link to the dataset object

/rest/projects/$projectId/md/datasets?name={datasetName}

...

KeyTypeOptionalityDescriptionConstraints
typestring

Status
colourRed
titlerequired

type identifier, always categories

[categories]
titlestring
Status
colourRed
titlerequired
human-readable title of the categories block(*)
descriptionstring
Status
colourRed
titlerequired
description of the categories block(*)
splitPropertystring
Status
colourRed
titlerequired
identifier of a dataset property, by which the classes of data will be split{datasetName}.{datasetProperty}
indicatorstring
Status
colourGreen
titleoptional

URL link to the indicator object

(info) in case the block should not drill its paired indicator from the dashboard

/rest/projects/$projectId/md/indicators?name={indicatorName}
onDashboardboolean
Status
colourGreen
titleoptional
determines if the block should be displayed directly on a dashboard[true, false]
collapsedboolean
Status
colourGreen
titleoptional
determines if the block should be collapsed when entering the view[true, false]
visualizedboolean
Status
colourGreen
titleoptional
determines if the block should be visualized when entering the view (= if qualitative visualization should be enabled, more here)[true, false]
filterableboolean
Status
colourGreen
titleoptional

flag that allows you to turn off the default filterability

if not present, the block is filterable, must be set to false to turn it off

[true, false]
hideNullItemsboolean
Status
colourGreen
titleoptional

determines if the block should display categories with null or zero values

default = false

[true, false]
sizeLimitinteger
Status
colourGreen
titleoptional
limit the size of displayed categoriesx => 1
orderByobject
Status
colourGreen
titleoptional

specifies ordering of the properties in the block

(info) if orderBy is not specified, the categories are ranked by the indicator value

see content.filterGroup.multiSelect.orderBy


verticalboolean
Status
colourGreen
titleoptional

determines if the block should be vertical

(warning) doesn't work with condensed, dualProperty and label properties

[true, false]
condensedboolean
Status
colourGreen
titleoptional

determines if the block should appear as condensed or not

(info) see visual representation below

[true, false]
dualPropertystring
Status
colourGreen
titleoptional

identifier of a dataset property, by which the data will be dually split

(warning) block with dualProperty is always condensed = true

{datasetName}.{datasetProperty}
labelstring
Status
colourGreen
titleoptional

determines the default label of condensed categories

(warning) it is not possible to set the label for condensed = false block

(*)

...

The data in the distribution block below are evenly distributed, and distinctively separate the areas of interest.

Image RemovedImage Added

Ranking block

This block ranks areas by a specific indicator. In this case, it's the number of customers turnover value in Ward areasadministrative units.

Image RemovedImage Added

Time series block

Time series block shows progress and trend of a selected indicator over a specific period of time.

Image RemovedImage Added

Time series block with additionalSeries

This block contains one additional indicator in the additionalSeries. It shows the comparison of offline (blue) and online (black) turnover. See the syntax example above.

...

If you specify more than one additional indicator, a dropdown menu with all other available indicators is displayed.

...

Image Added

Time series block with additionalSeries and annotations

Events specified in the annotations array are related to a specific object - in this case a marker. So, note that to see them - we have to drill down on that specific marker. See the syntax example above.

...

Image Added

Categories block

Categories block lists specific classes of data.

This is a comparison of Total turnover by each day of the week.

Image RemovedImage Added

Categories also offers some additional configuration. It is possible to make the block condensed, or make it dually split (age pyramid). In condensed and dual mode, the detail of each category can be shown by hovering over it.

...

regularcondensed


Code Block
{
    ...
    "condensed": false
}



Code Block
{
    ...
    "condensed": true,
    "label": "Age groups"
}


Image RemovedImage Added

Image RemovedImage Added

dualvertical


Code Block
{
    ...
    "condensed": true,
    "dualProperty": "demography_age_1.sex",
    "label": "Age groups"
}



Code Block
{
    ...
    "vertical": true
}


Image RemovedImage Added

Image RemovedImage Added

Blocks on a dashboard

Available by setting the onDashboard property to true.

distributioncategories

Image RemovedImage Added


Image RemovedImage Added

rankingtimeSeries
Image RemovedImage AddedImage RemovedImage Added