Reporting status
Out of the box, Open SDG provides a page showing the "reporting status" of all the indicators, grouped by which goal they are in. This can be helpful in measuring the completeness of the platform, by clearly showing how many indicators have data and how many do not.
Reporting status options¶
By default, the reporting status options dispayed are Complete, In progress and Exploring data sources. However, these options can be changed to meet your needs. For example, options can be removed or another option, such as Not applicable, can be used.
The options available can be controlled by adjusting the status_types
property on reporting_status site configuration. For example, here is the reporting_status
site configuration that is in the site starter project, at the time of this writing - note the status_types
section below:
reporting_status:
title: status.reporting_status
description: status.description
disaggregation_tabs: false
status_types:
- value: notstarted
label: status.exploring_data_sources
hide_on_goal_pages: false
- value: complete
label: status.reported_online
hide_on_goal_pages: false
- value: notapplicable
label: status.not_applicable
hide_on_goal_pages: false
Color-coding¶
The horizontal bars on the reporting status page have color-coded segments. The default options mentioned above are already color-coded for black, grey, and white, respectively. That color-coding is controlled using Sass variables in this Sass variables file. To override any of these variables, you can override and edit this placeholder file for Sass variable overrides.
To color-code your custom options, add your own CSS code (such as in a custom.scss
file) using a class name that is the same as the option value. For example, if you have added a custom status type like so:
reporting_status:
status_types:
- value: my_custom_status_type
label: My custom status type
hide_on_goal_pages: false
Then you could color-code the "my_custom_status_type" option by adding this in your CSS:
.my_custom_status_type { background-color: pink; }
Alternative groupings¶
Apart from grouping by goal, you might like to show the reporting status in different ways (such as "status by tier", for example). To do this, your data repository needs to be configured to generate the necessary data. See the config_data.yml
file in the data starter, for an example.
Note that the value of that setting in the data repository should be a list of fields which are present in your indicator metadata files.
For example, suppose you would like to show reporting status grouped by UN custodian agency. To do this, you must have a field in your indicator metadata which specifies the UN custodian agency. (In fact, the data starter ships with such a field, called un_custodian_agency
.) To accomplish this, you could have the following configuration for your data repository's reporting_status_extra_fields
:
reporting_status_extra_fields:
- un_custodian_agency
There is no configuration necessary in the site repository, for this feature. Open SDG can automatically detect whether you have reporting_status_extra_fields
configured in the data repository.