Mostrar varias columnas en la imagen renderizada del diagrama de Gantt

**Visión general

En Microsoft Project, los datos del proyecto pueden representarse tanto en forma textual como gráficamente en forma de diagramas. Los tipos de gráficos más comunes son el diagrama de Gantt, el uso de tareas y el uso de recursos. Aspose.Tasks para .NET admite la representación de datos de proyectos como diagramas gráficos.

En este artículo se describen dos métodos para personalizar las columnas de un proyecto que aparecen en un diagrama de Gantt y se muestra cómo convertir el diagrama en una imagen.

Gantt Chart

Un diagrama de Gantt es una representación gráfica cronológica de las tareas de un proyecto, segmentadas por días, semanas o meses. Un proyecto suele constar de tareas asignadas a recursos. Una tarea individual puede dividirse en subtareas. Cada tarea tiene una fecha de inicio y otra de finalización que definen su duración. Un diagrama de Gantt en Microsoft Project proporciona una visión general de esta información.

La siguiente captura de pantalla muestra un diagrama de Gantt típico en Microsoft Project:

Gantt Chart Image en Aspose.Tasks para .NET

En Aspose.Tasks para .NET, la clase Project es la clase principal para trabajar con archivos de proyecto. Expone múltiples sobrecargas del método Save para exportar los datos del proyecto a varios formatos.

Por ejemplo, la sobrecarga Save(string, SaveOptions):

• El primer parámetro especifica el nombre del archivo de salida.
• El segundo parámetro acepta una instancia de una clase derivada de SaveOptions, como PdfSaveOptions para el formato PDF.

SaveOptions Tipo

El comportamiento de renderizado puede personalizarse utilizando las propiedades de la clase SaveOptions o una de sus herederas. Por ejemplo:

• Utilice SaveOptions.CustomPageSize para definir el tamaño de la página de salida.
• Utilice SaveOptions.LegendOnEachPage para controlar si aparece una leyenda en cada página.

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

Existen al menos dos enfoques para personalizar la apariencia del diagrama de Gantt renderizado.

Personalizar las columnas del diagrama de Gantt con ProjectView

Este enfoque se considera obsoleto y es improbable que se amplíe en futuras versiones. La clase ProjectView ofrece una funcionalidad limitada y permite especificar un conjunto de columnas para incluir en la imagen de salida.

Para usarla, cree una lista de instancias de GanttChartColumn y páselas al constructor de ProjectView. A continuación, asigne esta vista a la propiedad 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);

El constructor GanttChartColumn acepta tres argumentos: el nombre de la columna, su ancho y un delegado TaskToColumnTextConverter que convierte los datos de la tarea en texto para mostrar. Ejemplos de implementación:

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:

Personalizar columnas de diagrama de Gantt con View

Se recomienda usar la clase View y sus herederas para personalizar la salida del diagrama. La clase View corresponde a la configuración de vista en Microsoft Project y proporciona una API más completa que ProjectView.

Se puede recuperar una vista existente de la colección Views (para archivos MPP), personalizarla y pasarla al método Project.Save mediante la propiedad SaveOptions.ViewSettings.

El siguiente ejemplo muestra cómo recuperar una vista existente de un archivo MPP, insertar una nueva columna en ella y usarla para generar el diagrama de Gantt.

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);

Conclusión

Aspose.Tasks para .NET ofrece múltiples opciones para personalizar la representación de diagramas de Gantt. Si bien ProjectView permite una configuración básica, su funcionalidad es limitada y se considera obsoleto.

Para un control más avanzado y una mayor alineación con la estructura visual de Microsoft Project, se recomienda usar View y sus clases asociadas. Este enfoque proporciona mayor flexibilidad y es adecuado para trabajar con vistas definidas en archivos MPP o para configurar nuevos diseños de vista mediante programación.