Project's calculation modes

Project Calculation Modes

Aspose.Tasks for Java API provides three project calculation modes which define how values of dependent properties are calculated when the value of a property is set. These calculation modes are:

• None - Sets only necessary properties and does not perform any calculations
• Manual - Sets only dependent object properties without recalculation of any other data
• Automatic - Recalculates dates, work and cost properties automatically

This examples below shows the usage of each of these with the help of code samples.

Project Calculation Mode - None

// Create empty project and set calculation mode to None
Project project = new Project();
project.setCalculationMode(CalculationMode.None);

// Add a new task
Task task = project.getRootTask().getChildren().add("Task");

Date minDate = new GregorianCalendar(1, Calendar.JANUARY, 1).getTime();

// Note that even ids were not calculated
System.out.println("Task Id Equals 0 : " + task.get(Tsk.ID).equals(0));
System.out.println("Task Start Equals 01/01/0001 : " + task.get(Tsk.START).equals(minDate));
System.out.println("Task Finish Equals 01/01/0001 : " + task.get(Tsk.FINISH).equals(minDate));
System.out.println("Task Duration Equals 0 mins : " + task.get(Tsk.DURATION).toString().equals("0 mins"));

// Set duration property
task.set(Tsk.DURATION, project.getDuration(2, TimeUnitType.Day));
System.out.println("Task Duration Equals 2 days : " + task.get(Tsk.DURATION).toString().equals("2 days"));
System.out.println("Task Start Equals 01/01/0001 : " + task.get(Tsk.START).equals(minDate));
System.out.println("Task Finish Equals 01/01/0001 : " + task.get(Tsk.FINISH).equals(minDate));

Project Calculation Mode - Manual

// Create empty project and set calculation mode to Manual
Project project = new Project();
project.setCalculationMode(CalculationMode.Manual);

// Set project start date and add new tasks
project.set(Prj.START_DATE, new GregorianCalendar(2015, Calendar.APRIL, 15).getTime());
Task task1 = project.getRootTask().getChildren().add("Task 1");
Task task2 = project.getRootTask().getChildren().add("Task 2");

// The necessary properties are set in manual mode
Date start = new GregorianCalendar(2015, Calendar.APRIL, 15, 8, 0, 0).getTime();
Date finish = new GregorianCalendar(2015, Calendar.APRIL, 15, 17, 0, 0).getTime();
System.out.println("Task1 Id Equals 1 : " + task1.get(Tsk.ID).equals(1));
System.out.println("Task1 Start Equals 15/04/2015 08:00 AM : " + task1.get(Tsk.START).equals(start));
System.out.println("Task1 Finish Equals 15/04/2015 05:00 PM : " + task1.get(Tsk.FINISH).equals(finish));
System.out.println("Task1 Duration Equals 1 day : " + task1.get(Tsk.DURATION).toString().equals("1 day"));
System.out.println("Task2 Start Equals 15/04/2015 08:00 AM : " + task2.get(Tsk.START).equals(start));
System.out.println("Task2 Finish Equals 15/04/2015 05:00 PM : " + task2.get(Tsk.FINISH).equals(finish));
System.out.println("Task2 Duration Equals 1 day : " + task2.get(Tsk.DURATION).toString().equals("1 day"));

// When we link two tasks together their dates are not recalculated in manual mode
TaskLink link = project.getTaskLinks().add(task1, task2, TaskLinkType.FinishToStart);

// Task 2 Start has not been changed
System.out.println("Task1 Start Equals Task2 Start : " + task1.get(Tsk.START).equals(task2.get(Tsk.START)));
System.out.println("Task1 Finish Equals Task2 Finish : " + task1.get(Tsk.FINISH).equals(task2.get(Tsk.FINISH)));

Project Calculation Mode - Automatic

// Create empty project and set calculation mode to Automatic
Project project = new Project();
project.setCalculationMode(CalculationMode.Automatic);

// Set project start date and add new tasks
project.set(Prj.START_DATE, new GregorianCalendar(2015, Calendar.APRIL, 15).getTime());
Task task1 = project.getRootTask().getChildren().add("Task 1");
Task task2 = project.getRootTask().getChildren().add("Task 2");

// Link tasks
TaskLink link = project.getTaskLinks().add(task1, task2, TaskLinkType.FinishToStart);

// Verify dates have been recalculated
Calendar cal = Calendar.getInstance();
cal.setTime(task1.get(Tsk.START));
cal.add(Calendar.DATE, 1);
Date task1StartPlusOneDay = cal.getTime();
System.out.println("Task1 Start + 1 Equals Task2 Start : " + task1StartPlusOneDay.equals(task2.get(Tsk.START)));

cal.setTime(task1.get(Tsk.FINISH));
cal.add(Calendar.DATE, 1);
Date task1FinishPlusOneDay = cal.getTime();
System.out.println("Task1 Finish + 1 Equals Task2 Finish : " + task1FinishPlusOneDay.equals(task2.get(Tsk.FINISH)));

System.out.println("RootTask Finish Equals Task2 Finish : " + project.getRootTask().get(Tsk.FINISH).equals(task2.get(Tsk.FINISH)));
System.out.println("Project Finish Date Equals Task2 Finish : " + project.get(Prj.FINISH_DATE).equals(task2.get(Tsk.FINISH)));