Utility Features Available in Aspose.Tasks for Java

Calculating Critical Path

The critical path is the tasks, or task, that ultimately determine when your project will end. Keeping track of the critical path and the resources assigned to them helps keep the project on time. Microsoft Project calculates the critical path based on tasks that have no slack, have specific date constraints (must start on, must finish on, as soon as possible or as late as possible) or have the same, or later, end date as the project. Aspose.Tasks allows you to calculate the critical path.

The Project class provides the getCriticalPath() method which is used to get the list of tasks that part of the critical path.

The following piece of code calculates and displays the tasks in the critical path.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(CriticalPath.class);

Project project = new Project(dataDir + "New project 2010.mpp");
project.setCalculationMode(CalculationMode.Automatic);

Task subtask1 = project.getRootTask().getChildren().add("1");
Task subtask2 = project.getRootTask().getChildren().add("2");
Task subtask3 = project.getRootTask().getChildren().add("3");

project.getTaskLinks().add(subtask1, subtask2, TaskLinkType.FinishToStart);

// Display the critical path now
for (Task task : project.getCriticalPath()) {
    System.out.println(task.get(Tsk.NAME));
}

Printing the TaskWritingException

A project consists of a number of tasks and Aspose.Tasks for Java API allows adding, removing and updating task information. If there’s a problem when writing tasks, use TasksWritingException to catch them.

Aspose.Tasks for Java supports printing a message when there’s an exception in writing a task. This is done with TaskWritingException, in a similar way to how TaskReadingException is used. The log message is contained in the public property TasksWritingException.getLogText(), as shown in the following code example.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(PrintTaskWritingExceptions.class);
Project prj = new Project(dataDir + "Project5.mpp");

try {
    prj.save(dataDir + "project.MPP", SaveFileFormat.MPP);
} catch (TasksWritingException ex) {
    System.out.println(ex.getLogText());
}

Working with Filter Data from MPP files

Aspose.Tasks allows to read Information about filters applied to an MPP file data. This topic shows retrieving Filter Definition and Filter Criteria data from a Microsoft Project MPP file.

Reading Filter Definition Data

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(FilterDataFromMppFile.class);

Project project = new Project(dataDir + "Project2003.mpp");
List<Filter> taskFilters = project.getTaskFilters().toList();

System.out.println("Task Filters Count: " + taskFilters.size());
System.out.println("All Tasks: " + taskFilters.get(0).getName());
System.out.println("Task Item: " + taskFilters.get(0).getFilterType());
System.out.println("Task Filters Show In Menu: " + taskFilters.get(0).getShowInMenu());
System.out.println("Task filter ShowRelatedSummaryRows: " + taskFilters.get(0).getShowRelatedSummaryRows());

System.out.println("Task filter type: " + taskFilters.get(1).getFilterType());
System.out.println("Task Filters Show In Menu: " + taskFilters.get(1).getShowInMenu());
System.out.println("Task filter ShowRelatedSummaryRows: " + taskFilters.get(1).getShowRelatedSummaryRows());

System.out.println("NEW FILTER" + taskFilters.get(2).getName());
System.out.println("Task filter type: " + taskFilters.get(2).getShowInMenu());
System.out.println("Task Filters Show In Menu: " + taskFilters.get(2).getShowInMenu());
System.out.println("Task filter ShowRelatedSummaryRows: " + taskFilters.get(2).getShowRelatedSummaryRows());

System.out.println("Task FilterCriteria:m" + taskFilters.get(2).getCriteria());
System.out.println("(TaskName Contains T)" + taskFilters.get(2).getCriteria().toString());

List<Filter> rscFilters = project.getResourceFilters().toList();

System.out.println("Project.ResourceFilters count: " + rscFilters.size());
System.out.println("Resource Filter Item Type: Item.ResourceType: " + rscFilters.get(0).getFilterType());
System.out.println("Resource filter ShowInMenu" + rscFilters.get(0).getShowInMenu());
System.out.println("Resource filter ShowRelatedSummaryRows: " + rscFilters.get(0).getShowRelatedSummaryRows());

Reading Filter Criteria Data

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(FilterDataFromMppFile.class);

Project project = new Project(dataDir + "Task name filter.mpp");

Filter filter = project.getTaskFilters().toList().get(1);
System.out.println(filter.getCriteria().getCriteriaRows().size());
System.out.println(filter.getCriteria().getOperation());

FilterCriteria criteria1 = filter.getCriteria().getCriteriaRows().get(0);
System.out.println(criteria1.getTest());
System.out.println(criteria1.getField());
// System.out.println(criteria1.getValues().getValues().get(0).toString());

FilterCriteria criteria2 = filter.getCriteria().getCriteriaRows().get(1);
System.out.println(criteria2.getOperation());
System.out.println(criteria2.getCriteriaRows().size());

FilterCriteria criteria21 = criteria2.getCriteriaRows().get(0);
System.out.println(criteria21.getTest());
System.out.println(criteria21.getField());

FilterCriteria criteria22 = criteria2.getCriteriaRows().get(1);
System.out.println(criteria22.getTest());
System.out.println(criteria22.getField());

FilterCriteria criteria23 = criteria2.getCriteriaRows().get(2);
System.out.println(criteria23.getTest());
System.out.println(criteria23.getField());

FilterCriteria criteria3 = filter.getCriteria().getCriteriaRows().get(2);
System.out.println(criteria3.getCriteriaRows().size());
System.out.println(criteria3.getOperation());

System.out.println(filter.getCriteria());

Reading Group Definition Data

A Microsoft Project data file may contain data in groups. Aspose.Tasks for Java provides the facility to read the group definition data as shown in this topic.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
String testDir = Utils.getDataDir(ReadGroupDefinitionData.class);

Project project = new Project(testDir + "Task name filter.mpp");
System.out.println("Task Groups Count: " + project.getTaskGroups().size());

Group taskGroup = project.getTaskGroups().toList().get(1);
System.out.println("Percent Complete:" + taskGroup.getName());
System.out.println("Group Criteria count: " + taskGroup.getGroupCriteria().size());

System.out.println("\n************* Retrieving Task Group's Criterion information *************");
GroupCriterion criterion = taskGroup.getGroupCriteria().toList().get(0);
System.out.println("Criterion Field: " + criterion.getField());
System.out.println("Criterion GroupOn: " + criterion.getGroupOn());
System.out.println("Criterion Cell Color: " + criterion.getCellColor());
System.out.println("Criterion Pattern: " + criterion.getPattern());

if (taskGroup == criterion.getParentGroup())
    System.out.println("Parent Group is equval to task Group.");

System.out.println("\n*********** Retreivnig Criterion's Font Information ***********");
System.out.println("Font Name: " + criterion.getFont().getName());
System.out.println("Font Size: " + criterion.getFont().getSize());
System.out.println("Font Style: " + criterion.getFont().getStyle());
System.out.println("Ascending/Dscending: " + criterion.getAscending());

Reading Table Data from a Project File

Aspose.Tasks for Java API supports reading Table data from Microsoft Project data files. The Project.Tables implements the ICollection interface to provide access to the Table data of MPP file. The feature is supported for all versions of Microsoft Project data files i.e. MPP 2003, 2007, 2010 and 2013.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ReadTableDataFromFile.class);
;

Project project = new Project(dataDir + "TASKS_33579\\Project2003.mpp");

Table t1 = project.getTables().toList().get(0);
System.out.println("Table Fields Count" + t1.getTableFields().size());

TableField f = t1.getTableFields().get(0);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(1);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(2);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(3);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(4);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(5);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(6);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

f = t1.getTableFields().get(7);
System.out.println("Field width: " + f.getWidth());
System.out.println("Field Title: " + f.getTitle());
System.out.println("Field Title Alignment: " + f.getAlignTitle());
System.out.println("Field Align Data: " + f.getAlignData());

Extracting Embedded Objects from Task or Resource View

Microsoft Project data files (MPP/XML) may contain embedded objects such as documents, excel sheets, PDF, images, etc. in Task or Resource views. Aspose.Tasks for Java API provides the capability to extract these from a project’s Task or Resource view as shown in this topic.

Embedded objects (those which were created from the file by selecting a file path) are packed into OLE Package inside MPP file. To extract the original file you can use Content and FullPath properties of an instance of the OleObject class.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ExtractingEmbeddedObjects.class);
Project project = new Project(dataDir + "EmbeddedFile.mpp");
OleObject ole = project.getOleObjects().toList().get(0);

// we have to check this property because it can be null if the embedded
// object was created inside the ms project application
// Or, alternatively, you can use this check: if (ole.FileFormat ==
// "Package")
// if (!string.IsNullOrEmpty(ole.FullPath))
if (ole.getFileFormat().equals("Package")) {

    File file = new File(dataDir);
    FileOutputStream fop = new FileOutputStream(file);
    // get the content in bytes
    byte[] contentInBytes = ole.getContent();

    fop.write(contentInBytes);
    fop.flush();
    fop.close();
}