Megosztás:

Alapszintű lekérdezések definiálása az OData Analytics használatával

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Az Azure DevOps-hoz készült Analytics használatával OData-lekérdezéseket hozhat létre a kívánt adatok visszaadásához. Ezeket a lekérdezéseket a böngészőben vagy az olyan ügyfélszoftverekben futtathatja, mint az Excel vagy a Power BI.

Ez a cikk az Azure Boards munkakövetési entitáskészleteinek lekérésére szolgáló lekérdezésekre összpontosít, de az alapelvek más entitáskészletek lekérdezésére is érvényesek. További információ: OData-lekérdezések létrehozása az AzureBoards Analytics elemzési és metaadat-referenciáihoz.

Ez az oktatóanyag a következőket mutatja be:

  • Olyan lekérdezések definiálása, amelyek elemszámot adnak vissza, az adatokkal vagy anélkül.
  • Válassza ki, ha adott tulajdonságok adatait szeretné visszaadni.
  • Adatok szűrése adott tulajdonságok szerint.
  • Az olyan navigációs tulajdonságok adatait adja vissza, mint az Identitás, a Terület elérési útja és az Iterációs útvonal.
  • A expand záradékok és beágyazott expand utasítások használata.
  • Lekérdezési dátumtartományok.
  • A orderby opció használatával rendezheti az eredményeket.

Megjegyzés

Az Elemzési szolgáltatás automatikusan engedélyezve van és támogatott éles környezetben az Azure DevOps Services összes szolgáltatásához. Az Analytics szolgáltatás OData-hírcsatornájánakPower BI-integrációja és hozzáférése általánosan elérhető. Javasoljuk, hogy használja az Analytics OData-hírcsatornát, és küldjön visszajelzést.

A rendelkezésre álló adatok verziófüggők. Az OData API legújabb támogatott verziója a v2.0, és a legújabb előzetes verzió a v4.0-preview. További információ: OData API-verziószámozás.

Megjegyzés

Az Azure DevOps Server 2020 és újabb verziói esetén az Analytics szolgáltatás automatikusan telepítve lesz és támogatott működés közben, az összes új projektgyűjteménynél. Az Analytics szolgáltatás OData-hírcsatornájánakPower BI-integrációja és hozzáférése általánosan elérhető. Javasoljuk, hogy használja az Analytics OData-hírcsatornát, és küldjön visszajelzést. Ha az Azure DevOps Server 2019-ről frissít, a frissítés során telepítheti az Analytics szolgáltatást.

A rendelkezésre álló adatok verziófüggők. Az OData API legújabb támogatott verziója a v2.0, és a legújabb előzetes verzió a v4.0-preview. További információ: OData API-verziószámozás.

Előfeltételek

Kategória Követelmények
hozzáférési szintek - projekt tagja.
- Legalább alapszintű hozzáférést.
Jogosultságok Alapértelmezés szerint a projekttagok jogosultak az Analytics lekérdezésére és nézetek létrehozására. A szolgáltatás- és szolgáltatás-engedélyezéssel, valamint az általános adatkövetési tevékenységekkel kapcsolatos egyéb előfeltételekről további információt az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben talál.

Megjegyzés

Projektközi lekérdezések meghiúsulnak, ha a lekérdezést futtató felhasználó nem fér hozzá az összes projekthez. A követelményekkel kapcsolatos további információkért tekintse meg a Project és a szervezet hatókörébe tartozó lekérdezéseket.

Megjegyzés

A cikkben szereplő OData-lekérdezések az Azure DevOps Serviceshez definiált lekérdezési URL-címet használják. https://analytics.dev.azure.com/ Cserélje le a saját szervezet- és projektneveit a lekérdezésekben az OData lekérdezésének megismeréséhez.

Helyszíni kiszolgáló esetén hasonló lekérdezéseket hozhat létre egy URL-címmel a kiszolgáló és a projektgyűjtemény alapján. https://<servername>/<ProjectCollectionName>/ További információ: OData-lekérdezések létrehozása az Analyticshez.

Elemek számának lekérése

Ha csak a szervezetben vagy projektben meghatározott elemek vagy entitások számát szeretné visszaadni más információk hozzáadása nélkül, alkalmazza a $apply=aggregate($count as Count) lekérdezési lehetőséget. Az alábbi lekérdezések egy szervezet projektjeinek, munkaelemeinek, területútvonalainak és felhasználóinak számát adja vissza.

https://analytics.dev.azure.com/<OrganizationName>/_odata/v4.0-preview/Projects?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/<OrganizationName>/_odata/v4.0-preview/WorkItems?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/<OrganizationName>/_odata/v4.0-preview/Areas?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/<OrganizationName>/_odata/v4.0-preview/Users?$apply=aggregate($count as Count)

Az előző lekérdezések az alábbi példához hasonló eredményeket adnak vissza a fabrikam szervezet projektjeihez:

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#Projects(Count)",
  "value": [
    {
      "@odata.id": null,
      "Count": 16
    }
  ]
}

Elemek számának és adataik lekérése

Ha az elemek számát és a kijelölt adatokat szeretné visszaadni, adja meg a $count=true lekérdezési lehetőséget egy select utasításban. Az alábbi lekérdezések a projekthez definiált munkaelemek, területelérési utak és felhasználók számát, valamint a megadott tulajdonságokat adják vissza. Érvényes tulajdonságokért tekintse meg az Azure Boards Analytics metaadat-referenciáját és az Azure DevOps Analytics naptár dátumához, projekt és felhasználói metaadatokhoz tartozó referenciáját.

https://analytics.dev.azure.com/<OrganizationName>/<ProjectName>/_odata/v4.0-preview/WorkItems?$count=true&$select=WorkItemId,Title,WorkItemType 
https://analytics.dev.azure.com/<OrganizationName>/<ProjectName>/_odata/v4.0-preview/Areas?$count=true&$select=AreaName,AreaPath 
https://analytics.dev.azure.com/<OrganizationName>/<ProjectName>/_odata/v4.0-preview/Users?$count=true&$select=UserName,UserEmail

Megjegyzés

Ha egy adott entitástípushoz definiált összes tulajdonságot vissza szeretne adni, záradék nélkül $count=true is használhatóselect. Azonban ha nem tartalmaz $select vagy $apply záradékot, akkor figyelmeztetést kap, például VS403507: The specified query does not include a $select or $apply clause which is recommended for all queries. Details on recommended query patterns are available here: https://go.microsoft.com/fwlink/?linkid=861060. A használati korlátok elkerülése érdekében mindig adjon meg egy $select vagy $apply záradékot a lekérdezésekben.

A következő lekérdezés például a Fabrikam Fibre projekt felhasználóinak számát és felhasználóneveit kéri le:

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Users?$count=true&$select=UserName

A lekérdezés a 5 rendelkező felhasználók számát adja vissza.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Users(UserName)",
  "@odata.count": 5,
  "value": [
    {
      "UserName": "Microsoft.VisualStudio.Services.TFS"
    },
    {
      "UserName": "fabrikamfiber1@hotmail.com"
    },
    {
      "UserName": "Jamal Hartnett"
    },
    {
      "UserName": "fabrikamfiber5@hotmail.com"
    },
    {
      "UserName": "fabrikamfiber2@hotmail.com"
    }
  ]
}

Adott tulajdonságok vagy mezők kiválasztása

Adott tulajdonságok vagy munkaelemmezők visszaadásához adjon hozzá egy $select záradékot, amely megadja a tulajdonságneveket. Ha például a munkaelem azonosítóját, a munkaelem típusát, címét és állapotát szeretné visszaadni, adja hozzá a záradékot a $select=WorkItemId,WorkItemType,Title,State lekérdezéshez.

A $select záradék a névvel ellátott mezőknek megfelelő tulajdonságneveket adja meg. Az OData-lekérdezések tulajdonságnevei a szóközökre és a kis- és nagybetű használatra is figyelmet igényelnek. Bár a tulajdonság megjeleníthet olyan neveket, mint a Munkaelem-azonosító, amelyek tartalmazhatnak szóközöket, a formális tulajdonságnevek nem tartalmazhatnak szóközöket.

A tulajdonságok nevével és címkéivel kapcsolatos további információkért tekintse meg az Azure Boards metaadat-referenciáját. Az egyéni mezőtulajdonságok címkézésének megismeréséhez tekintse meg az Egyéni tulajdonságok című témakört.

Az alábbi példa lekérdezés a Fabrikam Fibre projekt első három munkaelemének azonosítóit, címét és állapotát kéri le.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$top=3

Az Analytics a következő adatokat adja vissza.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State)",
  "value": [
    {
      "WorkItemId": 31,
      "Title": "About screen",
      "WorkItemType": "Task",
      "State": "New"
    },
    {
      "WorkItemId": 30,
      "Title": "Change background color",
      "WorkItemType": "Task",
      "State": "Active"
    },
    {
      "WorkItemId": 32,
      "Title": "Standardize on form factors",
      "WorkItemType": "Task",
      "State": "Active"
    }
  ]
}

Adatok szűrése

Ha egy entitáskészletet adott elemek visszaadására szeretne szűrni, adjon hozzá egy $filter záradékot, amely meghatározza, hogy az elemeknek milyen feltételeknek kell megfelelniük. Az alábbi szűrőzáradék csak a Funkció munkaelemtípusokat adja vissza, amelyek Folyamatban állapotban vannak.

/WorkItems?$filter=WorkItemType eq 'Feature' and State eq 'In Progress'

Az alábbi példa lekérdezés a Munkaelem-azonosítót, a Munkaelem típusát, a Címet és az Állapotot csak a Folyamatban állapotú szolgáltatásmunkaelemeknek adja vissza.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,Title,AssignedTo,State&$filter=WorkItemType eq 'Feature' and State eq 'In Progress'

Több szűrőzáradék megadása

Egyetlen and záradékban megadhat több szűrőt a or és $select segítségével. Az alábbi lekérdezés például több mezőt határoz meg a Felhasználói szövegegység, a Hiba vagy az Egyéni típusú Teendőlista munka típusú munka típusú munkaelemekből, amelyek az Új, a Véglegesített vagy az Aktív állapotban vannak. Zárójel használatával szükség szerint csoportosíthatja a szűrési záradékokat.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,Title,AssignedTo,State&$filter=(WorkItemType eq 'User Story' or WorkItemType eq 'Bug' or WorkItemType eq 'Backlog Work') and (State eq 'New' or State eq 'Committed' or State eq 'Active')

A lekérdezés az alábbi eredményekhez hasonló adatokat ad vissza:


{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,Title,AssignedTo,State)",
  "value": [
    {
      "WorkItemId": 210,
      "Title": "Slow response on form",
      "State": "Active"
    },
    ...
    {
      "WorkItemId": 160,
      "Title": "Game store testing",
      "State": "New"
    }
  ]
}

Különböző függvényeket is alkalmazhat, például contains, startswith és endswith a $select záradékban. Lásd : Támogatott függvények.

Lekérdezze a terület útvonal vagy iterációs útvonal tulajdonságait

Egy adott terület elérési útjának, iterációs útvonalának, vagy más tulajdonságainak kereséséhez AreaSKIterationSK használja az alábbi lekérdezéseket.

Egy adott terület elérési útjának AreaSK-jának visszaadása

Az alábbi lekérdezés a AreaSK területi útvonalhoz definiált Fabrikam Fiber\Production Planning\Web tulajdonságot kéri le. A Területek entitáskészlet egyéb definiált tulajdonságainak megtekintéséhez tekintse meg a Területek című témakört.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Areas?$filter=AreaPath eq 'Fabrikam Fiber\Production Planning\Web' &$select=AreaSK

A lekérdezés a következő adatokat adja vissza.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Areas(AreaSK)",
  "value": [
    {
      "AreaSK": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

Az IterationSK visszaadása egy adott iterációs útvonalhoz

Az alábbi lekérdezés az IterationSK iterációs útvonalhoz Fabrikam Fiber\3Week Sprints\Sprint 3 definiált tulajdonságot adja vissza. Az Iterations entitáskészlet egyéb definiált tulajdonságainak megtekintéséhez tekintse meg az Iterációk című témakört.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Iterations?$filter=IterationPath eq 'Fabrikam Fiber\Release 1\Sprint 3' &$select=IterationSK

Szűrés navigációs tulajdonságok alapján

A navigációs tulajdonságok az entitástípusok közötti kapcsolatokat jelölik. Ha egy navigációs tulajdonságot a szűrőfeltételek részeként ad meg, meg kell adnia a navigációs tulajdonság teljes elérési útját. Az alábbi záradék például a navigációs tulajdonság megadott iterációs útvonala alapján szűri a Iteration munkaelemeket.

/WorkItems?$filter=Iteration/IterationPath eq 'Project Name\Iteration 1'

Iteration a navigációs tulajdonság, és IterationPath az érdeklődési terület. Iteration/IterationPath a IterationPath tulajdonság teljes elérési útja.

Az alábbi példa lekérdezés az Fabrikam Fiber\3Week Sprints\Sprint 3 iterációs útvonal öt legfontosabb munkaeleméből kér le adatokat a Iteration/IterationPath teljes elérési út megadásával.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$top=5&$filter=Iteration/IterationPath eq 'Fabrikam Fiber\3Week Sprints\Sprint 3'&$select=WorkItemId, WorkItemType, Title, State&$orderby=WorkItemId asc

Az előző példa lekérdezés nem ad vissza Iteration adatokat, mert Iteration egy kapcsolódó entitás. Az olyan navigációs tulajdonságok tulajdonságai, mint a Identity, Area, és Iteration, nem érhetők el közvetlenül a $select utasítások használatával. Használnia kell a $expand utasításokat az adatok visszaadására kapcsolódó entitásokból.

/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 00000&$expand=Iteration

Az alábbi példa lekérdezés a munkaelem-azonosítóhoz 480társított adatokat kéri le, beleértve a bővített Iteration adatokat is.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration

A lekérdezés a következő adatokat adja vissza, amelyek a kibontott Iteration tulajdonság összes mezőjét tartalmazzák.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration)",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "IterationSK": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationId": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationName": "Sprint 3",
        "Number": 276,
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "StartDate": "2025-12-04T00:00:00-12:00",
        "EndDate": "2025-12-25T23:59:59.999-12:00",
        "IterationLevel1": "Fabrikam Fiber",
        "IterationLevel2": "3Week Sprints",
        "IterationLevel3": "Sprint 3",
        "IterationLevel4": null,
        "IterationLevel5": null,
        "IterationLevel6": null,
        "IterationLevel7": null,
        "IterationLevel8": null,
        "IterationLevel9": null,
        "IterationLevel10": null,
        "IterationLevel11": null,
        "IterationLevel12": null,
        "IterationLevel13": null,
        "IterationLevel14": null,
        "Depth": 2,
        "IsEnded": false,
        "AnalyticsUpdatedDate": "2025-10-22T17:28:14.7166667Z"
      }
    }
  ]
}

Select használata kibontási utasításokban

Ha egy kibontott tulajdonság a kívántnál több adatot ad vissza, adjon hozzá egy utasítást $select a tulajdonsághoz.

/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 00000&$expand=Iteration($select=Name,IterationPath)

Az alábbi példa lekérdezés például csak a IterationNameIterationPath kibontott Iteration tulajdonság adatait választja ki.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($select=IterationName,IterationPath)

A lekérdezés a következő adatokat adja vissza.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration(IterationName,IterationPath))",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "IterationName": "Sprint 3",
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3"
      }
    }
  ]
}

Az alábbi táblázat bemutatja, hogyan használható $expand és $select záradékokkal jelölhet ki több mezőt a navigációs tulajdonságokban. Például a $expand=AssignedTo($select=UserName) navigációs tulajdonságban a Felhasználónév mező Hozzárendelt tulajdonságát a Identity használatával adja vissza.

Típus mező Hivatkozott tulajdonság Példa záradékok
Dátum/idő DateSK $expand=CreatedDate($select=Date) vagy
$expand=CreatedDate($select=WeekStartingDate)
Identitás UserSK $expand=AssignedTo($select=UserName) vagy
$expand=AssignedTo($select=UserEmail)
Terület AreaSK $expand=Area($select=AreaName) vagy
$expand=Area($select=AreaPath)
Iteráció IterationSK $expand=Iteration($select=IterationName) vagy
$expand=Iteration($select=IterationPath) vagy
$expand=Iteration($select=StartDate)
Projekt ProjectSK $expand=Project($select=ProjectName)
Csoport TeamSK $expand=Teams($select=TeamName)

Egyetlen $expand záradékban több tulajdonságot is megadhat, ha vesszővel elválasztott listát használ.

$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Beágyazott kibontó utasítások használata

Az OData-utasítások beágyazott $expand formában is használhatók. Az alábbi lekérdezés például beágyazott $expand utasításokat használ annak a projektnek a megjelenítéséhez, amelyben az iteráció szerepel.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($expand=Project)

A lekérdezés a következő adatokat adja vissza:

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration)",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "IterationSK": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationId": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationName": "Sprint 3",
        "Number": 276,
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "StartDate": "2025-12-04T00:00:00-12:00",
        "EndDate": "2025-12-25T23:59:59.999-12:00",
        "IterationLevel1": "Fabrikam Fiber",
        "IterationLevel2": "3Week Sprints",
        "IterationLevel3": "Sprint 3",
        "IterationLevel4": null,
        "IterationLevel5": null,
        "IterationLevel6": null,
        "IterationLevel7": null,
        "IterationLevel8": null,
        "IterationLevel9": null,
        "IterationLevel10": null,
        "IterationLevel11": null,
        "IterationLevel12": null,
        "IterationLevel13": null,
        "IterationLevel14": null,
        "Depth": 2,
        "IsEnded": false,
        "AnalyticsUpdatedDate": "2025-10-22T17:28:14.7166667Z",
        "Project": {
          "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectName": "Fabrikam Fiber",
          "AnalyticsUpdatedDate": "2025-10-28T20:27:13.5833333Z",
          "ProjectVisibility": "Private"
        }
      }
    }
  ]
}

$select Például hozzáadhat utasításokat, hogy csak a IterationName és IterationPath értékeket adja vissza Iteration:

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($select=IterationName,IterationPath;$expand=Project)

Ez a lekérdezés a következő adatokat adja vissza:

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration(IterationName,IterationPath,Project))",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "IterationName": "Sprint 3",
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "Project": {
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectName": "Fabrikam Fiber",
          "AnalyticsUpdatedDate": "2025-10-28T20:27:13.5833333Z",
          "ProjectVisibility": "Private"
        }
      }
    }
  ]
}

Az eredmények csak a IterationName és a IterationPath elemeket mutatják a Iteration-ből, míg a Project egy beágyazott objektumként jelenik meg a Iteration eredmények között.

Megjegyzés

Amikor egy $expand záradékot egy $select utasításon belül ágyaz be, a beágyazott ; elé pontosvesszőt $expand kell használnia a hiba elkerülése érdekében.

Dátumtartomány lekérdezése

Az alábbi példa lekérdezés olyan munkaelemeket ad vissza, amelyek legutóbbi módosított dátuma nagyobb vagy egyenlő, mint 2025. január 1.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2025-01-01Z

Az alábbi példa lekérdezés olyan munkaelemeket ad vissza, amelyek legutóbbi módosított dátuma 2025. október 31. és november 7. között történt.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2025-10-31Z&ChangedDate le 2025-11-07Z

Az eredmények rendezése

Adja meg az $orderby eredmények rendezésének lehetőségét, vagy adja meg azt a sorrendet, amelyben az eredményeket vissza szeretné adni. Növekvő vagy csökkenő sorrendben rendezhet kulcsszavak segítségével: asc vagy desc. Az alábbi táblázat néhány példát mutat be.

Rendezési szempont: Záradék
Munkaelem azonosítója /WorkItems?$orderby=WorkItemId
Munkaelem-azonosító csökkenő sorrendben /WorkItems?$orderby=WorkItemId desc
Munkaelem típusa és állapota /WorkItems?$orderby=WorkItemType,State

Következő lépés

Project > szervezeti hatókörű lekérdezések

Kapcsolódó tartalom

  • Last updated on