Gebiedspaden definiëren en toewijzen aan een team

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Voeg gebiedspaden toe om teams te organiseren en werkitems te groeperen op product, functie of bedrijfsgebieden. Als u gebiedspaden toewijst aan teams, zorgt u ervoor dat werkitems onder deze paden worden weergegeven in de achterstanden en borden van het desbetreffende team. Standaard worden alle werkitems toegewezen aan het hoofdgebiedpad en worden ze weergegeven in het standaardteam van het project.

Nadat u gebiedspaden op projectniveau hebt gedefinieerd, wijst u deze toe aan teams binnen de teamconfiguratie. U kunt ook een hiërarchische structuur van vlakpaden maken om subgebieden te ondersteunen, met maximaal 14 niveaus diep.

Als u de volgende taken wilt uitvoeren, moet u gebiedspaden definiëren:

• Werkitems voor query's en grafieken op basis van vlakpad
• Werk toewijzen aan meer dan één team
• Werken met beheer- en functieteams
• Een achterstand, query, bord of plan filteren met behulp van vlakpaden

Tip

U kunt de structuur van het gebiedspad definiëren en gebiedspaden toewijzen aan teams. U kunt ook een team toevoegen en het gebiedspad maken met de teamnaam op dat moment. Als teams volledig onafhankelijk zijn, maakt u een platte set gebiedspaden. Als u echter een hiërarchie van teams wilt maken, moet u een structuurhiërarchie van gebiedspaden maken. Zie Een hiërarchie van teams configureren voor meer informatie.

Als u de volgende hulpprogramma's wilt gebruiken, moeten teams zich abonneren op gebiedspaden:

• Borden> alle hulpprogramma's
• Backlogs alle hulpprogramma's>
• Sprints alle hulpprogramma's>
• Leveringsplannen
• Samenvouwen
• Alles analyseren>

Als u wilt weten hoe het systeem gebiedspaden gebruikt, raadpleegt u Over gebieds- en iteratiepaden.

Vereisten

Machtigingen:

• Als u teamgebiedpaden wilt instellen, moet u een teambeheerder of lid zijn van de groep Projectbeheerders . De gebruiker die het project heeft gemaakt, heeft standaard deze machtigingen.
• Als u een gebiedspad wilt toevoegen onder het hoofdknooppunt of een onderliggend knooppunt wilt bewerken of verwijderen, moet u lid zijn van de groep Projectbeheerders .
• Als u gebiedspaden onder een knooppunt wilt toevoegen, bewerken en beheren, moet u een of meer van de volgende machtigingen instellen op Toestaan:
  • Onderliggende knooppunten maken
  • Dit knooppunt verwijderen
  • Dit knooppunt bewerken
  • Machtigingen in dit knooppunt weergeven

Zie Machtigingen en toegang instellen voor het bijhouden van werk voor meer informatie.

Zie Over gebieden en iteraties, naamgevingsbeperkingen, voor naamgevingsbeperkingen voor naamgevingsbeperkingen voor gebiedspaden.

Aan de slag

Elk team heeft toegang tot verschillende Agile-hulpprogramma's, zoals beschreven in Over teams en Agile-hulpprogramma's. Deze hulpprogramma's verwijzen naar de standaardgebiedpaden van het team. De meeste teams gebruiken één gebiedspad en verschillende iteratiepaden voor het bijhouden van werk, maar teams kunnen ook meerdere vlakpaden gebruiken op hun achterstand en borden om verschillende scenario's te ondersteunen.

Nieuwe projecten bevatten één hoofdgebied dat overeenkomt met de projectnaam en een standaardteam met dezelfde naam die is toegewezen aan dit hoofdgebiedpad.

Als u geen toegang hebt tot projecten en teams, volgt u deze stappen om uw project en teams te configureren:

1. Gebiedspaden definiëren: bepaal het aantal en de namen van gebiedspaden die nodig zijn om uw werk te categoriseren. Voeg ten minste één gebiedspad per team toe. Zie Over gebieden en iteraties voor meer informatie.
2. Teams definiëren: bepaal het aantal en de namen van de vereiste teams. Zie Over teams en Agile-hulpprogramma's voor meer informatie.
3. Gebiedspaden configureren: Ga naar Projectinstellingen>Projectconfiguratiegebieden> en definieer de gebiedspaden voor uw project. Volg de stappen in Gebiedspaden toevoegen.
4. Teams maken: Maak de benodigde teams op basis van stap 2. Zie Een team toevoegen, van één standaardteam naar meerdere teams gaan voor meer informatie.
5. Gebiedspaden toewijzen aan teams: Wijs in de teamconfiguratie de standaard- en andere gebiedspaden toe aan elk team. Voer de stappen uit in de standaardgebiedpaden van het team instellen.
6. Gebiedspaden toewijzen aan werkitems: Wijs werkitems toe aan de gedefinieerde vlakpaden met behulp van bulksgewijs wijzigen om meerdere items tegelijk bij te werken.

Notitie

Als u hetzelfde gebiedspad aan meerdere teams toewijst, kan dit conflicten veroorzaken ten opzichte van het eigendom van werkitems. Zie Beperkingen van weergaven voor meerdere teams voor meer informatie.

Indien nodig kunt u de volgende acties op elk gewenst moment uitvoeren:

• Andere onderliggende knooppunten toevoegen
• De naam van een gebiedspad wijzigen (behalve het pad naar het hoofdgebied)
• Een onderliggend knooppunt onder een ander knooppunt verplaatsen
• Een onderliggend knooppunt verwijderen
• De naam van een team wijzigen
• De toewijzingen van het gebiedspad wijzigen in een team

Projectgebieden weergeven

Ga als volgt te werk om projectgebieden weer te geven:

Browser

Selecteer in uw webportal (1) Projectinstellingen> (2) Projectconfiguratie> (3) Gebieden.

Azure DevOps CLI

Een lijst met projectgebiedpaden Toevoegen van een projectgebiedpad | Lijst teamgebiedenpaden | Stel teamgebiedpaden | De naam van een projectgebiedpad | wijzigen of een pad naar het projectgebied verwijderen uit een team verplaatsen |

U kunt de gebiedspaden weergeven die zijn gedefinieerd voor een project met behulp van az boards area project list. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards area project list [--depth]
                            [--path]
                            [--project]

Parameters

• diepte: optioneel. Diepte van onderliggende knooppunten die moeten worden weergegeven. Voorbeeld: --depth 3. Wanneer dit niet is opgegeven, worden alleen de gebiedspaden op het hoogste niveau geretourneerd.
• pad: Optioneel. Absoluut pad van een gebied. \Area\ moet volgen na de \ProjectName, die dit pad onderscheidt van een iteratiepad. Bijvoorbeeld: --path \ProjectName\Area\AreaName. Als er spaties in een knooppunt worden gebruikt, plaatst u deze tussen dubbele aanhalingstekens, bijvoorbeeld --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Wanneer dit niet is opgegeven, worden gebiedspaden van het hoofdniveau weergegeven.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Opmerking

Met de volgende opdracht worden bijvoorbeeld de gebiedspaden weergegeven tot een diepte van 3 voor het Fabrikam Fiber-project. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor andere opties voor uitvoerindelingen.

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Een gebiedspad toevoegen

Er wordt standaard slechts één hoofdgebied gedefinieerd. Voeg nieuwe en onderliggende gebiedspaden toe onder het hoofdgebiedpad voor het project of als onderliggend element aan een ander gebiedspad of team. Nieuwe gebiedspaden worden standaard toegevoegd aan het hoofdknooppunt.

U kunt ook nieuwe en onderliggende gebiedspaden toevoegen aan een team. Zie Teamgebiedpaden instellen voor meer informatie.

Browser

Ga als volgt te werk om een nieuw gebiedspad toe te voegen:

1. Markeer het gebiedspad en kies vervolgens Nieuw onderliggend item. U kunt desgewenst een gebiedspad selecteren en Nieuw kiezen of het menu-item Nieuw boven aan de gebiedslijst selecteren.

2. Voer een naam (255 tekens of minder) in voor het knooppunt. Zie Informatie over gebieden en iteraties, naamgevingsbeperkingen voor meer naambeperkingen.

   

3. Opslaan en sluiten selecteren

Alle nieuwe gebieden worden toegevoegd als een onderliggend knooppunt aan het hoofdgebiedpad.

Ga als volgt te werk om een pad naar een onderliggend gebied toe te voegen:

1. Markeer het gebiedspad en kies vervolgens Nieuw onderliggend item. U kunt desgewenst het gebiedspad selecteren en Nieuw onderliggend item kiezen of Nieuw onderliggend item selecteren in het menu bovenaan de lijst met gebieden.

2. Voer een naam (255 tekens of minder) in voor het knooppunt. Zie Informatie over gebieden en iteraties, naamgevingsbeperkingen voor meer naambeperkingen.

   

3. Opslaan en sluiten selecteren

U kunt ook gebiedspaden toevoegen aan een team op de pagina Teamconfiguratiegebieden>.

Azure DevOps CLI

U kunt gebiedspaden toevoegen aan een project met behulp van az boards area project create. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

Als u de --path parameter opgeeft, wordt het nieuwe gebiedspad toegevoegd als een onderliggend knooppunt aan het opgegeven pad. Als u de --path parameter niet opgeeft, wordt het nieuwe gebiedspad toegevoegd als een onderliggend knooppunt aan het hoofdknooppunt.

az boards area project create --name
                              [--path]
                              [--project]

Parameters

• name: vereist. Naam van gebiedspad.
• pad: Optioneel. Absoluut pad van een gebied. Voorbeeld: --path \ProjectName\Area\AreaName. Wanneer dit niet is opgegeven, voegt u een gebied toe op het hoofdniveau.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Voorbeeld: JSON-indeling

Met de volgende opdracht wordt bijvoorbeeld het pad naar het Spraakgebied toegevoegd aan het Fabrikam Fiber-project op het hoofdknooppunt.

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

Voorbeeld: Tabelindeling

En hier ziet u dezelfde opdracht met de tabeluitvoerindeling.

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Teamgebiedpaden weergeven

U stelt de standaardinstellingen van het team in op basis van teaminstellingen. Als u geen teambeheerder bent, wordt u toegevoegd als een teambeheerder. Alleen team- of projectbeheerders kunnen de teaminstellingen wijzigen.

Browser

1. Open uw project en selecteer vervolgens Projectinstellingen>Teamconfiguratiegebieden.>

   

2. Als u de teamcontext wilt wijzigen, gebruikt u de teamkiezer in de breadcrumbs.

   

Azure DevOps CLI

U kunt de gebiedspaden weergeven die voor een team zijn gedefinieerd met behulp van az boards area team list. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards area team list --team
                         [--project] 

Parameters

• team: vereist. Naam of id van het team.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Met de volgende opdracht worden bijvoorbeeld de gebiedspaden voor het serviceleveringsteam weergegeven. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor andere opties voor uitvoerindelingen

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Teaminstellingen openen vanuit het teamprofiel

U definieert beide gebieden en iteraties van de configuratie van het projectinstellingenteam>. U kunt er snel naartoe navigeren vanuit een teamwerkachterstand, bord of dashboard.

1. Open een achterstand of bord voor een team en kies Teamprofiel> Teaminstellingen.

   Hier openen we het bord voor het Fabrikam Fiber-team en van daaruit het teamprofiel.

   

2. Kies Iteraties en gebieden.

   

3. Als u de teamcontext wilt wijzigen, gebruikt u de teamkiezer in de breadcrumbs.

   

Teamgebiedpaden instellen

Alle werkitems die zijn toegewezen aan een teamgebiedpad, worden weergegeven in de achterstanden en borden voor dat team. U kunt een of meer gebiedspaden selecteren en eventueel hun subgebiedpaden opnemen. Kies ervoor om subgebiedpaden op te nemen wanneer u samengetelde weergaven van werk wilt ondersteunen die in verschillende teams of gebieden worden uitgevoerd.

Notitie

Teams kunnen maximaal 300 gebiedspaden worden toegewezen. Zie Werktracking, proces- en projectlimieten voor meer informatie.

Het standaardgebiedpad bepaalt het standaardgebiedpad dat is toegewezen aan werkitems die zijn gemaakt op basis van de teamcontext.

Belangrijk

Werkitems die worden weergegeven op het bord van meer dan één team, kunnen queryresultaten opleveren die niet aan uw verwachtingen voldoen. Omdat elk team de bordkolommen en zwembanen kan aanpassen, zijn de waarden die zijn toegewezen aan werkitems die op verschillende borden worden weergegeven, mogelijk niet hetzelfde. De belangrijkste oplossing voor dit probleem is het behouden van één eigendom van werkitems per teamgebiedpad.

Browser

U kunt bestaande gebiedspaden selecteren of nieuwe of onderliggende gebiedspaden maken vanuit de teaminstellingen.

1. Selecteer Projectinstellingen>Teamconfiguratiegebieden>.

2. Selecteer het team dat u wilt configureren in de vervolgkeuzelijst boven aan de pagina.

   Hier laten we de gebieden voor het Fabrikam Fiber-team zien.

   

3. Kies een of meer gebiedspaden om actief te zijn voor het team.

   

   In dit geval kiezen we ervoor om de subgebiedpaden voor het project te activeren. Het managementteam kan nu de voortgang bijhouden voor alle teams.

   

4. Wanneer u klaar bent, vernieuwt u de pagina met productachterstanden voor het team en ziet u de werkitems die aan het team zijn toegewezen. Voeg het gebiedspad toe aan de kolommen die worden weergegeven om de toewijzingen aan werkitems weer te geven.

   

   

Azure DevOps CLI

U kunt het standaardgebiedpad voor een team instellen of een gebiedspad toevoegen met behulp van az boards area team add. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

Parameters

• pad: vereist. Absoluut pad van een gebied. Voorbeeld: --path \ProjectName\AreaName.
• team: vereist. Naam of id van het team.
• include-sub-areas: Optional. Onderliggende knooppunten van het gebiedspad opnemen. Geaccepteerde waarden: onwaar, waar.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".
• set-as-default: Optioneel. Geef op als het standaardgebiedpad voor het team. Standaard: Onwaar.

Opmerking

Met de volgende opdracht wordt bijvoorbeeld het pad naar het spraakgebied toegevoegd aan het Voice-team voor het Fabrikam Fiber-project, wordt dit ingesteld als de standaardinstelling en worden subgebieden opgenomen.

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

De naam van een gebiedspad wijzigen of verplaatsen

Het systeem werkt werkitems en query's die verwijzen naar het bijgewerkte gebiedspad automatisch bij. Elk gebiedspad is gekoppeld aan een unieke GUID.

Browser

1. Als u de naam van een gebiedspad wilt wijzigen, opent u de pagina Projectinstellingen projectconfiguratiegebieden>> in de webportal.

2. Kies het contextmenu voor het knooppunt en selecteer Bewerken.

   

3. Voer in het dialoogvenster dat wordt geopend de nieuwe naam in.

   

4. Als u het knooppunt in de hiërarchie wilt verplaatsen, wijzigt u het veld Locatie .

   Notitie

   Wanneer u de naam van het veld Locatie voor een knooppunt wijzigt, worden de bestaande werkitems die verwijzen naar het gebiedspad, automatisch bijgewerkt.

Azure DevOps CLI

De naam van een gebiedspad wijzigen of verplaatsen vanuit een project

U kunt de naam van een gebiedspad voor een project wijzigen of verplaatsen met behulp van az boards area project update de opdracht. Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

• pad: vereist. Absoluut pad van een gebied. Voorbeeld: --path \ProjectName\AreaName.
• onderliggende id: optioneel. Hiermee verplaatst u een bestaand gebiedspad en voegt u dit toe als een onderliggend knooppunt voor de opgegeven padnaam of id.
• name: Optioneel. Hiermee geeft u de nieuwe naam van het gebiedspad.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Opmerking

Met de volgende opdracht wijzigt u bijvoorbeeld de naam van het pad van het spraakgebied in Voice en Web voor het Fabrikam Fiber-project.

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

Een gebiedspad uit een team verwijderen

Als u een gebiedspad uit een team wilt verwijderen, gebruikt u az boards area team remove.

az boards area team remove --path
                           --team
                           [--project]

Parameters

• pad: vereist. Absoluut pad van een gebied. Voorbeeld: --path \ProjectName\AreaName.
• team: vereist. Naam of id van het team.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Opmerking

Met de volgende opdracht wordt bijvoorbeeld het pad \Service Delivery\Voice verwijderd uit het Voice-team van het Fabrikam Fiber-project.

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Een gebiedspad verwijderen

Wanneer u een gebiedspad verwijdert, moet u een gebiedspad opgeven dat moet worden gebruikt om de werkitems bij te werken die zijn toegewezen aan het gebiedspad dat u wilt verwijderen.

Belangrijk

• Als u gebiedspaden verwijdert of iteratiepaden opnieuw configureert, kunnen gegevens verloren gaan. In burndown- en burnupwidgetdiagrammen, sprint burndown- en snelheidsdiagrammen voor teams met gewijzigde vlakpaden worden bijvoorbeeld geen nauwkeurige gegevens weergegeven. Historische trenddiagrammen verwijzen naar het gebiedspad en iteratiepad zoals deze zijn gedefinieerd op het moment dat elk werkitem wordt gedefinieerd. Nadat u de gegevens hebt verwijderd, kunt u geen historische gegevens voor deze paden ophalen.
• U kunt alleen gebieds- en iteratiepaden verwijderen die niet meer worden gebruikt door werkitems.

1. Als u een gebiedspad wilt verwijderen, opent u de pagina Projectinstellingen projectconfiguratiegebieden>> in de webportal.

2. Kies het contextmenu voor het knooppunt en selecteer Verwijderen of Verwijderen.

3. Selecteer in het dialoogvenster dat wordt geopend het gebiedspad waarnaar u werkitems opnieuw wilt toewijzen en kies vervolgens Pad verwijderen.

   

Voortgang van grafiek per gebied

U kunt snel query's genereren om de voortgang te bekijken op basis van een gebiedspad. Visualiseer bijvoorbeeld de voortgang van werkitems die zijn toegewezen aan het gebiedspad van elk team, zoals wordt weergegeven in het volgende gestapelde staafdiagram. Kies Knooppuntnaam om het leaf-knooppunt van het gebiedspad op te halen.

Volgende stappen

Iteratiepaden of sprints instellen

Verwante artikelen:

Zoals u kunt zien, spelen gebiedspaden een belangrijke rol bij het ondersteunen van Agile-hulpprogramma's, teams en het beheren van werkitems. Meer informatie over het werken met deze velden vindt u in de volgende artikelen:

• Meer informatie over gebieden en iteraties
• Een ander team toevoegen
• Teaminstellingen configureren en teambeheerders toevoegen
• Agile-hulpprogramma's gebruiken die afhankelijk zijn van gebieden of iteraties
• Query uitvoeren op gebied of iteratiepad
• Machtigingen en toegang instellen voor het bijhouden van werk

Programmatische resources

Gebiedspaden en iteratiepaden worden ook wel classificatieknooppunten genoemd.

• Gebruik het gebied az boards (Azure DevOps CLI).
• Gebruik de Teams (REST API) om teamconfiguraties te beheren.
• Gebruik de classificatieknooppunten (REST API) om werkitemclassificaties te organiseren.