Writing Metadata to MPP

Aspose.Tasks for C++ API provides a facility for writing metadata to MPP files for calendars, tasks, task links, resources and resource assignments.

Writing Metadata to Microsoft Project Files

The following metadata is used in this example:

• Calendar
  • CalendarName
• Task
  • Contact
  • IsMarked
  • IgnoreWarnings
• TaskLink
  • LagFormat
  • LinkLag
• Resource
  • Type
  • Initials
  • MaxUnits
  • Code
  • Group
  • EmailAddress
  • NTAccount
  • IsGeneric
  • AccrueAt
  • TeamAssignmentPool
  • CostCenter
• ResourceAssignment
  • Uid
  • Work
  • RemainingWork
  • RegularWork
  • Start
  • Finish

Here IsMarked and IgnoreWarnings are newly added fields for a task. Similarly for resources, the TeamAssignmentPool and CostCenter properties are provided.

The following steps are followed in the sample code to demonstrate how to write metadata to MPPs:

1. Open a new, blank MPP file.
2. Add working times on Monday of the project calendar and change the project calendar name.
3. Add three tasks with task links and lags.
4. Add two resources, one budget work and one budget cost resource (four in total).
5. Assign budget resources to the project root task (the project summary task).
6. Assign another two resources to the first and second tasks.
7. Set the project baseline.
8. Add a new task extended attribute.
9. Save changes as an MPP file.

System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"Project1.mpp");
        
// Add working times to project calendar
System::SharedPtr<WorkingTime> wt = System::MakeObject<WorkingTime>();
wt->set_FromTime(System::DateTime(2010, 1, 1, 19, 0, 0));
wt->set_ToTime(System::DateTime(2010, 1, 1, 20, 0, 0));
System::SharedPtr<WeekDay> day = project->Get<System::SharedPtr<Calendar>>(Prj::Calendar())->get_WeekDays()->ToList()->idx_get(1);
day->get_WorkingTimes()->Add(wt);
        
// Change calendar name
project->Get<System::SharedPtr<Calendar>>(Prj::Calendar())->set_Name(u"CHANGED NAME!");
        
// Add tasks and set task meta data
System::SharedPtr<Task> task = project->get_RootTask()->get_Children()->Add(u"Task 1");
task->Set<TimeUnitType>(Tsk::DurationFormat(), Aspose::Tasks::TimeUnitType::Day);
task->Set<Duration>(Tsk::Duration(), project->GetDuration(3));
task->Set<System::String>(Tsk::Contact(), u"Rsc 1");
task->Set<bool>(Tsk::IsMarked(), true);
task->Set<bool>(Tsk::IgnoreWarnings(), true);
System::SharedPtr<Task> task2 = project->get_RootTask()->get_Children()->Add(u"Task 2");
task2->Set<TimeUnitType>(Tsk::DurationFormat(), Aspose::Tasks::TimeUnitType::Day);
task2->Set<System::String>(Tsk::Contact(), u"Rsc 2");
        
// Link tasks
project->get_TaskLinks()->Add(task, task2, Aspose::Tasks::TaskLinkType::FinishToStart, project->GetDuration(-1, Aspose::Tasks::TimeUnitType::Day));
        
// Set project start date
project->Set(Prj::StartDate(), System::DateTime(2013, 8, 13, 9, 0, 0));
        
// Add resource and set resource meta data
System::SharedPtr<Resource> rsc1 = project->get_Resources()->Add(u"Rsc 1");
rsc1->Set<ResourceType>(Rsc::Type(), Aspose::Tasks::ResourceType::Work);
rsc1->Set<System::String>(Rsc::Initials(), u"WR");
rsc1->Set<CostAccrualType>(Rsc::AccrueAt(), Aspose::Tasks::CostAccrualType::Prorated);
rsc1->Set<double>(Rsc::MaxUnits(), 1.0);
rsc1->Set<System::String>(Rsc::Code(), u"Code 1");
rsc1->Set<System::String>(Rsc::Group(), u"Workers");
rsc1->Set<System::String>(Rsc::EMailAddress(), u"[e-mail]");
rsc1->Set<System::String>(Rsc::WindowsUserAccount(), u"user_acc1");
rsc1->Set<NullableBool>(Rsc::IsGeneric(), NullableBool(true));
rsc1->Set<CostAccrualType>(Rsc::AccrueAt(), Aspose::Tasks::CostAccrualType::End);
rsc1->Set<System::Decimal>(Rsc::StandardRate(), static_cast<System::Decimal>(10));
rsc1->Set<RateFormatType>(Rsc::StandardRateFormat(), Aspose::Tasks::RateFormatType::Day);
rsc1->Set<System::Decimal>(Rsc::OvertimeRate(), static_cast<System::Decimal>(15));
rsc1->Set<RateFormatType>(Rsc::OvertimeRateFormat(), Aspose::Tasks::RateFormatType::Hour);
        
rsc1->Set<bool>(Rsc::IsTeamAssignmentPool(), true);
rsc1->Set<System::String>(Rsc::CostCenter(), u"Cost Center 1");
        
// Create resource assignment and set resource assignment meta data
System::SharedPtr<ResourceAssignment> assn = project->get_ResourceAssignments()->Add(task, rsc1);
assn->Set<int32_t>(Asn::Uid(), 1);
assn->Set<Duration>(Asn::Work(), task->Get<Duration>(Tsk::Duration()));
assn->Set<Duration>(Asn::RemainingWork(), assn->Get<Duration>(Asn::Work()));
assn->Set<Duration>(Asn::RegularWork(), assn->Get<Duration>(Asn::Work()));
task->Set<Duration>(Tsk::Work(), assn->Get<Duration>(Asn::Work()));
        
rsc1->Set<Duration>(Rsc::Work(), task->Get<Duration>(Tsk::Work()));
assn->Set(Asn::Start(), task->Get<System::DateTime>(Tsk::Start()));
assn->Set(Asn::Finish(), task->Get<System::DateTime>(Tsk::Finish()));
        
// Add extended attribute for project and task
System::SharedPtr<ExtendedAttributeDefinition> attr = ExtendedAttributeDefinition::CreateTaskDefinition(Aspose::Tasks::CustomFieldType::Flag, Aspose::Tasks::ExtendedAttributeTask::Flag1, u"My Flag Field");
project->get_ExtendedAttributes()->Add(attr);
        
System::SharedPtr<ExtendedAttribute> taskAttr = attr->CreateExtendedAttribute();
taskAttr->set_FlagValue(true);
task2->get_ExtendedAttributes()->Add(taskAttr);
        
// Save project as MPP
project->Save(dataDir + u"WriteMetaData_out.mpp", Aspose::Tasks::Saving::SaveFileFormat::MPP);