Aspose.Tasks for .NET 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, RateScaleType 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.Units = 3D / 40; a.RateScale = RateScaleType.Week;

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

Boolean property SaveOptions.LegendOnEachPage was replaced by more versatile LegendDrawingOptions property with 4 allowed values: NoLegend - the legend is not rendered, AfterLastPage - the legend is rendered on a separate page after the last page of the project’s pages, OnEveryPage - the legend is rendered on every page, DefinedInView - the legend is rendered according to View.PageInfo.Legend.LegendOn property of the rendered View.

var project = new Project("test.mpp");
var view = project.Views.GetByName("&Gantt Chart");
view.PageInfo.Legend.LegendOn = Legend.AfterLastPage;

PdfSaveOptions so = new PdfSaveOptions()
{
    LegendDrawingOptions = LegendDrawingOptions.DefinedInView,
    StartDate = project.StartDate,
    EndDate = project.FinishDate,
    ViewSettings = view
};

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

var project = new Project("test.mpp");
var view = project.Views.GetByName("&Gantt Chart");

PdfSaveOptions so = new PdfSaveOptions()
{
    LegendDrawingOptions = LegendDrawingOptions.NoLegend,
    StartDate = project.StartDate,
    EndDate = project.FinishDate,
    ViewSettings = view
};

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

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

FieldHelper.GetDefaultFieldTitle(Field 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.

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

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

var view = project.DefaultView;
options.View = ProjectView.GetDefaultGanttChartView();
options.View.Columns.Clear();

foreach (var t in view.Table.TableFields)
{
    var columnTitle = string.IsNullOrEmpty(t.Title) ? FieldHelper.GetDefaultFieldTitle(t.Field) : t.Title;
    options.View.Columns.Add(new GanttChartColumn(columnTitle, 10, t.Field));
}

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