Visualizzare, eseguire o inviare un messaggio di posta elettronica a una query dell'elemento di lavoro

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

Visual Studio 2019 | Visual Studio 2022

Per trovare gli elementi di lavoro assegnati all'utente o al team, eseguire una query. Molte query sugli elementi di lavoro sono predefinite con il processo. I membri del team potrebbero aver creato query condivise che è possibile visualizzare ed eseguire. Spesso è più semplice definire una nuova query basandosi sulla definizione di query già disponibile.

Prerequisiti

  • È necessario avere accesso agli stakeholder per visualizzare ed eseguire query condivise. Per impostazione predefinita, tutti i membri del progetto hanno accesso a Stakeholder. Per altre informazioni, vedere Modificare le autorizzazioni per una query o una cartella condivisa.
  • Per aggiungere e salvare una query condivisa, è necessario disporre dell'accesso Basic o superiore.
  • È necessario disporre dell'autorizzazione Collaborazione impostata su Consenti per la cartella a cui si vuole aggiungere una query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione.

Nota

Gli utenti con accesso stakeholder per un progetto pubblico hanno accesso completo alle funzionalità di query esattamente come gli utenti con accesso di base . Per altre informazioni, vedere Informazioni di riferimento rapido sull'accesso di tipo Stakeholder.

  • Per impostazione predefinita, tutti i membri e gli utenti del progetto con accesso stakeholder possono visualizzare ed eseguire tutte le query condivise. È possibile modificare il set di autorizzazioni per una cartella di query condivisa o una query condivisa. Per altre informazioni, vedere Impostare le autorizzazioni di query.
  • Per aggiungere e salvare una query in Query condivise, è necessario concedere l'accesso basic o superiore. Inoltre, è necessario disporre dell'autorizzazione Collaborazione impostata su Consenti per la cartella a cui si vuole aggiungere la query. Per impostazione predefinita, il gruppo Collaboratori non dispone di questa autorizzazione.

Aprire query

Dal Web browser, (1) verificare di aver selezionato il progetto corretto, (2) scegliere Query boards> e quindi (3) scegliere Tutto.

Aprire le query boards>, spostamento verticale

Se è la prima volta che si apre Query, la pagina viene aperta su Preferiti. Questa pagina elenca le query indicate come preferite. In caso contrario, è possibile scegliere Tutto per visualizzare tutte le query definite e condivise definite per il progetto.

Suggerimento

Le query che l'utente o il team hanno scelto come preferiti sono visualizzati nella pagina Preferiti . Anche le query preferite insieme ad altri oggetti vengono visualizzate nella pagina Progetto . Per altre informazioni, vedere Impostare i preferiti personali o dei team.

Eseguire una query in Azure Boards

Per eseguire qualsiasi query, espandere una cartella e scegliere il titolo della query. Verrà visualizzata la visualizzazione per visualizzare i risultati della query.

È anche possibile eseguire una query usando l'interfaccia della riga di comando di Azure DevOps.

Suggerimento

La pagina Query , come con altre pagine del portale Web, ricorda la visualizzazione a cui è stata eseguita l'ultima volta e restituisce tale visualizzazione.

  1. Scegliere Tutto per aprire la pagina in cui è possibile visualizzare tutte le query definite o condivise all'interno del progetto.

    Portale Web, scegliere Boards Querys All page (Tutte le query sulle bacheche>)>

  2. Scegliere Query personali in base alle esigenze.

    • Per visualizzare tutti gli elementi di lavoro assegnati all'utente, scegliere Assegnato a me. Questa query usa la macro @Me per elencare tutti gli elementi di lavoro assegnati.
    • Per visualizzare tutti gli elementi di lavoro che si stanno seguendo, scegliere Elementi di lavoro seguiti. Questa query usa la macro @Follows (ID in @Follows) per elencare tutti gli elementi di lavoro che si è scelto di seguire). Per altre informazioni, vedere Seguire un elemento di lavoro o una richiesta pull.
  3. Scegliere Query condivise per espandere la cartella e accedere alle query salvate come query condivise.

  4. Scegliere una cartella all'interno di un percorso di navigazione per aprire una cartella di query.

    Screenshot dell'esempio di navigazione delle query.

Eseguire una query dalla riga di comando

È possibile eseguire una query nell'interfaccia della riga di comando con il comando az boards query . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

Parametri

  • id: ID di una query esistente. Obbligatorio a meno che non venga specificato --path o-wiql.
  • wiql: query nel formato del linguaggio di query dell'elemento di lavoro. Se si specifica if--id o-path viene ignorato.
  • path: percorso di una query esistente. Viene specificato if-id ignorato.
  • org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.
  • project: nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o prelevato tramite git config.

Esempio

Il comando seguente esegue una query con l'ID specificato e mostra il risultato in formato tabella.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

Il comando seguente esegue una query con WIQL specificato e mostra il risultato in formato tabella.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Directory di query, cartelle di query e percorsi di navigazione

Nota

Non è possibile aggiungere cartelle ai Preferiti personali o ai Preferiti del team.

La pagina Query contiene una visualizzazione incentrata sulla directory che è possibile filtrare per trovare query specifiche di interesse. Quando si lavora nelle pagine Query , è possibile passare a una sottocartella, una cartella o una pagina.

Percorsi di navigazione delle query

È anche possibile scegliere una query preferita dal menu del selettore oppure scegliere di esplorare tutte le query, che restituisce la pagina Tutte le query .

Screenshot di Query, selettore di query.

Per altre informazioni, vedere Domande frequenti sulle query, Navigazione e cartelle.

Tutte le attività supportate da Tutti e Preferiti

È possibile eseguire la maggior parte delle attività per visualizzare ed eseguire query da ognuna delle pagine dell'elenco delle query, come indicato nella tabella seguente. Solo le query salvate in My Queries (Query personali) e sono state visualizzate come preferite in My Favorites (Preferiti personali). Solo le query salvate in Query condivise possono essere preferite da un team.


Attività
Preferiti
(Browser)
Tutte le date
(Browser)
Work Items
(Team Explorer)
Visualizzare tutte le query preferite, il proprio o un team a cui si appartiene ✔️ ✔️
Visualizzare tutte le query o le query condivise per il progetto corrente ✔️ ✔️
Eseguire una query, aprire il menu di scelta rapida per una query ✔️ ✔️ ✔️
Espandere o comprimere cartelle contenitore o cartelle di query ✔️ ✔️ ✔️
Filtrare l'elenco di query ✔️ ✔️
Preferiti per una query (per il portale Web, scegliere Preferito) ✔️
Annullare la richiesta di una query (per il portale Web scegliere ) ✔️ ✔️ ✔️
Aggiungere una nuova query: scegliere ✔️ ✔️ ✔️

Filtrare l'elenco di query

Immettere una parola chiave nella casella di filtro per filtrare il set di query visualizzate nelle pagine Preferiti o Tutte . Per altre informazioni sul filtro, vedere Filtrare backlog, bacheche, query e piani.

Screenshot che mostra tutte le query nel progetto filtrate in base ai criteri di parola chiave IQ WIT.

Per altre informazioni, vedere Domande frequenti sulle query, Navigazione e cartelle.

Elementi di query di posta elettronica o condividere un URL di query

Dalla visualizzazione Editor di query o Risultati è possibile inviare un messaggio di posta elettronica a un elenco formattato di elementi di query o copiare l'URL della query.

Scegliere l'icona azioni per aprire il menu e selezionare tra le opzioni elencate, Query di posta elettronica o Copia URL query.

Portale Web, Editor di query/Risultati, menu Apri azioni, Scegliere Query di posta elettronica o Copia URL query
È possibile inviare il messaggio di posta elettronica solo a un singolo indirizzo per un membro del progetto riconosciuto dal sistema. L'aggiunta di un gruppo di team o di un gruppo di sicurezza alla riga non è supportata. Se si aggiunge un account di posta elettronica non riconosciuto dal sistema, viene visualizzato un messaggio che informa che uno o più destinatari del messaggio di posta elettronica non dispongono delle autorizzazioni per leggere gli elementi di lavoro inviati tramite posta elettronica.

Nota

Per inviare un messaggio di posta elettronica a un elenco formattato agli utenti che non sono membri del progetto, è necessario usare l'opzione Copia come HTML descritta in Copiare un elenco di elementi di lavoro. Per Azure DevOps locale, tutte le azioni di posta elettronica richiedono la configurazione di un server SMTP. Se non è configurato un server SMTP, è possibile risolvere il problema usando Copia come HTML.

Passaggi successivi