Wiql - Query By Id

Referenz

Dienst:: Work Item Tracking

API-Version:: 5.0

Ruft die Ergebnisse der Abfrage ab, die die Abfrage-ID angegeben hat.

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/wit/wiql/{id}?api-version=5.0

Mit optionalen Parametern:

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/wit/wiql/{id}?timePrecision={timePrecision}&$top={$top}&api-version=5.0

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
id	path	True	string (uuid)	Die Abfrage-ID.
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path		string	Projekt-ID oder Projektname
team	path		string	Team-ID oder Teamname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "5.0" festgelegt werden, um diese Version der API zu verwenden.
$top	query		integer (int32)	Die maximale Anzahl der zurückzugebenden Ergebnisse.
timePrecision	query		boolean	Gibt an, ob die Zeitgenauigkeit verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	WorkItemQueryResult	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Bereiche

Name	Beschreibung
vso.work	Gewährt die Möglichkeit, Arbeitsaufgaben, Abfragen, Boards, Flächen- und Iterationspfade und andere Metadaten zur Nachverfolgung von Arbeitsaufgaben zu lesen. Gewährt außerdem die Möglichkeit, Abfragen auszuführen, Arbeitsaufgaben zu durchsuchen und Benachrichtigungen über Arbeitsaufgabenereignisse über Dienst-Hooks zu erhalten.

Beispiele

Beispielanforderung

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/wiql/{id}?api-version=5.0

Beispiel für eine Antwort

Statuscode:: 200

{
  "queryType": "tree",
  "asOf": "2014-12-29T20:49:33.803Z",
  "columns": [
    {
      "referenceName": "System.Id",
      "name": "ID",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
    },
    {
      "referenceName": "System.WorkItemType",
      "name": "Work Item Type",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
    },
    {
      "referenceName": "System.Title",
      "name": "Title",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
    },
    {
      "referenceName": "System.AssignedTo",
      "name": "Assigned To",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.AssignedTo"
    },
    {
      "referenceName": "System.State",
      "name": "State",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
    }
  ],
  "workItemRelations": [
    {
      "target": {
        "id": 4,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/4"
      }
    },
    {
      "target": {
        "id": 5,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/5"
      }
    },
    {
      "target": {
        "id": 6,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/6"
      }
    },
    {
      "target": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      },
      "target": {
        "id": 8,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/8"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      },
      "target": {
        "id": 9,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/9"
      }
    },
    {
      "target": {
        "id": 11,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/11"
      }
    },
    {
      "target": {
        "id": 12,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/12"
      }
    },
    {
      "target": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 1,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 2,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 3,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/3"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 13,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/13"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 14,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/14"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 15,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/15"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 16,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/16"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 17,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/17"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 18,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/18"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 19,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/19"
      }
    },
    {
      "target": {
        "id": 21,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/21"
      }
    },
    {
      "target": {
        "id": 33,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/33"
      }
    },
    {
      "target": {
        "id": 34,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/34"
      }
    },
    {
      "target": {
        "id": 46,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/46"
      }
    },
    {
      "target": {
        "id": 47,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/47"
      }
    },
    {
      "target": {
        "id": 58,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/58"
      }
    },
    {
      "target": {
        "id": 59,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/59"
      }
    },
    {
      "target": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      },
      "target": {
        "id": 299,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      },
      "target": {
        "id": 300,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
      }
    },
    {
      "target": {
        "id": 298,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/298"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
QueryResultType	Der Ergebnistyp
QueryType	Der Abfragetyp.
WorkItemFieldReference	Verweisen auf ein Feld in einer Arbeitsaufgabe
WorkItemLink	Eine Verknüpfung zwischen zwei Arbeitsaufgaben.
WorkItemQueryResult	Das Ergebnis einer Arbeitsaufgabenabfrage.
WorkItemQuerySortColumn	Eine Sortierspalte.
WorkItemReference	Enthält einen Verweis auf eine Arbeitsaufgabe.

QueryResultType

Enumeration

Der Ergebnistyp

Wert	Beschreibung
workItem	Eine Liste der Arbeitsaufgaben (für flache Abfragen).
workItemLink	Eine Liste der Arbeitsaufgabenlinks (für OneHop- und Strukturabfragen).

QueryType

Enumeration

Der Abfragetyp.

Wert	Beschreibung
flat	Ruft eine flache Liste von Arbeitsaufgaben ab.
oneHop	Ruft eine Liste der Arbeitsaufgaben und deren direkte Verknüpfungen ab.
tree	Ruft eine Struktur der Arbeitsaufgaben ab, die ihre Verknüpfungshierarchie anzeigen.

WorkItemFieldReference

Objekt

Verweisen auf ein Feld in einer Arbeitsaufgabe

Name	Typ	Beschreibung
name	string	Der Name des Felds.
referenceName	string	Der Verweisname des Felds.
url	string	Die REST-URL der Ressource.

WorkItemLink

Objekt

Eine Verknüpfung zwischen zwei Arbeitsaufgaben.

Name	Typ	Beschreibung
rel	string	Der Typ des Links.
source	WorkItemReference	Die Arbeitsaufgabe der Quelle.
target	WorkItemReference	Die Zielarbeitsaufgabe.

WorkItemQueryResult

Objekt

Das Ergebnis einer Arbeitsaufgabenabfrage.

Name	Typ	Beschreibung
asOf	string (date-time)	Das Datum, an dem die Abfrage im Kontext ausgeführt wurde.
columns	WorkItemFieldReference[]	Die Spalten der Abfrage.
queryResultType	QueryResultType	Der Ergebnistyp
queryType	QueryType	Der Typ der Abfrage
sortColumns	WorkItemQuerySortColumn[]	Die Sortierspalten der Abfrage.
workItemRelations	WorkItemLink[]	Die von der Abfrage zurückgegebenen Arbeitsaufgabenlinks.
workItems	WorkItemReference[]	Die arbeitsaufgaben, die von der Abfrage zurückgegeben werden.

WorkItemQuerySortColumn

Objekt

Eine Sortierspalte.

Name	Typ	Beschreibung
descending	boolean	Die Richtung, nach der sortiert werden soll.
field	WorkItemFieldReference	Ein Arbeitselementfeld.

WorkItemReference

Objekt

Enthält einen Verweis auf eine Arbeitsaufgabe.

Name	Typ	Beschreibung
id	integer (int32)	Arbeitselement-ID.
url	string	REST-API-URL der Ressource

Freigeben über

Wiql - Query By Id

URI-Parameter

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Beispielanforderung

Beispiel für eine Antwort

Definitionen

QueryResultType

QueryType

WorkItemFieldReference

WorkItemLink

WorkItemQueryResult

WorkItemQuerySortColumn

WorkItemReference

Zusätzliche Ressourcen