Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Sie können Analytics für Azure DevOps verwenden, um OData-Abfragen zu erstellen, um Daten zurückzugeben, die Sie interessieren. Sie können diese Abfragen in Ihrem Browser oder in Clientsoftware wie Excel oder Power BI ausführen.
Dieser Artikel konzentriert sich auf Abfragen zum Abrufen von Azure Boards work tracking entity sets, aber die Prinzipien gelten für die Abfrage anderer Entitätssätze. Weitere Informationen finden Sie unter Erstellen von OData-Abfragen für Die Analyse - und Metadatenreferenz für Azure Boards Analytics.
In diesem Lernprogramm erfahren Sie, wie Sie:
- Definieren Sie Abfragen, die die Anzahl der Elemente zurückgeben, mit oder ohne deren Daten.
- Wählen Sie diese Option aus, um Daten für bestimmte Eigenschaften zurückzugeben.
- Filtern von Daten nach bestimmten Eigenschaften.
- Zurückgeben von Daten für Navigationseigenschaften wie Identität, Bereichspfad und Iterationspfad.
- Verwenden Sie
expandKlauseln und geschachtelteexpandAnweisungen. - Abfragedatumsbereiche.
- Verwenden Sie die Option zum Sortieren von
orderbyErgebnissen.
Hinweis
Der Analysedienst wird automatisch aktiviert und in der Produktion für alle Dienste in Azure DevOps Services unterstützt. Power BI-Integration und Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Sie werden dazu ermutigt, den OData-Datenfeed für Analytics zu verwenden und Feedback zu geben.
Verfügbare Daten sind versionsabhängig. Die neueste unterstützte Version der OData-API ist v2.0, und die neueste Vorschauversion ist v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.
Hinweis
Der Analysedienst wird automatisch installiert und in der Produktion für alle neuen Projektsammlungen für Azure DevOps Server 2020 und höhere Versionen unterstützt. Power BI-Integration und Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Sie werden dazu ermutigt, den OData-Datenfeed für Analytics zu verwenden und Feedback zu geben. Wenn Sie ein Upgrade von Azure DevOps Server 2019 durchführen, können Sie den Analysedienst während des Upgrades installieren.
Verfügbare Daten sind versionsabhängig. Die neueste unterstützte Version der OData-API ist v2.0, und die neueste Vorschauversion ist v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen |
-
Projektmitglied. – Mindestens einfacher Zugriff. |
| Erlaubnisse | Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten. Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datenverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics. |
Hinweis
Projektübergreifende Abfragen schlagen fehl, wenn der Benutzer, der die Abfrage ausführt, keinen Zugriff auf alle Projekte hat. Weitere Informationen zu Anforderungen finden Sie unter Project- und Organisationsbezogene Abfragen.
Hinweis
Die OData-Abfragen in diesem Artikel verwenden die abfrage-URL, die für Azure DevOps Services definiert ist. https://analytics.dev.azure.com/ Ersetzen Sie Ihre eigene Organisation und Projektnamen in den Abfragen, um sich mit der Abfrage von OData vertraut zu machen.
Für einen lokalen Server können Sie ähnliche Abfragen mit einer URL erstellen, die auf Ihrem Server und ihrer Projektsammlung basiert. https://<servername>/<ProjectCollectionName>/ Weitere Informationen finden Sie unter Erstellen von OData-Abfragen für Analytics.
Anzahl der Elemente ermitteln
Um nur eine Anzahl von Elementen oder Entitäten zurückzugeben, die in einer Organisation oder einem Projekt definiert sind, ohne andere Informationen einzuschlussen, wenden Sie die $apply=aggregate($count as Count) Abfrageoption an. Die folgenden Abfragen geben die Anzahl der Projekte, Arbeitsaufgaben, Bereichspfade und Benutzer in einer Organisation zurück.
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)
Die vorherigen Abfragen geben Ergebnisse wie das folgende Beispiel für Projekte in der fabrikam Organisation zurück:
{
"@odata.context": "https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#Projects(Count)",
"value": [
{
"@odata.id": null,
"Count": 16
}
]
}
Anzahl der Elemente und deren Daten erfassen
Wenn Sie eine Anzahl von Elementen zusammen mit ausgewählten Daten für die Elemente zurückgeben möchten, geben Sie die $count=true Abfrageoption in einer select Anweisung an. Die folgenden Abfragen geben zusammen mit den angegebenen Eigenschaften eine Anzahl von Arbeitsaufgaben, Flächenpfaden und Benutzern zurück, die für ein Projekt definiert sind. Gültige Eigenschaften finden Sie unter Metadatenreferenz für Azure Boards Analytics und Kalenderdatum, Project und Benutzermetadatenreferenz für Azure DevOps Analytics.
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
Hinweis
Um alle für einen angegebenen Entitätstyp definierten Eigenschaften zurückzugeben, können Sie ohne $count=true Klausel verwendenselect. Wenn Sie jedoch keine Klausel einschließen $select$apply , erhalten Sie eine Warnung wie 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. Um zu vermeiden, dass Sie die Nutzungsgrenzwerte erreichen, fügen Sie immer eine $select-Klausel oder eine $apply-Klausel in Ihre Abfragen ein.
Die folgende Abfrage fordert beispielsweise die Anzahl und die Benutzernamen von Benutzern im Fabrikam Fiber-Projekt an:
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Users?$count=true&$select=UserName
Die Abfrage gibt eine Anzahl von 5 Benutzern mit ihren Benutzernamen zurück.
{
"@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"
}
]
}
Auswählen bestimmter Eigenschaften oder Felder
Um bestimmte Eigenschaften oder Arbeitsaufgabenfelder zurückzugeben, fügen Sie eine $select Klausel hinzu, die die Eigenschaftennamen angibt. Um z. B. die Arbeitselement-ID, den Arbeitsaufgabentyp, den Titel und den Status von Arbeitsaufgaben zurückzugeben, fügen Sie der Abfrage die $select=WorkItemId,WorkItemType,Title,State Klausel hinzu.
Die $select Klausel gibt die Eigenschaftennamen an, die den benannten Feldern entsprechen. Eigenschaftsnamen in OData-Abfragen erfordern sowohl die Beachtung der Leerzeichen als auch der Schreibweise. Obwohl Eigenschaftsanzeigenamen wie die Arbeitselement-ID Leerzeichen enthalten können, dürfen formale Eigenschaftsnamen keine Leerzeichen enthalten.
Weitere Informationen zu Eigenschaftennamen und Bezeichnungen finden Sie in der Metadatenreferenz für Azure Boards. Informationen dazu, wie benutzerdefinierte Feldeigenschaften bezeichnet werden, finden Sie unter "Benutzerdefinierte Eigenschaften".
Im folgenden Beispiel werden die Arbeitsgegenstand-IDs, Titel und Zustände für die drei wichtigsten Arbeitsgegenstände im Fabrikam Fiber-Projekt angefordert.
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$top=3
Analytics gibt die folgenden Daten zurück.
{
"@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"
}
]
}
Filtern von Daten
Um einen Entitätssatz zum Zurückgeben bestimmter Elemente zu filtern, fügen Sie eine $filter Klausel hinzu, die die Kriterien angibt, die die Elemente erfüllen müssen. Die folgende Filterklausel gibt nur Funktionsaufgabentypen zurück, die sich im Status "In Bearbeitung" befinden.
/WorkItems?$filter=WorkItemType eq 'Feature' and State eq 'In Progress'
Die folgende Beispielabfrage gibt an, dass arbeitsaufgaben-ID, Arbeitselementtyp, Titel und Status nur von Funktionsarbeitselementen zurückgegeben werden, die sich im Status "In Bearbeitung" befinden.
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'
Angeben mehrerer Filterklauseln
Sie können and und or verwenden, um mehrere Filter in einer einzelnen $select Klausel anzugeben. Die folgende Abfrage gibt z. B. mehrere Felder aus Arbeitsaufgaben des Typs "User Story", "Bug" oder "Custom type Backlog Work " an, die sich im Status "Neu", " Zugesichert" oder " Aktiv " befinden. Verwenden Sie Klammern, um Filterklauseln nach Bedarf zu gruppieren.
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')
Die Abfrage gibt Daten wie die folgenden Ergebnisse zurück:
{
"@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"
}
]
}
Sie können auch verschiedene Funktionen wie contains, startswith, und endswith in $select Klauseln anwenden. Siehe unterstützte Funktionen.
Eigenschaften des Abfragebereichspfads oder Iterationspfads
Verwenden Sie die folgende Abfrage, um AreaSK-Eigenschaften, IterationSK-Eigenschaften oder andere Eigenschaften für einen bestimmten Bereichspfad oder Iterationspfad zu ermitteln.
Geben Sie das AreaSK für einen bestimmten Bereichspfad zurück
Die folgende Abfrage fordert die im Bereichspfad AreaSK definierte Eigenschaft Fabrikam Fiber\Production Planning\Web an. Weitere definierte Eigenschaften für die Entität "Areas" finden Sie unter "Areas".
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Areas?$filter=AreaPath eq 'Fabrikam Fiber\Production Planning\Web' &$select=AreaSK
Die Abfrage gibt die folgenden Daten zurück.
{
"@odata.context": "https://analytics.dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Areas(AreaSK)",
"value": [
{
"AreaSK": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}
]
}
Zurückgeben des IterationSK für einen bestimmten Iterationspfad
Die folgende Abfrage gibt die IterationSK für den Iterationspfad Fabrikam Fiber\3Week Sprints\Sprint 3 definierte Eigenschaft zurück. Weitere definierte Eigenschaften für den Iterationsentitätssatz finden Sie unter Iterationen.
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Iterations?$filter=IterationPath eq 'Fabrikam Fiber\Release 1\Sprint 3' &$select=IterationSK
Nach Navigationseigenschaften filtern
Navigationseigenschaften stellen Beziehungen zwischen Entitätstypen dar. Wenn Sie eine Navigationseigenschaft als Teil Ihrer Filterkriterien angeben, müssen Sie den vollständigen Pfad für die Navigationseigenschaft angeben. Beispielsweise filtert die folgende Klausel Arbeitsaufgaben basierend auf einem angegebenen Iterationspfad für die Iteration Navigationseigenschaft.
/WorkItems?$filter=Iteration/IterationPath eq 'Project Name\Iteration 1'
Iteration ist die Navigationseigenschaft und IterationPath ist das interessante Feld.
Iteration/IterationPath ist der vollständige Pfad für die IterationPath Eigenschaft.
Im folgenden Beispielabfrage werden Daten aus den fünf wichtigsten Arbeitsaufgaben im Iterationspfad Fabrikam Fiber\3Week Sprints\Sprint 3 abgerufen, indem der vollständige Pfad für Iteration/IterationPath angegeben wird.
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
Erweitern von Daten aus verwandten Entitäten
Die vorherige Beispielabfrage gibt keine Daten zurück Iteration , da es sich um Iteration eine verknüpfte Entität handelt. Eigenschaften von Navigationseigenschaften wie Identity, Area, und Iteration können nicht direkt mithilfe von $select Anweisungen angesprochen werden. Sie müssen $expand-Anweisungen verwenden, um Daten aus verwandten Entitäten zurückzugeben.
/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 00000&$expand=Iteration
Das folgende Beispiel fordert Informationen an, die mit der Arbeitsaufgaben-ID 480verknüpft sind, einschließlich erweiterter Iteration Daten.
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration
Die Abfrage gibt die folgenden Daten zurück, die alle Felder aus der erweiterten Iteration Eigenschaft enthalten.
{
"@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"
}
}
]
}
Auswahl in expand-Anweisungen verwenden
Wenn eine erweiterte Eigenschaft mehr Daten zurückgibt, als Sie möchten, fügen Sie eine $select Anweisung für die Eigenschaft hinzu.
/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 00000&$expand=Iteration($select=Name,IterationPath)
Die folgende Beispielabfrage wählt nur die IterationName und IterationPath Daten aus der erweiterten Iteration Eigenschaft aus.
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)
Die Abfrage gibt die folgenden Daten zurück.
{
"@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"
}
}
]
}
In der folgenden Tabelle wird gezeigt, wie Sie $expand und $select Klauseln verwenden, um mehrere Felder in Navigationseigenschaften auszuwählen. Um beispielsweise die $expand=AssignedTo($select=UserName) des Felds "Benutzername" in der Navigationseigenschaft zurückzugeben, verwenden Sie Identity.
| Feld 'Typ' | Referenzierte Eigenschaft | Beispielklauseln |
|---|---|---|
| Datum/Uhrzeit | DateSK |
$expand=CreatedDate($select=Date) oder$expand=CreatedDate($select=WeekStartingDate) |
| Identität | UserSK |
$expand=AssignedTo($select=UserName) oder$expand=AssignedTo($select=UserEmail) |
| Bereich | AreaSK |
$expand=Area($select=AreaName) oder$expand=Area($select=AreaPath) |
| Wiederholung | IterationSK |
$expand=Iteration($select=IterationName) oder$expand=Iteration($select=IterationPath) oder$expand=Iteration($select=StartDate) |
| Projekt | ProjectSK |
$expand=Project($select=ProjectName) |
| Teams | TeamSK |
$expand=Teams($select=TeamName) |
Sie können mehrere Eigenschaften angeben, die in einer einzelnen $expand Klausel erweitert werden sollen, indem Sie eine durch Trennzeichen getrennte Liste verwenden.
$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)
Verwenden von geschachtelten Expand-Anweisungen
Sie können geschachtelte OData-Anweisungen $expand verwenden. Die folgende Abfrage verwendet beispielsweise geschachtelte $expand Anweisungen, um das Projekt anzuzeigen, zu dem eine Iteration gehört.
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)
Die Abfrage gibt die folgenden Daten zurück:
{
"@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"
}
}
}
]
}
Sie können $select Anweisungen hinzufügen, z. B., um nur die IterationName und IterationPath von Iteration zurückzugeben.
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)
Diese Abfrage gibt die folgenden Daten zurück:
{
"@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"
}
}
}
]
}
Die Ergebnisse zeigen nur das IterationName und IterationPath aus Iteration und Project als geschachteltes Objekt innerhalb der Iteration-Ergebnisse an.
Hinweis
Wenn Sie eine $expand Klausel in einer $select Anweisung verschachteln, müssen Sie vor dem geschachtelten ; Semikolon einen Semikolon $expand verwenden, um einen Fehler zu vermeiden.
Abfragen eines Datumsbereichs
Die folgende Beispielabfrage gibt Arbeitsaufgaben zurück, deren letztes Änderungsdatum größer oder gleich dem 1. Januar 2025 ist.
https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2025-01-01Z
Die folgende Beispielabfrage gibt Arbeitsaufgaben zurück, deren letztes Änderungsdatum in der Woche vom 31. Oktober bis zum 7. November 2025 aufgetreten ist.
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
Ergebnisse sortieren
Geben Sie die $orderby Option zum Sortieren der Ergebnisse an, oder geben Sie die Reihenfolge an, in der Ergebnisse zurückgegeben werden sollen. Sie können in aufsteigender oder absteigender Reihenfolge mithilfe von Schlüsselwörtern asc oder desc. Die folgende Tabelle enthält einige Beispiele.
| Sortieren nach | Klausel |
|---|---|
| ID des Arbeitselements | /WorkItems?$orderby=WorkItemId |
| Absteigende Arbeitselement-ID | /WorkItems?$orderby=WorkItemId desc |
| Arbeitselementtyp und Status | /WorkItems?$orderby=WorkItemType,State |