Arbeiten mit Projekteigenschaften

Arbeiten mit Projekteigenschaften

Microsoft Project speichert Metadaten und Konfiguration mit jeder Projektdatei (MPP/XML).
Mit Aspose.Tasks für .NET können Sie lesen, ändern und schreiben diese Eigenschaften programmgesteuert.

Dazu gehören:

• Allgemeine Projekteigenschaften (Startdatum, Statusdatum, Kalender usw.)
• Standardwerte für Vorgänge und Zuordnungen
• Projektversion und Zusammenfassungsinformationen
• Geschäftsjahres- und Wochentagseinstellungen
• Währungseinstellungen
• Attribute für neue Vorgänge
• Eingebaute und benutzerdefinierte Eigenschaften

Allgemeine Projekteigenschaften

Microsoft Project speichert Metadaten wie Start- und Enddaten, Statusdatum, Kalendertypund mehr.
Sie können auch benutzerdefinierte Eigenschaften.

Hinweis: Sie können keine Werte für **Application** und **Producer** Feldwerte setzen. Sie werden automatisch auf *Aspose Ltd.* und *Aspose.Tasks for .NET x.x.x*.

Eigenschaften

Eigenschaft	Typ	Beschreibung
StartDate	DateTime	Projekt-Startdatum
FinishDate	DateTime	Projekt-Enddatum
CurrentDate	DateTime	Aktuelles Arbeitsdatum
StatusDate	DateTime	Berichtsdatum für Fortschritt
IsScheduleFromStart	Boolean	Ob Planung vom Anfang oder Ende erfolgt
Calendar	Calendar	Zugewiesener Basiskalender

Projektinformationen lesen

Die Project Klasse verfügt über eine Reihe von Eigenschaften, die Projekteigenschaften betreffen:

• StartDate: das Projekt-Startdatum, vom Datentyp DateTime.
• FinishDate: das Projekt-Enddatum, vom Datentyp DateTime.
• CurrentDate: das aktuelle Datum, vom Datentyp DateTime.
• StatusDate: das Datum, an dem der Projektfortschritt gemeldet wird, vom Datentyp DateTime.
• IsScheduleFromStart: definiert, ob das Projekt vom Start- oder Enddatum geplant wird, und nimmt einen Boolean-Wert an.
• Calendar: der vom Projekt verwendete Kalendertyp, verwaltet durch die Aspose.Tasks.Calendar Klasse.

Um Projekteigenschaften in Microsoft Project zu lesen, klicken Sie auf Projektinformationen im Projekt Menü.

Die folgenden Programmbeispiele zeigen, wie man Start- und Enddatum des Projekts liest und ausgibt, ob das Projekt vom Anfang oder Ende geplant ist, sowie Autor, letzter Autor, Revision, Stichwörter und Kommentare.

// Create a project reader instance
Project project = new Project("New Project.mpp");

// Display project information
if (project.Get(Prj.ScheduleFromStart))
    Console.WriteLine("Project Finish Date : " + project.Get(Prj.StartDate).ToShortDateString());
else
    Console.WriteLine("Project Finish Date : " + project.Get(Prj.FinishDate).ToShortDateString());
Console.WriteLine(project.Get(Prj.Author));
Console.WriteLine(project.Get(Prj.LastAuthor));
Console.WriteLine(project.Get(Prj.Revision));
Console.WriteLine(project.Get(Prj.Keywords));
Console.WriteLine(project.Get(Prj.Comments));
Console.WriteLine("The program has run successfully");

Projektinformationen schreiben

Aspose.Tasks für .NET kann Projektinformationen sowohl schreiben als auch lesen. Die folgenden Codebeispiele zeigen, wie man Autor, letzten Autor, Revision, Stichwörter und Kommentare setzt.

// Create project from template file
Project project = new Project("New Project.mpp");
// Set project information
project.Set(Prj.Author, "Author");
project.Set(Prj.LastAuthor, "Last Author");
project.Set(Prj.Revision, 15);
project.Set(Prj.Keywords, "MSP Aspose");
project.Set(Prj.Comments, "Comments");
project.Save("WriteProjectInfo_out.mpp", SaveFileFormat.MPP);

Bestimmung der Projektversion

Die Aspose.Tasks für .NET-API bietet die Möglichkeit, Projektdateiinformationen mit einfachen API-Aufrufen abzurufen. Die Project Klassen- Get Methode ermöglicht es Benutzern, projektbezogene Informationen mithilfe der statischen Klasse Prjabzurufen. Die Prj-Klasse stellt eine Reihe von mit dem Projekt verbundenen Eigenschaften bereit. Dieses Thema zeigt, wie Versionsinformationen abgerufen werden.

Die von der Prj-Klasse bereitgestellten Eigenschaften SaveVersion und LastSaved werden verwendet, um die Projektversion und das Datum der letzten Speicherung zu bestimmen. SaveVersion verwendet den Datentyp Integer, während LastSaved den Datentyp DateTime verwendet.

Verwenden Sie die Prj.SaveVersion und Prj.LastSaved Eigenschaften, um die Version des Projektdateiformats und das Datum der letzten Speicherungabzurufen.

Eigenschaft	Typ	Beschreibung
SaveVersion	int	Version des Projektdateiformats
LastSaved	DateTime	Datum der letzten Speicherung

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

// Display project version
Console.WriteLine("Project Version : " + project.Get(Prj.SaveVersion).ToString());
Console.WriteLine("Last Saved : " + project.Get(Prj.LastSaved).ToShortDateString());

Standard-Projekteigenschaften

Microsoft Project erlaubt Benutzern, Standard-Projekteigenschaften festzulegen, die den Prozess der Projekteinrichtung beschleunigen. Die Standardwerte legen fest, wann ein neuer Vorgang beginnt und endet, setzen die Standard- und Überstundensätze und mehr. Aspose.Tasks für .NET unterstützt diese Funktionen.

Die Prj stellt eine Reihe von Eigenschaften zur Verwaltung der Standardwerte eines Projekts bereit:

Eigenschaft	Typ	Beschreibung
DefaultStartTime	DateTime	Standard-Startzeit für Vorgänge
DefaultFinishTime	DateTime	Standard-Endzeit für Vorgänge
DefaultFixedCostAccrual	CostAccrualType	Standard-Kostenverrechnung
DefaultStandardRate	double	Standard-Lohnsatz
DefaultOvertimeRate	double	Standard-Überstundensatz
DefaultTaskEVMethod	EarnedValueMethodType	Berechnung des Earned Value
DefaultTaskType	TaskType	Standardtyp neuer Vorgänge

//

• DefaultStartTime: Standard-Startzeit neuer Vorgänge, nimmt einen DateTime-Wert an.
• DefaultFinishTime: Standard-Endzeit neuer Vorgänge, nimmt einen DateTime-Wert an.
• DefaultFixedCostAccrual: Standard-Kostenverrechnungsart einer Zuordnung; nimmt einen der durch die CostAccrualType Enumeration definierten Werte an.
• DefaultStandardRate: der standardmäßige normale Lohnsatz, nimmt einen double-Wert an.
• DefaultOvertimeRate: der standardmäßige Überstundensatz, nimmt einen double-Wert an.
• DefaultTaskEVMethod: die standardmäßige Earned-Value-Methode für Vorgänge; nimmt einen der durch die EarnedValueMethodType Enumeration definierten Werte an.
• DefaultTaskType: der Standard-Vorgangstyp des Projekts; nimmt einen der durch die TaskType Enumeration definierten Werte an. //

Um die Standard-Projektinformationen in Microsoft Project zu sehen:

1. Öffnen Sie ein Projekt.
2. Im Extras Menü klicken Sie auf Optionen.
3. Gehen Sie zur Allgemein Registerkarte. Hier sehen Sie die Einstellungen für die Standard- und Überstundensätze.
4. Gehen Sie zur Zeitplan Registerkarte. Hier sehen Sie die Einstellungen für den Standard-Vorgangstyp und die Standard-Startzeit für Vorgänge.

Standard-Projektinformationen in Microsoft Project, wie von Aspose.Tasks geschrieben

Standardwerte lesen

Das folgende Beispiel liest die Standardwerte eines Projekts und schreibt sie in ein Konsolenfenster.

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

// Display default properties
Console.WriteLine("New Task Default Start: " + project.Get(Prj.DefaultStartTime).ToShortDateString());
Console.WriteLine("New Task Default Type: " + project.Get(Prj.DefaultTaskType));
Console.WriteLine("Resource Default Standard Rate: " + project.Get(Prj.DefaultStandardRate).ToString());
Console.WriteLine("Resource Default Overtime Rate: " + project.Get(Prj.DefaultOvertimeRate).ToString());
Console.WriteLine("Default Task EV Method: " + project.Get(Prj.DefaultTaskEVMethod).ToString());
Console.WriteLine("Default Cost Accrual: " + project.Get(Prj.DefaultFixedCostAccrual).ToString());

Standardwerte schreiben

Die folgenden Codezeilen setzen die Standardwerte eines Projekts.

// Create a project instance and Set default properties
Project project = new Project();
project.Set(Prj.ScheduleFromStart, true);
project.Set(Prj.StartDate, DateTime.Now);
project.Set(Prj.DefaultStartTime, project.Get(Prj.StartDate));
project.Set(Prj.DefaultTaskType, TaskType.FixedDuration);
project.Set(Prj.DefaultStandardRate, 15);
project.Set(Prj.DefaultOvertimeRate, 12);
project.Set(Prj.DefaultTaskEVMethod, EarnedValueMethodType.PercentComplete);
project.Set(Prj.DefaultFixedCostAccrual, CostAccrualType.Prorated);
project.Save("WriteDefaultProperties_out.xml", SaveFileFormat.XML);

Projektzusammenfassungsinformationen schreiben

Die meisten Programme speichern Zusammenfassungsinformationen mit den Dateien, die sie speichern. Microsoft Project ist da keine Ausnahme. Neben dem Namen des Autors, dem Erstellungsdatum des Projekts und dem Datum der letzten Bearbeitung und Speicherung speichert es Stichwörter, Betreff, Kommentare und mehr. Aspose.Tasks für .NET ermöglicht es Ihnen, diese Art von Informationen sowohl zu lesen als auch zu schreiben.

Die Project-Klasse Set Methode kann verwendet werden, um zu schreiben und die Get Methode kann verwendet werden, um Projektzusammenfassungsinformationen zu lesen, indem die Prj Klassenmitglieder verwendet werden. Die Datei kann nach Aktualisierung der Zusammenfassungsinformationen zurückgespeichert werden. Um die Projektzusammenfassungsinformationen einer bestehenden MPP-Datei zu aktualisieren:

1. Erstellen Sie eine Instanz der Project Klasse
2. Setzen Sie die verschiedenen Eigenschaften, die von der Prj Klasse bereitgestellt werden, um die Zusammenfassungsinformationen zu definieren.
3. Speichern Sie das Projekt mit der Save Methode der Project Klasse

Um die Zusammenfassungsinformationen der Datei zu sehen:

1. Finden Sie die Datei in einem Dateibrowser.
2. Klicken Sie mit der rechten Maustaste auf die Datei und wählen Sie Eigenschaften.
3. Gehen Sie zur Details Registerkarte.

Das folgende Codebeispiel schreibt Projektzusammenfassungsinformationen in eine MPP-Datei.

// Instantiate Project class
Project project = new Project("New Project.mpp");

// Set project summary
project.Set(Prj.Author, "Author");
project.Set(Prj.LastAuthor, "Last Author");
project.Set(Prj.Revision, 15);
project.Set(Prj.Keywords, "MSP Aspose");
project.Set(Prj.Comments, "Comments");
project.Save("WriteMPPProjectSummary_out.mpp", SaveFileFormat.MPP);

Eigenschaften des Geschäftsjahres

Das Geschäftsjahr entspricht dem Finanz- oder Haushaltsjahr. Es sind die Daten, innerhalb derer ein Land, eine Organisation oder eine Person Budgets und Steuern berechnet. Microsoft Project ermöglicht es Benutzern, ein Geschäftsjahr für Projekte zu definieren. Aspose.Tasks für .NET unterstützt diese Funktionalität mit Eigenschaften, die Entwicklern erlauben, sowohl Geschäftsjahrseigenschaften lesen aus bestehenden Projekten und Geschäftsjahrseigenschaften festlegen beim Erstellen oder Bearbeiten von Projekten.

Die Prj Klasse stellt die FyStartDate und FiscalYearStart Eigenschaften bereit, die zur Verwaltung des Geschäftsjahres eines Projekts verwendet werden:

• FyStartDate: definiert den Beginnmonat des Geschäftsjahres und unterstützt einen der durch die Month-Enumeration definierten Werte.
• FiscalYearStart: bestimmt, ob die Nummerierung des Geschäftsjahres im Projekt verwendet wurde. Boolean.

Geschäftsjahrseigenschaften lesen

Die Eigenschaften FyStartDate und FiscalYearStart machen es mit Aspose.Tasks einfach herauszufinden, welches das aktuelle Startdatum des Geschäftsjahres ist und ob die Geschäftsjahresnummerierung verwendet wird.

Der folgende Code liest die Geschäftsjahrseigenschaften eines Projekts und zeigt sie in einem Konsolenfenster an.

// Create a project instance
Project project = new Project("New Project.mpp");

// Display fiscal year properties
Console.WriteLine("Fiscal Year Start Date : " + project.Get(Prj.FyStartDate).ToString());
Console.WriteLine("Fiscal Year Numbering : " + project.Get(Prj.FiscalYearStart).ToString());

Geschäftsjahrseigenschaften schreiben

Um Geschäftsjahrseigenschaften in Microsoft Project zu sehen:

1. Öffnen Sie eine Projektdatei.
2. Im Extras Menü klicken Sie auf Optionen.
3. Klicken Sie auf die Kalender Registerkarte. Sie sieht wie unten gezeigt aus.

Überprüfung, ob die Geschäftsjahrseigenschaften in Microsoft Project gesetzt wurden.

Das folgende Beispiel schreibt die Geschäftsjahrseigenschaften des Projekts.

// Create a project instance
Project project = new Project("New Project.mpp");

// Set fiscal year properties
project.Set(Prj.FyStartDate, Month.July);
project.Set(Prj.FiscalYearStart, true);
project.Save("WriteFiscalYearProperties_out.mpp", SaveFileFormat.MPP);

Wochentagseigenschaften

Microsoft Project erlaubt Benutzern, verschiedene Wochentagseigenschaften festzulegen. Zum Beispiel, an welchem Tag eine Woche beginnt und wie viele Arbeitstage ein Monat hat. Aspose.Tasks unterstützt diese Funktionen über eine Reihe von Eigenschaften, die sowohl zum Lesen von Wochentagseigenschaften als auch zum Schreiben dieser Eigenschaften in ein Projekt.

Aspose.Tasks verfügt über eine Reihe von Eigenschaften, die durch die Project Klasse bereitgestellt werden und speziell zur Verwaltung der Wochentagseigenschaften eines Projekts dienen:

• WeekStartDay: der erste Tag der Woche. Diese Eigenschaft nimmt Werte an, die durch die DayType-Enumeration definiert sind. DayType Enumeration.
• DaysPerMonth: die Anzahl der Arbeitstage in einem Monat, übergeben als Integer.
• MinutesPerDay: die Anzahl der Arbeitsminuten an einem Arbeitstag, übergeben als Integer.
• MinutesPerWeek: die Anzahl der Arbeitsminuten in einer Arbeitswoche, übergeben als Integer.

Wochentagseigenschaften lesen

Der folgende Code liest die Wochentagseigenschaften eines Projekts und schreibt sie in ein Konsolenfenster.

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

// Display week days properties
Console.WriteLine("Week Start Date : " + project.Get(Prj.WeekStartDay).ToString());
Console.WriteLine("Days Per Month : " + project.Get(Prj.DaysPerMonth).ToString());
Console.WriteLine("Minutes Per Day : " + project.Get(Prj.MinutesPerDay).ToString());
Console.WriteLine("Minutes Per Week : " + project.Get(Prj.MinutesPerWeek).ToString());

Wochentagseigenschaften schreiben

Um Wochentagseigenschaften in Microsoft Project zu sehen:

1. Öffnen Sie eine Datei.
2. Im Extras Menü wählen Sie Optionen.
3. Wählen Sie die Kalender Registerkarte aus. Sie wird ungefähr wie das folgende Beispiel aussehen.

Anzeigen der Wochentagseigenschaften in Microsoft Project

Der folgende Code schreibt Wochentagseigenschaften, wie oben im Screenshot gezeigt, in ein Projekt.

// Create a project instance
Project project = new Project("New Project.mpp");

// Set week days properties
project.Set(Prj.WeekStartDay, DayType.Monday);
project.Set(Prj.DaysPerMonth, 24);
project.Set(Prj.MinutesPerDay, 540);
project.Set(Prj.MinutesPerWeek, 3240);
project.Save("WriteWeekdayProperties_out.xml", SaveFileFormat.XML);

Währungseigenschaften

Microsoft Project erlaubt Benutzern, welche Währung in einem Projekt angezeigt wird. Sie können den Währungscode, die Anzahl der Dezimalstellen und das Währungssymbol festlegen, damit Kosten übersichtlich und intuitiv angezeigt werden. Aspose.Tasks für .NET unterstützt diese Funktionen und stellt eine Reihe von Eigenschaften bereit, die Entwicklern helfen, Währungseinstellungen zu setzen und zu steuern. Dieses Thema erklärt sowohl, wie man Währungseigenschaften liest, und wie man sie setzt.

Aspose.Tasks für .NET bietet Eigenschaften, die von der Prj Klasse bereitgestellt werden, zur Verwaltung von Währungseigenschaften:

• CurrencyCode: der dreibuchstabige Währungscode, zum Beispiel USD, GBP oder AUD, übergeben als String.
• CurrencyDigits: die Anzahl der Nachkommastellen, zum Beispiel 2 (100,00) oder 3 (100,000), übergeben als Integer.
• CurrencySymbol: das Währungssymbol, zum Beispiel $ oder £, übergeben als String.
• CurrencySymbolPosition: die Position des Währungssymbols, zum Beispiel davor ($100) oder danach (100$). CurrencySymbolPosition nimmt einen Wert aus der CurrencySymbolPositionType Enumeration an.

Währungseigenschaften lesen

Der folgende Code liest die Währungseigenschaften eines Projekts.

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

// Display currency properties
Console.WriteLine("Currency Code : " + project.Get(Prj.CurrencyCode).ToString());
Console.WriteLine("<br>Currency Digits : " + project.Get(Prj.CurrencyDigits).ToString());
Console.WriteLine("<br>Currency Symbol : " + project.Get(Prj.CurrencySymbol).ToString());
Console.WriteLine("Currency Symbol Position" + project.Get(Prj.CurrencySymbolPosition).ToString());

Währungseigenschaften schreiben

Um die Währungseigenschaften in Microsoft Project zu sehen:

1. Öffnen Sie die Projektdatei.
2. Im Extras Menü wählen Sie Optionen.
3. Klicken Sie auf die Ansicht Registerkarte. Sie sieht wie unten gezeigt aus.

Währungseigenschaften in Microsoft Project lesen

Das folgende Beispiel schreibt Währungseigenschaften in das Projekt.

// Create a project instance
Project project = new Project("New Project.mpp");

// Set currency properties
project.Set(Prj.CurrencyCode, "AUD");
project.Set(Prj.CurrencyDigits, 2);
project.Set(Prj.CurrencySymbol, "$");
project.Set(Prj.CurrencySymbolPosition, CurrencySymbolPositionType.After);

project.Save("WriteCurrencyProperties_out.xml", SaveFileFormat.XML);

Attribute für neue Vorgänge festlegen

Microsoft Project erlaubt das Festlegen von Standardwerten für neu hinzugefügte Vorgänge. Dieses Thema erklärt, wie man mit der Aspose.Tasks für .NET-API das Standardstartdatum für neue Vorgänge setzt.

Die Prj Klasse stellt die NewTaskStartDate Eigenschaft bereit, die das Startdatum für einen neuen Vorgang definiert. Diese Eigenschaft unterstützt die durch die TaskStartDateType Enumeration definierten Werte.

Um die Vorgangsattribute zu sehen:

1. Öffnen Sie die Datei mit Microsoft Project.
2. Im Extras Menü wählen Sie Optionen.
3. Wählen Sie die Zeitplan Registerkarte. Die Registerkarte sieht wie die unten gezeigte aus.

Neue Vorgänge beginnen am aktuellen Datum

Die folgenden Codezeilen setzen das Startdatum neuer Vorgänge.

// Create a project instance Set new task property and Save the project as XML project file
Project project = new Project();
project.Set(Prj.NewTaskStartDate, TaskStartDateType.CurrentDate);
project.Save("SetAttributesForNewTasks_out.xml", SaveFileFormat.XML);
 
// Display Status.
Console.WriteLine("New Task created with start date successfully.");

Benutzerdefinierte und eingebaute Eigenschaften lesen

In Aspose.Tasks für .NET sind die benutzerdefinierten Eigenschaften über eine typisierte Sammlung verfügbar, während die eingebauten Eigenschaften direkt verfügbar sind.

Das folgende Codebeispiel zeigt, wie man benutzerdefinierte und eingebaute Eigenschaften liest.

// Create a project reader instance
Project project = new Project("New Project.mpp");

// custom properties are available through the typed collection
foreach (var property in project.CustomProps)
{
    Console.WriteLine(property.Type);
    Console.WriteLine(property.Name);
    Console.WriteLine(property.Value);
}

// built-in properties are available directly
Console.WriteLine(project.BuiltInProps.Author);
Console.WriteLine(project.BuiltInProps.Title);


// or as an item of built-in property collection
foreach (var property in project.BuiltInProps)
{
    Console.WriteLine(property.Name);
    Console.WriteLine(property.Value);
}