Articulation scores
The articulation score of an asset is a percentage that indicates how complete the asset is according to the articulation score rules. It is typically used to give you a quick estimation of the status of the asset and whether the most important characteristics are present.
You can configure an articulation score calculator that contains your own rules. Whenever an asset is edited, either manually or via a workflow, the articulation score is reset to 0 and the articulation score rules are executed in their specific order.
The score is shown in the title bar of the asset page, a column in a table or as a field on a tile.
- You may have to refresh the page after you edited the asset to see the new score.
- If you edited the articulation rules or their assignment, the articulation score of the assets to which it is assigned does not recalculate. You still need to edit each asset to trigger recalculation of the articulation score.
Articulation score rules
An articulation rule consists of a number of fields that determine when a rule applies and what the result is.
- The Condition field and the subsequent Status or Characteristic field determine when a rule applies. These fields allow your rule to look for a specific status or a specific characteristic. Having multiple instances of the same characteristic, for example, two notes, does not apply the rule more than once.
- The Score and Value fields determine what the effect of the articulation rule is. You can either increase the score, or set the score to a specific value.
- 'Increasing the score' means that the value will be added to the percentage that was received from the other rules. It does not increase the score of the asset before it was edited.
- If a rule sets the score to a specific value, all previous rules effectively become useless.
Example
Suppose this is the articulation score calculator:
|
1 |
Condition Characteristic added |
Characteristic Definition |
Score Increase score by |
Value 33 |
|
2 |
Condition Status set to |
Status Candidate |
Score Sets score to |
Value 0 |
|
3 |
Condition Status set to |
Status In progress |
Score Sets score to |
Value 10 |
|
4 |
Condition Status set to |
Status Under review |
Score Sets score to |
Value 50 |
|
5 |
Condition Status set to |
Status Reviewed |
Score Sets score to |
Value 80 |
|
6 |
Condition Status set to |
Status Accepted |
Score Sets score to |
Value 100 |
|
7 |
Condition Characteristic added |
Characteristic Note |
Score Increase score by |
Value 22 |
A business term has the following attributes:
- Status: In progress
- A definition
- A note
- Articulation score: 32%
- Articulation score rule 1 matches and adds 33%.
Current score: 33% - Articulation score rule 2 does not match.
- Articulation score rule 3 matches and sets the score to 10%.
Current score: 10% - Articulation score rule 4 does not match.
- Articulation score rule 5 does not match.
- Articulation score rule 6 does not match.
- Articulation score rule 7 matches and adds 22%
Final articulation score: 32%
- Articulation score rule 1 matches and adds 33%.
A second note is added, the definition is deleted and the status of the business term is changed to Reviewed. It now has the following attributes:
- Status: Reviewed
- Two notes
- Articulation score: 100%
- Articulation score rule 1 does not match.
- Articulation score rule 2 does not match.
- Articulation score rule 3 does not match.
- Articulation score rule 4 does not match.
- Articulation score rule 5 matches and adds 80%.
Current score: 80% - Articulation score rule 6 does not match.
- Articulation score rule 7 matches and adds 22%
Final articulation score: 100%
