Erstellen, Aktualisieren und Entfernen von Kalendern

Erstellen eines Kalenders

Kalender in Microsoft Project definieren Arbeits- und Nichtarbeitszeiten, die direkten Einfluss auf die Aufgabenplanung und Ressourcenzuweisung haben. In Aspose.Tasks for .NET können Kalender mithilfe der Klasse Calendar erstellt werden, die drei Konstruktorüberladungen bietet:

• Calendar() – Initialisiert einen Standardkalender.
• Calendar(int id) – Initialisiert einen Kalender mit einer bestimmten ID.
• Calendar(string name) – Initialisiert einen Kalender mit einem bestimmten Namen.

Das folgende Codebeispiel zeigt, wie Kalender mit jeder dieser Konstruktoren erstellt werden. Die erstellten Kalender können in Microsoft Project unter Projekt > Projektinformationen angezeigt werden.

Projektinformationen mit den verfügbaren Kalendern

// Create a project instance
Project project = new Project();

// New calendar can be added to a project's calendar collection using the collection's Add method.
Calendar cal1 = project.Calendars.Add("New Info");
Calendar cal2 = project.Calendars.Add("no name");
Calendar cal3 = project.Calendars.Add("cal3");

project.Save("CreatingCalendar_out.Xml", SaveFileFormat.XML);

Wochentage für einen Kalender definieren

Die Eigenschaft Days der Calendar-Klasse repräsentiert Arbeitstage und deren zugehörige Arbeitszeiten. Wochentage werden über die Klassen WeekDay und WorkingTime modelliert.

Entwickler können CreateDefaultWorkingDay() verwenden, um Standardzeiten für einen Wochentag zu initialisieren, oder benutzerdefinierte Zeitintervalle über die Eigenschaften FromTime und ToTime festlegen.

Das folgende Beispiel definiert Montag bis Donnerstag als Standardarbeitstage und Freitag mit benutzerdefinierten Arbeitszeiten. Um das Ergebnis in Microsoft Project zu überprüfen, gehen Sie zu Extras > Arbeitszeit ändern.

Definition der Arbeitstage in Microsoft Project

// This example shows how Aspose.Tasks API can be used to define a new Calendar, add week days to it and define working times for days
// Create a project instance
Project project = new Project();

// Define Calendar
Calendar cal = project.Calendars.Add("Calendar1");

// Add working days monday through thursday with default timings
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
cal.WeekDays.Add(WeekDay.CreateDefaultWorkingDay(DayType.Thursday));
cal.WeekDays.Add(new WeekDay(DayType.Saturday));
cal.WeekDays.Add(new WeekDay(DayType.Sunday));

// Set friday as short working day
WeekDay myWeekDay = new WeekDay(DayType.Friday);

// Sets working time. Only time part of DateTime is important
WorkingTime wt1 = new WorkingTime();
wt1.FromTime = new DateTime(1, 1, 1, 9, 0, 0, 0);
wt1.ToTime = new DateTime(1, 1, 1, 12, 0, 0, 0);
WorkingTime wt2 = new WorkingTime();
wt2.FromTime = new DateTime(1, 1, 1, 13, 0, 0, 0);
wt2.ToTime = new DateTime(1, 1, 1, 16, 0, 0, 0);
myWeekDay.WorkingTimes.Add(wt1);
myWeekDay.WorkingTimes.Add(wt2);
myWeekDay.DayWorking = true;
cal.WeekDays.Add(myWeekDay);

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

Kalender ersetzen

Basiskalender dienen als Vorlagen für die Ressourcen- und Aufgabenplanung. Mit Aspose.Tasks können bestehende Kalender über die CalendarCollection des Project-Objekts ersetzt werden.

Unterstützte Basiskalendertypen:

• Standard: Montag–Freitag, 08:00–17:00.
• 24-Stunden: Für durchgängige Arbeitspläne.
• Nachtschicht: Montagabend bis Samstagmorgen, 23:00–08:00.

Der folgende Code zeigt, wie ein bestehender Kalender entfernt und ein neuer Standardkalender zur Sammlung hinzugefügt wird.

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

// Access project calendars
CalendarCollection calColl = project.Calendars;
foreach (Calendar myCalendar in calColl)
{
    if (myCalendar.Name == "TestCalendar")
    {
        // Remove calendar
        calColl.Remove(myCalendar);
    }
}

// Add new calendar
Calendar newCalendar = calColl.Add("TestCalendar");
project.Save("ReplaceCalendar_out.mpp", SaveFileFormat.MPP);

Erstellen eines Standardkalenders

Ein Standardkalender definiert die typischen Arbeitszeiten und -tage, die in Projekten üblich sind. Aspose.Tasks bietet zwei statische Methoden zur Erstellung:

• MakeStandardCalendar() – Erstellt einen neuen Kalender mit Standardkonfiguration.
• MakeStandardCalendar(Calendar cal) – Wandelt einen bestehenden Kalender in einen Standardkalender um.

Zur Überprüfung des Ergebnisses in Microsoft Project verwenden Sie Extras > Arbeitszeit ändern.

Dialogfeld zur Bearbeitung von Arbeitszeiten im Projektkalender

// Create a project instance
Project project = new Project();

// Define Calendar and make it standard
Calendar cal1 = project.Calendars.Add("My Cal");
Calendar.MakeStandardCalendar(cal1);

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

Aktualisierte Kalenderdaten in MPP schreiben

Mit Aspose.Tasks können Kalenderdefinitionen bearbeitet und in eine MPP-Datei zurückgeschrieben werden. Der Vorgang umfasst:

1. Laden der bestehenden MPP-Datei.
2. Ändern der Kalendersammlung (hinzufügen, aktualisieren).
3. Speichern des aktualisierten Projekts auf die Festplatte.

Das folgende Beispiel zeigt, wie ein neuer Kalender hinzugefügt und in die Quelldatei zurückgeschrieben wird.

Project project = new Project("New Project.mpp");
Calendar cal = project.Calendars.GetByUid(3);

// Update the calendar information
Calendar.MakeStandardCalendar(cal);
cal.Name = "Test calendar";
CalendarException exc = new CalendarException();
exc.FromDate = DateTime.Now;
exc.ToDate = DateTime.Now.AddDays(2);
exc.DayWorking = true;

WorkingTime wt1 = new WorkingTime();
wt1.FromTime = new DateTime(10, 1, 1, 9, 0, 0);
wt1.ToTime = new DateTime(10, 1, 1, 13, 0, 0);

WorkingTime wt2 = new WorkingTime();
wt2.FromTime = new DateTime(10, 1, 1, 14, 0, 0);
wt2.ToTime = new DateTime(10, 1, 1, 19, 0, 0);

WorkingTime wt3 = new WorkingTime();
wt3.FromTime = new DateTime(10, 1, 1, 20, 0, 0);
wt3.ToTime = new DateTime(10, 1, 1, 21, 0, 0);

exc.WorkingTimes.Add(wt1);
exc.WorkingTimes.Add(wt2);
exc.WorkingTimes.Add(wt3);
cal.Exceptions.Add(exc);

CalendarException exc2 = new CalendarException();
exc2.FromDate = DateTime.Now.AddDays(7);
exc2.ToDate = exc2.FromDate;
exc2.DayWorking = false;
cal.Exceptions.Add(exc2);

project.Set(Prj.Calendar, cal);

project.Save("WriteUpdatedCalendarDataToMPP_out.mpp", SaveFileFormat.MPP);