Написання метаданих до MPP

Aspose.tasks для .net надає можливість запису метаданих у файли Microsoft Project (MPP). Сюди входять властивості, пов’язані з календарями, завданнями, посиланнями на завдання, ресурсами та завданнями ресурсів. Такі метадані можуть бути важливими для інтеграції, перевірки або відстеження проектів.

Цей приклад демонструє, як записати різні типи метаданих у файл MPP за допомогою ASPOPE.TASKS API. Він охоплює загальні поля, такі як контактна інформація про завдання, деталі розподілу ресурсів, налаштування календаря та власні атрибути.

Метадані, що використовуються в прикладі

Застосовуються такі поля метаданих:

• Календар
  • CalendarName
• Завзяти
  • Contact
  • IsMarked
  • IgnoreWarnings
• Завзяття
  • LagFormat
  • LinkLag
• Ресурс
  • Type
  • Initials
  • MaxUnits
  • Code
  • Group
  • EmailAddress
  • NTAccount
  • IsGeneric
  • AccrueAt
  • TeamAssignmentPool
  • CostCenter
• Resourceassignment
  • Uid
  • Work
  • RemainingWork
  • RegularWork
  • Start
  • Finish

Тут є позначкою, а ігнорування - це нещодавно додані поля для завдання. Аналогічно для ресурсів надається командна нерухомість та властивості костюмів.

Наступні кроки виконуються у зразковому коді, щоб продемонструвати, як записати метадані у файли MPP:

1. Відкрийте новий, порожній файл MPP.
2. Додайте робочий час у понеділок до календаря проекту та змініть назву календаря проекту.
3. Додайте три завдання з посиланнями та відставаннями.
4. Додайте два ресурси, один бюджетний роботу та один ресурс витрат на бюджет (загалом чотири).
5. Призначити бюджетні ресурси для кореневого завдання проекту (завдання підсумків проекту).
6. Призначте ще два ресурси до перших та другого завдання.
7. Встановіть базову лінію проекту.
8. Додайте новий розширений атрибут.
9. Зберегти зміни як файл MPP.

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

// Add working times to project calendar
WorkingTime wt = new WorkingTime();
wt.FromTime = new DateTime(2010, 1, 1, 19, 0, 0);
wt.ToTime = new DateTime(2010, 1, 1, 20, 0, 0);
WeekDay day = project.Get(Prj.Calendar).WeekDays.ToList()[1];
day.WorkingTimes.Add(wt);

// Change calendar name
project.Get(Prj.Calendar).Name = "CHANGED NAME!";

// Add tasks and set task meta data
Task task = project.RootTask.Children.Add("Task 1");
task.Set(Tsk.DurationFormat, TimeUnitType.Day);
task.Set(Tsk.Duration, project.GetDuration(3));
task.Set(Tsk.Contact, "Rsc 1");
task.Set(Tsk.IsMarked, true);
task.Set(Tsk.IgnoreWarnings, true);
Task task2 = project.RootTask.Children.Add("Task 2");
task2.Set(Tsk.DurationFormat, TimeUnitType.Day);
task2.Set(Tsk.Contact, "Rsc 2");

// Link tasks
project.TaskLinks.Add(task, task2, TaskLinkType.FinishToStart, project.GetDuration(-1, TimeUnitType.Day));

// Set project start date
project.Set(Prj.StartDate, new DateTime(2013, 8, 13, 9, 0, 0));

// Add resource and set resource meta data
Resource resource = project.Resources.Add("Rsc 1");
resource.Set(Rsc.Type, ResourceType.Work);
resource.Set(Rsc.Initials, "WR");
resource.Set(Rsc.AccrueAt, CostAccrualType.Prorated);
resource.Set(Rsc.MaxUnits, 1);
resource.Set(Rsc.Code, "Code 1");
resource.Set(Rsc.Group, "Workers");
resource.Set(Rsc.EMailAddress, "[e-mail]");
resource.Set(Rsc.WindowsUserAccount, "user_acc1");
resource.Set(Rsc.IsGeneric, new NullableBool(true));
resource.Set(Rsc.AccrueAt, CostAccrualType.End);
resource.Set(Rsc.StandardRate, 10);
resource.Set(Rsc.StandardRateFormat, RateFormatType.Day);
resource.Set(Rsc.OvertimeRate, 15);
resource.Set(Rsc.OvertimeRateFormat, RateFormatType.Hour);
resource.Set(Rsc.IsTeamAssignmentPool, true);
resource.Set(Rsc.CostCenter, "Cost Center 1");

// Create resource assignment and set resource assignment meta data
ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);
assignment.Set(Asn.Uid, 1);
assignment.Set(Asn.Work, task.Get(Tsk.Duration));
assignment.Set(Asn.RemainingWork, assignment.Get(Asn.Work));
assignment.Set(Asn.RegularWork, assignment.Get(Asn.Work));
task.Set(Tsk.Work, assignment.Get(Asn.Work));

resource.Set(Rsc.Work, task.Get(Tsk.Work));
assignment.Set(Asn.Start, task.Get(Tsk.Start));
assignment.Set(Asn.Finish, task.Get(Tsk.Finish));

// Add extended attribute for project and task
ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Flag, ExtendedAttributeTask.Flag1,  "My Flag Field");
project.ExtendedAttributes.Add(attr);

ExtendedAttribute taskAttr = attr.CreateExtendedAttribute();
taskAttr.FlagValue = true;
task2.ExtendedAttributes.Add(taskAttr);

project.Save("WriteMetaData_out.mpp", SaveFileFormat.MPP);

Summary

Writing metadata to an MPP file involves setting structured fields for various project elements. Aspose.Tasks for .NET allows direct access to these fields using the object model. This approach enables integration with other systems and prepares MPP files for detailed reporting or validation.