Робота з календарями

Створення календаря

Календарі в Microsoft Project визначають робочий та неробочий час, безпосередньо впливаючи на планування завдань та доступність ресурсів. В Aspose.Tasks для .NET календарі можна створювати за допомогою класу Calendar, який надає три перевантаження конструктора:

• Calendar() – Ініціалізує календар за замовчуванням.
• Calendar(int id) – Ініціалізує календар з певним ID.
• Calendar(string name) – Ініціалізує календар із зазначеною назвою.

Наступний зразок коду демонструє, як створювати календарі за допомогою кожного конструктора. Після створення календарі можна переглянути в Microsoft Project, перейшовши до Проект > Інформація про проект.

Інформація про проект, що показує календарі

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

Визначення днів тижня для календаря

Колекція Days класу Calendar представляє робочі дні та їх пов’язані часові діапазони. Визначення днів тижня моделюються через класи WeekDay та WorkingTime.

Розробники можуть використовувати CreateDefaultWorkingDay() для ініціалізації стандартних годин для певного дня тижня або встановлювати користувацькі робочі інтервали через властивості FromTime та ToTime.

Зразок нижче визначає понеділок-четвер як стандартні робочі дні, а п’ятницю з користувацькими робочими годинами. Щоб перевірити результат у Microsoft Project, перейдіть до Інструменти > Змінити робочий час.

Визначення днів тижня в 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);

Заміна календаря

Базові календарі служать шаблонами для планування ресурсів та завдань. Aspose.Tasks дозволяє замінювати існуючий календар, звертаючись до CalendarCollection через об’єкт Project.

Підтримувані типи базових календарів включають:

• Стандартний: понеділок–п’ятниця, 08:00–17:00.
• 24 години: використовується для безперервних робочих графіків.
• Нічна зміна: з понеділка ввечері до суботи вранці, 23:00–08:00.

Код нижче демонструє, як видалити існуючий календар та додати новий стандартний календар до колекції.

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

Створення стандартного календаря

Стандартний календар визначає стандартні робочі дні та години, які зазвичай використовуються в графіках проектів. Aspose.Tasks надає два статичні методи для полегшення цього:

• MakeStandardCalendar() – Створює новий календар зі стандартною конфігурацією.
• MakeStandardCalendar(Calendar cal) – Перетворює існуючий календар на стандартний.

Щоб перевірити результат у Microsoft Project, використовуйте Інструменти > Змінити робочий час.

Діалог інформації про зміну робочого часу показує стандартний календар, який використовується проектом

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

Запис оновлених даних календаря в MPP

Aspose.Tasks дозволяє оновлювати визначення календарів та зберігати їх назад у файл MPP. Процес включає:

1. Завантаження існуючого файлу MPP.
2. Модифікацію колекції календарів (додавання, оновлення).
3. Збереження оновленого проекту назад на диск.

Наступний приклад демонструє додавання нового календаря та запис його назад у вихідний файл MPP.

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