Campi, operatori e macro per le query in Azure Boards

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

Qui sono disponibili descrizioni dettagliate di ogni tipo di dati di campo, operatori di query e macro di query. Alcuni tipi di dati, operatori e macro sono validi solo per la versione di Azure DevOps indicata.

Per un riferimento rapido alle attività di query e agli operatori e alle macro supportate per ogni tipo di dati, vedere Riferimento rapido alle query. Vedere anche Creare una query o procedure consigliate.

Tipi di dati e valori dei campi di query

Il valore specificato per un campo deve essere conforme al tipo di dati per tale campo. Nella tabella seguente sono elencati i tipi di dati supportati:

Nota

Per il servizio cloud Azure Boards, il tipo di dati corrisponde a quello elencato per il campo nella pagina Campi processo>. Per le distribuzioni locali, il tipo di dati corrisponde all'attributo type assegnato a una FIELD definizione. Per altre informazioni, vedere Campi e attributi di campo dell'elemento di lavoro.

Tipo di dati

Descrizione

Booleano

Specifica un campo che accetta un valore True/False.

DateTime o Date/Time

Campo data in cui è possibile specificare una variabile, ad esempio @Today o @Today-1, o un valore, ad esempio 1/1/2023. 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).

Double o Decimal

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

GUID

Stringa di caratteri che rappresenta un ID univoco.

Cronologia

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.

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. 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.

Identità

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

Integer

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

Campo Testo non crittografato o Testo (multilinea)

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.

picklistDouble¹

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

picklistInteger¹

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

picklistString¹

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

Campo Stringa o Testo (riga singola)

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.

TreePath

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, non uguali, sotto o meno in una struttura ad albero oppure utilizzare gli operatori In o Not In per specificare diversi 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.

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 Services e Azure DevOps Server 2019.

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 per Ora e impostazioni locali.

Operatori di query

È possibile usare gli operatori di query nella tabella seguente per specificare il modo in cui ogni valore in una clausola deve essere correlato al valore corrispondente in un elemento di lavoro. Per informazioni sul tipo di dati assegnato ai campi dell'elemento di lavoro, vedere Informazioni di riferimento sul campo elemento di lavoro.

Per informazioni sull'aggiunta di clausole e sull'uso degli operatori And/Or, vedere Definire una query.

Operatore Query

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

=[Campo]

Corrisponde al valore contenuto nel campo specificato.

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

<>[Campo]

Non corrisponde al valore contenuto nel campo specificato.

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

>[Campo]

Maggiore del valore contenuto nel campo specificato.

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

<[Campo]

È minore del valore contenuto nel campo specificato.

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

>=[Campo]

È maggiore o uguale al valore contenuto nel campo specificato.

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

<=[Campo]

È minore o uguale al valore contenuto nel campo specificato.

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

Contiene

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

Stringa

Non contiene

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

Stringa

Contiene parole

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 parole

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.

Utilizzare 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.

In

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

È vuoto

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 (servizio cloud), Azure DevOps Server 2019 e versioni successive.

HTML

Non è vuoto

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 (servizio cloud), Azure DevOps Server 2019 e versioni successive.

HTML

Non in

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 è disponibile da Azure Boards e TFS 2018.2 e versioni successive.

Number, String, DateTime, TreePath

In gruppo

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.

Nota

È possibile utilizzare l'operatore In Group solo con campi che utilizzano il tipo di dati String o il campo Tipo elemento di lavoro. È anche possibile usare i gruppi definiti in Microsoft Entra ID quando l'account Azure Boards è supportato da Microsoft Entra ID o Active Directory quando l'istanza del server locale è supportata da Active Directory.

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

Non nel gruppo

Non corrisponde a un valore membro del gruppo nella clausola .

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

Nota

È possibile utilizzare l'operatore Not In Group solo con campi che utilizzano il tipo di dati String o il campo Tipo elemento di lavoro. È anche possibile usare i gruppi definiti in Microsoft Entra ID quando l'account Azure Boards è supportato da Microsoft Entra ID o Active Directory quando l'istanza del server locale è supportata da Active Directory.

Non sotto

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

TreePath

Sotto

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

TreePath

È mai stato

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

String , DateTime

Nota

I campi data non sono attualmente supportati quando si usa il Editor di query. Sono supportati solo quando si esegue un WIQL diretto.

Suggerimento

È possibile contsruct una query usando la sintassi WIQL che usa un operatore, ad esempio Was Ever, per altri campi di tipo di dati rispetto a quelli elencati. Ad esempio, è possibile usare Was Ever all'interno di una clausola usando il percorso di iterazione. Per un esempio, vedere Eseguire una query in base alla data o all'iterazione corrente, Elencare gli elementi di lavoro spostati da uno sprint.

Eseguire query su macro o variabili

È possibile usare le macro descritte nella tabella seguente per filtrare le query in base a campi specifici.

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.

---

Macro

Descrizione

---

[Qualsiasi]

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, Work Item Type=[Any] non inserisce filtri in base al tipo di elemento di lavoro.

---

@CurrentIteration

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.

---

@CurrentIteration +/- n

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 2019 e versioni successive e solo quando viene eseguita dal portale Web.

---

@Follows

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 sulla funzionalità Segui, 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.

---

@Me

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 modifiche alla scheda Kanban.

---

^{@MyRecentActivity 1}

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.

---

@Project

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.

---

^{@RecentMentions 1}

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

---

^{@RecentProjectActivity 1}

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 che sono stati 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.

---

^{@StartOfDay 2}

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.

---

^{@StartOfMonth 2}

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.

---

^{@StartOfWeek 2}

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.

---

^{@StartOfYear 2}

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.

---

@TeamAreas

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 2019 e versioni successive e solo quando viene eseguita dal portale Web.

---

@Today

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.

---

Nota

1. Le macro @MyRecentActivity, @RecentMentions e @RecentProjectActivity sono supportate per TFS 2018.2 e versioni successive.
2. Le macro @StartOfDay, @StartOfWeek, @StartOfMonth e @StartOfYear sono supportate per Azure DevOps Server 2019 Update 1 e versioni successive.

Ricerche full-text e parziali di parole

Specificare Contains o Does Not Contain per cercare corrispondenze esatte o parziali di una parola o di una frase. Questi operatori filtrano gli elementi in base all'indice di ricerca full-text creato per i campi long-text. Specificare contiene parole o non contiene parole da cercare in una frase esatta o utilizzare il carattere jolly , *. Questi operatori usano l'indice di ricerca full-text. È possibile usare il carattere jolly solo alla fine di una parola o di una frase parziale.

Per esempi, vedere Query degli elementi di lavoro di esempio e Query per gli elementi di lavoro usando il campo Cronologia.

Nota

Non tutte le distribuzioni supportano ricerche full-text. Ad esempio, SQL Express e SQL Azure, che supportano il servizio cloud, non supportano la ricerca full-text. In questi casi vengono visualizzati solo gli operatori Contains e Does not Contain .

Articoli correlati

• Riferimento rapido alle query
• Informazioni sulle query gestite
• Indice del campo dell'elemento di lavoro
• Sintassi per il linguaggio di query dell'elemento di lavoro (WIQL)

REST API

Per interagire a livello di codice con le query, vedere una delle risorse dell'API REST seguenti:

• Informazioni di riferimento sulle API REST di Azure DevOps Services
• Query
• Linguaggio di query dell'elemento di lavoro
• Recuperare elementi di lavoro con query a livello di codice