Display Multiple Columns in Rendered Gantt Chart Image

Overview

In Microsoft Project, project data can be represented both in textual form and graphically as charts. The most common chart types include Gantt Chart, Task Usage, and Resource Usage. Aspose.Tasks for .NET supports rendering project data as graphical charts.

У цій статті описані два підходи для налаштування стовпців проекту, відображених у діаграмі Ганта, і демонструє, як передати діаграму на зображення.

Gantt Chart

A Gantt chart is a timeline-based graphical representation of project tasks, segmented by days, weeks, or months. A project typically consists of tasks assigned to resources. An individual task may be divided into subtasks. Each task has a start and end date that defines its duration. A Gantt chart in Microsoft Project provides a visual overview of this information.

The following screenshot shows a typical Gantt chart in Microsoft Project:

Зображення діаграми Ганта в Aspose.Tasks для .NET

В Aspose.Tasks для .NET клас Project є основним класом для роботи з файлами проекту. Він надає кілька перевантажень методу Save для експорту даних проекту в різні формати.

Наприклад, перевантаження Save(string, SaveOptions):

• Перший параметр вказує ім’я вихідного файлу.
• Другий параметр приймає екземпляр класу, похідного від SaveOptions, наприклад PdfSaveOptions для формату PDF.

Тип SaveOptions

Поведінку рендерингу можна налаштувати за допомогою властивостей класу SaveOptions або одного з його спадкоємців. Наприклад:

• Використовуйте SaveOptions.CustomPageSize для визначення розміру вихідної сторінки.
• Використовуйте SaveOptions.LegendOnEachPage для керування тим, чи відображається легенда на кожній сторінці.

PdfSaveOptions saveOptions = new PdfSaveOptions()
{
CustomPageSize = new SizeF(800, 600),
LegendOnEachPage = false
};

Існує щонайменше два підходи до налаштування зовнішнього вигляду відображеної діаграми Ганта.

Налаштування стовпців діаграми Ганта за допомогою ProjectView

Цей підхід вважається застарілим і навряд чи буде розширено в майбутніх випусках. Клас ProjectView надає обмежену функціональність і дозволяє вказати набір стовпців, які будуть включені до вихідного зображення.

Щоб використовувати його, створіть список екземплярів GanttChartColumn і передайте їх конструктору ProjectView. Потім призначте це представлення властивості SaveOptions.View.

// Create the view columns
var columns = new List<GanttChartColumn>();
columns.Add(new GanttChartColumn("Name", 100, new TaskToColumnTextConverter(TaskName)));
columns.Add(new GanttChartColumn("Notes", 100, new TaskToColumnTextConverter(TaskNotes)));
columns.Add(new GanttChartColumn("Resources", 200, new TaskToColumnTextConverter(TaskResources)));

// Create the view
ProjectView projectView = new ProjectView(columns);

// Create SaveOptions
PdfSaveOptions saveOptions = new PdfSaveOptions()
{
    CustomPageSize = new SizeF(800, 600),
    View = projectView
};

// Save the project to PDF
project.Save("output.pdf", saveOptions);

The GanttChartColumn constructor accepts three arguments: the column name, column width, and a TaskToColumnTextConverter delegate that converts task data to display text. Example implementations:

private string TaskName(Task task)
{
    StringBuilder res = new StringBuilder();
    for (int i = 1; i < task.OutlineLevel; i++)
    {
        res.Append("  ");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

private string TaskNameHtml(Task task)
{
    StringBuilder res = new StringBuilder();
    for (int i = 1; i < task.OutlineLevel; i++)
    {
        res.Append("&nbsp;&nbsp;");
    }

    res.AppendFormat("{0}. {1}", task.Id, task.Name);
    return res.ToString();
}

private string TaskNotes(Task task)
{
    return task.NotesText ?? string.Empty;
}

private string TaskResources(Task task)
{
    StringBuilder res = new StringBuilder();
    Project project = task.ParentProject;
    bool bFirst = true;
    foreach (ResourceAssignment assignment in project.GetResourceAssignmentsByTask(task))
    {
        if (assignment.Resource != null)
        {
            if (!bFirst)
            {
                res.Append(", ");
            }

            res.Append(assignment.Resource.Name);
            bFirst = false;
        }
    }

    return res.ToString();
}

Below are examples of resulting images exported using the above code:

Customize Gantt Chart Columns Using View

Using the View class and its inheritors is the recommended approach for customizing chart output. The View class corresponds to the view settings in Microsoft Project and provides a richer API compared to ProjectView.

An existing view can be retrieved from the Views collection (for MPP files), customized, and passed to the Project.Save method via the SaveOptions.ViewSettings property.

The following example demonstrates how to retrieve an existing view from an MPP file, insert a new column into it, and use this view for rendering the Gantt chart.

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

// Get existing view
var view = (GanttChartView) project.Views.GetByName("&Gantt Chart");

// Define and insert new column
TableField field = new TableField()
{
    AlignData = StringAlignment.Far,
    Width = 50,
    Field = Field.TaskName,
    Title = "Task name"
};

view.Table.TableFields.Insert(1, field);

PdfSaveOptions saveOptions = new PdfSaveOptions()
{
    ViewSettings = view
};

project.Save("output.pdf", saveOptions);

Висновок

Aspose.Tasks для .NET надає кілька варіантів налаштування візуалізації діаграми Ганта. Хоча ProjectView дозволяє базову конфігурацію, його функціональність обмежена і вважається застарілим.

Для більш розширеного контролю та узгодження з візуальною структурою Microsoft Project рекомендується використовувати View та пов’язані з ним класи. Цей підхід забезпечує кращу гнучкість і підходить для роботи з представленнями, визначеними у файлах MPP, або для програмного налаштування нових макетів представлень.