Travailler avec les calendriers

Créer un calendrier

Les calendriers dans Microsoft Project définissent les heures ouvrables et non ouvrables, influençant directement la planification des tâches et la disponibilité des ressources. Dans Aspose.Tasks for .NET, les calendriers peuvent être créés à l’aide de la classe Calendar, qui fournit trois surcharges de constructeur :

• Calendar() – Initialise un calendrier par défaut.
• Calendar(int id) – Initialise un calendrier avec un ID spécifique.
• Calendar(string name) – Initialise un calendrier avec un nom spécifié.

L’exemple de code suivant montre comment instancier des calendriers avec chaque constructeur. Une fois créés, les calendriers peuvent être visualisés dans Microsoft Project via Projet > Informations sur le projet.

Informations sur le projet affichant les calendriers

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

Définir les jours de la semaine pour un calendrier

La collection Days de la classe Calendar représente les jours ouvrables et leurs plages horaires associées. Les jours de la semaine sont définis à l’aide des classes WeekDay et WorkingTime.

Les développeurs peuvent utiliser CreateDefaultWorkingDay() pour initialiser les heures standard d’un jour donné, ou définir des intervalles personnalisés via les propriétés FromTime et ToTime.

L’exemple ci-dessous définit les lundis à jeudis comme jours ouvrables par défaut, et le vendredi avec des heures personnalisées. Pour vérifier le résultat dans Microsoft Project, allez à Outils > Modifier les horaires de travail.

Définir les jours de semaine dans 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);

Remplacer un calendrier

Les calendriers de base servent de modèles pour la planification des ressources et des tâches. Aspose.Tasks permet de remplacer un calendrier existant en accédant à la CalendarCollection via l’objet Project.

Les types de calendrier de base pris en charge incluent :

• Standard : lundi–vendredi, 08:00–17:00.
• 24 heures : utilisé pour des horaires de travail en continu.
• Équipe de nuit : du lundi soir au samedi matin, 23:00–08:00.

Le code ci-dessous montre comment supprimer un calendrier existant et en ajouter un nouveau de type standard à la collection.

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

Créer un calendrier standard

Un calendrier standard définit les jours et heures ouvrables par défaut utilisés couramment dans la planification de projets. Aspose.Tasks fournit deux méthodes statiques pour faciliter cela :

• MakeStandardCalendar() – Crée un nouveau calendrier avec une configuration standard.
• MakeStandardCalendar(Calendar cal) – Convertit un calendrier existant en standard.

Pour inspecter le résultat dans Microsoft Project, utilisez Outils > Modifier les horaires de travail.

La boîte de dialogue d’informations sur les horaires de travail montre le calendrier standard utilisé par le projet

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

Écrire les données de calendrier mises à jour dans un fichier MPP

Aspose.Tasks permet de mettre à jour les définitions de calendriers et de les enregistrer dans un fichier MPP. Le processus implique :

1. Chargement du fichier MPP existant.
2. Modification de la collection de calendriers (ajout, mise à jour).
3. Enregistrement du projet mis à jour sur le disque.

L’exemple suivant montre comment ajouter un nouveau calendrier et l’enregistrer dans le fichier MPP source.

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