Робота з властивостями проекту

Робота з властивостями проекту

Microsoft Project зберігає метадані та конфігурацію з кожним файлом проекту (MPP/XML).
За допомогою Aspose.Tasks for .NET ви можете зчитувати, змінювати та записувати ці властивості програмно.

Це включає:

• Загальні властивості проекту (дата початку, дата статусу, календар тощо)
• Значення за замовчуванням для завдань та призначень
• Версія проекту та підсумкова інформація
• Налаштування фінансового року та днів тижня
• Налаштування валюти
• Атрибути для нових завдань
• Вбудовані та користувацькі властивості

Загальні властивості проекту

Microsoft Project зберігає метадані, такі як дати початку/завершення, дата статусу, тип календаря, і інше.
Ви також можете визначити користувацькі властивості.

Примітка: Ви не можете встановлювати значення для **Application** і **Producer** полів. Вони автоматично встановлюються в *Aspose Ltd.* і *Aspose.Tasks for .NET x.x.x*.

Властивості

Властивість	Тип	Опис
StartDate	DateTime	дата початку проекту
FinishDate	DateTime	дата завершення проекту
CurrentDate	DateTime	поточна робоча дата
StatusDate	DateTime	дата звітування про прогрес
IsScheduleFromStart	Boolean	Чи планується від початку чи від завершення
Calendar	Calendar	призначений базовий календар

Зчитування інформації про проект

Клас Project має низку властивостей, що стосуються властивостей проекту:

• StartDate: дата початку проекту, тип даних DateTime.
• FinishDate: дата завершення проекту, тип даних DateTime.
• CurrentDate: поточна дата, тип даних DateTime.
• StatusDate: дата, на яку звітується прогрес проекту, тип даних DateTime.
• IsScheduleFromStart: визначає, чи планування виконується від початку чи від завершення і має значення Boolean.
• Calendar: тип календаря, що використовується в проекті, керується через Aspose.Tasks.Calendar class.

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

Наведені нижче приклади програмного коду показують, як зчитувати та виводити дату початку і завершення проекту, чи план проекту від початку чи від завершення, автора, останнього автора, ревізію, ключові слова та коментарі.

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

// Display project information
if (project.Get(Prj.ScheduleFromStart))
    Console.WriteLine("Project Finish Date : " + project.Get(Prj.StartDate).ToShortDateString());
else
    Console.WriteLine("Project Finish Date : " + project.Get(Prj.FinishDate).ToShortDateString());
Console.WriteLine(project.Get(Prj.Author));
Console.WriteLine(project.Get(Prj.LastAuthor));
Console.WriteLine(project.Get(Prj.Revision));
Console.WriteLine(project.Get(Prj.Keywords));
Console.WriteLine(project.Get(Prj.Comments));
Console.WriteLine("The program has run successfully");

Запис інформації про проект

Aspose.Tasks for .NET може не лише зчитувати, а й записувати інформацію про проект. Наведені приклади коду показують, як встановити автора, останнього автора, ревізію, ключові слова та коментарі.

// Create project from template file
Project project = new Project("New Project.mpp");
// Set project information
project.Set(Prj.Author, "Author");
project.Set(Prj.LastAuthor, "Last Author");
project.Set(Prj.Revision, 15);
project.Set(Prj.Keywords, "MSP Aspose");
project.Set(Prj.Comments, "Comments");
project.Save("WriteProjectInfo_out.mpp", SaveFileFormat.MPP);

Визначення версії проекту

Aspose.Tasks for .NET API надає можливість отримувати інформацію про файл проекту за допомогою простих викликів API. Project класу Get метод дозволяє користувачам отримувати інформацію, пов’язану з Project, використовуючи статичний клас Prj. Клас Prj надає низку властивостей, пов’язаних з Project. У цій темі показано, як отримати інформацію про версію.

Властивості SaveVersion і LastSaved, що надаються класом Prj, використовуються для визначення версії проекту та дати, коли проект було останнього разу збережено. SaveVersion підтримує тип даних Integer, тоді як LastSaved — тип даних DateTime.

Використовуйте Prj.SaveVersion та Prj.LastSaved властивості для отримання версії формату файлу проекту і дату останнього збереження.

Властивість	Тип	Опис
SaveVersion	int	версія файлу проекту
LastSaved	DateTime	дата останнього збереження

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

// Display project version
Console.WriteLine("Project Version : " + project.Get(Prj.SaveVersion).ToString());
Console.WriteLine("Last Saved : " + project.Get(Prj.LastSaved).ToShortDateString());

Властивості проекту за замовчуванням

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

Клас Prj надає низку властивостей для керування властивостями проекту за замовчуванням:

Властивість	Тип	Опис
DefaultStartTime	DateTime	Час початку за замовчуванням для завдань
DefaultFinishTime	DateTime	Час завершення за замовчуванням для завдань
DefaultFixedCostAccrual	CostAccrualType	Нарахування фіксованої вартості за замовчуванням
DefaultStandardRate	double	Стандартна ставка оплати за замовчуванням
DefaultOvertimeRate	double	Ставка оплати за надгодини за замовчуванням
DefaultTaskEVMethod	EarnedValueMethodType	Розрахунок приросту вартості
DefaultTaskType	TaskType	Тип нових завдань за замовчуванням

//

• DefaultStartTime: час початку за замовчуванням для нового завдання, приймає значення типу DateTime.
• DefaultFinishTime: час завершення за замовчуванням для нового завдання, приймає значення типу DateTime.
• DefaultFixedCostAccrual: нарахування фіксованої вартості за замовчуванням для призначення, приймає одне зі значень, визначених у CostAccrualType enumeration.
• DefaultStandardRate: стандартна ставка оплати за замовчуванням, приймає значення типу double.
• DefaultOvertimeRate: ставка оплати за надгодини за замовчуванням, приймає значення типу double.
• DefaultTaskEVMethod: метод розрахунку вартості завдання за замовчуванням, приймає одне зі значень, визначених у EarnedValueMethodType enumeration.
• DefaultTaskType: тип завдання за замовчуванням у проекті, приймає одне зі значень, визначених у TaskType enumeration. //

Щоб переглянути інформацію про проект за замовчуванням у Microsoft Project:

1. Відкрийте проект.
2. У Tools меню, натисніть Options.
3. Перейдіть на вкладку General . Тут ви можете побачити параметри стандартних ставок та ставок за надгодини за замовчуванням.
4. Перейдіть на вкладку Schedule . Тут ви можете побачити параметри типу завдання за замовчуванням та часу початку завдання за замовчуванням.

Інформація про проект за замовчуванням у Microsoft Project, записана Aspose.Tasks

Зчитування властивостей за замовчуванням

Наступний приклад зчитує властивості проекту за замовчуванням і виводить їх у вікно консолі.

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

// Display default properties
Console.WriteLine("New Task Default Start: " + project.Get(Prj.DefaultStartTime).ToShortDateString());
Console.WriteLine("New Task Default Type: " + project.Get(Prj.DefaultTaskType));
Console.WriteLine("Resource Default Standard Rate: " + project.Get(Prj.DefaultStandardRate).ToString());
Console.WriteLine("Resource Default Overtime Rate: " + project.Get(Prj.DefaultOvertimeRate).ToString());
Console.WriteLine("Default Task EV Method: " + project.Get(Prj.DefaultTaskEVMethod).ToString());
Console.WriteLine("Default Cost Accrual: " + project.Get(Prj.DefaultFixedCostAccrual).ToString());

Запис властивостей за замовчуванням

Наступні рядки коду встановлюють властивості проекту за замовчуванням.

// Create a project instance and Set default properties
Project project = new Project();
project.Set(Prj.ScheduleFromStart, true);
project.Set(Prj.StartDate, DateTime.Now);
project.Set(Prj.DefaultStartTime, project.Get(Prj.StartDate));
project.Set(Prj.DefaultTaskType, TaskType.FixedDuration);
project.Set(Prj.DefaultStandardRate, 15);
project.Set(Prj.DefaultOvertimeRate, 12);
project.Set(Prj.DefaultTaskEVMethod, EarnedValueMethodType.PercentComplete);
project.Set(Prj.DefaultFixedCostAccrual, CostAccrualType.Prorated);
project.Save("WriteDefaultProperties_out.xml", SaveFileFormat.XML);

Запис підсумкової інформації про проект

Більшість програм зберігають підсумкову інформацію разом із файлами. Microsoft Project не є винятком. Окрім імені автора, дати створення проекту та останнього редагування і збереження, воно зберігає ключові слова, тему, коментарі тощо. Aspose.Tasks for .NET дозволяє як зчитувати, так і записувати такий тип інформації.

Клас Project Set метод можна використовувати для запису, а Get метод можна використовувати для зчитування підсумкової інформації Project за допомогою членів Prj класу. Файл можна зберегти після оновлення підсумкової інформації. Щоб оновити підсумкову інформацію проекту в існуючому MPP-файлі:

1. Створіть екземпляр Project class
2. Встановіть різні властивості, які надає Prj class для визначення підсумкової інформації.
3. Збережіть Project за допомогою методу Save класу Project class

Щоб переглянути підсумкову інформацію файлу:

1. Знайдіть файл у файловому провіднику.
2. Клацніть правою кнопкою миші по файлу та виберіть Properties.
3. Перейдіть на вкладку Details .

Наведений приклад коду записує підсумкову інформацію проекту у MPP-файл.

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

// Set project summary
project.Set(Prj.Author, "Author");
project.Set(Prj.LastAuthor, "Last Author");
project.Set(Prj.Revision, 15);
project.Set(Prj.Keywords, "MSP Aspose");
project.Set(Prj.Comments, "Comments");
project.Save("WriteMPPProjectSummary_out.mpp", SaveFileFormat.MPP);

Властивості фінансового року

Фінансовий рік збігається з бюджетним роком. Це період, протягом якого країна, організація або особа розраховують бюджети та податки. Microsoft Project дозволяє користувачам визначати фінансовий рік для проектів. Aspose.Tasks for .NET підтримує цю функціональність за допомогою властивостей, що дозволяють розробникам як зчитувати властивості фінансового року з існуючих проектів, так і встановлювати властивості фінансового року під час створення або роботи з проектами.

Клас Prj надає FyStartDate і FiscalYearStart для керування фінансовим роком проекту:

• FyStartDate: визначає місяць початку фінансового року і приймає одне зі значень, визначених у перерахуванні Month.
• FiscalYearStart: визначає, чи використовується нумерація фінансових років у проекті. Boolean.

Зчитування властивостей фінансового року

Властивості FyStartDate і FiscalYearStart полегшують визначення дати початку поточного фінансового року та того, чи використовується нумерація фінансового року у Aspose.Tasks.

Наступний код зчитує властивості фінансового року проекту і відображає їх у вікні консолі.

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

// Display fiscal year properties
Console.WriteLine("Fiscal Year Start Date : " + project.Get(Prj.FyStartDate).ToString());
Console.WriteLine("Fiscal Year Numbering : " + project.Get(Prj.FiscalYearStart).ToString());

Запис властивостей фінансового року

Щоб переглянути властивості фінансового року в Microsoft Project:

1. Відкрийте файл проекту.
2. У Tools меню, натисніть Options.
3. Клацніть на вкладку Calendar . Вона виглядатиме як показано нижче.

Перевірка, чи властивості фінансового року встановлено в Microsoft Project.

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

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

// Set fiscal year properties
project.Set(Prj.FyStartDate, Month.July);
project.Set(Prj.FiscalYearStart, true);
project.Save("WriteFiscalYearProperties_out.mpp", SaveFileFormat.MPP);

Властивості днів тижня

Microsoft Project дозволяє користувачам налаштовувати низку властивостей днів тижня. Наприклад, який день вважається початком тижня і скільки робочих днів у місяці. Aspose.Tasks підтримує ці можливості через низку властивостей, які можна як зчитувати властивості днів тижня так і записувати їх у проект.

Aspose.Tasks має ряд властивостей, наданих Project класом, призначених спеціально для керування властивостями днів тижня проекту:

• WeekStartDay: перший день тижня. Це властивість приймає значення, визначені у DayType enumeration.
• DaysPerMonth: кількість робочих днів у місяці, задається як ціле число.
• MinutesPerDay: кількість робочих хвилин у робочому дні, задається як ціле число.
• MinutesPerWeek: кількість робочих хвилин у робочому тижні, задається як ціле число.

Зчитування властивостей днів тижня

Наступний код зчитує властивості днів тижня проекту і виводить їх у вікно консолі.

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

// Display week days properties
Console.WriteLine("Week Start Date : " + project.Get(Prj.WeekStartDay).ToString());
Console.WriteLine("Days Per Month : " + project.Get(Prj.DaysPerMonth).ToString());
Console.WriteLine("Minutes Per Day : " + project.Get(Prj.MinutesPerDay).ToString());
Console.WriteLine("Minutes Per Week : " + project.Get(Prj.MinutesPerWeek).ToString());

Запис властивостей днів тижня

Щоб переглянути властивості днів тижня в Microsoft Project:

1. Відкрийте файл.
2. У Tools меню, натисніть Options.
3. Виберіть вкладку Calendar . Вона виглядатиме приблизно як на прикладі нижче.

Перегляд властивостей днів тижня в Microsoft Project

Наведений код записує властивості днів тижня до проекту, як показано на скріншоті вище.

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

// Set week days properties
project.Set(Prj.WeekStartDay, DayType.Monday);
project.Set(Prj.DaysPerMonth, 24);
project.Set(Prj.MinutesPerDay, 540);
project.Set(Prj.MinutesPerWeek, 3240);
project.Save("WriteWeekdayProperties_out.xml", SaveFileFormat.XML);

Властивості валюти

Microsoft Project дозволяє користувачам вибирати, в якій валюті відображаються витрати у проекті. Вони можуть задати код валюти, кількість знаків після десяткової коми та символ валюти, щоб витрати відображалися зрозуміло й інтуїтивно. Aspose.Tasks for .NET підтримує ці функції та надає ряд властивостей, що допомагають розробникам задавати та контролювати налаштування валюти. Ця тема пояснює, як зчитувати властивості валюти, та як їх встановлювати.

Aspose.Tasks for .NET надає властивості класу Prj для керування властивостями валюти:

• CurrencyCode: трьохбуквенний код валюти, наприклад USD, GBP або AUD, задається як рядок.
• CurrencyDigits: кількість знаків після десяткової крапки, наприклад, 2 (100.00) або 3 (100.000), задається як ціле число.
• CurrencySymbol: символ валюти, наприклад $ або £, задається як рядок.
• CurrencySymbolPosition: позиція символу валюти, наприклад перед числом ($100) або після (100$). CurrencySymbolPosition приймає значення з CurrencySymbolPositionType enumeration.

Зчитування властивостей валюти

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

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

// Display currency properties
Console.WriteLine("Currency Code : " + project.Get(Prj.CurrencyCode).ToString());
Console.WriteLine("<br>Currency Digits : " + project.Get(Prj.CurrencyDigits).ToString());
Console.WriteLine("<br>Currency Symbol : " + project.Get(Prj.CurrencySymbol).ToString());
Console.WriteLine("Currency Symbol Position" + project.Get(Prj.CurrencySymbolPosition).ToString());

Запис властивостей валюти

Щоб переглянути властивості валюти в Microsoft Project:

1. Відкрийте файл проекту.
2. У Tools меню, оберіть Options.
3. Клацніть вкладку View . Вона виглядатиме як показано нижче.

Зчитування властивостей валюти в Microsoft Project

Наведений приклад записує властивості валюти у проект.

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

// Set currency properties
project.Set(Prj.CurrencyCode, "AUD");
project.Set(Prj.CurrencyDigits, 2);
project.Set(Prj.CurrencySymbol, "$");
project.Set(Prj.CurrencySymbolPosition, CurrencySymbolPositionType.After);

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

Встановлення атрибутів для нових завдань

Microsoft Project дозволяє встановлювати властивості за замовчуванням для нових завдань. Ця тема пояснює, як задати дату початку за замовчуванням для нових завдань за допомогою Aspose.Tasks for .NET API.

Клас Prj надає властивість NewTaskStartDate , яка визначає дату початку для нового завдання. Ця властивість підтримує значення, визначені у TaskStartDateType переліку.

Щоб переглянути атрибути завдання:

1. Відкрийте файл у Microsoft Project.
2. У Tools меню, оберіть Options.
3. Виберіть вкладку Schedule . Вкладка виглядає як показано нижче.

Нові завдання починаються з поточної дати

Наступні рядки коду встановлюють дату початку для нового завдання.

// Create a project instance Set new task property and Save the project as XML project file
Project project = new Project();
project.Set(Prj.NewTaskStartDate, TaskStartDateType.CurrentDate);
project.Save("SetAttributesForNewTasks_out.xml", SaveFileFormat.XML);
 
// Display Status.
Console.WriteLine("New Task created with start date successfully.");

Зчитування користувацьких та вбудованих властивостей

В Aspose.Tasks for .NET користувацькі властивості доступні через типізовану колекцію, тоді як вбудовані властивості доступні безпосередньо.

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

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

// custom properties are available through the typed collection
foreach (var property in project.CustomProps)
{
    Console.WriteLine(property.Type);
    Console.WriteLine(property.Name);
    Console.WriteLine(property.Value);
}

// built-in properties are available directly
Console.WriteLine(project.BuiltInProps.Author);
Console.WriteLine(project.BuiltInProps.Title);


// or as an item of built-in property collection
foreach (var property in project.BuiltInProps)
{
    Console.WriteLine(property.Name);
    Console.WriteLine(property.Value);
}