カレンダーの操作

カレンダーの作成

Microsoft Projectのカレンダーは、作業時間と非作業時間を定義し、タスクのスケジューリングとリソースの可用性に直接影響します。Aspose.Tasks for .NETでは、3つのコンストラクタオーバーロードを提供する 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);

カレンダーの平日の定義

Calendarクラスの Daysコレクションは、作業日とそれに関連する時間範囲を表します。平日の定義は、 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では、 Projectオブジェクトを介して CalendarCollectionにアクセスすることで、既存のカレンダーを置換できます。

サポートされている基本カレンダータイプには以下があります：

• 標準: 月曜日から金曜日、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は、これを容易にする2つの静的メソッドを提供します：

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