Answer

Validate custom workflow scoring by completing test workflows, then reviewing the results in ANVL Insights to confirm the percentage and points earned / possible points match what you expected.

This is important because even small setup issues can create missing scores, incorrect percentages, or misleading reporting. The most common problems usually come from:

missing or incorrect tags
non-numeric response values
incorrect maxScore values
not testing enough scoring scenarios

Steps

Note: Use the testing checklist at the bottom of this article to document your test scenarios and results.

1. Publish the workflow for testing

Publish the workflow to Demonstration / UAT or your approved testing site.

2. Complete test workflows in ANVL Workflows

Open ANVL Workflows.
If you were already signed in before the scoring changes were published, sign out and sign back in to see the latest version.
Open the workflow.
Complete all questions for each test scenario.

At minimum, test:

one low-score scenario
one expected / good scenario
one high-score / best-practice scenario

3. Review the scoring in ANVL Insights

Open ANVL Insights.
Select the Demonstration Group.
Locate the completed test workflows.
Open each completed workflow.
Review:
- points earned
- possible points
- percentage score
Confirm the results match your expectations for each test case.

Validate the Workflow Score is correct based on the test case. Review individual question scores to verify responses.

4. Update and test again if needed

If the score does not match expectations, review the scoring setup in Editor.
Check the question design, response values, and scoring tags.
Make the needed updates.
Republish the workflow.
Re-test the same scenarios.
Repeat until the results are correct.

5. Move to live use

Once the test results match expectations, publish the workflow to the live Group(s) for usage.

Common scoring issues

Scores not appearing
Check whether the required scoring tags were added correctly.
Unexpected scores
Check whether the response values or maxScore values are misaligned.
Scores are all too similar
Check whether the scoring scale is too narrow to show meaningful variation.
Score feels wrong even though math is working
Check whether the scored questions are actually measuring something useful for the decision you want to support.

Helpful notes

Validate scoring with more than one scenario.
Most scoring issues come from setup, not calculation.
It is easier to fix scoring problems before broad rollout than after users are already relying on the results.

Workflow Scoring Test Template

Workflow Name: __________________________
Workflow Type / Program: __________________________
Test Environment: UAT / Demonstration
Tester: __________________________
Date: __________________________

Test Setup Checklist (Before You Begin)

☐ Workflow is published to Demonstration (UAT) group
☐ Tester has signed out and back in to Mobile / Web Workflows to see the latest update
☐ Scored questions use ONLY the Checklist Radio question with numeric responses
☐ maxScore tag is setup correctly on all scored questions

Test Case Planning (Custom Scoring)

At minimum, two test cases are required.
A third is recommended when workflows are complex.

Test Case	Intent
Test Case 1	Maximum score (all scored questions selected at highest value)
Test Case 2	Middle / mixed score (realistic combination of responses)
Test Case 3 (Optional)	Minimum score (all scored questions at lowest value)

Test Case 1: Maximum Score

Goal: Confirm the workflow can achieve the expected maximum possible score.

Responses to Use

Select the highest numeric value for every scored question

Item	Notes
Expected Score (Points / %)	__________________
Actual Score (Points / %)	__________________
Match?	☐ Yes ☐ No
Notes	__________________

Test Case 2: Middle / Mixed Score

Goal: Confirm scores calculate correctly for a realistic mix of responses.

Responses to Use

Combination of high, medium, and low numeric values
Reflects typical user behavior

Item	Notes
Expected Score (Points / %)	__________________
Actual Score (Points / %)	__________________
Match?	☐ Yes ☐ No
Notes	__________________

Test Case 3: Minimum Score (Optional)

Goal: Confirm the workflow can score at or near the minimum possible value.

Responses to Use

Select the lowest numeric value for all scored questions

Item	Notes
Expected Score (Points / %)	__________________
Actual Score (Points / %)	__________________
Match?	☐ Yes ☐ No
Notes	__________________

Score Review Checklist (After Submission)

For each test case, confirm:

☐ Custom score appears in the workflow summary
☐ Points earned match selected response values
☐ Percentage score reflects points earned / total possible
☐ Maximum score test reaches expected ceiling
☐ Mixed-score test produces a reasonable mid-range result

If Scores Do Not Match Expectations

Review in Editor: