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 following locations:
- In the At a glance sidebar of the asset page.
- In the Articulation Score column in a table of assets.
- As a field on the tiles of assets.
- 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 Condition Value field (which will be either a status or characteristic) 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, doesn't apply the rule more than once.
- The Score and Score 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 score 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 |
Condition Value Definition |
Score Increase by |
Score Value 33 |
|
2 |
Condition Status |
Condition Value Candidate |
Score Sets to |
Score Value 0 |
|
3 |
Condition Status |
Condition Value In progress |
Score Sets to |
Score Value 10 |
|
4 |
Condition Status |
Condition Value Under review |
Score Sets to |
Score Value 50 |
|
5 |
Condition Status |
Condition Value Reviewed |
Score Sets to |
Score Value 80 |
|
6 |
Condition Status |
Condition Value Accepted |
Score Sets to |
Score Value 100 |
|
7 |
Condition Characteristic |
Condition Value Note |
Score Increase by |
Score 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%