Trabajar con vistas

Lectura de los datos de una vista específica

Las vistas proporcionan una representación gráfica de un proyecto o de sus elementos (recursos, tareas, etc.). Por ejemplo, un diagrama de Gantt muestra visualmente el progreso y la planificación de un proyecto:

Microsoft Project permite a los usuarios personalizar diferentes propiedades de vista, como estilos de barra, líneas de cuadrícula, líneas de progreso, información de escala de tiempo y configuración de página. Todas estas propiedades se almacenan en el archivo MPP. Con Aspose.Tasks para .NET puede acceder y modificarlas programáticamente a través de la View class or its derived classes: GanttChartView, TaskUsageView, y ResourceUsageView.

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

GanttChartView view = project.Views.ToList()[0] as GanttChartView;
Console.WriteLine("Is Bar Rounding: " + view.BarRounding);
Console.WriteLine("Show Bar Splits? : " + view.ShowBarSplits);
Console.WriteLine("Show Drawings? : " + view.ShowDrawings);
Console.WriteLine("Roll Up Gantt Bars? " + view.RollUpGanttBars);
Console.WriteLine("Hide Rollup Bars When Summary Expa0nded: " + view.HideRollupBarsWhenSummaryExpanded);
Console.WriteLine("Bar Size: " + view.BarSize.ToString());
Console.WriteLine("Bar Style: " + view.BarStyles.Count);
Console.WriteLine("************************ RETREIVING BAR STYLES INFORMATION FROM THE VIEW *********************");
int i = 0;
foreach (GanttBarStyle barStyle in view.BarStyles)
{
    Console.WriteLine("Name: " + barStyle.Name);
    Console.WriteLine("ShowFor: " + barStyle.ShowFor.ToString());
    Console.WriteLine("Row: " + barStyle.Row);
    Console.WriteLine("From: " + barStyle.From);
    Console.WriteLine("To: " + barStyle.To);
    Console.WriteLine("MiddleShape: " + barStyle.MiddleShape);
    Console.WriteLine("MiddleShapeColor: " + barStyle.MiddleShapeColor);
    Console.WriteLine("StartShape: " + barStyle.StartShape);
    Console.WriteLine("EndShape: " + barStyle.EndShape);
    Console.WriteLine("EndShapeColor: " + barStyle.EndShapeColor);
    i++;
}

Console.WriteLine("Grid Lines Count: " + view.Gridlines.Count);
Gridlines gridlines = view.Gridlines[0];
Console.WriteLine("************************ RETREIVING GRID LINES PROPERTIES *********************");
Console.WriteLine("GridLine Type: " + gridlines.Type);
Console.WriteLine("Gridlines Internval: " + gridlines.Interval);
Console.WriteLine("Gridlines Color: " + gridlines.NormalColor);
Console.WriteLine("Gridlines NormalPattern: " + gridlines.NormalPattern);
Console.WriteLine("Gridlines IntervalPattern: " + gridlines.IntervalPattern);
Console.WriteLine("Gridlines IntervalColor: " + gridlines.IntervalColor);
Console.WriteLine("************************ RETREIVING PROGRESS LINES PROPERTIES *********************");
Console.WriteLine("ProgressLInes.BeginAtDate: ", view.ProgressLines.BeginAtDate);
Console.WriteLine("ProgressLines.isBaselinePlan: " + view.ProgressLines.IsBaselinePlan);
Console.WriteLine("ProgressLines.DisplaySelected: " + view.ProgressLines.DisplaySelected);
Console.WriteLine("ProgressLines.SelectedDates.Count: " + view.ProgressLines.SelectedDates.Count);
Console.WriteLine("ProgressLines.SelectedDates[0]: " + view.ProgressLines.SelectedDates[0]);
Console.WriteLine("ProgressLines.SelectedDates[1]: " + view.ProgressLines.SelectedDates[1]);
Console.WriteLine("ProgressLines.SelectedDates[2]: " + view.ProgressLines.SelectedDates[2]);
Console.WriteLine("ProgressLines.DisplayAtRecurringIntervals: " + view.ProgressLines.DisplayAtRecurringIntervals);
Console.WriteLine("ProgressLines.RecurringInterval.Interval: " + Interval.Weekly, view.ProgressLines.RecurringInterval.Interval);
Console.WriteLine("ProgressLines.RecurringInterval.WeeklyDays.Count" + view.ProgressLines.RecurringInterval.WeeklyDays.Count);
Console.WriteLine("Recurring Interval.WeeklyDays: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("Recurring Interval.DayType.Saturday: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("Recurring Interval.DayType.Sunday: " + view.ProgressLines.RecurringInterval.WeeklyDays);
Console.WriteLine("ProgressLines.ShowDate: " + view.ProgressLines.ShowDate);
Console.WriteLine("ProgressLines.ProgressPointShape: " + view.ProgressLines.ProgressPointShape.ToString());
Console.WriteLine("ProgressLines.ProgressPointColor: " + view.ProgressLines.ProgressPointColor);
Console.WriteLine("ProgressLines.LineColor: " + Color.Red, view.ProgressLines.LineColor);
Console.WriteLine("ProgressLines.LinePattern: " + LinePattern.Solid, view.ProgressLines.LinePattern);
Console.WriteLine("ProgressLines.OtherProgressPointShape: " + view.ProgressLines.OtherProgressPointShape.ToString());
Console.WriteLine("ProgressLines.OtherProgressPointColor: " + view.ProgressLines.OtherProgressPointColor.ToString());
Console.WriteLine("ProgressLines.OtherLineColor: " + view.ProgressLines.OtherLineColor);
Console.WriteLine("************************ BOTTOM TIMESCALE IFORMATION ******************");
Console.WriteLine("BottomTimescaleTier.Count:" + view.BottomTimescaleTier.Count);
Console.WriteLine("BottomTimescaleTier.Unit:" + TimescaleUnit.Days, view.BottomTimescaleTier.Unit.ToString());
Console.WriteLine("BottomTimescaleTier.UsesFiscalYear: " + view.BottomTimescaleTier.UsesFiscalYear);
Console.WriteLine("BottomTimescaleTier.Alignment: " + StringAlignment.Center, view.BottomTimescaleTier.Alignment.ToString());
Console.WriteLine("BottomTimescaleTier.ShowTicks: " + view.BottomTimescaleTier.ShowTicks.ToString());
Console.WriteLine("BottomTimescaleTier.Label:" + DateLabel.DayDi, view.BottomTimescaleTier.Label);
Console.WriteLine("************************ MIDDLE TIMESCALE IFORMATION ******************");
Console.WriteLine("MiddleTimescaleTier.Count:" + view.MiddleTimescaleTier.Count);
Console.WriteLine("MiddleTimescaleTier.Unit:" + TimescaleUnit.Days, view.MiddleTimescaleTier.Unit.ToString());
Console.WriteLine("MiddleTimescaleTier.UsesFiscalYear: " + view.MiddleTimescaleTier.UsesFiscalYear);
Console.WriteLine("MiddleTimescaleTier.Alignment: " + StringAlignment.Center, view.MiddleTimescaleTier.Alignment.ToString());
Console.WriteLine("MiddleTimescaleTier.ShowTicks: " + view.MiddleTimescaleTier.ShowTicks.ToString());
Console.WriteLine("MiddleTimescaleTier.Label:" + DateLabel.DayDi, view.MiddleTimescaleTier.Label);
Console.WriteLine("************************ TOP TIMESCALE IFORMATION ******************");
Console.WriteLine("TopTimescaleTier.Unit:" + TimescaleUnit.Days, view.TopTimescaleTier.Unit.ToString());
Console.WriteLine("TopTimescaleTier.UsesFiscalYear: " + view.TopTimescaleTier.UsesFiscalYear);
Console.WriteLine("TopTimescaleTier.Alignment: " + StringAlignment.Center, view.TopTimescaleTier.Alignment.ToString());
Console.WriteLine("TopTimescaleTier.ShowTicks: " + view.TopTimescaleTier.ShowTicks.ToString());
Console.WriteLine("TopTimescaleTier.Label: ", view.TopTimescaleTier.Label.ToString()); 

En este fragmento de código se accede directamente a la vista de diagrama de Gantt, lo que permite leer y trabajar con sus propiedades almacenadas, como la escala de tiempo, el formato o las reglas de visualización.

Configurar la vista de diagrama de Gantt mostrando campos personalizados seleccionados

Se pueden agregar atributos extendidos a las tareas de un proyecto. A veces es necesario mostrar automáticamente campos personalizados específicos en la vista de diagrama de Gantt en lugar de seleccionarlos manualmente. El siguiente código muestra cómo personalizar la tabla del proyecto para conseguirlo.

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

// Create a new project task
Task task = project.RootTask.Children.Add("New Activity");

// Define new custom attribute
ExtendedAttributeDefinition text1Definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text1, null);
project.ExtendedAttributes.Add(text1Definition);
// Add custom text attribute to created task.
task.ExtendedAttributes.Add(text1Definition.CreateExtendedAttribute("Activity attribute"));

// Customize table by adding text attribute field
TableField attrField = new TableField();
attrField.Field = Field.TaskText1;
attrField.Width = 20;
attrField.Title = "Custom attribute";
attrField.AlignTitle = StringAlignment.Center;
attrField.AlignData = StringAlignment.Center;
Table table = project.Tables.ToList()[0];
table.TableFields.Insert(3, attrField);

project.Save("ConfigureTheGantChartViewShowSelectedColumnFields_out.mpp", new MPPSaveOptions() { WriteViewData = true });

Este enfoque garantiza que los campos personalizados seleccionados aparezcan por defecto en la vista MPP exportada.

Personalizar las etiquetas de los niveles de la escala de tiempo según la configuración cultural actual

Aspose.Tasks para .NET permite personalizar las etiquetas de los niveles de la escala de tiempo según la configuración del sistema CultureInfo. DateTimeConverter El delegate proporciona control sobre cómo se representan las fechas en los niveles de la escala de tiempo.

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

// Add task links
project.TaskLinks.Add(project.RootTask.Children.Add("Task 1"), project.RootTask.Children.Add("Task 2"));

GanttChartView view = (GanttChartView)project.DefaultView;

// This code is added for better visualization
view.MiddleTimescaleTier.Unit = TimescaleUnit.Months;
project.Set(Prj.TimescaleStart, new DateTime(2012, 8, 6));

// Customize middle tier dates
view.MiddleTimescaleTier.DateTimeConverter =
date => new[] { "Янв.", "Фев.", "Мар.", "Апр.", "Май", "Июнь", "Июль", "Авг.", "Сен.", "Окт.", "Ноя.", "Дек." }[date.Month - 1];
project.Save("CustomizeTimescaleTierLabels_out.pdf", SaveFileFormat.PDF);

Este fragmento demuestra cómo formatear las etiquetas de la escala de tiempo dinámicamente, asegurando que se respeten los formatos de fecha localizados en las vistas de proyecto exportadas.

Personalizar la configuración de la escala de tiempo para una vista específica

La TimescaleTier class lets developers define precise timescale settings for a project view. The example below shows how to adjust bottom and middle tiers and render the project with these settings.

	Project project = new Project();
	GanttChartView view = (GanttChartView)project.Views.First(v => v.Name == "&Gantt Chart");

	// Configure timescale tiers
	view.BottomTimescaleTier.Count = 2;
	view.BottomTimescaleTier.ShowTicks = false; 
	view.BottomTimescaleTier.Unit = TimescaleUnit.Days;
	view.BottomTimescaleTier.Label = DateLabel.DayDdd;

	view.MiddleTimescaleTier.Count = 1;
	view.MiddleTimescaleTier.Unit = TimescaleUnit.Weeks;
	view.MiddleTimescaleTier.Label = DateLabel.WeekDddDd;

	// Save with custom timescale settings
	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = view;
	saveOptions.Timescale = Timescale.DefinedInView;
	project.Save("SetTimeScaleCount_out.pdf", saveOptions);

Esto permite generar salidas del proyecto donde la granularidad temporal coincide con los requisitos de informe.

Soporte para el estilo de texto

Se puede aplicar formateo de texto a las vistas de diagrama de Gantt utilizando la TableTextStyle class. El siguiente código muestra cómo establecer un formato de texto personalizado:

Project project = new Project("New Project.mpp");
GanttChartView ganttChartView = project.Views.ToList()[0] as GanttChartView;
if (ganttChartView != null)
{
    ganttChartView.TableTextStyles.Clear();
    ganttChartView.TableTextStyles.Add(new TableTextStyle(1) { Color = Color.Red, Field = Field.TaskName });
    ganttChartView.TableTextStyles.Add(new TableTextStyle(1) { Color = Color.Gray, Field = Field.TaskDurationText });
    ganttChartView.TableTextStyles.Add(new TableTextStyle(2) { Color = Color.Blue, FontStyle = FontStyle.Bold | FontStyle.Italic | FontStyle.Underline });
}

Esta característica es útil para enfatizar campos clave o mejorar la legibilidad de los documentos de proyecto exportados.

Guardar MPP utilizando una vista de proyecto específica

Aspose.Tasks permite guardar un archivo MPP en formatos gráficos utilizando una vista específica definida en el proyecto. Esta función es útil cuando existen múltiples vistas y solo es necesario exportar una de ellas.

	Project project = new Project("TestViews.mpp");
	var view = project.Views.First(v => v.Name == "Customized Resource &Sheet");
	view.PageInfo.PageSettings.IsPortrait = false;

	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = view;
	project.Save("output.pdf", saveOptions);

Esto garantiza flexibilidad al exportar vistas personalizadas para distintos interesados.

Trabajar con estilos de barra de la vista de diagrama de Gantt

La vista de diagrama de Gantt admite estilos de barra tanto específicos para tareas como para categorías.
El siguiente código muestra cómo modificarlos para una mejor visualización.

	Project project = new Project("TestGanttChartView.mpp");
	var ganttChartView = (GanttChartView)project.Views.First(v => v.Name == "Gantt &Chart");

	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.ViewSettings = ganttChartView;
	saveOptions.Timescale = Timescale.DefinedInView;

	// Modify custom bar styles
	foreach (GanttBarStyle ganttBarStyle in ganttChartView.CustomBarStyles)
	{
		if (ganttBarStyle.ShowForTaskUid == 11)
		{
			ganttBarStyle.LeftField = Field.TaskName;
			ganttBarStyle.InsideBarTextConverter = task => "Hours rem.: " + 
				(int)task.Get(Tsk.RemainingWork).TimeSpan.TotalHours;
		}
	}

Al personalizar los estilos de barra, puede resaltar tareas, hitos e indicadores de progreso en las vistas de proyecto exportadas.

Conclusión

Aspose.Tasks para .NET proporciona una amplia funcionalidad para trabajar con vistas de proyecto. Los desarrolladores pueden leer y personalizar diagramas de Gantt, configurar niveles de escala de tiempo, aplicar estilos de texto, guardar archivos MPP con vistas específicas y modificar estilos de barra. Estas funciones permiten crear informes altamente personalizados y asegurar que los datos de proyecto exportados cumplan con las necesidades empresariales y de presentación.

Enlaces rápidos

• Imprimir páginas del proyecto en archivos separados
• Eliminar el espacio entre la lista de tareas y el pie de página
• Renderizado de notas al convertir vistas de proyecto

Preguntas frecuentes

P: ¿Necesito tener Microsoft Project instalado para trabajar con vistas?

• No. Aspose.Tasks para .NET funciona de forma independiente de Microsoft Project.

P: ¿Puedo personalizar qué campos se muestran en un diagrama de Gantt?

• Sí. Puede configurar las tablas para que muestren automáticamente los campos personalizados seleccionados.

P: ¿Aspose.Tasks admite etiquetas de escala de tiempo localizadas?

• Sí. Las etiquetas de los niveles de escala de tiempo se pueden personalizar según la configuración cultural actual CultureInfo.

P: ¿Es posible exportar solo una vista desde un archivo de proyecto?

• Sí. Puede seleccionar una vista específica y exportarla a formatos PDF, imagen o HTML.

P: ¿Se pueden personalizar programáticamente los estilos de barra en los diagramas de Gantt?

• Sí. Tanto los estilos de barra específicos de tareas como los específicos de categoría pueden modificarse mediante la API.