Arbeiten mit Ansichten

Daten einer bestimmten Ansicht lesen

Ansichten bieten eine grafische Darstellung eines Projekts oder seiner Elemente (Ressourcen, Aufgaben usw.). Zum Beispiel zeigt ein Gantt-Diagramm den Fortschritt und die Planung eines Projekts visuell:

Microsoft Project ermöglicht es Benutzern, verschiedene Ansichtseigenschaften wie Balkenstile, Rasterlinien, Fortschrittslinien, Angaben zur Zeitskala und Seitenlayout anzupassen. All diese Eigenschaften sind in der MPP file gespeichert. Mit Aspose.Tasks for .NET können Sie programmgesteuert über die View class oder deren abgeleitete Klassen: GanttChartView, TaskUsageView, und 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()); 

In diesem Codeausschnitt wird die Gantt-Diagramm-Ansicht direkt aufgerufen, wodurch es möglich ist, ihre gespeicherten Eigenschaften wie Zeitskala, Formatierung oder Darstellungsregeln zu lesen und zu bearbeiten.

Konfigurieren der Gantt-Diagramm-Ansicht durch Anzeige ausgewählter benutzerdefinierter Felder

Aufgaben in einem Projekt können erweiterte Attribute erhalten. Manchmal ist es notwendig, bestimmte benutzerdefinierte Felder automatisch in der Gantt-Diagramm-Ansicht anzuzeigen, anstatt sie manuell auszuwählen. Der folgende Code zeigt, wie die Projekttabelle angepasst werden kann, um dies zu erreichen.

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

Dieser Ansatz stellt sicher, dass ausgewählte benutzerdefinierte Felder standardmäßig in der exportierten MPP view erscheinen.

Anpassen der Beschriftungen der Zeitskalenstufen entsprechend den aktuellen Kulturinformationen

Aspose.Tasks for .NET ermöglicht das Anpassen der Beschriftungen der Zeitskalenstufen entsprechend den Systemeinstellungen für CultureInfo. Der DateTimeConverter delegate bietet Kontrolle darüber, wie Datumsangaben in Zeitskalenstufen dargestellt werden.

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

Dieses Codebeispiel zeigt, wie Beschriftungen der Zeitskalen dynamisch formatiert werden können, sodass lokalisierte Datumsformate in exportierten Projektansichten berücksichtigt werden.

Anpassen der Zeitskalen-Einstellungen für eine bestimmte Ansicht

Die TimescaleTier class ermöglicht Entwicklern, präzise Zeitskalen-Einstellungen für eine Projektansicht festzulegen. Das folgende Beispiel zeigt, wie die untere und mittlere Stufe angepasst und das Projekt mit diesen Einstellungen dargestellt wird.

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

Dies ermöglicht die Erstellung von Projektausgaben, bei denen die Zeitgranularität den Anforderungen an Berichte entspricht.

Unterstützung für Textformatierung

Textformatierung kann auf Gantt-Diagramm-Ansichten angewendet werden mithilfe der TableTextStyle class. Der folgende Code zeigt, wie benutzerdefinierte Textformatierungen gesetzt werden:

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

Diese Funktion ist nützlich, um wichtige Felder hervorzuheben oder die Lesbarkeit exportierter Projektdokumente zu verbessern.

Speichern von MPP mithilfe einer bestimmten Projektansicht

Aspose.Tasks ermöglicht das Speichern einer MPP file in grafische Formate unter Verwendung einer im Projekt definierten Ansicht. Diese Funktion ist praktisch, wenn mehrere Ansichten vorhanden sind und nur eine davon exportiert werden muss.

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

Dies gewährleistet Flexibilität beim Export maßgeschneiderter Ansichten für verschiedene Interessengruppen.

Arbeiten mit Balkenstilen in der Gantt-Diagramm-Ansicht

Die Gantt-Diagramm-Ansicht unterstützt sowohl aufgabenbezogene als auch kategorienbezogene Balkenstile.
Der folgende Code zeigt, wie diese zur besseren Visualisierung angepasst werden können.

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

Durch Anpassen der Balkenstile können Sie Aufgaben, Meilensteine und Fortschrittsanzeigen in exportierten Projektansichten hervorheben.

Fazit

Aspose.Tasks for .NET bietet umfangreiche Funktionalität für die Arbeit mit Projektansichten. Entwickler können Gantt-Diagramme lesen und anpassen, Zeitskalenstufen konfigurieren, Textstile anwenden, MPP files mit bestimmten Ansichten speichern und Balkenstile ändern. Diese Funktionen ermöglichen die Erstellung stark angepasster Berichte und stellen sicher, dass exportierte Projektdaten den geschäftlichen und präsentationsbezogenen Anforderungen entsprechen.

Schnellzugriffe

• Projektseiten in separate Dateien drucken
• Lücke zwischen Aufgabenliste und Fußzeile entfernen
• Notizen beim Konvertieren von Projektansichten rendern

Häufig gestellte Fragen

F: Muss Microsoft Project installiert sein, um mit Ansichten zu arbeiten?

• Nein. Aspose.Tasks for .NET funktioniert unabhängig von Microsoft Project.

F: Kann ich anpassen, welche Felder in einem Gantt-Diagramm angezeigt werden?

• Ja. Sie können Tabellen so konfigurieren, dass ausgewählte benutzerdefinierte Felder automatisch angezeigt werden.

F: Unterstützt Aspose.Tasks lokalisierte Zeitskalenbeschriftungen?

• Ja. Beschriftungen der Zeitskalenstufen können entsprechend der aktuellen CultureInfo.

F: Ist es möglich, nur eine Ansicht aus einer Projektdatei zu exportieren?

• Ja. Sie können eine bestimmte Ansicht auswählen und sie in PDF-, Bild- oder HTML-Formate exportieren.

F: Können Balkenstile in Gantt-Diagrammen programmgesteuert angepasst werden?

• Ja. Sowohl aufgabenbezogene als auch kategorienbezogene Balkenstile können über die API geändert werden.