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. Het toewijzen van gebiedspaden aan teams zorgt ervoor dat werkitems via die paden verschijnen op de backlogs 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 achterstandslijst, query, bord of plan filteren met behulp van gebiedspaden

Tip

U kunt de structuur van het gebiedspad definiëren en gebiedspaden toewijzen aan teams. U kunt ook een team toevoegen en dan het gebiedspad maken met de teamnaam. 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 van alle tools>
• Alle hulpprogramma's van Sprints>
• Leveringsplannen
• Overzicht
• Alles analyseren>

Om te begrijpen hoe het systeem gebiedspaden gebruikt, zie over gebieds- en iteratiepaden.

Vereisten

Categorie

Eisen

Toestemmingen

- Teamgebied- of iteratiepaden instellen: teambeheerder of lid van de projectbeheerders groep. 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: lid van de projectbeheerders groep. - Om gebiedspaden onder een knooppunt toe te voegen, te bewerken en te beheren: een of meer van de volgende machtigingen ingesteld op Toestaan: - Maak onderliggende knooppunten - dit knooppunt verwijderen - Dit knooppunt bewerken - Machtigingen weergeven in dit knooppunt

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

Zie Over gebieden en iteraties, naamgevingsbeperkingen voor de beperkingen op de naamgeving van 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 werktracking, maar teams kunnen ook meerdere gebiedspaden gebruiken op hun backlogs 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 nieuw bent in het beheren van 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 >> 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. In 'Standaardgebiedpaden voor het team instellen', voer de stappen uit.
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

Door hetzelfde gebiedspad aan meerdere teams toe te wijzen, kunnen er conflicten ontstaan over het eigenaarschap van werkitems. Zie voor meer informatie Beperkingen van weergaven van meerdere teams.

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 subknooppunt onder een ander knooppunt verplaatsen
• Een kindknooppunt verwijderen
• De naam van een team wijzigen
• De toewijzingen van het gebiedspad aan een team wijzigen

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

Lijst met projectgebiedpaden | Een projectgebiedpad toevoegen | Lijst met teampaden | Teampaden instellen | Een projectgebiedpad hernoemen of verplaatsen | Een gebiedspad uit een team verwijderen

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 subknooppunten die moet worden weergegeven. Voorbeeld: --depth 3. Wanneer niet anders aangegeven, 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".

Voorbeeld

Met de volgende opdracht worden bijvoorbeeld de gebiedspaden weergegeven tot een diepte van 3 voor het Fabrikam Fiber-project. Voor andere uitvoerformaatopties, zie Uitvoerformaten voor Azure CLI-opdrachten.

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 pad en kies Nieuw kind. 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. Selecteer Opslaan en sluiten

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

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

1. Markeer het gebiedspad en kies vervolgens Nieuw kind. Optioneel kunt u het gebiedspad selecteren en kiezen voor Nieuw onderliggend item 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. Selecteer Opslaan en sluiten

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 hetzelfde commando in tabeluitvoerformaat.

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 via 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 >

   

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. Voor andere opties voor uitvoerindelingen, zie Uitvoerindelingen voor Azure CLI-opdrachten

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 zowel gebieden als iteraties via Projectinstellingen > Teamconfiguratie. U kunt er snel naartoe navigeren vanuit een teamwerk-tracking backlog, een bord of een dashboard.

1. Open een achterstandslijst of teamboard 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.

   

Team-gebiedspaden instellen

Alle werkitems die zijn toegewezen aan een teamgebiedspad, worden weergegeven in de backlogs en taskborden voor dat team. U kunt een of meer gebiedspaden selecteren en eventueel hun subgebiedpaden opnemen. Kies ervoor om subgebiedpaden op te nemen wanneer u gegroepeerde weergaven van werk wilt ondersteunen dat door verschillende teams of in meerdere gebieden wordt 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 aanmaken in 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: Verplicht. Naam of id van het team.
• include-sub-areas: Optional. Neem de onderliggende knooppunten van het gebiedspad op. 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.

Voorbeeld

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: verplicht. 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. Specificeert de nieuwe naam van het gebiedspad.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Voorbeeld

Met de volgende opdracht hernoemt u bijvoorbeeld het Voice-gebiedspad 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

Verwijder een gebiedspad uit een team

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: Verplicht. Naam of id van het team.
• project: Optioneel. Naam of id van het project. Voorbeeld: --project "Fabrikam Fiber".

Voorbeeld

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. Bijvoorbeeld:
  • Burndown- en burnup-widgetgrafieken
  • Burndown-grafieken voor sprints
  • Snelheidsgrafieken voor teams met gewijzigde gebiedspaden
  • Historische trenddiagrammen die verwijzen naar het gebiedspad en iteratiepad zoals ze zijn gedefinieerd voor elk werkitem.
• 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 webportalpagina Projectinstellingen>Projectconfiguratie>Gebieden.

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 Pad verwijderen vervolgens.

   

Voortgang per gebied in kaart brengen

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

Programmamiddelen

Gebiedspaden en iteratiepaden worden ook wel classificatieknooppunten genoemd.

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