Java의 캘린더 작성 및 업데이트

캘린더 만들기

캘린더 및 기타 정보는 Microsoft Project에서 프로젝트 일정을 구축하는 데 사용됩니다. Aspose.Tasks 를 사용하면 Java의 경우 프로젝트에 달력을 추가하는 것이 쉽습니다. 캘린더 클래스 생성자를 사용하면 캘린더 이름을 캘린더에 할당 할 수 있습니다. 옵션은 아래에 설명되어 있습니다.

Aspose.Tasks에서 캘린더를 만드는 세 가지 방법이 있습니다. 캘린더 클래스는 다음 생성자를 노출시킵니다.

• 캘린더 (문자열 이름) - 이름의 캘린더를 만듭니다.

프로젝트 캘린더는 getCalendars () 프로젝트 클래스의 메소드에 의해 캘린더 컬렉션으로 반환됩니다. Microsoft Project에서 출력 파일을 열고 프로젝트 메뉴에서 프로젝트 정보를 선택하여 캘린더에 액세스하십시오.

달력 정보를 보여주는 프로젝트 정보

프로그래밍 샘플

// The path to the documents directory.
String dataDir = Utils.getDataDir(CreateCalendar.class);

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

// Define Calendar
Calendar cal1 = prj.getCalendars().add("no info");
Calendar cal2 = prj.getCalendars().add("no name");
Calendar cal3 = prj.getCalendars().add("cal3");

prj.getCalendars().add(cal1);
prj.getCalendars().add(cal2);
prj.getCalendars().add(cal3);

prj.save(dataDir + "Project.Xml", SaveFileFormat.XML);

// Display result of conversion.
System.out.println("Process completed Successfully");

Defining Weekdays for Calendar

Microsoft Project keeps track of which days are considered weekdays in a calendar so that it can calculate project end dates and so on. Aspose.Tasks allows developers to define weekdays for a calendar associated with a project. This topic shows how.

The Days collection exposed by the Calendar class is used to define the weekdays for a calendar. The Days collection represents an array list of WeekDay objects.

The CreateDefaultWorkingDay method exposed by the WeekDay class can further be implemented to define the default day timings, while the FromTime and ToTime properties exposed by the WorkingTime class is used to define the specific timing for a day. The FromTime and ToTime support the DateTime datatype.

The code samples below set weekdays for a project. After running the code, open the output file in Microsoft Project and, on the Tools menu, select Change Work Timing to establish that the changes have been applied.

Defining weekdays in Microsoft Project

Programming Sample

The code below defines Monday through Thursday as weekdays with default timings, whereas Friday as a weekday with special timings.

// The path to the documents directory.
String dataDir = Utils.getDataDir(DefineWeekdays.class);

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

//Define Calendar
Calendar cal = prj.getCalendars().add("Calendar1");

//Add working days Monday through Thursday with default timings
cal.getWeekDays().add(WeekDay.createDefaultWorkingDay(DayType.Monday));
cal.getWeekDays().add(WeekDay.createDefaultWorkingDay(DayType.Tuesday));
cal.getWeekDays().add(WeekDay.createDefaultWorkingDay(DayType.Wednesday));
cal.getWeekDays().add(WeekDay.createDefaultWorkingDay(DayType.Thursday));
cal.getWeekDays().add(new WeekDay(DayType.Saturday));
cal.getWeekDays().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();
java.util.Calendar calTime = java.util.Calendar.getInstance();

calTime.set(1,1,1,9,0,0);
Date date = calTime.getTime();
wt1.setFromTime(date);

calTime.set(1,1,1,12,0,0);
date = calTime.getTime();
wt1.setToTime(date);

WorkingTime wt2 = new WorkingTime();

calTime.set(1,1,1,13,0,0);
date = calTime.getTime();
wt2.setFromTime(date);

calTime.set(1,1,1,16,0,0);
date = calTime.getTime();
wt2.setToTime(date);

myWeekDay.getWorkingTimes().add(wt1);
myWeekDay.getWorkingTimes().add(wt2);
myWeekDay.setDayWorking(true);
cal.getWeekDays().add(myWeekDay);


//Save the Project
prj.save(dataDir + "Project.Xml", SaveFileFormat.XML);

//Display result of conversion.
System.out.println("Process completed Successfully");

Replacing a Calendar

Calendars are used to see whether resources are available, and when tasks are scheduled. There are different types of calendars. This topic looks at how to replace a base calendar, that is, the calendar used for projects and tasks, with another one.

Base calendars come in different forms:

• Standard: the default calendar has a Monday to Friday work week and a day that runs from 08:00 to 17:00.
• 24-hours: used for around the clock working, or for resources that run around the clock.
• Night shift: similar to the standard calendar, the night-shift calendar has a Monday to Saturday morning work week and a day that runs from 23:00 to 08:00.

Replacing a Calendar with a New Calendar

The Project class contains CalendarCollection that comprises of all the calendars which are part of the project. A Calendar item can be removed and a new can be added as well, thus replacing the older one.

Programming Sample

The following lines of code replace an existing calendar with a new standard calendar.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Tasks-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ReplaceCalendar.class);

Project project = new Project();
// Add a calendar to the project
Calendar cal = project.getCalendars().add("Cal 1");

Calendar newCal = new Calendar("New Cal");
CalendarCollection calColl = project.getCalendars();
for (Calendar c : calColl) {
    if (c.getName() == "Cal 1") {
        calColl.remove(c);
        calColl.add("Standard", newCal);
        break;
    }
}
// Display result of conversion.
System.out.println("Process completed Successfully");

Making a Standard Calendar

A standard calendar provides the most common work days, work hours and holidays. By default, a standard calendar is added whenever a project is created using Microsoft Project. Aspose.Tasks has features for defining a standard calendar for a project.

The Calendar class exposes the following two static (shared in Visual Basic) overloaded methods for creating a standard calendar:

• makeStandardCalendar() – Creates a new standard calendar.
• makeStandardCalendar(Calendar cal) – Makes a calendar as standard.

In Microsoft Project, open the file output by the code below and, on the Tools menu, select Change Working Times Information, to see the standard calendar.

The Change Working Times Information dialog shows the standard calendar used by the project

Programming Sample

The following lines of code create a standard calendar using both methods.

// The path to the documents directory.
String dataDir = Utils.getDataDir(MakeStandardCalendar.class);

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

//Define Calendar and make it standard
Calendar cal1 = project.getCalendars().add("My Cal");
Calendar.makeStandardCalendar(cal1);

//Save the Project
project.save(dataDir + "Project.Xml", SaveFileFormat.XML);

//Display result of conversion.
System.out.println("Process completed Successfully");

Writing Updated Calendar Data to MPP

With Aspose.Tasks for Java, you can update calendar data in a Microsoft Project MPP file and save it back. This topic shows an example of adding a calendar to the MPP file, update it and save back the changes to the MPP file.

The following code shows how to update the calendar data of a project by adding a new calendar and saving it back to the original MPP file. The steps involved in this activity are:

1. Create an instance of the Project class.
2. Read the source MPP file using the constructor.
3. Add the calendar data to the project.
4. Save the updated project data back to the MPP file.

Programming Sample

// The path to the documents directory.
String dataDir = Utils.getDataDir(UpdatedCalendarToMpp.class);

String resultFile = "OutputMPP.mpp";
String newFile = "SampleMPP.mpp";

Project project = new Project(dataDir + newFile);
Calendar cal1 = project.getCalendars().add("Calendar 1");
GetTestCalendar(cal1);

project.set(Prj.CALENDAR, cal1);

//Save the Project
project.save(dataDir + resultFile, SaveFileFormat.MPP);

//Display result of conversion.
System.out.println("Process completed Successfully");