Aspose.Tasks for Java 23.10 Release Notes

All Changes

Public API and Backwards Incompatible Changes

Examples and additional notes

Related issue: TASKSNET-11002 - Add public API to allow passing of encoding when reading Primavera XER files.

Starting with 23.10 encoding of input file can be set using LoadOptions.setEncoding(java.nio.charset.Charset) method:

LoadOptions lo = new LoadOptions();
lo.setEncoding(Charset.forName("windows-1251"));
lo.setPrimaveraReadOptions(new PrimaveraReadOptions());
Project project = new Project("encoding1251.xer", lo);

Related issue: TASKSNET-10971 - Modify hierarchy of Save Options to remove members of SaveOptions not applicable to certain formats.

Prior to version 23.10, all save options classes were inheritors of SaveOptions, which contained properties related to views that are not applicable to certain formats. For example Timescale or UseGradientBrush properties do not make sense when saving a project to Excel or MPX format.

To address this issue, a new base class for save options was intoduced: SimpleSaveOptions. The following save options classes are now inherited from SimpleSaveOptions: CsvOptions, MPPSaveOptions, PrimaveraSaveOptions, PrimaveraXmlSaveOptions, Spreadsheet2003SaveOptions, XlsxOptions. The following save options classes are still inherited from SaveOptions: HtmlSaveOptions, ImageSaveOptions, PdfSaveOptions, SvgOptions, XamlOptions, XpsOptions because these formats involve rendering and saving a project’s view to the output file.

Related issue: TASKSNET-10815 - Add reading of baseline projects for Primavera XML format.

The following applies to projects read from Primavera XML format (Primavera XER format doesn’t support baselines). While Microsoft Project allows 1-10 baselines and only has a limited number of baseline properties, Primavera allows an unlimited number of baseline projects, which are full snapshots of the original project. Starting with version 23.10, the baseline project can be examined using the PrimaveraProperties.getBaselineProjects() method:

Project project = new Project("BaselineProjects.xml");

System.out.println("Current baseline project uid: " + project.getPrimaveraProperties().getCurrentBaselineProjectId());

for (Project baselineProject : project.getPrimaveraProperties().getBaselineProjects())
{
    System.out.println("Baseline project: uid: " + baselineProject.getUid() + ", name: '" + baselineProject.getName() + "'");
}

Project baseline1 = project.getPrimaveraProperties().getBaselineProjects()[1];

Task task = getTaskByActivityId(project, "A1000");
Task baselineTask = getTaskByActivityId(baseline1, "A1000");

System.out.println("Task budgeted total cost: " + task.getPrimaveraProperties().getBudgetedTotalCost());
System.out.println("Task baseline budgeted total cost: " + baselineTask.getPrimaveraProperties().getBudgetedTotalCost());