Recalculations in Project Management
What is recalculation?
Recalculation, where project dates are computed based on the parent-child hierarchy and the relationships set up across various project tasks, is the core of project planning.
Key recalculation points:
- Dates are rolled up from child nodes to parent
- After a node has children, its date cannot be modified through the user interface (except the top project where the Planned Start Date can be modified)
- The logic of deriving dates is:
- For a node in Pending/Open states, Planned End Date = Planned Start Date + Planned Duration
- For a node in WIP state, Planned End Date = Actual Start Date + Planned Duration
- For a node in Closed state, Actual Duration = Actual End Date - Actual Start Date
How do I know if recalculation is working correctly?
Navigate to planned_task.list and query top_task as described in Troubleshooting Project Structure. Personalize (not configure) the list to add the following columns:
- Planned Start Date
- Planned End Date
- Actual Start Date
- Actual End Date
Sort the list by Planned Start Date in Ascending (A-Z) order. You should see the top project at the top of the list. The top project should share the Planned Start Date with at least one node appearing at the top of the list.
Sort the list by Planned End Date in Descending (Z-A) order. You should see the top project at the top of the list. The top project should share the Planned End Date with at least one node appearing at the top of the list.
How do I trigger recalculation myself and check?
There are two options:
- Use the Diagnostics Update Set
- Run an API call in Scripts > Background
How do I check that recalculation is completing properly?
- If the property does not already exist, create the com.snc.pm.debug.enable property.
Ensure that the type is true|false and the value is set to true.
- From Scripts > Background, trigger recalculation.
The platform prints out a significant number of messages in the system logs.
- Look for the highlighted messages in the screenshot below.
This output is from a Geneva instance and may differ slightly in subsequent releases.
Note that this modifies the project and task records, so be aware when running on a production instance.
If you see the last message Into saveRelations(), the recalculation has completed successfully and the project has been saved.
How do I debug recalculation from forms/lists?
Trigger the recalculation by changing the Start Date or Duration of a project task.
Navigate to System > Logs and look for the following:
|Start of Load||com.snc.planned_task.core.loader.Planned|
|End of Load : - 00:00:00 : 37 :: 37||com.snc.planned_task.core.loader.Planned|
|Start of recalculation||com.snc.planned_task.core.engine.Automat|
|End of recalculation : - 00:00:00 : 45 :: 45||com.snc.planned_task.core.engine.Automat|
|Start of Save||com.snc.planned_task.core.datastore.Data|
|End of Save : - 00:00:00 : 11 :: 11||com.snc.planned_task.core.datastore.Data|
These are the key logs that indicate the recalculation process is working properly. The process involves the following three steps:
- Load the Project into memory.
- Perform recalculation.
- Save the dirty records to the database.
I still can't figure why recalculation is not happening
Check the calculation_type field in Project and all sub-Projects/Project Tasks. They should be set to Automatic or Manual. Automatic projects are what we have used in this document. Manual projects do not honor relationships between nodes.
Check the project schedule in project record. Check if the schedule is valid. It should be valid for the dates of the project (for example, Schedule defined for year 2025 may not work properly today). It is acceptable to leave the schedule blank.