Aggiungere e modificare campi elemento di lavoro per supportare la creazione di rapporti

Articolo
03/05/2013

I campi elemento di lavoro vengono utilizzati per tenere traccia dei dati per un tipo di elemento di lavoro, per definire i criteri di filtro per le query e nell'ambito di rapporti.Qualsiasi campo, a eccezione dei campi di sistema, che si desidera visualizzare in un rapporto, deve essere definito nel file di definizione per i tipi di elementi di lavoro di cui il campo terrà traccia.I campi di sistema vengono definiti automaticamente per ogni tipo di elemento di lavoro.Devono tuttavia essere inclusi nel form elemento di lavoro per supportare l'immissione di dati.

Per supportare la creazione di rapporti, è possibile aggiungere campi o modificare gli attributi dei campi esistenti.Quando si aggiungono o si modificano campi, è necessario applicare le convenzioni sistematiche di denominazione per assicurarsi che i dati vengano raggruppati logicamente in cartelle nel cubo di SQL Server Analysis Services.

In questo argomento

Suggerimenti
Utilizzo di un campo esistente
Elencare i campi definiti per una raccolta di progetti team
Attributi di campi segnalabili
Modificare un attributo segnalabile per un campo
Aggiunta di campi per supportare la creazione di rapporti
Verifica delle modifiche apportate agli attributi di campi segnalabili
Procedure consigliate in caso di assegnazione di nomi di riferimento di creazione rapporti

Per un elenco di campi segnalabili definiti nei modelli di processo predefiniti, vedere Riferimento ai campi segnalabili per ALM di Visual Studio.

Suggerimenti

Prima di aggiungere o modificare un campo, rivedere le procedure consigliate riportate di seguito:

Verificare la possibilità di utilizzare un campo già definito nella raccolta di progetti team che contiene il progetto team.L'utilizzo di un campo esistente supporta la creazione di rapporti tra progetti.
Verificare la possibilità di utilizzare un campo già definito in un'altra raccolta di progetti nella distribuzione di Visual Studio Team Foundation Server. L'utilizzo di un campo esistente supporta la creazione di rapporti tra progetti.
È possibile avere non più di 1.024 campi in ogni raccolta di progetti e non più di 1.024 campi univoci segnalabili in tutte le raccolte di progetti nell'intero ambito di una distribuzione di Team Foundation Server.I campi uniti contano come un solo campo segnalabile.
Istituire una routine standard e un processo di revisione per l'aggiunta e la modifica di campi in modelli di processo, progetti team o raccolte di progetti.
Utilizzare le convenzioni di denominazione sistematiche quando si assegnano etichette ai campi per la creazione di rapporti.Quando si assegnano nomi di riferimento in modo sistematico in tutte le raccolte di progetti team nell'ambito di una distribuzione di Team Foundation Server, è opportuno garantire la presenza di un warehouse e di uno schema del cubo più coerenti e utilizzabili ed evitare conflitti di schema nel warehouse.Per ulteriori informazioni, vedere Risolvere conflitti di schema che si verificano nel data warehouse.

È possibile assegnare fino a quattro attributi etichetta a un campo elemento di lavoro:

[!NOTA]

Ai campi definiti nei modelli di processo per Microsoft Solutions Framework non viene assegnato alcun nome di rapporto o nome di riferimento di rapporto.Per impostazione predefinita, vengono utilizzati il nome di riferimento e gli attributi del nome.
- name.Il nome descrittivo del campo visualizzato nei menu a discesa di query elemento di lavoro.Il nome descrittivo deve essere univoco per tutti i campi definiti in un progetto team.Il nome descrittivo inoltre può essere diverso dall'etichetta visualizzata e assegnata al campo. in un form elemento di lavoro.Per ulteriori informazioni, vedere Riferimento all'elemento XML Control.
- refname.L'etichetta univoca assegnata al campo che lo distingue da tutti gli altri campi definiti nella raccolta di progetti team.Il valore assegnato a refname non può essere modificato.
  
  Per i requisiti e le limitazioni relativi ai nomi descrittivi e ai nomi di riferimento per i campi, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.
- reportingname.Attributo facoltativo.Nome utilizzato per identificare un campo nei rapporti.Se non impostato in modo esplicito, viene utilizzato il valore assegnato all'attributo name.
- reportingrefname.Attributo facoltativo.Etichetta univoca assegnata a un campo segnalabile che lo distingue da tutti gli altri campi segnalabili definiti in tutte le raccolte di progetti team.Se non impostato in modo esplicito, viene utilizzato il valore assegnato all'attributo refname.Per le convenzioni di denominazione consigliate, vedere Procedure consigliate per l'assegnazione di nomi di riferimento di creazione rapporti più avanti in questo argomento.
  
  [!NOTA]
  
  I nomi di riferimento di creazione rapporti sono visibili solo da un rapporto di tabella pivot o dal cubo di Analysis Services.

Utilizzo di un campo esistente

È necessario utilizzare un campo già definito, se tale campo corrisponde alle informazioni di cui si desidera tener traccia e creare un rapporto.Per utilizzare un campo esistente, effettuare i passaggi seguenti:

Identificare il campo che si desidera utilizzare.Utilizzare il comando witadmin listfields per identificare i campi e i rispettivi attributi definiti per tutte le raccolte di progetti.Per ulteriori informazioni, vedere Elencare i campi definiti per una raccolta di progetti team più avanti in questo argomento.
Determinare se il campo è segnalabile e se gli attributi segnalabili soddisfano i requisiti di creazione rapporti.
Se non è segnalabile, utilizzare il comando witadmin changefield per modificare l'attributo segnalabile per le raccolte di progetti nei quali viene utilizzato.Per ulteriori informazioni, vedere Modificare un attributo segnalabile per un campo più avanti in questo argomento.
Per la raccolta di progetti in cui non è definito il campo, aggiungerlo ai file di definizione XML per i tipi di elemento di lavoro che si desidera utilizzare per tenere traccia di dati.Per ulteriori informazioni, vedere Aggiungere campi per supportare la creazione di rapporti più avanti in questo argomento.

Elencare i campi definiti per una raccolta di progetti team

È possibile utilizzare il comando witadmin listfields per elencare i campi e i rispettivi attributi.È possibile elencare un campo specifico oppure tutti i campi definiti in una raccolta di progetti.Di seguito è riportata la sintassi del comando witadmin listfields.

witadmin listfields /collection:CollectionURL /n:RefName

Per ulteriori informazioni, vedere Gestire i campi degli elementi di lavoro [witadmin].

Attributi di campi segnalabili

I campi segnalabili dispongono dell'attributo reportable impostato su un valore pari a Detail, Dimensiono Measure.Gli attributi riportati di seguito determinano il modo in cui i campi elemento di lavoro vengono esportati ed elaborati nei database del data warehouse.

reportingtype.Per includere un campo nei rapporti, è necessario assegnare uno dei valori riportati di seguito all'attributo reportable.
- Assegnare Detail per esportare il campo nel database warehouse relazionale ma non nel cubo.Come illustrato nell'esempio seguente, utilizzare il tipo Detail solo per campi di tipo Integer, Double, String o DateTime.
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Assegnare Dimension per esportare il campo sia nel database warehouse relazionale sia nel cubo.Come illustrato nell'esempio seguente, utilizzare il tipo Dimension solo per campi di tipo Integer, Double, String o DateTime.Questo valore è utile per includere i campi utilizzati per filtrare i rapporti (ad esempio, campi che dispongono di elenchi di valori validi).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Assegnare Measure per supportare l'elaborazione di valori precalcolati nel cubo.Utilizzare il tipo Measure solo per i campi Integer e Double.
  
  Quando si assegna il valore Measure per reportingtype, è necessario assegnare il valore sum per formula, come illustrato nell'esempio seguente:
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname.È possibile assegnare un nome di riferimento diverso a un campo contrassegnato come segnalabile.Se non viene specificato alcun valore, verrà utilizzato il valore assegnato all'attributo refname.

È possibile utilizzare questo attributo sia per unire sia per far divergere i campi inclusi nei rapporti.Per unire due campi che dispongono di nomi di riferimento distinti e che sono definiti in differenti raccolte di progetti, assegnare lo stesso valore di reportingrefname a entrambi.Per far divergere due campi che dispongono dello stesso nome di riferimento, ma che sono definiti in differenti raccolte di progetti, assegnare un diverso valore di reportingrefname a ciascun campo.

È necessario unire i campi ogni qualvolta è possibile al fine di minimizzare il numero di campi nel database warehouse e di mantenere il numero al disotto del limite massimo di 1024 campi segnalabili.È possibile generare rapporti tra gruppi con i campi uniti.

reportingname.È possibile assegnare un'etichetta diversa a un campo utilizzato per visualizzare dati nei rapporti.Se non viene specificato alcun valore, verrà utilizzato il nome descrittivo per l'attributo name.Il valore assegnato a reportingname viene visualizzato nel cubo.Il valore assegnato a reportingrefname non viene visualizzato.

Importante
È necessario utilizzare procedure consigliate per assegnare etichette ai campi di creazione rapporti in modo che vengano raggruppati insieme nei rapporti di tabella pivot.Per ulteriori informazioni, vedere Procedure consigliate in caso di assegnazione di nomi di riferimento della creazione di rapporti.

Modificare un attributo segnalabile per un campo elemento di lavoro

È possibile rendere segnalabile un campo esistente modificando le assegnazioni di attributi del campo definite per una raccolta di progetti.Un campo esistente viene definito in una o più definizioni di tipo di elemento di lavoro.È possibile inoltre modificare tutti gli attributi che determinano il modo in cui un campo viene elaborato nei data warehouse.

Per modificare le assegnazioni degli attributi di un campo è possibile utilizzare la procedura riportata di seguito.

È possibile utilizzare il comando witadmin changefield per modificare l'assegnazione di un attributo di un campo.Si utilizza questo comando per una raccolta di progetti team.Utilizzare la seguente sintassi:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Per rendere segnalabile un campo esistente, modificare l'attributo reportingtype.Ad esempio per rendere disponibile il campo AW.Common.TeamPriority per il filtraggio di rapporti, assegnare al campo il valore Dimension:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Per ulteriori informazioni, vedere Gestire i campi degli elementi di lavoro [witadmin].
(Facoltativo) Se si dispone di più di una raccolta di progetti, è necessario apportare modifiche simili al campo elemento di lavoro definito in tale raccolta.Per evitare conflitti di schema quando si esportano e si elaborano dati nei database del data warehouse, è necessario assegnare gli stessi valori a questi attributi per tutte le raccolte:
- Tipo di campo (impossibile modificare il valore di questo campo per un campo esistente).
- Tipo di creazione rapporti.
- Nome del rapporto.
Per ulteriori informazioni, vedere Risolvere conflitti di schema che si verificano nel data warehouse.
Dopo avere apportato tutte le modifiche ai campi elemento di lavoro che si desidera utilizzare per la creazione di rapporti, è necessario elaborare i database del data warehouse.È possibile utilizzare i servizi Web ProcessWarehouse e ProcessAnalysis, disponibili tramite WarehouseControlWebService.

Questo passaggio assicura che chi utilizza i rapporti non veda alcun errore quando vengono modificati gli attributi del campo.

Per ulteriori informazioni, vedere Gestire i campi degli elementi di lavoro [witadmin].

Aggiunta di campi per supportare la creazione di rapporti

È possibile aggiungere campi alla definizione di un tipo o dei tipi di elementi di lavoro.Quando si aggiunge il campo, è necessario aggiungere la stessa definizione di elementi del campo per tutti i tipi di elementi di lavoro per i quali il campo supporterà la creazione di rapporti.Se si desidera che il campo supporti la creazione di rapporti tra progetti, il campo dovrà essere aggiunto a tutti i tipi di elemento di lavoro in tutti i progetti team per i quali verranno crearti rapporti.

Per ulteriori informazioni, vedere Utilizzo dei campi elementi di lavoro.

Verifica delle modifiche apportate agli attributi di campi segnalabili

È possibile verificare le modifiche apportate agli attributi di un campo segnalabile elaborando i data warehouse su richiesta e quindi controllando i rapporti per verificare che siano stati aggiornati.Oppure è possibile attendere fino all'esecuzione dei processi dell'adattatore del warehouse.Per impostazione predefinita, il database relazionale viene elaborato ogni pochi minuti.Tuttavia, per impostazione predefinita, il cubo viene elaborato ogni due ore.

[!NOTA]

Per ulteriori informazioni su WarehouseControlWebService, vedere Manualmente elaborare il data warehouse e il cubo di Analysis Services per Team Foundation Server.

Elaborare il data warehouse relazionale su richiesta tramite ProcessWarehouse WarehouseControlWebService.
Elaborare il cubo su richiesta tramite ProcessAnalysisDatabase WarehouseControlWebService.
Verificare che i rapporti vengano aggiornati.Visualizzare un rapporto tramite il dashboard o Gestione rapporti.Per ulteriori informazioni, vedere Dashboard (Agile) o Rapporti (Agile).

Procedure consigliate in caso di assegnazione di nomi di riferimento di creazione rapporti

Per creare rapporti con nomi di riferimento, è opportuno assegnare le etichette in modo che sia possibile trovare facilmente i campi nel rapporto di tabella pivot e nel cubo.Ciò può essere ottenuto applicando convenzioni di denominazione sistematiche in modo che i campi vengano raggruppati in una sequenza logica.Inoltre, se i campi non sono raggruppati in modo utile, è possibile modificare il nome riferimento per la creazione di rapporti di un campo.

L'applicazione di una convenzione di denominazione sistematica diventa ancora più importante perché tutti i dati segnalabili da tutti i progetti team definiti in tutte le raccolte di progetti vengono scritti in un solo data warehouse relazionale.I dati vengono quindi elaborati da tale warehouse e scritti nel cubo.Poiché i campi elemento di lavoro vengono gestiti distintamente per ogni raccolta di progetti, è possibile applicare etichette diverse che possono generare un set di campi non ben organizzato per supportare la creazione di rapporti.

I campi elemento di lavoro che dispongono di un tipo di dimensione segnalabile corrispondono agli attributi di dimensione nel cubo.Gli attributi di dimensione sono organizzati in cartelle basate sul nome di riferimento di creazione rapporti assegnato nel modello di processo o nella definizione del tipo di elemento di lavoro.Si hanno i seguenti tipi di mapping:

I campi che dispongono del prefisso "System" sono intrinseci e vengono elencati direttamente sotto la dimensione dell'elemento di lavoro, con "Elemento di lavoro" anteposto.
Gli altri campi vengono posti in cartelle i cui nomi corrispondono ai prefissi dei rispettivi nomi di riferimento.Ad esempio, i campi che dispongono del prefisso "Microsoft.VSTS.Common" vengono elencati sotto la cartella con l'etichetta "Microsoft VSTS Common".

Come illustrato nella figura riportata di seguito, viene aggiunta una cartella per ogni gruppo di campi con prefisso che condividono un prefisso comune.

Struttura di cartelle in un cubo dei dati OLAP

Nella tabella seguente vengono elencati i campi i cui nomi di riferimento iniziano con "Sistema" e che sono elencati nel rapporto di tabella pivot con il prefisso "Elemento di lavoro." Questi campi vengono inseriti direttamente sotto la dimensione Elemento di lavoro.Tutti gli altri campi vengono posti in cartelle i cui nomi corrispondono ai prefissi dei rispettivi nomi di riferimento.

[!NOTA]

Le distribuzioni che non utilizzano la versione Enterprise di SQL Server Analysis Services non dispongono di accesso alle funzionalità di conversione fornite da tale versione.In tali distribuzioni, i campi vengono identificati dal nome di riferimento completo nel cubo, con '.' sostituito da '_' (ad esempio, "System_Id" e "System_Title").

Nome nel rapporto di tabella pivot e nel cubo	Nome di riferimento	Tipo di dati
Elemento di lavoro.Percorso area	System.AreaPath	TreeType
Elemento di lavoro.Assegnato a	System.AssignedTo	String
Elemento di lavoro.Modificato da	System.ChangedBy	String
Elemento di lavoro.Data modifica	System.ChangedDate	DateTime
Elemento di lavoro.Creato da	Sistema.Creato da	String
Elemento di lavoro.Data creazione	System.CreatedDate	DateTime
Elemento di lavoro.ID	System.Id	Integer
Elemento di lavoro.Percorso iterazione	System.IterationPath	TreeType
Elemento di lavoro.Stato precedente	Sistema.StatoPrecedente	String
Elemento di lavoro.Motivo	System.Reason	String
Elemento di lavoro.Rev	System.Rev	Integer
Elemento di lavoro.Stato	System.State	String
Elemento di lavoro.Titolo	System.Title	String
Elemento di lavoro.Tipo elemento di lavoro	System.WorkItemType	String

La tabella riportata di seguito elenca i campi visualizzati nel rapporto di tabella pivot nella cartella con l'etichetta "Microsoft.VSTS.Common" sotto la dimensione dell'Elemento di lavoro.Questi campi dispongono di nomi riferimento che iniziano con "Microsoft.VSTS.Common".

Nome nel rapporto di tabella pivot e nel cubo	Nome di riferimento	Tipo di dati
Elemento di lavoro.Attivato da	Microsoft.VSTS.Common.ActivatedBy	String
Elemento di lavoro.Data attivazione	Microsoft.VSTS.Common.ActivatedDate	DateTime
Elemento di lavoro.Chiuso da	Microsoft.VSTS.Common.ClosedBy	String
Elemento di lavoro.Data chiusura	Microsoft.VSTS.Common.ClosedDate	DateTime
Elemento di lavoro.Creato da	Microsoft.VSTS.Common.CreatedBy	String
Elemento di lavoro.Data creazione	Microsoft.VSTS.Common.CreatedDate	DateTime
Elemento di lavoro.Risolto da	Microsoft.VSTS.Common.ResolvedBy	String
Elemento di lavoro.Data risoluzione	Microsoft.VSTS.Common.ResolvedDate	DateTime
Elemento di lavoro.Motivo risoluzione	Microsoft.VSTS.Common.ResolvedReason	String
Elemento di lavoro.Priorità	Microsoft.VSTS.Common.Priority	Integer
Elemento di lavoro.Gravità	Microsoft.VSTS.Common.Severity	String
Elemento di lavoro.Ordine priorità	Microsoft.VSTS.Common.Rank	Double

Vedere anche

Condividi tramite