Queries - Search Queries

Reference

Service:: Work Item Tracking

API Version:: 5.0

Prohledá všechny dotazy, ke které má uživatel přístup v aktuálním projektu.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&api-version=5.0

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&$top={$top}&$expand={$expand}&$includeDeleted={$includeDeleted}&api-version=5.0

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
$filter	query	True	string	Text, pomocí který chcete filtrovat dotazy.
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na hodnotu 5.0.
$expand	query		QueryExpand
$includeDeleted	query		boolean	Zahrnutí odstraněných dotazů a složek
$top	query		integer int32	Počet dotazů, které se mají vrátit (výchozí hodnota je 50 a maximum je 200).

Odpovědi

Name	Typ	Description
200 OK	QueryHierarchyItemsResult	úspěšná operace

Zabezpečení

oauth2

Type: oauth2
Flow: accessCode
Authorization 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

Scopes

Name	Description
vso.work	Umožňuje číst pracovní položky, dotazy, panely, cesty oblastí a iterací a další metadata související se sledováním pracovních položek. Poskytuje také možnost spouštět dotazy, vyhledávat pracovní položky a přijímat oznámení o událostech pracovních položek prostřednictvím volání služeb.

Definice

Name	Description
IdentityReference	Popisuje odkaz na identitu.
LinkQueryMode	Režim dotazu odkazu.
LogicalOperation	Logický operátor oddělující podmínku klauzule
QueryExpand	Rozbalit parametry pro dotazy. Možné možnosti jsou { None, Wiql, Clauses, All, Minimal }
QueryHierarchyItem	Představuje položku v hierarchii dotazů pracovní položky. Může se jednat o dotaz nebo složku.
QueryHierarchyItemsResult
QueryRecursionOption	Možnost rekurze pro použití ve stromovém dotazu.
QueryType	Typ dotazu.
ReferenceLinks	Třída představující kolekci odkazů REST.
WorkItemFieldOperation	Popisuje operaci pole pracovní položky.
WorkItemFieldReference	Odkaz na pole v pracovní položce
WorkItemQueryClause	Představuje klauzuli v dotazu pracovní položky. Zobrazí strukturu dotazu na pracovní položky.
WorkItemQuerySortColumn	Sloupec řazení.

IdentityReference

Popisuje odkaz na identitu.

Name	Typ	Description
_links	ReferenceLinks	Toto pole neobsahuje žádný nebo více zajímavých odkazů na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.
descriptor	string	Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.
directoryAlias	string
displayName	string	Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
name	string	Starší vlastnost back-compat. Jedná se o hodnotu specifickou pro WIT z konstant. Bude na klientovi skryté (ale existuje), pokud cílí na nejnovější verzi.
profileUrl	string
uniqueName	string
url	string	Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

LinkQueryMode

Režim dotazu odkazu.

Name	Typ	Description
linksOneHopDoesNotContain	string	Vrátí pracovní položky, které vyhovují zdroji, pouze pokud žádná propojená pracovní položka nesplňuje kritéria propojení a cíle.
linksOneHopMayContain	string	Vrátí pracovní položky, které splňují kritéria zdroje a propojení, i když žádná propojená pracovní položka nesplňuje cílová kritéria.
linksOneHopMustContain	string	Vrátí pracovní položky, u kterých jsou splněna všechna kritéria zdroje, cíle a odkazu.
linksRecursiveDoesNotContain	string
linksRecursiveMayContain	string	Vrátí pracovní položky hierarchii pracovních položek, které ve výchozím nastavení vyhovují zdroji.
linksRecursiveMustContain	string
workItems	string

LogicalOperation

Logický operátor oddělující podmínku klauzule

Name	Typ	Description
aND	string
nONE	string
oR	string

QueryExpand

Rozbalit parametry pro dotazy. Možné možnosti jsou { None, Wiql, Clauses, All, Minimal }

Name	Typ	Description
all	string	Rozbalí všechny vlastnosti.
clauses	string	Rozbalí sloupce, odkazy, informace o změnách, text a klauzule WIQL.
minimal	string	Zobrazí minimální vlastnosti a text JAZYKa WIQL.
none	string	Rozbalí sloupce, odkazy a informace o změnách.
wiql	string	Rozbalí sloupce, odkazy, informace o změnách a text WIQL.

QueryHierarchyItem

Představuje položku v hierarchii dotazů pracovní položky. Může se jednat o dotaz nebo složku.

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST.
children	QueryHierarchyItem[]	Podřízené položky dotazů ve složce dotazů.
clauses	WorkItemQueryClause	Klauzule pro plochý dotaz.
columns	WorkItemFieldReference[]	Sloupce dotazu
createdBy	IdentityReference	Identita, která vytvořila položku dotazu.
createdDate	string	Kdy byla vytvořena položka dotazu.
filterOptions	LinkQueryMode	Režim dotazu odkazu.
hasChildren	boolean	Pokud se jedná o složku dotazů, označuje, jestli obsahuje nějaké podřízené položky.
id	string	ID položky dotazu.
isDeleted	boolean	Označuje, jestli je tato položka dotazu odstraněna. Nastavením této hodnoty na false u odstraněné položky dotazu se zruší odstranění. Zrušením odstranění dotazu nebo složky se nevrátí změny oprávnění, které se na dotaz nebo složku dříve použily.
isFolder	boolean	Určuje, jestli se jedná o složku dotazů nebo dotaz.
isInvalidSyntax	boolean	Označuje, jestli je jazyk WIQL tohoto dotazu neplatný. Příčinou může být neplatná syntaxe nebo neplatná cesta k oblasti nebo iteraci.
isPublic	boolean	Určuje, jestli je tato položka dotazu veřejná nebo soukromá.
lastExecutedBy	IdentityReference	Identita, která dotaz naposledy spustila.
lastExecutedDate	string	Kdy byl dotaz naposledy spuštěn.
lastModifiedBy	IdentityReference	Identita, která naposledy upravila položku dotazu.
lastModifiedDate	string	Kdy byla položka dotazu naposledy změněna.
linkClauses	WorkItemQueryClause	Klauzule dotazu odkazu
name	string	Název položky dotazu.
path	string	Cesta k položce dotazu.
queryRecursionOption	QueryRecursionOption	Možnost rekurze pro použití ve stromovém dotazu.
queryType	QueryType	Typ dotazu.
sortColumns	WorkItemQuerySortColumn[]	Sloupce řazení dotazu
sourceClauses	WorkItemQueryClause	Zdrojové klauzule ve stromovém dotazu nebo dotazu propojení s jedním segmentem směrování.
targetClauses	WorkItemQueryClause	Cílové klauzule ve stromovém dotazu nebo dotazu propojení s jedním segmentem směrování.
url	string
wiql	string	Text dotazu v jazyce WIQL

QueryHierarchyItemsResult

Name	Typ	Description
count	integer	Počet položek.
hasMore	boolean	Označuje, jestli došlo k dosažení limitu maximálního počtu vrácených položek, ale stále existuje více položek.
value	QueryHierarchyItem[]	Seznam položek

QueryRecursionOption

Možnost rekurze pro použití ve stromovém dotazu.

Name	Typ	Description
childFirst	string	Vrátí pracovní položky, které splňují cílová kritéria, i když žádná pracovní položka nesplňuje kritéria zdroje a odkazu.
parentFirst	string	Vrátí pracovní položky, které vyhovují zdroji, i když žádná propojená pracovní položka nesplňuje kritéria cíle a propojení.

QueryType

Typ dotazu.

Name	Typ	Description
flat	string	Získá plochý seznam pracovních položek.
oneHop	string	Získá seznam pracovních položek a jejich přímé odkazy.
tree	string	Získá strom pracovních položek zobrazující jejich hierarchii propojení.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

WorkItemFieldOperation

Popisuje operaci pole pracovní položky.

Name	Typ	Description
name	string	Název operace.
referenceName	string	Referenční název operace.

WorkItemFieldReference

Odkaz na pole v pracovní položce

Name	Typ	Description
name	string	Název pole.
referenceName	string	Název odkazu pole.
url	string	Adresa URL REST prostředku.

WorkItemQueryClause

Představuje klauzuli v dotazu pracovní položky. Zobrazí strukturu dotazu na pracovní položky.

Name	Typ	Description
clauses	WorkItemQueryClause[]	Podřízené klauzule, pokud je aktuální klauzule logickým operátorem
field	WorkItemFieldReference	Pole přidružené k podmínce
fieldValue	WorkItemFieldReference	Pravá strana podmínky při porovnání pole s poli
isFieldValue	boolean	Určuje, jestli se jedná o pole pro porovnání polí.
logicalOperator	LogicalOperation	Logický operátor oddělující podmínku klauzule
operator	WorkItemFieldOperation	Operátor pole
value	string	Pravá strana podmínky při porovnání pole k hodnotě

WorkItemQuerySortColumn

Sloupec řazení.

Name	Typ	Description
descending	boolean	Směr řazení.
field	WorkItemFieldReference	Pole pracovní položky.

Sdílet prostřednictvím