WBSMask Element

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The work breakdown structure (WBS) mask that is applied to all tasks in the project.

<WBSMask>
  ComplexTypeValue
</WBSMask>

Parent Elements

WBSMasks

Child Elements

Element	Required / Optional	Description
Level	Required	Number of the WBS level, beginning with 1.
Type	Required	Type of code string for first-level tasks.
Length	Required	Number of characters required for the WBS mask value, from 1-255. If there can be any number of characters, Length is zero.
Separator	Required	Character used to separate the WBS mask levels.

Occurrences

Minimum: 0 Maximum: Unbounded

Example

In the following example, there are three levels in the WBS mask and a global prefix. Level one is of type uppercase characters, level two is numbers, and level three is unordered characters of any length. The table shows the WBS value for example tasks. The user typed the WBS level 3 value; Project generated the other WBS values. Because a task was deleted and WBS codes must be unique, task T2 has the WBS value Test-AC. The WBS value of the deleted task was Test-AB.

Task	Task outline level	WBS value
T1	1	Test-AA
st1	2	Test-AA.001
st2	2	Test-AA.002
ss1	3	Test-AA.002.ThisIsATest
T2	1	Test-AC

<Project>
   . . .
   <WBSMasks>
      <VerifyUniqueCodes>4</VerifyUniqueCodes>
      <GenerateCodes>1</GenerateCodes>
      <Prefix>Test-</Prefix>
      <Masks>
         <WBSMask>
            <Level>1</Level>
            <Type>1</Type>
            <Length>2</Length>
            <Separator>.</Separator>
         </WBSMask>
      </Masks>
      <Masks>
         <WBSMask>
            <Level>2</Level>
            <Type>0</Type>
            <Length>3</Length>
            <Separator>.</Separator>
         </WBSMask>
      </Masks>
      <Masks>
         <WBSMask>
            <Level>3</Level>
            <Type>3</Type>
            <Length>0</Length>
            <Separator>.</Separator>
         </WBSMask>
      </Masks>
   </WBSMasks>
   . . .
   <Tasks>
      . . .
      <Task>
         <UID>1</UID>
         <ID>1</ID>
         <Name>T1</Name>
         <Type>1</Type>
         <IsNull>0</IsNull>
         <CreateDate>2007-11-13T13:34:00</CreateDate>
         <WBS>Test-AA</WBS>
         <WBSLevel>AA</WBSLevel>
         . . .
      </Task>
      . . .
   </Tasks>
   . . .
</Project>

See Also

Concepts

WBSMask Elements and XML Structure

XML Schema for the WBSMasks Element