Travailler avec les vues

Lecture des données d’une vue spécifique

Les vues offrent une représentation graphique d’un projet ou de ses éléments (ressources, tâches, etc.). Par exemple, un diagramme de Gantt montre visuellement l’avancement et les plans d’un projet :

Microsoft Project permet aux utilisateurs de personnaliser différentes propriétés de vue telles que les styles de barres, les quadrillages, les lignes de progression, les informations d’échelle temporelle et la configuration de la page. Toutes ces propriétés sont stockées dans le fichier MPP. Avec Aspose.Tasks for .NET, vous pouvez y accéder et les modifier par programmation via la View classe ou ses classes dérivées : GanttChartView, TaskUsageView, et 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()); 

Dans cet extrait de code, la vue du diagramme de Gantt est accédée directement, ce qui permet de lire et d’utiliser ses propriétés stockées telles que l’échelle temporelle, le formatage ou les règles d’affichage.

Configurer la vue du diagramme de Gantt en affichant des champs personnalisés sélectionnés

Des attributs étendus peuvent être ajoutés aux tâches d’un projet. Parfois, il est nécessaire d’afficher automatiquement certains champs personnalisés dans la vue du diagramme de Gantt plutôt que de les sélectionner manuellement. Le code suivant montre comment personnaliser la table du projet pour y parvenir.

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

Cette approche garantit que les champs personnalisés sélectionnés apparaissent par défaut dans la vue MPP exportée.

Personnalisation des étiquettes des niveaux d’échelle temporelle en fonction des paramètres régionaux actuels

Aspose.Tasks for .NET permet de personnaliser les étiquettes des niveaux d’échelle temporelle selon les paramètres du système CultureInfo. DateTimeConverter Le délégué fournit un contrôle sur la façon dont les dates sont rendues dans les niveaux de l’échelle temporelle.

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

Cet extrait montre comment formater dynamiquement les étiquettes de l’échelle temporelle, en veillant à ce que les formats de date localisés soient respectés dans les vues de projet exportées.

Personnalisation des paramètres de l’échelle temporelle pour une vue spécifique

La TimescaleTier classe permet aux développeurs de définir des paramètres d’échelle temporelle précis pour une vue de projet. L’exemple ci‑dessous montre comment ajuster les niveaux inférieur et moyen et afficher le projet avec ces paramètres.

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

Cela permet de générer des exports de projet dont la granularité temporelle correspond aux besoins des rapports.

Prise en charge du style de texte

Le style de texte peut être appliqué aux vues du diagramme de Gantt à l’aide de la TableTextStyle classe. Le code suivant montre comment définir un formatage de texte personnalisé :

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

Cette fonctionnalité est utile pour mettre en évidence les champs clés ou améliorer la lisibilité des documents de projet exportés.

Enregistrer un fichier MPP en utilisant une vue de projet spécifique

Aspose.Tasks permet d’enregistrer un fichier MPP dans des formats graphiques en utilisant une vue spécifique définie dans le projet. Cette fonctionnalité est pratique lorsque plusieurs vues existent et qu’il n’est nécessaire d’en exporter qu’une seule.

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

Cela garantit une flexibilité lors de l’exportation de vues adaptées pour différentes parties prenantes.

Travailler avec les styles de barres de la vue du diagramme de Gantt

La vue du diagramme de Gantt prend en charge à la fois les styles de barres spécifiques aux tâches et ceux spécifiques aux catégories.
Le code suivant montre comment les modifier pour une meilleure visualisation.

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

En personnalisant les styles de barres, vous pouvez mettre en évidence les tâches, les jalons et les indicateurs d’avancement dans les vues de projet exportées.

Conclusion

Aspose.Tasks for .NET offre une fonctionnalité étendue pour travailler avec les vues de projet.

Liens rapides

• Imprimer des pages de projet dans des fichiers séparés
• Supprimer l’espace entre la liste des tâches et le pied de page
• Rendu des notes lors de la conversion des vues de projet

Questions fréquentes

Q : Ai-je besoin d’installer Microsoft Project pour travailler avec les vues ?

• No. Aspose.Tasks for .NET fonctionne indépendamment de Microsoft Project.

Q : Puis-je personnaliser les champs affichés dans un diagramme de Gantt ?

• Yes. Vous pouvez configurer les tables pour afficher automatiquement les champs personnalisés sélectionnés.

Q : Aspose.Tasks prend-il en charge les étiquettes d’échelle temporelle localisées ?

• Yes. Les étiquettes des niveaux d’échelle temporelle peuvent être personnalisées en fonction des paramètres régionaux actuels CultureInfo.

Q : Est-il possible d’exporter une seule vue depuis un fichier de projet ?

• Yes. Vous pouvez sélectionner une vue spécifique et l’exporter aux formats PDF, image ou HTML.

Q : Les styles de barres dans les diagrammes de Gantt peuvent-ils être personnalisés par programmation ?

• Yes. Les styles de barres spécifiques aux tâches et ceux spécifiques aux catégories peuvent être modifiés via l’API.