Aggiungere query elemento di lavoro a un modello di processo

Grazie all'aggiunta di query di elementi di lavoro al modello di processo, è possibile definire il set iniziale di query team e della struttura delle cartelle di query per un progetto team. Tutti i membri del team utilizzano le query per individuare bug, attività e altri elementi di lavoro su cui devono intervenire.

Le query elemento di lavoro specificano i criteri utilizzati per la generazione di un elenco di elementi di lavoro, ad esempio un elenco di bug attivi o di attività chiuse. I file delle query di elementi di lavoro presentano un'estensione wiq e vengono archiviati nella sottocartella Queries della cartella WorkItem Tracking per i modelli di processo di Microsoft Solutions Framework (MSF).

Importante
I modelli di processo per MSF definiscono diverse query. Per ulteriori informazioni, vedere Query Team (Agile) e Query Team (CMMI). Le definizioni delle query dipendono dai campi e dai tipi di elementi di lavoro nel modello di processo. Anche alcune cartelle di lavoro caricate all'interno del plug-in Portale dipendono dalle definizioni delle query.

È necessario specificare le definizioni delle query da caricare come attività nel plug-in WorkItemTracking. Questa attività può essere necessaria in quanto diversi elementi in un modello di processo potrebbero dipendere da una query. L'attività di caricamento delle query dipende inoltre dal completamento dell'attività che consente di caricare i tipi di elementi di lavoro. È possibile specificare ogni file di query da caricare nell'elemento taskXml.

In questo argomento

• Creazione di un file per una query di elementi di lavoro

• Determinazione di query da caricare

• Riferimento dell'elemento QUERY

Dopo aver creato un progetto team dal modello di processo, sarà possibile aggiungere, rimuovere e modificare le query team mediante l'Editor query. Per ulteriori informazioni, vedere Individuazione di bug, attività e altri elementi di lavoro.

Per informazioni sulla modalità di assegnazione delle autorizzazioni di query a gruppi, vedere Controllo dell'accesso ad aree funzionali. Per informazioni sulla creazione di cartelle query, vedere Definizione e personalizzazione di oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro.

Creazione di un file per una query di elementi di lavoro

Ogni definizione di query deve essere specificata in un file specifico con estensione wiq mediante l'elemento padre WorkItemQuery ed essere conforme allo schema definito nel file wiq.xsd. È possibile scaricare i file di schema per la gestione degli elementi di lavoro dalla seguente pagina del sito Web Microsoft: Modello di processo e schemi di elementi di lavoro di Visual Studio Team Foundation.

Nell'esempio indicato di seguito viene mostrata la struttura di sintassi di livello elevato che definisce una query di elementi di lavoro.

<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
  <Wiql>
      WorkItemQueryLanguage
  </Wiql>
</WorkItemQuery>

Per ulteriori informazioni su come creare una query di elementi di lavoro da aggiungere a un modello di processo, vedere Definire una query elemento di lavoro per aggiungere un modello di processo.

Torna all'inizio

Determinazione di query da caricare

Per includere le query di elementi di lavoro nel modello di processo, creare una o più attività nel file workitems.xml, disponibile nella cartella \WorkItem Tracking all'interno della cartella in cui è stato scaricato il modello di processo. Utilizzare l'elemento Query per specificare il file per la query di elementi di lavoro. Il file XML di seguito specifica ad esempio la query definita nel file ActiveBugs.wiq da caricare e denominata Bug attivi.

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

È possibile aggiungere il set di query da caricare come attività nel plug-in WorkItemTracking.

Nell'esempio indicato di seguito viene illustrato come specificare un'attività per creare una cartella di query denominata Gestione del prodotto e caricarvi una query denominata Tutte le storie utente.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" />
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <QueryFolder name="Product Management" >
            <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         </QueryFolder>
         . . .
      </QUERIES>
   </taskXml>
</task>

Per ulteriori informazioni, vedere Definizione e personalizzazione di oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro.

Torna all'inizio

Elementi QUERY

Nella sintassi indicata di seguito viene illustrata la struttura dell'elemento QUERIES e dei relativi elementi figlio.

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

Nella tabella di seguito vengono descritti gli elementi che è possibile utilizzare per specificare la struttura della cartella di query, le autorizzazioni e le query da caricare. Questi elementi vengono specificati all'interno di un elemento contenitore taskXml nel file di plug-in WorkItemTracking.

Elemento	Sintassi	Descrizione
Permission	<permission allow="ListOfPermissions" identity="GroupName" />	Elemento figlio facoltativo di Query. Consente di specificare le autorizzazioni predefinite assegnate alle query team. Per ulteriori informazioni, vedere Assegnazione di autorizzazioni per le query elemento di lavoro.
Query	<Query name="QueryName" fileName="QueryFilePathName" /> Come indicato nell'esempio di seguito, è possibile caricare la query etichettata "Bug attivi" e definita nel file ActiveBugs.wiq: <Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />	Elemento figlio obbligatorio di QUERIES. Consente di specificare il nome e il percorso del file con estensione wiq che definisce una query da caricare.
QueryFolder	<QueryFolder name="FolderName">    <Query /> </QueryFolder>	Elemento figlio facoltativo di QUERIES. Consente di specificare il nome di una cartella di query.
QUERIES	<QUERIES> . . . </QUERIES>	Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking. Specifica i file di definizione di query da utilizzare per creare query predefinite.

Torna all'inizio

Vedere anche

Concetti

Individuazione di bug, attività e altri elementi di lavoro

Altre risorse

Definizione e personalizzazione di oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro