Queries - Search Queries
Cerca tutte le query a cui l'utente ha accesso nel progetto corrente
GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$filter={$filter}&$top={$top}&$expand={$expand}&$includeDeleted={$includeDeleted}&api-version=7.1-preview.2
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
organization
|
path | True |
string |
Nome dell'organizzazione di Azure DevOps. |
project
|
path | True |
string |
ID progetto o nome del progetto |
$filter
|
query | True |
string |
Testo con cui filtrare le query. |
api-version
|
query | True |
string |
Versione dell'API da usare. Deve essere impostato su '7.1-preview.2' per usare questa versione dell'API. |
$expand
|
query | |||
$include
|
query |
boolean |
Includere query e cartelle eliminate |
|
$top
|
query |
integer int32 |
Numero di query da restituire (il valore predefinito è 50 e massimo è 200). |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
operazione riuscita |
Sicurezza
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
Nome | Descrizione |
---|---|
vso.work | Concede la possibilità di leggere elementi di lavoro, query, bacheche, percorsi di aree e iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query, cercare elementi di lavoro e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio. |
Definizioni
Nome | Descrizione |
---|---|
Identity |
Descrive un riferimento a un'identità. |
Link |
Modalità di query di collegamento. |
Logical |
Operatore logico che separa la clausola condition |
Query |
Parametri di espansione per le query. Le opzioni possibili sono { None, Wiql, Clauses, All, Minimal } |
Query |
Rappresenta un elemento nella gerarchia di query degli elementi di lavoro. Può trattarsi di una query o di una cartella. |
Query |
|
Query |
Opzione di ricorsione da usare in una query albero. |
Query |
Tipo di query. |
Reference |
Classe per rappresentare una raccolta di collegamenti di riferimento REST. |
Work |
Descrive un'operazione sul campo dell'elemento di lavoro. |
Work |
Riferimento a un campo in un elemento di lavoro |
Work |
Rappresenta una clausola in una query dell'elemento di lavoro. Viene visualizzata la struttura di una query dell'elemento di lavoro. |
Work |
Colonna di ordinamento. |
IdentityReference
Descrive un riferimento a un'identità.
Nome | Tipo | Descrizione |
---|---|---|
_links |
Questo campo contiene zero o più collegamenti interessanti sull'oggetto del grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo oggetto grafico. |
|
descriptor |
string |
Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso oggetto grafico in account e organizzazioni. |
directoryAlias |
string |
Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario "_links" IdentityRef |
displayName |
string |
Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore nel provider di origine. |
id |
string |
|
imageUrl |
string |
Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links" |
inactive |
boolean |
Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza graph a cui si fa riferimento nella voce "membershipState" del dizionario GraphUser "_links" |
isAadIdentity |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType) |
isDeletedInOrigin |
boolean |
|
name |
string |
Proprietà back-compat legacy. Questo è stato il valore specifico WIT di Constants. Verrà nascosto (ma esiste) nel client, a meno che non abbiano come destinazione la versione più recente |
profileUrl |
string |
Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef |
uniqueName |
string |
Deprecato: usare invece Domain+PrincipalName |
url |
string |
Questo URL è la route completa alla risorsa di origine di questo oggetto grafico. |
LinkQueryMode
Modalità di query di collegamento.
Nome | Tipo | Descrizione |
---|---|---|
linksOneHopDoesNotContain |
string |
Restituisce gli elementi di lavoro che soddisfano l'origine, solo se nessun elemento di lavoro collegato soddisfa i criteri di collegamento e di destinazione. |
linksOneHopMayContain |
string |
Restituisce elementi di lavoro che soddisfano i criteri di origine e collegamento, anche se nessun elemento di lavoro collegato soddisfa i criteri di destinazione. |
linksOneHopMustContain |
string |
Restituisce gli elementi di lavoro in cui vengono soddisfatti tutti i criteri di origine, destinazione e collegamento. |
linksRecursiveDoesNotContain |
string |
|
linksRecursiveMayContain |
string |
Restituisce elementi di lavoro una gerarchia di elementi di lavoro che per impostazione predefinita soddisfano l'origine |
linksRecursiveMustContain |
string |
|
workItems |
string |
Restituisce un elenco semplice di elementi di lavoro. |
LogicalOperation
Operatore logico che separa la clausola condition
Nome | Tipo | Descrizione |
---|---|---|
and |
string |
|
none |
string |
|
or |
string |
QueryExpand
Parametri di espansione per le query. Le opzioni possibili sono { None, Wiql, Clauses, All, Minimal }
Nome | Tipo | Descrizione |
---|---|---|
all |
string |
Espande tutte le proprietà |
clauses |
string |
Espande colonne, collegamenti, changeinfo, testo e clausole WIQL |
minimal |
string |
Visualizza le proprietà minime e il testo WIQL |
none |
string |
Espande colonne, collegamenti e ChangeInfo |
wiql |
string |
Espande colonne, collegamenti, changeinfo e testo WIQL |
QueryHierarchyItem
Rappresenta un elemento nella gerarchia di query degli elementi di lavoro. Può trattarsi di una query o di una cartella.
Nome | Tipo | Descrizione |
---|---|---|
_links |
Collegare i riferimenti alle risorse REST correlate. |
|
children |
Elementi di query figlio all'interno di una cartella di query. |
|
clauses |
Clausole per una query flat. |
|
columns |
Colonne della query. |
|
createdBy |
Identità che ha creato l'elemento di query. |
|
createdDate |
string |
Al momento della creazione dell'elemento di query. |
filterOptions |
Modalità di query di collegamento. |
|
hasChildren |
boolean |
Se si tratta di una cartella di query, indica se contiene elementi figlio. |
id |
string |
ID dell'elemento di query. |
isDeleted |
boolean |
Indica se l'elemento di query viene eliminato. Se si imposta su false in un elemento di query eliminato, verrà annullata l'eliminazione. L'annullamento dell'eliminazione di una query o di una cartella non restituirà le modifiche alle autorizzazioni applicate in precedenza. |
isFolder |
boolean |
Indica se si tratta di una cartella di query o di una query. |
isInvalidSyntax |
boolean |
Indica se wiql della query non è valido. Ciò potrebbe essere dovuto a una sintassi non valida o a un percorso di area/iterazione non valido. |
isPublic |
boolean |
Indica se l'elemento di query è pubblico o privato. |
lastExecutedBy |
Identità dell'ultima esecuzione della query. |
|
lastExecutedDate |
string |
Data dell'ultima esecuzione della query. |
lastModifiedBy |
Identità dell'ultima modifica dell'elemento di query. |
|
lastModifiedDate |
string |
Data dell'ultima modifica dell'elemento di query. |
linkClauses |
Clausola di query di collegamento. |
|
name |
string |
Nome dell'elemento di query. |
path |
string |
Percorso dell'elemento di query. |
queryRecursionOption |
Opzione di ricorsione da usare in una query albero. |
|
queryType |
Tipo di query. |
|
sortColumns |
Colonne di ordinamento della query. |
|
sourceClauses |
Clausole di origine in una query di collegamento ad albero o un hop. |
|
targetClauses |
Clausole di destinazione in una query di collegamento ad albero o un hop. |
|
url |
string |
|
wiql |
string |
Testo WIQL della query |
QueryHierarchyItemsResult
Nome | Tipo | Descrizione |
---|---|---|
count |
integer |
Conteggio degli elementi. |
hasMore |
boolean |
Indica se è stato raggiunto il limite massimo di restituzione, ma sono ancora presenti altri elementi |
value |
Elenco di elementi |
QueryRecursionOption
Opzione di ricorsione da usare in una query albero.
Nome | Tipo | Descrizione |
---|---|---|
childFirst |
string |
Restituisce elementi di lavoro che soddisfano i criteri di destinazione, anche se nessun elemento di lavoro soddisfa i criteri di origine e collegamento. |
parentFirst |
string |
Restituisce elementi di lavoro che soddisfano l'origine, anche se nessun elemento di lavoro collegato soddisfa i criteri di destinazione e collegamento. |
QueryType
Tipo di query.
Nome | Tipo | Descrizione |
---|---|---|
flat |
string |
Ottiene un elenco semplice di elementi di lavoro. |
oneHop |
string |
Ottiene un elenco di elementi di lavoro e i relativi collegamenti diretti. |
tree |
string |
Ottiene un albero di elementi di lavoro che mostra la gerarchia dei collegamenti. |
ReferenceLinks
Classe per rappresentare una raccolta di collegamenti di riferimento REST.
Nome | Tipo | Descrizione |
---|---|---|
links |
object |
Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura. |
WorkItemFieldOperation
Descrive un'operazione sul campo dell'elemento di lavoro.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome descrittivo dell'operazione. |
referenceName |
string |
Nome di riferimento dell'operazione. |
WorkItemFieldReference
Riferimento a un campo in un elemento di lavoro
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome descrittivo del campo. |
referenceName |
string |
Nome di riferimento del campo. |
url |
string |
URL REST della risorsa. |
WorkItemQueryClause
Rappresenta una clausola in una query dell'elemento di lavoro. Viene visualizzata la struttura di una query dell'elemento di lavoro.
Nome | Tipo | Descrizione |
---|---|---|
clauses |
Clausole figlio se la clausola corrente è un operatore logico |
|
field |
Campo associato alla condizione |
|
fieldValue |
Lato destro della condizione quando un campo per il confronto tra campi |
|
isFieldValue |
boolean |
Determina se si tratta di un campo per il confronto tra campi |
logicalOperator |
Operatore logico che separa la clausola condition |
|
operator |
Operatore field |
|
value |
string |
Lato destro della condizione quando un campo per il confronto dei valori |
WorkItemQuerySortColumn
Colonna di ordinamento.
Nome | Tipo | Descrizione |
---|---|---|
descending |
boolean |
Direzione in base alla quale eseguire l'ordinamento. |
field |
Campo dell'elemento di lavoro. |