Chart editor guide
Chart editor guide
You can create custom charts from GitLab data using the chart editor. In this guide, we'll guide you through the steps of creating any chart using GitLab boards as data sources.
You can create custom charts from GitLab data using the chart editor. In this guide, we'll guide you through the steps of creating any chart using GitLab boards as data sources.
You can create custom charts from GitLab data using the chart editor. In this guide, we'll guide you through the steps of creating any chart using GitLab boards as data sources.
Select the chart type
You can select the chart type using the Chart type menu:
You can learn more about the available charts on the Charts Tour.
Select the chart type
You can select the chart type using the Chart type menu:
You can learn more about the available charts on the Charts Tour.
Select the data sources
In the Data sources menu, you can select one or more boards to be used as data sources in the chart:
You can select multiple items from this menu by picking one, then another, and so on. The list contains the GitLab boards you have imported to Screenful.
You can import more boards by selecting Data sources from the main menu:
Select the data sources
In the Data sources menu, you can select one or more boards to be used as data sources in the chart:
You can select multiple items from this menu by picking one, then another, and so on. The list contains the GitLab boards you have imported to Screenful.
You can import more boards by selecting Data sources from the main menu:
Select the unit for the chart
You can select the unit for the chart from the Unit menu. The default selection is Issues and MRs, which shows the counts as the number of issues and merge requests (you can use the filter feature to limit to either one):
You can change the unit to either Points, Hours or Time in state:
The selected unit is reflected in the chart as follows:
Issues and MRs -> Chart uses issue and merge request count as the unit (e.g. completed issues within a date range).
Points -> Chart uses estimates as the unit.
Hours -> Chart uses logged hours as the unit.
Time in state -> Chart shows timing data e.g. time in progress, lead time, cycle time.
Select the unit for the chart
You can select the unit for the chart from the Unit menu. The default selection is Issues and MRs, which shows the counts as the number of issues and merge requests (you can use the filter feature to limit to either one):
You can change the unit to either Points, Hours or Time in state:
The selected unit is reflected in the chart as follows:
Issues and MRs -> Chart uses issue and merge request count as the unit (e.g. completed issues within a date range).
Points -> Chart uses estimates as the unit.
Hours -> Chart uses logged hours as the unit.
Time in state -> Chart shows timing data e.g. time in progress, lead time, cycle time.
Select the metric for the chart
Once you have selected the unit for the chart, the next step is to choose the metric:
Pay attention to this step, as picking the wrong metric can produce undesired results. Some of these metrics require a date range, while others don't. The first three metrics show the current state, and therefore, there is no date range involved. When you select a metric that requires a date range, the date range menu appears automatically.
The selected metric is reflected in the chart as below:
Total -> The total amount of the selected unit in the selected data sources
Not started & In progress -> The amount of selected unit not completed, according to the workflow settings
In progress -> The amount of selected unit in progress, according to the workflow settings
Created (within date range) -> How much of the selected unit was created within the date range
Completed (within date range) -> How much of the selected unit was completed within the date range
Select the metric for the chart
Once you have selected the unit for the chart, the next step is to choose the metric:
Pay attention to this step, as picking the wrong metric can produce undesired results. Some of these metrics require a date range, while others don't. The first three metrics show the current state, and therefore, there is no date range involved. When you select a metric that requires a date range, the date range menu appears automatically.
The selected metric is reflected in the chart as below:
Total -> The total amount of the selected unit in the selected data sources
Not started & In progress -> The amount of selected unit not completed, according to the workflow settings
In progress -> The amount of selected unit in progress, according to the workflow settings
Created (within date range) -> How much of the selected unit was created within the date range
Completed (within date range) -> How much of the selected unit was completed within the date range
Select grouping
If the selected chart type supports grouping, the Group by menu allows the selection of the grouping criteria:
At the bottom, you'll have the time-based grouping options: day, week, month, and quarter:
Select grouping
If the selected chart type supports grouping, the Group by menu allows the selection of the grouping criteria:
At the bottom, you'll have the time-based grouping options: day, week, month, and quarter: