The Ed-Fi Dashboard Metrics are organized in a hierarchical structure based on Education Organization types (e.g., School, Local Education Agency). The metrics can be managed via the Ed-Fi Core Dashboard Data Types Metric Metadata CSV files, but this can be challenging and error-prone. The Metric Configuration Tool is a lightweight utility to manage the logical hierarchy used by the Ed-Fi Dashboards metrics. The tool can be used to review the core, as-shipped metric hierarchy and extend the core metrics by adding new metrics following the core extension principles.
Instructions for deploying this utility on a developer machine can be found here.
Ed-Fi Dashboard Metric Management
The metric display in the Ed-Fi Dashboards are organized into a logical hierarchy. This hierarchical organization is defined by metadata. The metadata is used to drive both the navigation menus and the metric content on the Dashboard pages. The dashboard interface is rendered by combining the dashboard metric data calculated values with the hierarchal metadata into ASP.NET MVC view model classes in the code.
The metric configuration tool handles three tasks: import, export, and edit of CSV files.
The import option allows user to upload their dashboard type CSV files. The dashboard type files for a core dashboard implementation can be found in the Ed-Fi Dashboards repository. There are files for two versions of the Ed-Fi ODS:
- ODS v2.0. /Ed-Fi-Alliance/Ed-Fi-Dashboard/tree/v2.0/Etl/src/EdFi.Runtime/Reading/Queries/2.0/DashboardTypes
- ODS v1.2. /Ed-Fi-Alliance/Ed-Fi-Dashboard/tree/v2.0/Etl/src/EdFi.Runtime/Reading/Queries/1.2/DashboardTypes
The tool does not manage versioning or auditing of changes made to these files but they have a profound impact on the system – so we strongly recommended that these dashboard type files are checked in to source control before editing.
Once the files have been edited, we recommend you export the files, replace the original files, and check the updated files into source control. The ETL process will load the files into the metric metadata table and update the UI rendering accordingly. For more details on this process, review Import Dashboard Types.
The edit menu allows users to edit, add, and remove metrics. The sections below describe the overall hierarchy and navigation options the tool offers.
Main Metric Hierarchy
The as-shipped, core dashboards are based on a Local Education Agency > Schools > Student hierarchy. Depending on the role of the user, the landing page on the dashboards will be the Local Education Agency Overview (for superintendents), the School Overview (for principals), or the School Teacher View (for teachers). A Student Overview page is the most granular view.
Main Metric Category
The Local Education Agency, School, and Student metric types each contain a main metric category page. This view represents the tabs available in the dashboard for the hierarchy level you are in.
It is important to note that the available categories at the School level might be different based on the school category. For example, the category College and Career Readiness is available at the Local Education Agency (District) level as shown in Figure 1, below. This category is also available at the School High School category (Figure 2) – but it is not available at the School Elementary category (Figure 3) since metrics in this category only apply to high school grade levels.
Figure 1. District - College and Career Readiness Category
Figure 2. High School - College and Career Readiness Category
Figure 3. Elementary School Categories
Aggregate, Container, and Granular Metrics
Each category of metric contains Aggregate, Container, and Granular metrics. In general, calculations are performed at the container and/or granular level. This is reflected in the metric configuration navigation.