Condividi tramite


Usare un indice per eseguire query sui dati di riferimento rapido in Azure Boards e Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Usare questo indice per accedere rapidamente alle query di esempio e alle informazioni sull'apertura, la definizione e l'utilizzo delle query. Per informazioni su come usare il Editor di query, vedere Definire una query. Se si ritiene che le query richiedono troppo tempo per restituire i risultati, vedere Definire una query o procedure consigliate.

Query di esempio

È possibile elencare gli elementi di lavoro in base ai criteri seguenti...


Parole chiave, query con caratteri jolly

Query basate su tag

Query di modifica dello stato, del motivo o del flusso di lavoro

Query basate su data e iterazione

Query di conteggio collegamenti e allegati


Attività di query



Operatori e macro supportati per ogni tipo di dati

La tabella seguente indica gli operatori e le macro disponibili per i diversi tipi di dati di campo. Ogni campo è associato a un tipo di dati. È possibile trovare il tipo di dati elencato nelle descrizioni di ogni campo, che è possibile cercare usando l'indice del campo Elemento di lavoro. Gli operatori disponibili per la definizione di una clausola di query dipendono dal tipo di dati del campo selezionato. Per descrizioni più dettagliate di tipi di dati, operatori e macro, vedere Campi di query, operatori e macro.

Nota

Le macro seguenti sono supportate solo dal portale Web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity e @TeamAreas. Le query che contengono queste macro non funzioneranno quando vengono aperte in Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.

Tipo di dati

Descrizione

Operatori e macro supportati

Booleano

Supporta un valore True/False. Esempi di query: eseguire query in base all'assegnazione o alle modifiche del flusso di lavoro.

= , <> , =[Field] , <>[Field]

DateTime

Campo data in cui è possibile specificare una variabile, ad esempio @Today o @Today-1o un valore, ad esempio 1/1/2012. Immettere le date nel modello di data impostato per il profilo personale. Per informazioni dettagliate, vedere Impostare le preferenze personali.

Per esempi di query, vedere Eseguire query per data or@CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Macro: @Today, valido con qualsiasi campo DateTime

Macro aggiuntive supportate in Azure DevOps 2019 Update 1 e versioni successive:
@StartOfDay@StartOfMonth, @StartOfWeek, e @StartOfYear, valido con qualsiasi campo DateTime

Double

Detto anche decimale e include picklistDouble1. Numero reale, ad esempio 0,2 o 3,5.

Esempi di query: eseguire query in base a campi numerici.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

Stringa di caratteri che rappresenta un ID univoco.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Cronologia

Campo formattato personalizzato utilizzato per tenere traccia delle informazioni cronologiche e assegnato solo al campo Cronologia .

Esempi di query: Cronologia e controllo.

Contiene parole, non contiene parole

HTML

Stringhe di testo che supportano descrizioni formattate, ad esempio i campi Descrizione o Passaggi di riproduzione. Questi campi vengono indicizzati automaticamente per la ricerca full-text quando è disponibile la ricerca full-text. Esempi di query: eseguire query in base a titoli, ID e campi RTF.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Identità

Campo Stringa utilizzato per contenere un'identità utente. Esempi di query: eseguire query in base all'assegnazione o alle modifiche del flusso di lavoro.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMacro: @me valida per tutti i campi Identity.

Integer

Include anche picklistInteger1. Intero a 32 bit con segno, ad esempio 0, 1, 2, 34.

Esempi di query: eseguire query in base a campi numerici

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Macro: @Follows, @MyRecentActivity, @RecentMentionse @RecentProjectActivity, valide se usate con il campo ID.

Plaintext

Stringhe di testo a più righe che supportano descrizioni lunghe e vengono indicizzate automaticamente per la ricerca full-text, quando è disponibile la ricerca full-text.
Esempi di query: eseguire query in base a titoli, ID e campi RTF.

Contains Words, Does Not Contain Words, Is EmptyIs Not Empty

Stringa

Include anche picklistString1. Testo breve a riga singola che può contenere fino a 255 caratteri Unicode. I campi stringa supportano il campo Titolo , le elenchi a discesa (menu a discesa), gli account utente, i tag e altri campi.

Esempi di query: eseguire query in base a titoli, ID e campi RTF e Query in base al valore dell'elenco a discesa.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Macro: [Any], valido con il campo @ProjectTipo elemento di lavoro , valido con il campo Progetto team.

TreePath

Tipo di campo che supporta i campi Percorso area e Percorso iterazione. Si definisce la struttura ad albero per un progetto, ovvero percorsi di area e percorsi di iterazione.

Esempi di query: eseguire query per area o percorso di iterazione e Query per data o iterazione corrente.

Under, Not Under, =, <>, InNot In

Macro: @TeamAreas3, valido con campo Percorso area
@CurrentIteration e @CurrentIteration+/- n4 validi con il campo Percorso di iterazione

Nota

  1. I tipi di dati picklist... vengono assegnati solo ai campi personalizzati definiti per un processo ereditato. Il modello di processo ereditato è supportato solo per Azure DevOps Server 2019 e versioni successive.
  2. Gli Is Empty operatori e Is Not Empty sono supportati per Azure DevOps Server 2019 RC2 e versioni successive.
  3. La @TeamAreas macro è supportata per Azure Boards e Azure DevOps Server 2019 e versioni successive.
  4. La @CurrentIteration +/- n macro è supportata per Azure DevOps Server 2019 e versioni successive e solo quando viene eseguita dal portale Web.

Modello di data e ora

Il modello di data e ora immesso per i campi DateTime deve corrispondere a quello selezionato tramite il profilo. Per visualizzare o modificare la selezione, vedere Impostare le preferenze utente.

Screenshot che mostra le opzioni dell'elenco a discesa Modello di data nel riquadro Ora e impostazioni locali.Screenshot che mostra le opzioni dell'elenco a discesa Modello di tempo nel riquadro Ora e impostazioni locali.

Screenshot che mostra il riquadro Ora e impostazioni locali con i campi Modello di data e Ora.

Query di esempio per i campi selezionati

Nella tabella seguente sono elencati i campi di query comuni e il relativo tipo di dati per cui vengono fornite query di esempio. Per determinare il tipo di dati di un campo, vedere Campi e attributi dell'elemento di lavoro, Attributi dei campi elenco.

Un

G

A

D-E-F

H-P

R

S

T

V-W