Share via


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