Csatolt munkaelemek mintául szolgáló lekérdezések és jelentések listázása

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

Ez a cikk bemutatja, hogyan hozhat létre olyan jelentést, amely felsorolja a más munkaelemekhez csatolt munkaelemeket. Az alábbi jelentés például a szülő-gyermek kapcsolattípusú felhasználói történetekhez csatolt szolgáltatások listáját jeleníti meg.

A hivatkozástípusokról és a munkaelemek csatolásáról további információt a Felhasználói történetek, problémák, hibák és egyéb munkaelemek csatolása című témakörben talál.

A minta lekérdezések közé tartoznak a hibák felsorolása egy másik hibára mutató duplikált hivatkozással, valamint az olyan hibák felsorolása, amelyek nem tartalmaznak ismétlődő hivatkozást egy másik hibára.

Feljegyzés

Ez a cikk feltételezi, hogy OData-lekérdezések használatával olvassa el a mintajelentések áttekintését, és alapszintű ismeretekkel rendelkezik a Power BI-ról.

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.

Minta lekérdezések

Több lekérdezés is rendelkezésre áll, amelyek bemutatják, hogyan szűrheti a csatolt munkaelemeket. Ezek a lekérdezések az WorkItems entitáshalmazt jelölik meg, mivel aktuális adatokat adnak vissza.

Feljegyzés

A szűrési vagy jelentéskészítési célokra elérhető tulajdonságok meghatározásához tekintse meg az Azure Boards metaadat-referenciáját. Lekérdezéseit szűrheti, vagy a tulajdonságokat visszakaphatja bármelyik Property érték alapján, amelyek egy EntityType vagy NavigationPropertyBinding Path érték alatt érhetők el egy EntitySet segítségével. Mindegyik EntitySet megfelel egy EntityType-nek. Az egyes értékek adattípusával kapcsolatos további információkért tekintse át a megfelelő EntityTypemetaadatokat.

Szolgáltatások és gyermek felhasználói történetek visszaküldése

Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.

Power BI-lekérdezés

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Closed' and State ne 'Removed' "
            &"and startswith(Area/AreaPath,'{areapath}') " 
        &"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath), "
                &"Links( "
                    &"$filter=LinkTypeName eq 'Child' "
                        &"and TargetWorkItem/WorkItemType eq 'User Story'; "
                    &"$select=LinkTypeName; "
                    &"$expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State) "
                &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-lekérdezés

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezésekkel.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Feature'
            and State ne 'Closed' and State ne 'Removed'
            and startswith(Area/AreaPath,'{areapath}')
        &$select=WorkItemId,Title,WorkItemType,State,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
                Links(
                    $filter=LinkTypeName eq 'Child'
                        and TargetWorkItem/WorkItemType eq 'User Story';
                    $select=LinkTypeName;
                    $expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State)
                )

Helyettesítési sztringek és lekérdezések bontása

Cserélje le a következő sztringeket az értékekkel. Ne használjon szögletes zárójeleket {} a helyettesítésnél. Ha például a szervezet neve "Fabrikam", cserélje le a {organization}-t Fabrikam-re, nem pedig {Fabrikam}-re.

• {organization} - A szervezet neve
• {project} - A csapat projektneve, vagy a "/{project}" teljes kihagyása projektközi lekérdezéshez
• {areapath} - Az útvonalad. Példaformátum: Project\Level1\Level2.

Lekérdezések lebontása

Az alábbi táblázat a lekérdezés egyes részeit ismerteti.

Lekérdezési rész

Leírás

$filter=WorkItemType eq 'Feature'

Felhasználói történeteket ad vissza.

and State ne 'Closed' and State ne 'Removed'

Kihagyhatja azokat a funkciókat, amelyek állapota bezárt vagy eltávolított állapotú.

and startswith(Area/AreaPath,'{areapath}')

Csak az adott terület elérési útjának helyére tartozó szolgáltatások belefoglalása '{areapath}'.
A csoportnév alapján történő szűréshez használja a szűrőutasítást Teams/any(x:x/TeamName eq '{teamname})'.

&$select=WorkItemId,Title,WorkItemType,State,AreaSK

Jelölje ki a visszaadni kívánt mezőket.

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

Adja meg a kibontandó AssignedTo mezők, Iteration és Area entitások mezőit.

Links(

Nyissa meg az Links entitást.

$filter=LinkTypeName eq 'Child'

Csak azokat a munkaelemeket szűrje, amelyek a Gyermek hivatkozástípusúak. Ilyenek például a szülő, gyermek, duplikált, duplikátuma, hatással van, érintett.

and TargetWorkItem/WorkItemType eq 'User Story';

Csak csatolt felhasználói történetek tartoznak ide.

$select=LinkTypeName;

Válassza ki a LinkTypeName visszaadni kívánt tulajdonságot.

$expand=TargetWorkItem($select=WorkItemType, WorkItemId, Title, State)

Válassza ki a visszaadni kívánt csatolt munkaelem tulajdonságait.

)

Zárja be a Links() záradékot.

Kapcsolódó hivatkozástípussal társított felhasználói történetek visszaadása

Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.

Power BI-lekérdezés

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath), "
                &"Links( "
                    &"$filter=LinkTypeName eq 'Related' "
                        &"and TargetWorkItem/WorkItemType eq 'User Story'; "
                    &"$select=LinkTypeName; "
                    &"$expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State) "
                &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-lekérdezés

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezésekkel.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'User Story'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
        &$select=WorkItemId,Title,WorkItemType,State,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
                Links(
                    $filter=LinkTypeName eq 'Related'
                        and TargetWorkItem/WorkItemType eq 'User Story';
                    $select=LinkTypeName;
                    $expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State)
                )

A Teams által szűrt csatolt felhasználói történetek visszaküldése

A következő lekérdezés megegyezik a cikkben korábban használt lekérdezéssel, kivéve, hogy a terület elérési útja helyett csoportnév alapján szűr.

Power BI-lekérdezés

Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and State ne 'Closed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath), "
                &"Links( "
                    &"$filter=LinkTypeName eq 'Related' "
                        &"and TargetWorkItem/WorkItemType eq 'User Story'; "
                    &"$select=LinkTypeName; "
                    &"$expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State) "
                &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-lekérdezés

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezésekkel.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'User Story'
            and State ne 'Closed'
            and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
                Links(
                    $filter=LinkTypeName eq 'Related'
                        and TargetWorkItem/WorkItemType eq 'User Story';
                    $select=LinkTypeName;
                    $expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State)
                )

Hibák visszaadása duplikált hivatkozással egy másik hibára

Power BI-lekérdezés

Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.

let
    Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Links/any(x:x/LinkTypeName eq 'Duplicate' and x/TargetWorkItem/WorkItemType eq 'Bug') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath), "
            &"Links( "
                &"$filter=LinkTypeName eq 'Duplicate' "
                &"and TargetWorkItem/WorkItemType eq 'Bug'; "
                    &"$select=LinkTypeName; "
                &"$expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-lekérdezés

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezésekkel.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and Links/any(x:x/LinkTypeName eq 'Duplicate' and x/TargetWorkItem/WorkItemType eq 'Bug')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
            Links(
                $filter=LinkTypeName eq 'Duplicate'
                and TargetWorkItem/WorkItemType eq 'Bug';
                    $select=LinkTypeName;
                $expand=TargetWorkItem($select=WorkItemType,WorkItemId,Title,State)
            )

Olyan hibákat ad vissza, amelyek nem rendelkeznek duplikált hivatkozással egy másik hibára

Power BI-lekérdezés

Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
                &"and State ne 'Closed' "
                &"and startswith(Area/AreaPath,'{areapath}') "
                &"and not (Links/any(x:x/LinkTypeName eq 'Duplicate' and x/TargetWorkItem/WorkItemType eq 'Bug')) "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-lekérdezés

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezésekkel.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
                and State ne 'Closed'
                and startswith(Area/AreaPath,'{areapath}')
                and not (Links/any(x:x/LinkTypeName eq 'Duplicate' and x/TargetWorkItem/WorkItemType eq 'Bug'))
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

(Nem kötelező) Lekérdezés átnevezése

Az alapértelmezett lekérdezéscímkét (Query1) átnevezheti valami értelmesebbre. Egyszerűen adjon meg egy új nevet a Lekérdezés beállításai panelen.

Adatok átalakítása a Power Query Editorban

A jelentés létrehozása előtt ki kell bontania azokat az oszlopokat, amelyek több mezőt tartalmazó rekordokat ad vissza. Ebben az esetben a következő rekordokat szeretné megnyitni:

• Links
• Links.TargetWorkItem
• Area
• Iteration
• AssignedTo

A munkaelemek kibontásával kapcsolatos további információkért tekintse meg a Power BI-jelentések létrehozásához használható Transform Analytics-adatokat.

(Nem kötelező) Nevezze át a mezőket

Az oszlopok kibontása után érdemes lehet átnevezni egy vagy több mezőt. Átnevezheti például az oszlopot AreaPath a következőre Area Path: . A jelentés létrehozásakor átnevezheti őket adattábla nézetben vagy később. A Oszlopmezők átnevezése című részből megtudhatja, hogyan.

Ebben a példában a következő mezők lettek átnevezve:

Eredeti mezőnév	Átnevez
Links.TargetWorkItem.ID	Célazonosító
LinkekLinkTípusNév	Hivatkozástípus
Links.TargetWorkItem.State	Cél állapota
Links.TargetWorkItem.Title	Célkitűzés címe

Zárja be a lekérdezést, és alkalmazza a módosításokat

Miután elvégezte az összes adatátalakítást, válassza a Kezdőlap menü Bezárás &alkalmaz elemét a lekérdezés mentéséhez és a Power BI Jelentés lapjára való visszatéréshez.

Csatolt munkaelemek listázására táblajelentés létrehozása

1. A Power BI-ban válassza a Tábla jelentés lehetőséget a Vizualizációk csoportban.

   

2. Adja hozzá a következő mezőket az oszlopokhoz megadott sorrendben:

   • Azonosító, kattintson a jobb gombbal, és válassza az Összegzés mellőzése lehetőséget
   • State
   • Cím
   • Célazonosító, kattintson a jobb gombbal, és válassza az Összegzés mellőzése lehetőséget
   • Hivatkozás típusa
   • Célállapot
   • Célcím

Megjelenik a példajelentés.

Kapcsolódó cikkek

• Mintajelentések vizsgálata OData-lekérdezésekkel
• OData-lekérdezések létrehozása az Analyticshez
• Csatlakozás a Power BI-hoz OData-lekérdezésekkel
• Tekintse meg az Azure Boards Analytics metaadatait
• Mintajelentések és gyorshivatkozási index elérése
• Csapatszeletelő hozzáadása meglévő jelentéshez