Campi, operatori e macro per le query in Azure Boards

Descrizione

Specifica un campo che accetta un valore True/False.

Campo data in cui è possibile specificare una variabile, ad esempio @Today o @Today-1o un valore, ad esempio 01/01/2025. Immettere le date nel modello di data impostato per il profilo personale. (Vedere Impostare le preferenze personali per i dettagli. Per esempi di query, vedere Query by date or @CurrentIteration.

Per le query WIQL, è anche possibile specificare la data nel modello UTC (Coordinated Universal Time). Per altre informazioni, vedere Sintassi per il linguaggio di query dell'elemento di lavoro (WIQL).

Numero reale, ad esempio 0,2 o 3,5. Per esempi di query, vedere Eseguire query in base a campi numerici.

Stringa di caratteri che rappresenta un ID univoco.

Campo formattato personalizzato utilizzato per tenere traccia delle informazioni cronologiche. Questo tipo di dati viene usato solo per supportare il campo Cronologia . Questo campo viene indicizzato automaticamente per la ricerca full-text quando è disponibile la ricerca full-text. Vedere Ricerche full-text e parziali descritte più avanti in questo articolo. Per esempi di query, vedere Cronologia e controllo.

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. Vedere Ricerche full-text e parziali descritte più avanti in questo articolo. Per eseguire query su campi RTF, vedere Eseguire query in base a titoli, ID e campi RTF.

Stringa di testo breve che identifica un'identità utente.

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

Stringhe di testo che supportano descrizioni lunghe, ad esempio il campo Application Start Information .Text strings that support long description, such as the Application Start Information field. Questi campi vengono indicizzati automaticamente per la ricerca full-text, quando è disponibile la ricerca full-text. Vedere Ricerche full-text e parziali descritte più avanti in questo articolo. Per eseguire query su campi di testo normale, vedere Eseguire query in base a titoli, ID e campi RTF.

Campo personalizzato definito per contenere un elenco di selezione di valori decimali.

Campo personalizzato definito per contenere un elenco di selezione di valori Integer.

Campo personalizzato definito per contenere un elenco di selezione di valori di stringa di testo breve (255 caratteri o meno).

Stringa di testo breve che può contenere fino a 255 caratteri Unicode. I campi di testo stringa vengono spesso usati per supportare elenchi a discesa o elenchi a discesa.

Struttura ad albero di diramazione, ad esempio un percorso di area o iterazione. Scegliere un elemento da un elenco di valori validi. Trovare elementi di lavoro uguali a, non uguali a, sotto o meno in una struttura ad albero. È anche possibile usare gli In operatori o Not In per specificare più valori. Definire la struttura ad albero per un progetto, ovvero percorsi di area e percorsi di iterazione, quindi selezionare quelli da associare a un team.

Per altre informazioni sulla creazione di query, vedere Eseguire query in base all'area o al percorso di iterazione o eseguire query in base alla data o all'iterazione corrente.

Restituisce gli elementi di lavoro se il valore nell'elemento di lavoro corrisponde ai criteri elencati

Tipi di dati applicabili

Trova la corrispondenza con il valore nella clausola .

Number, che include Double, GUID, Integer e String, DateTime e TreePath

Non corrisponde al valore nella clausola .

Number, String, DateTime e TreePath

Maggiore del valore nella clausola .

Number, String e DateTime

È minore del valore nella clausola .

Number, String e DateTime

Maggiore o uguale al valore nella clausola .

Number, String e DateTime

È minore o uguale al valore nella clausola .

Number, String e DateTime

Corrisponde al valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato
Controlla se il campo booleano è uguale a un altro campo

Non corrisponde al valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato
Controlla se il campo booleano non è uguale a un altro campo

Maggiore del valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato

È minore del valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato

È maggiore o uguale al valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato

È minore o uguale al valore contenuto nel campo specificato.

Nome di un campo con lo stesso tipo di dati del campo specificato

Contiene una corrispondenza esatta o parziale della stringa di testo all'interno del campo selezionato per il filtro.

Stringa

Non contiene una corrispondenza esatta o parziale della stringa di testo all'interno del campo selezionato per il filtro.

Stringa

Contiene la stringa di testo o le parole esatte all'interno del campo selezionato per il filtro. È anche possibile immettere parole o frasi parziali contenenti il carattere jolly * . La stringa di testo è limitata a 100 caratteri. Per le restrizioni, vedere Ricerca full-text per i requisiti relativi a server e regole di confronto.

Campi di testo lungo indicizzati per la ricerca full-text, che corrispondono a tutti i campi Testo normale e HTML, nonché ai campi Cronologia e Titolo.

Non contiene la stringa di testo o le parole esatte all'interno del campo selezionato per il filtro. La stringa di testo è limitata a 100 caratteri.

Usare questo operatore in combinazione con una clausola con l'operatore Contains Words per includere ed escludere parole chiave specifiche.

Campi di testo indicizzati per la ricerca full-text.

Trova la corrispondenza con qualsiasi valore in un set delimitato. Ad esempio, è possibile trovare elementi di lavoro i cui ID sono 100, 101 e 102 se si specificano tali valori per il campo ID. Separare i valori con il separatore di elenco che corrisponde alle impostazioni internazionali definite per il computer client. Ad esempio, è possibile usare una virgola ,.

Number, String, DateTime, TreePath

Elenca gli elementi di lavoro che contengono un campo HTML vuoto. Non si specifica un valore con questo operatore. Questo operatore è supportato per Azure Boards e Azure DevOps Server.

HTML

Elenca gli elementi di lavoro che contengono contenuto nel campo HTML. Non si specifica un valore con questo operatore. Questo operatore è supportato per Azure Boards e Azure DevOps Server.

HTML

Non corrisponde ad alcun valore in un set delimitato. È possibile escludere gli elementi di lavoro i cui stati non sono risolti, completati o chiusi dai risultati della query se si specificano tali valori per il campo Stato. Separare i valori con il separatore di elenco che corrisponde alle impostazioni internazionali definite per il computer client. Ad esempio, è possibile usare una virgola ,.

L'operatore Not In è supportato per Azure Boards e Azure DevOps Server.

Number, String, DateTime, TreePath

Corrisponde a un valore membro del gruppo nella clausola . I gruppi corrispondono al nome di un team, di un gruppo di sicurezza o di una categoria di rilevamento del lavoro. Ad esempio, è possibile creare una query per trovare tutti gli elementi di lavoro assegnati ai membri del gruppo Collaboratori o a un team. I gruppi di team vengono creati quando si crea un team. Il nome dei gruppi di team segue il modello [Nome progetto team]\Nome team.

Per le query di esempio, vedere Eseguire query in base all'assegnazione o alle modifiche del flusso di lavoro.

Stringa che corrisponde al nome di un team, di un gruppo di sicurezza o di una categoria definita nel sistema.

Per informazioni, vedere Usare le categorie per raggruppare i tipi di elementi di lavoro.

Non corrisponde a un valore membro del gruppo nella clausola .

Stringa che corrisponde al nome di un gruppo di utenti in Azure DevOps Server o a un gruppo di categorie definito per un progetto.

Non corrisponde al valore nella clausola e non è contenuto nel nodo nella clausola .

TreePath

Trova la corrispondenza con il valore nella clausola o è contenuto nel nodo nella clausola .

TreePath

Trova la corrispondenza con il valore nella clausola in qualsiasi punto precedente.

String , DateTime

Descrizione

Usare con i campi Tipo elemento di lavoro o Stato per eseguire la ricerca in tutti i tipi di elemento di lavoro o in tutti gli stati. Ad esempio, non inserisce Work Item Type=[Any] filtri in base al tipo di elemento di lavoro.

Usare con il campo Percorso iterazione per filtrare automaticamente gli elementi di lavoro assegnati allo sprint corrente in base al contesto o all'attenzione del team corrente. Per esempi specifici, vedere Eseguire query in base alla data o all'iterazione corrente.
La macro @CurrentIteration funziona solo quando viene eseguita dal portale Web. Non è possibile usare la macro durante la copia o la clonazione di gruppi di test e test case, la definizione di avvisi o le API REST.

Usare con il campo Percorso iterazione per filtrare il set di elementi di lavoro assegnati allo sprint corrente +/- n sprint in base al contesto o allo stato attivo del team corrente. Per esempi specifici, vedere Eseguire query in base alla data o all'iterazione corrente.
La macro @CurrentIteration +/- n è supportata per Azure Boards, Azure DevOps Server quando viene eseguito dal portale Web.

Usare con il campo ID e l'operatore In per elencare tutti gli elementi di lavoro che si stanno seguendo nel progetto. Per altre informazioni, vedere Seguire un elemento di lavoro o una richiesta pull. È possibile visualizzare lo stesso elenco dalla pagina Elementi di lavoro, visualizzazione pivot seguente.
La macro @Follows è supportata solo quando viene eseguita dal portale Web.

Usare con un campo identità o account utente per cercare automaticamente gli elementi associati al nome dell'utente o dell'account. Ad esempio, è possibile trovare elementi di lavoro aperti con la clausola Created By=@Me. Per altri esempi, vedere Eseguire query per assegnazione, flusso di lavoro o modifica della scheda.

Usare con il campo ID e l'operatore In per elencare gli elementi di lavoro visualizzati o aggiornati nel progetto negli ultimi 30 giorni. È possibile visualizzare lo stesso elenco dalla pagina Elementi di lavoro, visualizzazione Pivot attività personali.

Usare con il campo Progetto team per filtrare gli elementi di lavoro in altri progetti. Ad esempio, è possibile trovare tutti gli elementi di lavoro nel progetto attualmente selezionato con la clausola Team Project=@Project. Per impostazione predefinita, il sistema applica automaticamente il filtro in base al progetto corrente. Per altre informazioni, vedere Definire una query, Eseguire query tra progetti.

Usare con il campo ID e l'operatore In per elencare gli elementi di lavoro in cui si è menzionati nella sezione Discussione. È possibile visualizzare lo stesso elenco dalla pagina Elementi di lavoro, vista pivot menzionata.

Usare con il campo ID e l'operatore In per elencare gli elementi di lavoro aggiornati di recente. Il numero di elementi di lavoro elencati dipende dall'attività di rilevamento del lavoro del progetto. Per i progetti altamente attivi, la macro elenca gli elementi di lavoro aggiornati nel progetto negli ultimi 30 giorni o così via. Per i progetti meno attivi, tuttavia, questo elenco può includere elementi di lavoro precedenti a 30 giorni. È possibile visualizzare elenchi simili dalla pagina Elementi di lavoro, Recentemente creati, Aggiornati di recente e Visualizzazioni pivot completate di recente. Il numero di elementi di lavoro restituiti è limitato a 5000.

Utilizzare con un DateTime campo per filtrare gli elementi di lavoro correlati alla data corrente o con un offset più/meno. Ad esempio, è possibile trovare tutti gli elementi chiusi nell'ultima settimana con la clausola Closed Date>=@StartOfDay-7. Per altri esempi, vedere Eseguire query in base alla data o all'iterazione corrente.

Utilizzare con un DateTime campo per filtrare gli elementi di lavoro correlati al mese corrente o con un offset più/meno. Ad esempio, è possibile trovare tutti gli elementi creati negli ultimi tre mesi con la clausola Created Date>=@StartOfMonth-3. Per altri esempi, vedere Eseguire query in base alla data o all'iterazione corrente.

Utilizzare con un DateTime campo per filtrare gli elementi di lavoro correlati alla settimana corrente o con un offset più/meno. Ad esempio, è possibile trovare tutti gli elementi modificati nelle ultime due settimane con la clausola Changed Date>=@StartOfWeek-2. Per altri esempi, vedere Eseguire query in base alla data o all'iterazione corrente.

Utilizzare con un DateTime campo per filtrare gli elementi di lavoro correlati all'anno corrente o con un offset più/meno. Ad esempio, è possibile trovare tutte le funzionalità con una data di destinazione pianificata nell'anno corrente con la clausola Target Date>=@StartOfYear. Per altri esempi, vedere Eseguire query in base alla data o all'iterazione corrente.

Usare solo con il campo Percorso area per filtrare gli elementi di lavoro il cui percorso di area corrisponde a uno assegnato a un team specifico. Richiede l'uso dell'operatore = . Ad esempio, è possibile trovare tutti gli elementi assegnati ai percorsi di area assegnati al team Web con la clausola Area Path=@TeamAreas [Fabrikam Fiber]\Web. Per altri esempi, vedere Eseguire query in base all'area o al percorso di iterazione.
La macro @TeamAreas è supportata per Azure DevOps Server solo quando viene eseguita dal portale Web.

Utilizzare con un DateTime campo per filtrare gli elementi di lavoro correlati alla data corrente o a una data precedente. È anche possibile modificare la macro @Today sottraendo giorni. Ad esempio, è possibile trovare tutti gli elementi creati nell'ultima settimana con la clausola Created Date>=@Today-7. Per altri esempi, vedere Eseguire query in base alla data o all'iterazione corrente.