Travailler avec WBS associé aux tâches

Les codes WBS (Work Breakdown Structure), vous permettent d’attribuer des numéros de contour aux tâches en fonction des besoins de votre entreprise. Il s’agit d’une méthode pour appliquer un schéma de contour personnalisé à un projet. Aspose.Tasks pour l’API C ++ prend en charge cette fonctionnalité.

Travailler avec la structure de panne de travail

Les propriétés WBS et WBSLevel exposées par la classe TSK sont utilisées pour lire et écrire une structure de panne de travail de tâches.

View du projet Microsoft de WBS

Pour afficher les informations WBS dans Microsoft Project:

1. Dans le formulaire d’entrée de tâche, sélectionnez le menu INSERT puis colonne.
2. Ajoutez la colonne WBS.

Obtenir WBS dans Aspose.Tasks

Les exemples suivants montrent comment obtenir la valeur WBS d’une tâche en utilisant 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"; ");
    }
}