Working with WBS Associated with Tasks

WBS (Work Breakdown Structure) codes, lets you assign outline numbers to tasks according to the needs of your business. It’s a method for applying a customized outline scheme to a project. Aspose.Tasks for C++ API supports this feature.

Working with Work Breakdown Structure

The WBS and WBSLevel properties exposed by the Tsk class are used to read and write a tasks work breakdown structure.

Microsoft Project View of WBS

To view WBS information in Microsoft Project:

1. On the Task Entry Form, select the Insert menu and then Column.
2. Add the WBS column.

Getting WBS in Aspose.Tasks

The following examples show how to get a task’s WBS value using Aspose.Tasks.

// Read project
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
System::SharedPtr<Project> project1 = System::MakeObject<Project>(dataDir + u"TaskWBS.mpp");
    
// Create a ChildTasksCollector instance
System::SharedPtr<ChildTasksCollector> collector = System::MakeObject<ChildTasksCollector>();
    
// Collect all the tasks from RootTask using TaskUtils
TaskUtils::Apply(project1->get_RootTask(), collector, 0);
    
// Parse through all the collected tasks
    
{
    auto tsk_enumerator = (collector->get_Tasks())->GetEnumerator();
    decltype(tsk_enumerator->get_Current()) tsk;
    while (tsk_enumerator->MoveNext() && (tsk = tsk_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(tsk->Get(Tsk::WBS()));
        System::Console::WriteLine(tsk->Get(Tsk::WBSLevel()));
        
        // Set custom WBS
        tsk->Set<System::String>(Tsk::WBS(), System::String(u"custom wbs") + tsk->Get(Tsk::WBS()));
    }
}

Adding WBS Code Definitions

Aspose.Tasks for C++ API allows adding WBS code definition for tasks to a project same as Microsoft Project.WBSCodeDefinition class exposes various properties that can be used to generate desired WBS codes in a project. The following code sample demonstrates setting up WBS code definitions in a project.

System::SharedPtr<Project> proj = System::MakeObject<Project>();
    
proj->set_WBSCodeDefinition(System::MakeObject<WBSCodeDefinition>());
proj->get_WBSCodeDefinition()->set_GenerateWBSCode(true);
proj->get_WBSCodeDefinition()->set_VerifyUniqueness(true);
proj->get_WBSCodeDefinition()->set_CodePrefix(u"CRS-");
    
System::SharedPtr<WBSCodeMask> mask = System::MakeObject<WBSCodeMask>();
mask->set_Length(2);
mask->set_Separator(u"-");
mask->set_Sequence(Aspose::Tasks::WBSSequence::OrderedNumbers);
proj->get_WBSCodeDefinition()->get_CodeMaskCollection()->Add(mask);
    
mask = System::MakeObject<WBSCodeMask>();
mask->set_Length(1);
mask->set_Separator(u"-");
mask->set_Sequence(Aspose::Tasks::WBSSequence::OrderedUppercaseLetters);
proj->get_WBSCodeDefinition()->get_CodeMaskCollection()->Add(mask);
    
System::SharedPtr<Task> tsk = proj->get_RootTask()->get_Children()->Add(u"Task 1");
System::SharedPtr<Task> child = tsk->get_Children()->Add(u"Task 2");
    
proj->Recalculate();
proj->Save(dataDir + u"AddWBSCodes_out.xml", Aspose::Tasks::Saving::SaveFileFormat::XML);

Renumber WBS codes

Aspose.Tasks for C++ API is able to renumber WBS codes similar to MSP’s “Renumber” function.

auto project = System::MakeObject<Project>(dataDir + u"RenumberExample.mpp");
    
auto tasks = project->get_RootTask()->SelectAllChildTasks();
    
System::Console::WriteLine(u"WBS codes before: ");
    
// output: ""; "1"; "2"; "4"
    
{
    auto task_enumerator = (tasks)->GetEnumerator();
    decltype(task_enumerator->get_Current()) task;
    while (task_enumerator->MoveNext() && (task = task_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(System::String(u"\"") + task->Get(Tsk::WBS()) + u"\"" + u"; ");
    }
}
    
// project.RenumberWBSCode(); // this overload could have used too
project->RenumberWBSCode([&]{ int32_t init_0[] = {1, 2, 3}; auto list_0 = System::MakeObject<System::Collections::Generic::List<int32_t>>(); list_0->AddInitializer(3, init_0); return list_0; }());
    
System::Console::WriteLine(u"\nWBS codes after: ");
    
// output: ""; "1"; "2"; "3"
    
{
    auto task_enumerator = (tasks)->GetEnumerator();
    decltype(task_enumerator->get_Current()) task;
    while (task_enumerator->MoveNext() && (task = task_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(System::String(u"\"") + task->Get(Tsk::WBS()) + u"\"" + u"; ");
    }
}