Projekt- és szervezeti hatókörű lekérdezések

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

Az Azure DevOps-hez készült Analytics használatával olyan lekérdezéseket hozhat létre, amelyek egy projektre, szervezetre vagy gyűjteményre terjednek ki. Ezeket a lekérdezéseket közvetlenül a böngészőben vagy a Power BI-ban is futtathatja.

A projekthatókörű lekérdezések segítenek megválaszolni az egyetlen projekttel kapcsolatos kérdéseket, míg a szervezeti és gyűjtemény hatókörű lekérdezések lehetővé teszik a projekthatárokat átlépő kérdések megválaszolásához. A szervezeti és gyűjtemény hatókörű lekérdezésekhez szélesebb körű felhasználói engedélyekre vagy gondos hatókörkezelési korlátozásokra van szükség annak érdekében, hogy a lekérdezés ne legyen letiltva az engedélyek hiánya miatt.

Feljegyzés

Az Elemzési szolgáltatás automatikusan engedélyezve és támogatva van az összes Azure DevOps Services esetében az éles környezetben. Az Elemzési szolgáltatás OData-hírcsatornájának Power BI-integrációja és hozzáférése általánosan elérhető. Javasoljuk, hogy használja és küldjön nekünk visszajelzést. A rendelkezésre álló adatok verziófüggők. A legújabb támogatott verzióv2.0, és a legújabb előzetes verzió.v4.0-preview További információ: OData API-verziószámozás.

Előfeltételek

• Az Analytics-adatok megtekintéséhez és a szolgáltatás lekérdezéséhez egy alapszintű hozzáféréssel rendelkező vagy annál nagyobb hozzáférésű projekt tagjának kell lennie. Alapértelmezés szerint minden projekttag rendelkezik az Analytics lekérdezéséhez és az Analytics-nézetek meghatározásához szükséges engedélyekkel.
• 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 az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben olvashat.

Fontos

Ha nem fér hozzá egy szervezet összes projektjéhez, javasoljuk, hogy minden lekérdezésre alkalmazza a projektszűrőt. Ha adatokat kér le az ügyféleszközökre, például a Power BI-ba vagy az Excelbe, a projektút szintaxisa a legjobb módszer annak biztosítására, hogy az összes adatot az adott projekt korlátozza. Javasoljuk, hogy csak akkor használjon szervezeti hatókörű vagy gyűjtemény hatókörű lekérdezéseket, ha két vagy több projektről kell jelentést tennie.

Projekt hatókörű lekérdezések

Egy lekérdezést úgy hozhat létre, hogy beírja az OData URL-címét egy támogatott webböngészőbe.

Egy projektszintű OData-lekérdezés alap URL-címe az alábbi szintaxisban látható.

Felhő (Azure DevOps Services

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/

A megadott példákban cserélje le és {ProjectName} írja be {OrganizationName} a lekérdezni kívánt szervezet és projekt nevét.

Helyszíni (Azure DevOps Server)

https://{servername}:{port}/tfs/{CollectionName}/{ProjectName}/_odata/{version}/

A megadott példákban végezze el a következő cserét:

• analytics.dev.azure.com a {ServerName}:{Port}/tfs/
• {CollectionName} a projektgyűjtemény nevével (alapértelmezés szerint DefaultCollection)
• {ProjectName} a lekérdezni kívánt projekt nevével.

Feljegyzés

A cikkben szereplő további példák az Azure DevOps Services URL-címén alapulnak. A példák végrehajtásához az Azure DevOps Server URL-címét kell lecserélnie.

Munkaelemek számának visszaadása

Az alábbi projekthatókörű lekérdezés például egy adott projekt munkaelemeinek számát adja vissza.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/WorkItems/$count

A Fabrikam Fibre-projekt lekérdezése például 7126 munkaelemet ad vissza. A törölt munkaelemek nem szerepelnek a darabszámban.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v1.0/WorkItems/$count

7126

Projektterület elérési útjainak visszaadása

Hasonlóképpen, a következő lekérdezési sztring egy adott projekt területeit adja vissza:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/Areas

Ez egyenértékű a következő szűrővel egy szervezeti hatókörű lekérdezésen:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/Areas?
  $filter=Project/ProjectName eq '{ProjectName}'

A Fabrikam Fibre-projekt lekérdezése például egy terület elérési útjának összes tulajdonságát visszaadja, mivel a lekérdezésben nincs $select operátor alkalmazva.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v1.0/Areas

Az alábbi példa egyetlen terület elérési útjának visszaadott adatait mutatja be.

ProjectSK	"56af920d-393b-4236-9a07-24439ccaa85c"
AreaSK	"26be05fd-e68a-4fcb-833f-497f6bee45f2"
AreaId	"26be05fd-e68a-4fcb-833f-497f6bee45f2"
AreaName	"Service Delivery"
Number	55373
AreaPath	"Fabrikam Fiber\\Service Delivery"
AreaLevel1	"Fabrikam Fiber"
AreaLevel2	"Service Delivery"
AreaLevel3	null
AreaLevel4	null
AreaLevel5	null
AreaLevel6	null
AreaLevel7	null
AreaLevel8	null
AreaLevel9	null
AreaLevel10	null
AreaLevel11	null
AreaLevel12	null
AreaLevel13	null
AreaLevel14	null
Depth	1

A $expand lehetőség használata

Ha projekthatókörű lekérdezést használ egy $expand beállítással, nem kell más szűrőket megadnia.

Például a következő projekthatókörű szűrő:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/WorkItems?
  $expand=Parent

a rendszer automatikusan szűri a biztonság kikényszerítéséhez:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Parent($filter=ProjectName eq '{ProjectName}')

Szervezeti hatókörű lekérdezések

A szervezeti szintű lekérdezések alap URL-címe az alábbi módon jelenik meg:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v1.0

Ha szervezeti hatókörű lekérdezést használ egy $expand beállítással, egy másik szűrőt kell megadnia.

A következő szervezeti hatókörű lekérdezés például az összes munkaelem gyermekeinek lekérésére használható $expand .

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Children

Egy másik szűrőre van szükség annak ellenőrzéséhez, hogy a gyermekek a megadott projektre vannak-e korlátozva:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Children($filter=Project/ProjectName eq '{ProjectName}')

Az összes munkaelem szülőjének visszaadása

A következő lekérdezés, amely az $expand összes munkaelem szülőjének lekérésére szolgáló lehetőséget használja.

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Parent

Egy másik szűrőre van szükség annak ellenőrzéséhez, hogy a szülő a megadott projektre van-e korlátozva:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=Project/ProjectName eq '{ProjectName}'
  &$expand=Parent($filter=Project/ProjectName eq '{ProjectName}')

A másik szűrő nélkül a kérés sikertelen lesz, ha bármely munkaelem szülője olyan projekt munkaelemeire hivatkozik, amelyekhez nem rendelkezik olvasási hozzáféréssel.

Projektszintű biztonsági korlátozások

Az Analytics a projektszintű biztonsághoz kapcsolódó lekérdezési szintaxisra vonatkozó néhány további korlátozással rendelkezik.

A any vagy all szűrők az alapentitásra vonatkoznak egy $expand. Projekten alapuló szűrők esetén kifejezetten figyelmen kívül hagyjuk a szűrőt:$expand

Például a következő lekérdezés:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Children($filter=Project/ProjectName eq '{ProjectName}')

A következőképpen értelmezi:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}'
  &$expand=Children

és sikertelen lesz, ha nem fér hozzá az összes projekthez.

A korlátozás megkerüléséhez egy további kifejezést kell hozzáadnia a $filterkövetkezőhöz:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $filter=ProjectName eq '{ProjectName}' and Children/any(r: r/ProjectName eq '{ProjectName}')
  &$expand=Children

A használat $level csak akkor támogatott, ha rendelkezik hozzáféréssel a gyűjtemény összes projektéhez, vagy ha projekthatókörű lekérdezést használ:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $expand=Children($levels=2;$filter=ProjectName eq '{ProjectName}')

Az Elemzés nem támogatja a záradékot használó projektek keresztszintű hivatkozását $it . A következő lekérdezés például a főmunkaelem ProjectName alias használatára $it hivatkozik, amely nem támogatott:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $expand=Links(
    $expand=TargetWorkItem;
    $filter=TargetWorkItem/Project/ProjectName eq $it/Project/ProjectName)

Következő lépés

Összesítő adatok lekérdezése

Kapcsolódó cikkek

• Lekérdezési irányelvek