Queries - Create

Referenz

Dienst:: Work Item Tracking

API-Version:: 7.1

Erstellt eine Abfrage oder verschiebt eine Abfrage.

Weitere Informationen zur WiQL-Syntax (Work Item Query Language) hier.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?api-version=7.1

Mit optionalen Parametern:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?validateWiqlOnly={validateWiqlOnly}&api-version=7.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
query	path	True	string	Die übergeordnete ID oder der Pfad, unter der die Abfrage erstellt werden soll.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
validateWiqlOnly	query		boolean	Wenn Sie Ihre WIQL-Abfrage nur überprüfen möchten, ohne tatsächlich eine Abfrage zu erstellen, legen Sie sie auf "true" fest. Der Standardwert ist "false".

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
children	QueryHierarchyItem[]	Die untergeordneten Abfrageelemente in einem Abfrageordner.
clauses	WorkItemQueryClause	Die Klauseln für eine flache Abfrage.
columns	WorkItemFieldReference[]	Die Spalten der Abfrage.
createdBy	IdentityReference	Die Identität, die das Abfrageelement erstellt hat.
createdDate	string (date-time)	Beim Erstellen des Abfrageelements.
filterOptions	LinkQueryMode	Der Verknüpfungsabfragemodus.
hasChildren	boolean	Wenn es sich um einen Abfrageordner handelt, wird angegeben, ob er untergeordnete Elemente enthält.
id	string (uuid)	Die ID des Abfrageelements.
isDeleted	boolean	Gibt an, ob dieses Abfrageelement gelöscht wird. Durch Festlegen dieses Werts auf "false" für ein gelöschtes Abfrageelement wird es rückgängig gemacht. Durch das Rückgängigmachen einer Abfrage oder eines Ordners werden die Zuvor angewendeten Berechtigungsänderungen nicht zurückgesetzt.
isFolder	boolean	Gibt an, ob es sich um einen Abfrageordner oder eine Abfrage handelt.
isInvalidSyntax	boolean	Gibt an, ob die WIQL dieser Abfrage ungültig ist. Dies kann auf ungültige Syntax oder einen nicht mehr gültigen Bereichs-/Iterationspfad zurückzuführen sein.
isPublic	boolean	Gibt an, ob dieses Abfrageelement öffentlich oder privat ist.
lastExecutedBy	IdentityReference	Die Identität, die die Abfrage zuletzt ausgeführt hat.
lastExecutedDate	string (date-time)	Wann die Abfrage zuletzt ausgeführt wurde.
lastModifiedBy	IdentityReference	Die Identität, die das Abfrageelement zuletzt geändert hat.
lastModifiedDate	string (date-time)	Zeitpunkt der letzten Änderung des Abfrageelements.
linkClauses	WorkItemQueryClause	Die Verknüpfungsabfrageklausel.
name	string	Der Name des Abfrageelements.
path	string	Der Pfad des Abfrageelements.
queryRecursionOption	QueryRecursionOption	Die Rekursionsoption für die Verwendung in einer Strukturabfrage.
queryType	QueryType	Der Abfragetyp.
sortColumns	WorkItemQuerySortColumn[]	Die Sortierspalten der Abfrage.
sourceClauses	WorkItemQueryClause	Die Quellklauseln in einer Struktur- oder Ein-Hop-Verknüpfungsabfrage.
targetClauses	WorkItemQueryClause	Die Zielklauseln in einer Struktur- oder Ein-Hop-Verknüpfungsabfrage.
url	string
wiql	string	Der WIQL-Text der Abfrage

Antworten

Name	Typ	Beschreibung
200 OK	QueryHierarchyItem	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_write	Gewährt die Möglichkeit, Arbeitsaufgaben und Abfragen zu lesen, zu erstellen und zu aktualisieren, Boardmetadaten zu aktualisieren, Bereiche und Iterationspfade für andere Pfade für die Nachverfolgung verwandter Arbeitsaufgaben zu aktualisieren, Abfragen auszuführen und Benachrichtigungen über Arbeitsaufgabenereignisse über Diensthaken zu erhalten.

Beispiele

Create a folder

Create a query

Move a query or folder

Create a folder

Beispielanforderung

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "name": "Website team",
  "isFolder": true
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website team",
  "path": "Shared Queries/Website team",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:56.323Z",
  "isFolder": true,
  "hasChildren": false,
  "isPublic": true,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/eb5c1e25-9b3e-4416-a833-e500122882c7"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Create a query

Beispielanforderung

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "name": "All Bugs",
  "wiql": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.WorkItemType] = 'Bug' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "id": "342f0f44-4069-46b1-a940-3d0468979ceb",
  "name": "All Bugs",
  "path": "Shared Queries/Website team/All Bugs",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.64Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:56.64Z",
  "queryType": "flat",
  "columns": [
    {
      "referenceName": "System.Id",
      "name": "ID",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
    },
    {
      "referenceName": "System.Title",
      "name": "Title",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
    },
    {
      "referenceName": "System.State",
      "name": "State",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
    }
  ],
  "sortColumns": [
    {
      "field": {
        "referenceName": "Microsoft.VSTS.Common.Priority",
        "name": "Priority",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Priority"
      },
      "descending": false
    },
    {
      "field": {
        "referenceName": "System.CreatedDate",
        "name": "Created Date",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.CreatedDate"
      },
      "descending": true
    }
  ],
  "wiql": "select [System.Id], [System.Title], [System.State] from WorkItems where [System.WorkItemType] = 'Bug' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc",
  "isPublic": true,
  "clauses": {
    "field": {
      "referenceName": "System.WorkItemType",
      "name": "Work Item Type",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
    },
    "operator": {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    "value": "Bug"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "wiql": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/wiql/342f0f44-4069-46b1-a940-3d0468979ceb"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
}

Move a query or folder

Beispielanforderung

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website",
  "path": "My Queries/Website",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:59.407Z",
  "isFolder": true,
  "hasChildren": true,
  "isPublic": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/3c65fbc1-d427-48ce-9091-633dde9e27e2"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Definitionen

Name	Beschreibung
IdentityReference	Beschreibt einen Verweis auf eine Identität.
LinkQueryMode	Der Verknüpfungsabfragemodus.
LogicalOperation	Logischer Operator, der die Bedingungsklausel trennt
QueryHierarchyItem	Stellt ein Element in der Arbeitsaufgabenabfragehierarchie dar. Dies kann eine Abfrage oder ein Ordner sein.
QueryRecursionOption	Die Rekursionsoption für die Verwendung in einer Strukturabfrage.
QueryType	Der Abfragetyp.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
WorkItemFieldOperation	Beschreibt einen Arbeitsaufgabenfeldvorgang.
WorkItemFieldReference	Verweisen auf ein Feld in einer Arbeitsaufgabe
WorkItemQueryClause	Stellt eine Klausel in einer Arbeitsaufgabenabfrage dar. Dies zeigt die Struktur einer Arbeitsaufgabenabfrage an.
WorkItemQuerySortColumn	Eine Sortierspalte.

IdentityReference

Objekt

Beschreibt einen Verweis auf eine Identität.

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.
id	string (uuid)
imageUrl	string	Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"
inactive	boolean	Veraltet – Kann abgerufen werden, indem der Graph-Mitgliedschaftsstatus abgefragt wird, auf den im Eintrag "membershipState" des GraphUser-Wörterbuchs "_links" verwiesen wird.
isAadIdentity	boolean	Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
name	string	Legacy-Back-compat-Eigenschaft. Dies war der WIT-spezifische Wert aus Konstanten. Wird auf dem Client ausgeblendet (aber vorhanden), es sei denn, sie sind auf die neueste Version ausgerichtet.
profileUrl	string	Veraltet – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet
uniqueName	string	Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

LinkQueryMode

Enumeration

Der Verknüpfungsabfragemodus.

Wert	Beschreibung
linksOneHopDoesNotContain	Gibt Arbeitsaufgaben zurück, die der Quelle entsprechen, nur, wenn keine verknüpfte Arbeitsaufgabe die Verknüpfungs- und Zielkriterien erfüllt.
linksOneHopMayContain	Gibt Arbeitsaufgaben zurück, die die Quell- und Verknüpfungskriterien erfüllen, auch wenn keine verknüpfte Arbeitsaufgabe die Zielkriterien erfüllt.
linksOneHopMustContain	Gibt Arbeitsaufgaben zurück, bei denen die Quell-, Ziel- und Verknüpfungskriterien erfüllt sind.
linksRecursiveDoesNotContain
linksRecursiveMayContain	Gibt Arbeitsaufgaben einer Hierarchie von Arbeitsaufgaben zurück, die standardmäßig die Quelle erfüllen
linksRecursiveMustContain
workItems	Gibt eine flache Liste von Arbeitsaufgaben zurück.

LogicalOperation

Enumeration

Logischer Operator, der die Bedingungsklausel trennt

Wert	Beschreibung
and
none
or

QueryHierarchyItem

Objekt

Stellt ein Element in der Arbeitsaufgabenabfragehierarchie dar. Dies kann eine Abfrage oder ein Ordner sein.

Name	Typ	Beschreibung
_links	ReferenceLinks	Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
children	QueryHierarchyItem[]	Die untergeordneten Abfrageelemente in einem Abfrageordner.
clauses	WorkItemQueryClause	Die Klauseln für eine flache Abfrage.
columns	WorkItemFieldReference[]	Die Spalten der Abfrage.
createdBy	IdentityReference	Die Identität, die das Abfrageelement erstellt hat.
createdDate	string (date-time)	Beim Erstellen des Abfrageelements.
filterOptions	LinkQueryMode	Der Verknüpfungsabfragemodus.
hasChildren	boolean	Wenn es sich um einen Abfrageordner handelt, wird angegeben, ob er untergeordnete Elemente enthält.
id	string (uuid)	Die ID des Abfrageelements.
isDeleted	boolean	Gibt an, ob dieses Abfrageelement gelöscht wird. Durch Festlegen dieses Werts auf "false" für ein gelöschtes Abfrageelement wird es rückgängig gemacht. Durch das Rückgängigmachen einer Abfrage oder eines Ordners werden die Zuvor angewendeten Berechtigungsänderungen nicht zurückgesetzt.
isFolder	boolean	Gibt an, ob es sich um einen Abfrageordner oder eine Abfrage handelt.
isInvalidSyntax	boolean	Gibt an, ob die WIQL dieser Abfrage ungültig ist. Dies kann auf ungültige Syntax oder einen nicht mehr gültigen Bereichs-/Iterationspfad zurückzuführen sein.
isPublic	boolean	Gibt an, ob dieses Abfrageelement öffentlich oder privat ist.
lastExecutedBy	IdentityReference	Die Identität, die die Abfrage zuletzt ausgeführt hat.
lastExecutedDate	string (date-time)	Wann die Abfrage zuletzt ausgeführt wurde.
lastModifiedBy	IdentityReference	Die Identität, die das Abfrageelement zuletzt geändert hat.
lastModifiedDate	string (date-time)	Zeitpunkt der letzten Änderung des Abfrageelements.
linkClauses	WorkItemQueryClause	Die Verknüpfungsabfrageklausel.
name	string	Der Name des Abfrageelements.
path	string	Der Pfad des Abfrageelements.
queryRecursionOption	QueryRecursionOption	Die Rekursionsoption für die Verwendung in einer Strukturabfrage.
queryType	QueryType	Der Abfragetyp.
sortColumns	WorkItemQuerySortColumn[]	Die Sortierspalten der Abfrage.
sourceClauses	WorkItemQueryClause	Die Quellklauseln in einer Struktur- oder Ein-Hop-Verknüpfungsabfrage.
targetClauses	WorkItemQueryClause	Die Zielklauseln in einer Struktur- oder Ein-Hop-Verknüpfungsabfrage.
url	string
wiql	string	Der WIQL-Text der Abfrage

QueryRecursionOption

Enumeration

Die Rekursionsoption für die Verwendung in einer Strukturabfrage.

Wert	Beschreibung
childFirst	Gibt Arbeitsaufgaben zurück, die den Zielkriterien entsprechen, auch wenn keine Arbeitsaufgabe die Quell- und Verknüpfungskriterien erfüllt.
parentFirst	Gibt Arbeitsaufgaben zurück, die der Quelle entsprechen, auch wenn keine verknüpfte Arbeitsaufgabe die Ziel- und Verknüpfungskriterien erfüllt.

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.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

WorkItemFieldOperation

Objekt

Beschreibt einen Arbeitsaufgabenfeldvorgang.

Name	Typ	Beschreibung
name	string	Anzeigename des Vorgangs.
referenceName	string	Verweisname des Vorgangs.

WorkItemFieldReference

Objekt

Verweisen auf ein Feld in einer Arbeitsaufgabe

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

WorkItemQueryClause

Objekt

Stellt eine Klausel in einer Arbeitsaufgabenabfrage dar. Dies zeigt die Struktur einer Arbeitsaufgabenabfrage an.

Name	Typ	Beschreibung
clauses	WorkItemQueryClause[]	Untergeordnete Klauseln, wenn die aktuelle Klausel ein logischer Operator ist
field	WorkItemFieldReference	Feld, das der Bedingung zugeordnet ist
fieldValue	WorkItemFieldReference	Rechte Seite der Bedingung, wenn ein Feld zum Feldvergleich
isFieldValue	boolean	Bestimmt, ob es sich um ein Feld zum Feldvergleich handelt.
logicalOperator	LogicalOperation	Logischer Operator, der die Bedingungsklausel trennt
operator	WorkItemFieldOperation	Der Feldoperator
value	string	Rechte Seite der Bedingung, wenn ein Feld zum Wertvergleich

WorkItemQuerySortColumn

Objekt

Eine Sortierspalte.

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

Freigeben über

Queries - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Create a folder

Beispielanforderung

Beispiel für eine Antwort

Create a query

Beispielanforderung

Beispiel für eine Antwort

Move a query or folder

Beispielanforderung

Beispiel für eine Antwort

Definitionen

IdentityReference

LinkQueryMode

LogicalOperation

QueryHierarchyItem

QueryRecursionOption

QueryType

ReferenceLinks

WorkItemFieldOperation

WorkItemFieldReference

WorkItemQueryClause

WorkItemQuerySortColumn