Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
A terület elérési útja és az iterációs útvonal mezői minden munkaelem-űrlapon megjelennek minden munkaelem-típushoz. Definiálja ezeket az útvonalakat a 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 megismeréséhez tekintse meg a csapatokról és az agilis eszközökről szóló témakört.
Prerequisites
| Category | Requirements |
|---|---|
| Hozzáférési szintek | – Megosztott lekérdezések megtekintése és futtatása: Projekt tagja. – Megosztott lekérdezés hozzáadása és mentése: Legalább alapszintű hozzáférés. |
| Permissions | Hozzájárulás engedély beállítása engedélyezése azon mappához, amelyhez lekérdezést szeretne hozzáadni. Alapértelmezés szerint a Közreműködők csoport nem rendelkezik ezzel az engedéllyel. |
Note
A nyilvános projektekhez érintett hozzáféréssel rendelkező felhasználók ugyanúgy teljes hozzáféréssel rendelkeznek a lekérdezési funkciókhoz, mint a Alapszintű hozzáféréssel rendelkező felhasználók. További információért lásd: Érdekelt felek hozzáférésének gyorsreferenciája.
| Category | Requirements |
|---|---|
| Hozzáférési szintek | – Megosztott lekérdezések megtekintése és futtatása: Projekt tagja. – Megosztott lekérdezés hozzáadása és mentése: Legalább Egyszerű hozzáférés. |
| Permissions | Hozzájárulás engedély beállítása engedélyezése azon mappához, amelyhez lekérdezést szeretne hozzáadni. Alapértelmezés szerint a Közreműködők csoport nem rendelkezik ezzel az engedéllyel. |
Note
A következő makrók csak a webportá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
Amikor lekérdezéseket hoz létre, és megadja a Terület elérési útja és az Iterációs útvonal mezőket, a következő operátorokat használhatja:
| Operator | Akkor használja, ha azt szeretné... |
|---|---|
= |
Adjon meg egy adott területet vagy iterációs útvonalat |
<> |
Egy adott terület vagy iterációs útvonal szűrése |
In |
Egy adott területi vagy iterációs útvonal készlet szűrése |
Not In |
Terület- vagy iterációs útvonalakhoz rendelt elemek kizárása |
Under |
A kijelölt terület vagy iterációs útvonal alatti összes elérési út megadása |
Not Under |
Adott terület vagy iterációs útvonal alá rendelt elemek kizárása |
Az Iterációs útvonal mező kiválasztásakor az alábbi makrók használhatók. Példákért tekintse meg az ezen a lapon található lekérdezési példákat.
| Macro | Akkor használja, ha azt szeretné... |
|---|---|
@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 csapat kontextusához társított sprintek csúszó ablakához való hozzárendelés alapján |
@TeamAreas |
Elemek szűrése egy adott csapathoz rendelt terület elérési útja(i) alapján |
Note
Az Azure DevOps webes portál olyan makrókat értékel ki, mint a @CurrentIteration, @CurrentIteration +/- nés @TeamAreas (Szolgáltatások és kiszolgáló). A nem webes ügyfelek (Visual Studio/Team Explorer, Excel, Project) és a közvetlen WIQL/REST-hívások explicit terület-/iterációs útvonalakat igényelnek, és nem fogadnak nyers makrójogkivonatokat. Amikor a webes felhasználói felületen ment egy lekérdezést, a portál általában konkrét értékekre bontja a makrókat a tárolt WIQL-ben – ellenőrizze ezt a viselkedést a környezetben, ha a webes felhasználói felületen kívüli lekérdezéseket kell használnia.
Területútvonal-lekérdezések
A több területútvonalhoz rendelt munkaelemekre az In operátorral szűrhet az alábbi példában látható módon.
Csomópontnév és kulcsszóalapú lekérdezések
A Csomópontnév mezővel szűrheti a területútvonalakhoz rendelt munkaelemeket egy kulcsszó alapján a Contains operátor használatával. A csomópontnév egy területútvonal-utolsó csomópontját adja meg, amely a fahierarchia utolsó csomópontjának felel meg.
Az alábbi lekérdezés ugyanazt az eredményt hozza létre, mint az előző példában.
Ebben a példában a szűrő egy olyan területútvonalhoz rendelt munkaelemeket ad vissza, amelynek utolsó csomópontja az "Azure" szót tartalmazza.
Íme egy másik példa, amely a Csomópontnév és a In operátort használja.
Csapatterület elérési útjának lekérdezései
A @TeamAreas makróval megkeresheti az adott csapat által használt területútvonalakhoz rendelt elemeket. Adja meg a = operátort. A Lekérdezésszerkesztő kéri, hogy adja meg a csapat nevét; válassza ki a csoportot a javasolt listából.
Besorolási mező referenciája
| Mezőnév | Description | 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 az 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ályok kiértékelése.
A következő mezők nem jelennek meg a munkaelem-űrlapokon, de az Azure DevOps minden munkaelem-típushoz nyomon követi őket. Ezek a mezők numerikus értéket adnak 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 | Description | Hivatkozás neve | Adattípus |
|---|---|---|---|
| Területazonosító | Annak a területnek az egyedi azonosítója, ahová ezt a munkatételt rendeli hozzá. | System.AreaId | Integer |
| Iterációs azonosító | Annak az iterációnak az egyedi azonosítója, amelyhez ezt a munkaelemet rendeli hozzá. | System.IterationId | Integer |
| 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 | String |
Az alapértelmezett jelentéskészítési típus nincs. A területazonosító és az iterációs azonosító indexeket is tartalmazza. A csomópont neve nem létezik. A mezőattribútumokról további információt Munkaelem-mezők és -attribútumokcímű témakörben talál.
Kapcsolódó tartalom
- Gyors hivatkozás a lekérdezésekre
- Területútvonalak definiálása és csoporthoz való hozzárendelés
- 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: