Working with Projects

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)));