Lekérdezés terület vagy iterációs útvonal szerint
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ó.
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.
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.
Íme egy másik példa, amely a Csomópont nevét és az In operátort használja.
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.
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.
Kapcsolódó cikkek
- Rövid összefoglalás a lekérdezésekről
- Területútvonalak definiálása és csapathoz rendelése
- Iterációs (sprint) útvonalak definiálása és a csapat iterációinak konfigurálása
- Engedélyek és hozzáférés beállítása a munkakövetéshez
REST API
A lekérdezésekkel való programozott interakcióhoz tekintse meg az alábbi REST API-erőforrások egyikét: