Share via

Lekérdezés terület vagy iterációs útvonal szerint

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

A Terület elérési útja és az Iterációs útvonal két mező, amelyek az összes munkaelemtípus munkakövetési űrlapján jelennek meg. Definiálhatja őket egy projekthez – területútvonalakhoz és iterációs útvonalakhoz –, majd kiválaszthatja azokat, amelyeket egy csapathoz szeretne társítani.

A terület- és iterációs útvonalakkal való munka jobb megismeréséhez tekintse meg a csapatokról és az agilis eszközökről szóló témakört.

Feljegyzés

A következő makrók csak a webes portálról támogatottak: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity és @TeamAreas. A makrókat tartalmazó lekérdezések nem működnek a Visual Studio/Team Explorer, a Microsoft Excel vagy a Microsoft Project alkalmazásban való megnyitáskor.

Támogatott operátorok és makrók

Lekérdezések létrehozásakor és a Terület elérési útja és az Iterációs útvonal mezőinek megadásakor a következő operátorokat használhatja:

Operátor Használja, ha...
= Adjon meg egy adott területet vagy iterációs útvonalat
<> Szűrjön ki egy, egy adott területet vagy iterációs útvonalat.
In Szűrjön terület- vagy iterációs útvonalakat.
Not In Zárja ki azokat az elemeket, amelyek terület- vagy iterációs útvonalak készletéhez vannak rendelve.
Under Adja meg az összes elérési utat egy kijelölt terület vagy iterációs útvonal alatt.
Not Under Egy adott területhez vagy iterációs útvonalhoz rendelt elemek kizárása.

Az operátorokkal együtt az alábbi makrókat is használhatja az Iterációs útvonal kiválasztásakor. Példák : Lekérdezés dátum vagy aktuális iteráció szerint.

Macro Használja, ha...
@CurrentIteration Adja meg a kijelölt csapatkörnyezethez társított aktuális iterációt.
@CurrentIteration +/- n Elemek szűrése a kijelölt csapatkörnyezethez társított futamok csúsztatási ablakához való hozzárendelés alapján.
@TeamAreas Az elemek szűrése egy adott csapathoz rendelt terület elérési útja(i) alapján.

Feljegyzés

Az @CurrentIteration +/- n Azure DevOps Server 2019 és újabb verziói támogatják a makrókat és @TeamAreas a makrókat. Ezek a makrók csak a webes portálról támogatottak. A makrókat tartalmazó lekérdezések nem működnek a Visual Studio/Team Explorer, a Microsoft Excel vagy a Microsoft Project alkalmazásban való megnyitáskor.

Területútvonal-lekérdezések

A több területútvonalhoz rendelt munkaelemek szűrését az In operátorral adhatja meg, ahogyan az alábbi példában is látható.

Több terület területútvonalának lekérdezése

Csomópontnév és kulcsszóalapú lekérdezések

A Csomópontnév mezővel szűrhet a területútvonalakhoz hozzárendelt munkaelemekre egy kulcsszó alapján a Contains operátor használatával. A csomópont neve egy terület elérési útjának utolsó csomópontját adja meg, amely a fahierarchiában az utolsó csomópontnak felel meg.

Az alábbi lekérdezés ugyanazt az eredményt adja, mint az előző példában.

Lekérdezés több terület csomópontnevéről

Ebben a példában a szűrő egy olyan terület elérési úthoz rendelt munkaelemeket ad vissza, amelynek utolsó csomópontja az "Azure" szót tartalmazza.

Több futam lekérdezése

Íme egy másik példa, amely a Csomópont nevét és az In operátort használja.

Lekérdezés több terület csomópontnevéről

Csapatterület elérési útjának lekérdezései

A @TeamAreas makróval gyorsan megtalálhatja az adott csapathoz rendelt területútvonalakhoz rendelt elemeket. Adja meg az operátort = . A Lekérdezésszerkesztő automatikusan kéri, hogy adja meg a csapat nevét. A felvételhez adja meg a csapat nevét, és válassza ki a keresési szűrő feltételei között megjelenő csoportértéket.

Csoporthoz rendelt területútvonalak lekérdezése

Besorolási mező referenciája

Mezőnév Leírás Hivatkozás neve
Terület elérési útja A munkaelemeket termékfunkciókba vagy csoportterületekbe csoportosítja. A területnek érvényes csomópontnak kell lennie a projekthierarchiában. System.AreaPath
Iterációs útvonal Elnevezett futamok vagy időszakok szerint csoportosítja a munkaelemeket. Az iterációnak érvényes csomópontnak kell lennie a projekthierarchiában. System.IterationPath

Minden mező esetében adatelérési út=TreePath, jelentéskészítési típus=Dimension, indexattribútum=True.

Ha 256 karakternél hosszabb elérési utat határoz meg, a Microsoft Projectben nem adhatja meg. A probléma elkerülése érdekében adjon meg legfeljebb 10 karakter hosszúságú elérési utat, és ne ágyazzon be 14 szintnél mélyebb csomópontokat.

A legtöbb mezőszabály nem alkalmazható a rendszermezőkre, például a System.AreaPath és a System.IterationPath mezőkre. További információ: Szabályok és szabályértékelés.

A következő mezők nem jelennek meg a munkaelem-űrlapokon, de minden munkaelem-típushoz nyomon vannak követve. Ezek a mezők numerikus értéket biztosítanak a projekthez definiált egyes besorolási értékekhez. Ezekkel a mezőkkel szűrheti a lekérdezéseket és jelentéseket hozhat létre.

Mezőnév Leírás Hivatkozás neve Adattípus
Területazonosító Annak a területnek az egyedi azonosítója, amelyhez ez a munkaelem hozzá van rendelve. System.AreaId Egész
Iterációs azonosító Annak az iterációnak az egyedi azonosítója, amelyhez ez a munkaelem hozzá van rendelve. System.IterationId Egész
Csomópont neve Egy terület elérési útjának utolsó csomópontjának neve. Ha például a terület elérési útja Project\A1\B2\C3, akkor a csomópont neve C3. System.NodeName Sztring

Az alapértelmezett jelentéskészítési típus nincs. A területazonosító és az iterációs azonosító indexelt, a csomópont neve nem. A mezőattribútumokról további információt a Munkaelem mezői és attribútumai című témakörben talál.

REST API

A lekérdezésekkel való programozott interakcióhoz tekintse meg az alábbi REST API-erőforrások egyikét: