Aspose.Tasks for Java 24.4 Release Notes

All Changes

Public API and Backwards Incompatible Changes

Examples and additional notes

Related issue: TASKSNET-11146 - Remove rounding when reading Asn.Units from MPP.

Assignments of a material resource can have a variable consumption rate which means that the quantity of the material resource depends on the duration of the assignment. Method ResourceAssignment.setMaterialResourceUnits(double units, int rateScaleType) was added to ease setting of the variable consumption rate.

For example, to set “3 units per week” rate, setMaterialResourceUnits(3d, RateScaleType.Week) can be called. Prior to 24.4, the same result could be achieved by calling

a.setUnits(3d / 40);
a.setRateScale(RateScaleType.Week);

Related issue: TASKSNET-11097 - Fix setting PageInfo.Legend.LegendOn is not applied when project is rendered.

SaveOptions methods getLegendOnEachPage()/setLegendOnEachPage(boolean) was replaced by more versatile getLegendDrawingOptions()/setLegendDrawingOptions(int) methods with 4 allowed values: LegendDrawingOptions.NoLegend - the legend is not rendered, LegendDrawingOptions.AfterLastPage - the legend is rendered on a separate page after the last page of the project’s pages, LegendDrawingOptions.OnEveryPage - the legend is rendered on every page, LegendDrawingOptions.DefinedInView - the legend is rendered according to View.getPageInfo().getLegend().getLegendOn() com.aspose.tasks.Legend value of the rendered View.

Project project = new Project("test.mpp");
View view = project.getViews().getByName("&Gantt Chart");
view.getPageInfo().getLegend().setLegendOn(Legend.AfterLastPage)

PdfSaveOptions so = new PdfSaveOptions();
so.setLegendDrawingOptions(LegendDrawingOptions.DefinedInView);
so.setStartDate(project.getStartDate());
so.setEndDate(project.getFinishDate());
so.setViewSettings(view);

// The legend is rendered on each page.
project.save("output.pdf", so);

Project project = new Project("test.mpp");
View view = project.getViews().getByName("&Gantt Chart");

PdfSaveOptions so = new PdfSaveOptions();
so.setLegendDrawingOptions(LegendDrawingOptions.NoLegend);
so.setStartDate(project.getStartDate());
so.setEndDate(project.getFinishDate());
so.setViewSettings(view);

// The legend is not rendered.
project.save("output.pdf", so);

Related issue: TASKSNET-11134 - Enhance usability of export to CSV format.

FieldHelper.getDefaultFieldTitle(int field) methods was added which can be useful in some scenarios where field title is required. In the following example we take Gantt Chart view of the current project and set up CsvOptions so the exported CSV file has the same fields as Gantt Chart.

Project project = new Project("test.mpp");

CsvOptions options = new CsvOptions();
options.setTextDelimiter(CsvTextDelimiter.Tab);

View view = project.getDefaultView();
options.setView(ProjectView.getDefaultGanttChartView());
options.getView().getColumns().clear();

for (TableField t : view.getTable().getTableFields())
{
    String columnTitle = t.getTitle() == null || t.getTitle().isEmpty() ? FieldHelper.getDefaultFieldTitle(t.getField()) : t.getTitle();
    options.getView().getColumns().add(new GanttChartColumn(columnTitle, 10, t.getField()));
}

project.save("output.csv", options);