How to fix data quality errors
Data quality errors appear on Project → Settings in the Data quality check section (#data-quality-check). They are produced when you click Run data quality check; the last run’s errors and warnings are stored and shown until the next run.
To fix:
- Read the error messages in the Errors list.
- Fix the underlying data (project dates, tasks, milestones, deliverables, home org) as described below.
- Click Run data quality check again. When there are no errors, the state becomes “Checked and passed”.
Error types and how to fix them
Project dates and duration
| Error message |
Meaning |
Fix |
Planned begin (…) must be before planned end (…). |
Planned start date is on or after planned end date. |
In Project → Settings, set Planned begin to a date before Planned end. |
Actual begin (…) is after actual end (…). |
Actual start date is after actual end date. |
Set Actual begin to a date on or before Actual end. |
Duration months (…) must be >= 1. |
Project duration is less than 1 month. |
Set Duration (months) to 1 or more. |
Planned span (~… mo) shorter than duration_months (…). |
The number of months between planned begin and end is less than Duration (months). |
Either increase the date range (planned begin/end) so it covers at least duration_months, or reduce Duration (months) to match the planned span. |
Home org
| Error message |
Meaning |
Fix |
(Warning) No home org set for this project. |
Project has a name but no home org. |
In Project → Settings, set Home org. |
Tasks (WPs)
| Error message |
Meaning |
Fix |
Task … begin_month (…) must be ≤ end_month (…). |
Task’s start month is after its end month. |
In Tasks (or the WP/task editor), set Begin month ≤ End month for that task. |
Task … begin_month (…) outside duration (1–…). |
Task start month is < 1 or > project duration. |
Set Begin month between 1 and the project Duration (months). |
Task … end_month (…) outside duration (1–…). |
Task end month is outside 1..duration. |
Set End month between 1 and the project Duration (months). |
Task … awarded PMs (…) must not be negative. |
Allocated person-months are negative. |
Set Awarded PMs to 0 or a positive value. |
Task … awarded PMs > 0 but home org role must be set. |
Task has PMs allocated but no home org role. |
In the task (or role descriptions), set the Home org role for that task. |
Task … home org role is Lead but lead org (…) is not the project home org. |
Task’s HOME org role is Lead but the task’s lead org is not the project’s home org. |
In WPs+Tasks, set Lead org to the project’s HOME ORG for that task (when HOME org role is Lead). |
Milestones
| Error message |
Meaning |
Fix |
Milestone MS… due_month (…) outside duration (1–…). |
Milestone due month is < 1 or > project duration. |
In Milestones, set Due month between 1 and the project Duration (months). |
Deliverables
| Error message |
Meaning |
Fix |
Deliverable … due_month (…) outside duration (1–…). |
Deliverable due month is outside 1..duration. |
In Deliverables, set Due month between 1 and the project Duration (months). |
Quick checklist
- Project Settings: Duration ≥ 1; planned begin < planned end; actual begin ≤ actual end; planned span ≥ duration months; home org set if the project has a name.
- Tasks: For each task: begin_month ≤ end_month; both in 1..duration; awarded PMs ≥ 0; if awarded PMs > 0, set home org role; if home org role is Lead, then lead org = project home org.
- Milestones: Each due_month in 1..duration.
- Deliverables: Each due_month in 1..duration.
After editing, go to Project → Settings, scroll to Data quality check, and click Run data quality check. When the Errors list is empty, the project is “Checked and passed”.
