Collecting KQIs Results
Overview
The results of a quality check can be collected through various methods depending on specific requirements:
- manual entry by an operator
- automated probes definition
- use of APIs
- CSV files
The different result collection methods can coexist with each other and can be changed over time. For example, a check can be initially defined for manual entry and then implemented through an automated probe.
Manual collection
In order to enable a check for manual insertion, the “Manual Insert” flag must be set.
To add a result, press the “Add Result” button on the check detail page and fill in the form accordingly.
Automated probes
Blindata allows the definition of probes for the automated extraction of KQI. For details, see the dedicated section Quality Probes .
Blindata’s APIs
Blindata provides a dedicated API for mass uploading of KQIs. This API can be used to implement custom controls or to integrate external agents. The API takes as input a csv file with the following headers:
- qualityResult.qualityCheckCode [REQUIRED] The code that refers to the quality control whose results you want to insert.
- qualityResult.totalElements The total items checked, if necessary for calculating the score on the metric (Error Percentage).
- qualityResult.totalErrors [REQUIRED] The total errors identified by the check, that is the metric.
- qualityResult.startedAt [REQUIRED] The check start timestamp.
- qualityResult.finishedAt The check end timestamp.
The API returns the number of rows created, the number of rows updated with the same start timestamp, and the number of rows discarded. A row can be rejected because the associated check code does not exist, it does not have a mandatory field, or if the check is of the “Error Percentage” type because it does not have the field totalElements.
CSV files
It is possible to collect the results through csv files or more generally a spreadsheet and then be inserted into Blindata. To do this you can take advantage of the API as stated above or alternatively use the import functionality available directly in the platform, under “Settings”.