Hilfsfunktionen in Aspose.Tasks for .NET

Bei der Arbeit mit Microsoft Project-Dateien benötigen Entwickler oft mehr als nur das Erstellen von Aufgaben und Ressourcen. Sie benötigen Zugriff auf unterstützende Projektdaten wie z. B. Filter, Tabellen, Gruppen, eingebettete Objekte und sogar diagnostische Werkzeuge zur Fehlerbehandlung. Aspose.Tasks for .NET stellt eine Reihe von Hilfsfunktionen die Projektmanagement-Workflows leistungsfähiger und flexibler machen. Dazu gehören Funktionen wie die Berechnung des kritischen Pfads eines Projekts, das Behandeln von Ausnahmen beim Schreiben von Aufgaben, das Abrufen von Filter- und Gruppendefinitionen, das Extrahieren eingebetteter Objekte und mehr. Zusammengenommen helfen diese Hilfsfunktionen Entwicklern, die Funktionalität von Projekten zu erweitern, die Genauigkeit von Berichten zu verbessern und Microsoft Project-Dateien nahtlos in andere Systeme zu integrieren.

Kritischen Pfad berechnen

Der kritische Pfad sind die Aufgaben, die letztlich bestimmen, wann Ihr Projekt endet. Die Verfolgung des kritischen Pfads und der dafür zugewiesenen Ressourcen hilft, das Projekt termingerecht zu halten. Microsoft Project berechnet den kritischen Pfad anhand von Aufgaben, die keinen Puffer aufweisen, bestimmte Datumsbeschränkungen haben (muss an einem bestimmten Datum beginnen, muss an einem bestimmten Datum enden, so früh wie möglich oder so spät wie möglich) oder dasselbe oder ein späteres Enddatum als das Projekt haben. Aspose.Tasks ermöglicht es Ihnen, den kritischen Pfad zu berechnen.

Die Project Klasse stellt die CriticalPath Eigenschaft, mit der die Sammlung von Aufgaben abgerufen werden kann, die den kritischen Pfad des Projekts bilden. Der folgende Codeabschnitt berechnet und zeigt die Aufgaben im kritischen Pfad an.

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

Task subtask1 = project.RootTask.Children.Add("1");
Task subtask2 = project.RootTask.Children.Add("2");
Task subtask3 = project.RootTask.Children.Add("3");
project.TaskLinks.Add(subtask1, subtask2, TaskLinkType.FinishToStart);

// Display the critical path now
foreach (Task task in project.CriticalPath)
{
    Console.WriteLine(task.Get(Tsk.Name));
}

Ausgabe der TaskWritingException

Ein Projekt besteht aus einer Reihe von Aufgaben und die Aspose.Tasks for .NET API ermöglicht das Hinzufügen, Entfernen und Aktualisieren von Aufgabeninformationen. Wenn beim Schreiben von Aufgaben ein Problem auftritt, verwenden Sie TasksWritingException um diese abzufangen.

Aspose.Tasks for .NET unterstützt das Ausgeben einer Nachricht, wenn beim Schreiben einer Aufgabe eine Ausnahme auftritt. Dies erfolgt mit TaskWritingException, ähnlich wie TaskReadingException verwendet wird.

Die Protokollnachricht befindet sich in der öffentlichen Eigenschaft TasksWritingException.LogText, wie im folgenden Codebeispiel gezeigt.

try
{
    Project project = new Project("New Project.mpp");
    Console.Write("This example will only work if you apply a valid Aspose License. You can purchase full license or get 30 day temporary license from http://www.aspose.com/purchase/default.aspx.");
    project.Save("output.mpp", SaveFileFormat.MPP);
}
catch (TasksWritingException ex)
{
    Console.WriteLine(ex.LogText);
}
catch (NotSupportedException ex)
{
    Console.WriteLine(ex.Message + "\nThis example will only work if you apply a valid Aspose License. You can purchase full license or get 30 day temporary license from http://www.aspose.com/purchase/default.aspx.");
}

Arbeiten mit Filterdaten aus MPP-Dateien

Aspose.Tasks ermöglicht Entwicklern das Lesen von Informationen über auf MPP-Dateien angewendete Filter. Dieser Artikel zeigt, wie Filterdefinitionen und Filterkriterien aus einer Microsoft Project MPP-Datei abgerufen werden können.

Filterdefinitionsdaten lesen

Filterdefinitionen in Microsoft Project beschreiben die Struktur von Filtern – beispielsweise ihre Namen, Typen und die Felder, auf die sie angewendet werden. Mit Aspose.Tasks for .NET können Sie auf diese Filterdefinitionen programmgesteuert zugreifen und untersuchen, wie Filter in einer MPP-Datei konfiguriert sind.

// Instantiate project and access task filters
Project project = new Project("ReadFilterDefinitionData.mpp");
List<Filter> taskFilters = project.TaskFilters.ToList();
Console.WriteLine("Task Filters Count: " + taskFilters.Count);
Console.WriteLine("All Tasks: " + taskFilters[0].Name);
Console.WriteLine("Task Item: " + taskFilters[0].FilterType);
Console.WriteLine("Task Filters Show In Menu: " + taskFilters[0].ShowInMenu);
Console.WriteLine("Task filter ShowRelatedSummaryRows: " + taskFilters[0].ShowRelatedSummaryRows);

// Access resource filters
List<Filter> filters = project.ResourceFilters.ToList();
Console.WriteLine("Project.ResourceFilters count: " + filters.Count);
Console.WriteLine("Resource Filter Item Type: Item.ResourceType: " + filters[0].FilterType);
Console.WriteLine("Resource filter ShowInMenu" + filters[0].ShowInMenu);
Console.WriteLine("Resource filter ShowRelatedSummaryRows: " + filters[0].ShowRelatedSummaryRows);

Filterkriterien lesen

Während Definitionen die Struktur eines Filters beschreiben, legen Filterkriterien die genauen Bedingungen fest, die auf Projektdaten angewendet werden (zum Beispiel Aufgaben mit bestimmten Terminen oder Ressourcen). Aspose.Tasks ermöglicht das Lesen dieser Kriterien aus einer MPP-Datei, was besonders nützlich sein kann, um benutzerdefinierte Ansichten in Microsoft Project zu reproduzieren oder zu analysieren.

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

Filter filter = project.TaskFilters.ToList()[1];
Console.WriteLine(filter.Criteria.CriteriaRows.Count);
Console.WriteLine(filter.Criteria.Operation.ToString());

FilterCriteria criteria1 = filter.Criteria.CriteriaRows[0];
Console.WriteLine(criteria1.Test.ToString());
Console.WriteLine(criteria1.Field.ToString());
Console.WriteLine(criteria1.Values[0].ToString());

FilterCriteria criteria2 = filter.Criteria.CriteriaRows[1];
Console.WriteLine(criteria2.Operation.ToString());
Console.WriteLine(criteria2.CriteriaRows.Count);

FilterCriteria criteria21 = criteria2.CriteriaRows[0];
Console.WriteLine(criteria21.Test.ToString());
Console.WriteLine(criteria21.Field.ToString());
Console.WriteLine(criteria21.Values[0].ToString());

FilterCriteria criteria22 = criteria2.CriteriaRows[1];
Console.WriteLine(criteria22.Test.ToString());
Console.WriteLine(criteria22.Field.ToString());
Console.WriteLine(criteria22.Values[0].ToString());
Console.WriteLine(filter.Criteria);

Gruppendefinitionsdaten lesen

Eine Microsoft Project-Datendatei kann Daten in Gruppen enthalten. Aspose.Tasks for .NET bietet die Möglichkeit, die Gruppendefinitionsdaten zu lesen, wie im folgenden Beispiel gezeigt.

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

Console.WriteLine("Task Groups Count: " + project.TaskGroups.Count);

Group taskGroup = project.TaskGroups.ToList()[1];
Console.WriteLine("Group Name:", taskGroup.Name);
Console.WriteLine("Group Criteria count: " + taskGroup.GroupCriteria.Count);
Console.WriteLine("************* Retrieving Task Group's Criterion information *************");

GroupCriterion criterion = taskGroup.GroupCriteria.ToList()[0];
Console.WriteLine("Criterion Field: " + criterion.Field.ToString());
Console.WriteLine("Criterion GroupOn: " + criterion.GroupOn.ToString());
Console.WriteLine("Criterion Cell Color: " + criterion.CellColor);
Console.WriteLine("Criterion Pattern: " + criterion.Pattern.ToString());

if (taskGroup == criterion.ParentGroup)
{
    Console.WriteLine("Parent Group is equal to task Group.");
}

Console.WriteLine("*********** Retrieving Criterion's Font Information ***********");
Console.WriteLine("Font Name: " + criterion.Font.Name);
Console.WriteLine("Font Size: " + criterion.Font.Size);
Console.WriteLine("Font Style: " + criterion.Font.Style);
Console.WriteLine("Ascending/Descending: " + criterion.Ascending);

Tabellendaten aus einer MPP-Datei lesen

Die Aspose.Tasks for .NET API unterstützt das Lesen von Tabellendaten aus Microsoft Project-Datendateien. Project.Tables implementiert das ICollection-Interface, um Zugriff auf die Tabellendaten einer MPP-Datei zu bieten. Die Funktion wird für alle Versionen der Microsoft Project-Datendateien unterstützt, einschließlich MPP 2003, 2007, 2010 und 2013.

Das folgende Beispiel zeigt, wie Tabellendaten aus einer Microsoft Project MPP-Datei abgerufen werden. Die Werte von Tabelleneigenschaften wie Breite, Titel, Titelausrichtung und Datenausrichtung werden hier zur Demonstration angezeigt.

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

// Access table
Table task1 = project.Tables.ToList()[0];
Console.WriteLine("Table Fields Count" + task1.TableFields.Count);

// Display all table fields information
foreach (TableField tableField in task1.TableFields)
{
    Console.WriteLine("Field width: " + tableField.Width);
    Console.WriteLine("Field Title: " + tableField.Title);
    Console.WriteLine("Field Title Alignment: " + tableField.AlignTitle.ToString());
    Console.WriteLine("Field Align Data: " + tableField.AlignData.ToString());
}

Extrahieren eingebetteter Objekte aus dem Aufgaben- oder Überprüfungsformular

Microsoft Project-Datendateien (MPP/XML) können in Aufgaben- oder Ressourcenansichten eingebettete Objekte wie Dokumente, Excel-Tabellen, PDF, Bilder usw. enthalten. Die Aspose.Tasks for .NET API bietet die Möglichkeit, diese aus der Aufgaben- oder Ressourcenansicht eines Projekts zu extrahieren, wie in den folgenden Themen gezeigt.

Extrahieren eingebetteter Objekte

Eingebettete Objekte (diejenigen, die aus einer Datei durch Auswahl eines Dateipfads erstellt wurden) werden im OLE Package innerhalb der MPP-Datei verpackt. Um die Originaldatei zu extrahieren, können Sie die Eigenschaften Content und FullPath einer Instanz der OleObject-Klasse verwenden.

Project project = new Project("ExtractEmbeddedObjects.mpp");
OleObject ole = project.OleObjects.ToList()[0];
// We have to check this property because it can be null if the embedded object was created inside the ms project application Or, alternatively, you can use this check: if (ole.FileFormat == "Package")
if (!string.IsNullOrEmpty(ole.FullPath))
{
    using (FileStream stream = new FileStream("out.ole", FileMode.Create))
    {
        stream.Write(ole.Content, 0, ole.Content.Length);
    }
}

Eingebettete Objekte, die innerhalb der Microsoft Project-Anwendung erstellt wurden, können auf diese Weise extrahiert werden:

IDictionary<string, string> fileFormatExt = new Dictionary<string, string>();
fileFormatExt.Add("RTF", "_rtfFile_out.rtf");
fileFormatExt.Add("MSWordDoc", "_wordFile_out.docx");
fileFormatExt.Add("ExcelML12", "_excelFile_out.xlsx");
Project project = new Project("New Project.mpp"); 
foreach (OleObject oleObject in project.OleObjects)
{
    if (!string.IsNullOrEmpty(oleObject.FileFormat) && fileFormatExt.ContainsKey(oleObject.FileFormat))
    {
        using (FileStream stream = new FileStream("EmbeddedContent_" + fileFormatExt[oleObject.FileFormat], FileMode.Create))
        {
            stream.Write(oleObject.Content, 0, oleObject.Content.Length);
        }
    }
}

Hilfsfunktionen in Aspose.Tasks for .NET bieten Entwicklern ein umfassendes Werkzeugpaket für die Behandlung von Projektdetails, die über die einfache Manipulation von Aufgaben oder Ressourcen hinausgehen. Von der Ermittlung des kritischen Pfads und der Behebung von Problemen bei Aufgabenoperationen bis hin zum Abrufen von Filtern, Gruppen und Tabellen und sogar dem Extrahieren eingebetteter Inhalte – diese Möglichkeiten sorgen dafür, dass Entwickler die volle Kontrolle über den Lebenszyklus der Projektdaten haben. Durch die Integration dieser Hilfsfunktionen in Arbeitsabläufe können Teams bessere Überwachung, saubereren Datenaustausch und tiefere Automatisierung, was letztlich die Effizienz des Projektmanagements erhöht.