WBS Associated with a Task

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 .NET 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.

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

// Create a ChildTasksCollector instance
ChildTasksCollector collector = new ChildTasksCollector();

// Collect all the tasks from RootTask using TaskUtils
TaskUtils.Apply(project.RootTask, collector, 0);

// Parse through all the collected tasks
foreach (Task task in collector.Tasks)
{
    Console.WriteLine(task.Get(Tsk.WBS));
    Console.WriteLine(task.Get(Tsk.WBSLevel));

    // Set custom WBS
    task.Set(Tsk.WBS, "custom wbs" + task.Get(Tsk.WBS));
}

Adding WBS Code Definitions in Aspose.Tasks

Aspose.Tasks for .NET 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.

Project proj = new Project();

proj.WBSCodeDefinition = new WBSCodeDefinition();
proj.WBSCodeDefinition.GenerateWBSCode = true;
proj.WBSCodeDefinition.VerifyUniqueness = true;
proj.WBSCodeDefinition.CodePrefix = "CRS-";

WBSCodeMask mask = new WBSCodeMask();
mask.Length = 2;
mask.Separator = "-";
mask.Sequence = WBSSequence.OrderedNumbers;
proj.WBSCodeDefinition.CodeMaskCollection.Add(mask);

mask = new WBSCodeMask();
mask.Length = 1;
mask.Separator = "-";
mask.Sequence = WBSSequence.OrderedUppercaseLetters;
proj.WBSCodeDefinition.CodeMaskCollection.Add(mask);

Task task = proj.RootTask.Children.Add("Task 1");
Task child = task.Children.Add("Task 2");

proj.Recalculate();
proj.Save("AddWBSCodes_out.xml", SaveFileFormat.XML);

Renumber WBS Codes

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

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

Console.WriteLine("WBS codes before: ");

// output: ""; "1"; "2"; "4"
foreach (Task task in project.RootTask.SelectAllChildTasks())
{
    Console.WriteLine("\"" + task.Get(Tsk.WBS) + "\"" + "; ");
}

project.RenumberWBSCode(new List<int> { 1, 2, 3 });
// project.RenumberWBSCode(); // this overload can be used instead

Console.WriteLine("WBS codes after: ");

// output: ""; "1"; "2"; "3"
foreach (Task task in project.RootTask.SelectAllChildTasks())
{
    Console.WriteLine("\"" + task.Get(Tsk.WBS) + "\"" + "; ");
}