Riferimento all'elemento XML di configurazione del processo

I file di configurazione del processo determinano il layout e la funzionalità seguenti: backlog del prodotto e velocità del team, backlog iterazione, capacità del team e grafici di burn-down, scheda di attività, commenti e suggerimenti delle parti interessate, e Lavoro.È possibile esportare questi file di configurazione, AgileConfiguration e CommonConfiguration, dal progetto team o accedervi dal modello di processo scaricato da Visual Studio Team Foundation Server 2012.Personalizzare il layout delle pagine di backlog modificando le definizioni specificate in AgileConfiguration e personalizzare le aree comuni a diverse funzionalità modificando le definizioni specificate in CommonConfiguration.

Per una panoramica delle funzionalità che è possibile personalizzare, vedere Personalizzare le pagine di backlog e dell'area attività mediante la configurazione del processo.

[!NOTA]

Per informazioni su come un team utilizza le pagine dell'area di attività e backlog, vedere Pianificazione Agile e iterazioni.

In questo argomento

• AgileConfiguration: struttura della sintassi ed elementi

• CommonConfiguration: struttura della sintassi ed elementi

AgileConfiguration: struttura della sintassi ed elementi

Personalizzare la pagina di backlog modificando gli elementi contenuti nell'elemento AgileProjectConfiguration.Per personalizzare la pagina di backlog del prodotto, modificare gli elementi all'interno dell'elemento ProductBacklog e per personalizzare le pagine backlog iterazione, modificare gli elementi contenuti negli elementi IterationBacklog.

Il seguente esempio di XML mostra la struttura del codice che definisce la configurazione del processo Agile contenuta nel file di AgileConfiguration.xml.Questo esempio corrisponde alla sintassi predefinita definita per MSF di Agile Software Development v6.0.

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

Torna all'inizio

Elementi XML per le pagine di backlog

Nella tabella seguente vengono descritti gli elementi figli dell'elemento radice AgileProjectConfiguration.È possibile utilizzare questi elementi per specificare le colonne e i campi che devono essere presenti nella pagina di backlog.

Elemento	Descrizione e sintassi	Note
AddPanel	L'elemento contenitore utilizzato per specificare l'esperienza di "aggiunta rapida", i campi da visualizzare nell'area del pannello quando vengono definiti nuovi elementi di backlog. <AddPanel>     <Fields>        <Field . . . />        . . .    </Fields> </AddPanel>	Necessario.Solo un'istanza. È necessario specificare almeno un elemento Fields. L'esperienza di "aggiunta rapida" è visualizzabile solamente nella pagina di backlog del prodotto in Team Web Access.
Column	Specifica che un campo deve essere visualizzato come una colonna nella pagina di backlog. <Column refname="FieldReferenceName" width="FieldWidth" />	Necessario. Per ogni colonna che si desidera visualizzare nelle pagine che visualizzano un elenco di backlog, è necessario specificare il nome di riferimento di un campo definito per il tipo di elemento di lavoro associato agli elementi di backlog.È necessario specificare un numero intero positivo per la larghezza del campo.
Columns	Specifica una raccolta di elementi Column. <Columns>    <Column . . . />    . . . </Columns>	Necessario.Un'istanza sola per ogni IterationBacklog e per gli elementi padre ProductBacklog. È necessario specificare le colonne che si desidera vengano visualizzate nelle pagine che mostrano il backlog del prodotto o un backlog iterazione.
Field	Specifica che un campo deve essere visualizzato all'interno del pannello della pagina di backlog del prodotto. <Field refname=”FieldReferenceName” />	Necessario.Uno o più elementi contenuti nell'elemento padre Fields. Quando si definisce un elemento di lavoro da aggiungere al backlog, è possibile specificare un valore per i campi elencati nella sezione AddPanel del processo di configurazione. La configurazione predefinita specifica il campo Titolo come unico campo da visualizzare, come illustrato nell'esempio di codice seguente: <AddPanel>    <Fields>       <Field refname="System.Title" />    </Fields> </AddPanel>
Fields	Specifica una raccolta di elementi Field. <Fields> <Field . . . />    . . . </Fields>	Necessario.Un'istanza definita solo per l'elemento padre AddPanel. Specificare i campi che si desidera specificare rapidamente quando si aggiungono elementi al backlog del prodotto.
IterationBacklog	L'elemento contenitore è utilizzato per personalizzare il layout delle pagine che mostrano gli elementi di lavoro assegnati ad un'iterazione specifica. <IterationBacklog workItemCountLimit="MaximumLimit" >    <Columns> . . . </Columns>    . . .  </IterationBacklog >	Necessario.Solo un'istanza. Specificare il numero di colonne, la larghezza delle colonne e i campi che popolano ogni colonna per quelle pagine che mostrano l'elenco degli elementi di backlog assegnati a un'iterazione. Per impostazione predefinita, l'area attività è limitata a un totale di 500 elementi di lavoro.È possibile modificare questo limite specificando un valore per l'attributo workItemCountLimit.
ProductBacklog	L'elemento contenitore utilizzato per personalizzare il layout della pagina che mostra il backlog del prodotto e che contiene un pannello per l'aggiunta di elementi di lavoro al backlog. <ProductBacklog>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </ProductBacklog >	Necessario.Solo un'istanza. Specificare il numero di colonne, la larghezza delle colonne e i campi che popolano ogni colonna per quelle pagine che mostrano l'elenco degli elementi di backlog assegnati a un backlog del prodotto.Il backlog del prodotto mostra tutti gli elementi attivi nel backlog, inclusi quelli assegnati a un'iterazione.

Torna all'inizio

CommonConfiguration: struttura della sintassi ed elementi

Personalizzare l'area attività utilizzando l'elemento CommonProjectConfiguration, che supporta diversi elementi figli.TypeFields specifica il campo utilizzato nei tipi di elementi di lavoro per acquisire informazioni specifiche.Molti degli altri elementi figli, ad esempio, RequirementWorkItems, TaskWorkItemse BugWorkItems specificano il gruppo categoria da associare a questi tipi a cui viene fatto riferimento nelle aree funzionali di configurazione specifiche del processo.

Il seguente esempio di XML mostra la struttura del codice che definisce la configurazione comune del processo contenuta nel file CommonConfiguration.xml file.Questo esempio corrisponde alla sintassi predefinita definita per MSF di Agile Software Development v6.0.

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
  </TypeFields>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

Torna all'inizio

Elementi XML per le situazioni più comuni

Nella tabella seguente vengono descritti gli elementi figli dell'elemento CommonProjectConfiguration.Questi elementi configurano le aree che supportano le pagine che mostrano entrambi in Team Web Access, in Team Explorer e nel form di richiesta di informazioni.

Importante

I valori assegnati a NomeCategoria devono corrispondere a un gruppo di categorie definito per il progetto team.Specificare gruppi di categorie nel file di definizione per le categorie.Per l'ultima versione di Visual Studio ALM, sono state definite cinque nuove categorie.Per ulteriori informazioni, vedere Categorie, configurazione del processo e disabilitare la creazione di tipi specifici di elementi di lavoro.

Elemento	Descrizione e sintassi	Note
BugWorkItems	Specifica la categoria che corrisponde agli elementi di lavoro bug e associa gli stati del flusso di lavoro di elementi di backlog ai metastati. <BugWorkItems category=”CategoryName”>     <States>        <State . . . />        . . .    </States> </BugWorkItems	Necessario.NomeCategoria deve corrispondere a una categoria definita per il progetto team.
DayOfWeek	Specifica un giorno della settimana corrispondente a un giorno non lavorativo. <DayOfWeek>NameOfADay</DayOfWeek>	Elemento figlio obbligatorio di Weekends. I nomi validi corrispondono ai giorni della settimana inglese: Sunday, Monday, Tuesday, Wednesday, Thursday, Fridaye Saturday. Nota È necessario specificare il giorno della settimana in inglese, indipendentemente dal linguaggio installato in Team Foundation Server.
FeedbackResponseWorkItems	Specifica la categoria che corrisponde ai tipi di elemento di lavoro utilizzati per acquisire la risposta di feedback e associa gli stati del flusso di lavoro di questi elementi ai metastati.	Necessario.Non personalizzare. NomeCategoria deve corrispondere a un gruppo di categorie definito per il progetto team.
FeedbackRequestWorkItems	Specifica la categoria che corrisponde ai tipi di elemento di lavoro utilizzati per acquisire la richiesta di feedback e associa gli stati del flusso di lavoro di questi elementi ai metastati.	Necessario.Non personalizzare. NomeCategoria deve corrispondere a un gruppo di categorie definito per il progetto team.Specificare i gruppi di categorie utilizzando il file Categories.xml.
RequirementWorkItems	Specifica la categoria che corrisponde agli elementi di backlog, come ad esempio le storie utente, i requisiti e gli elementi di backlog del prodotto e associa gli stati del flusso di lavoro di elementi di backlog ai metastati. <RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >    <States>       <State . . . />       . . .    </States> </RequirementWorkItems>	Necessario. NomeCategoria deve corrispondere a un gruppo di categorie definito per il progetto team.Specificare i gruppi di categorie utilizzando il file Categories.xml.
State	Assegna lo stato del flusso di lavoro a un metastato.I metastati rappresentano un raggruppamento degli stati del flusso di lavoro che supportano la gestione degli stati del flusso di lavoro nell'area attività o in altri componenti di configurazione del processo. <State type="TypeName" value="ValueName"/>	Necessario. I valori validi per TypeName corrispondono a un valore assegnato a STATE nel flusso di lavoro definiti rispettivamente per i tipi di elementi di lavoro presenti nel gruppo di categorie. I valori validi per NomeValore corrispondono a uno dei seguenti valori enumerati: all'interno del flusso di lavoro definito per i tipi di elementi di lavoro presenti rispettivamente nel gruppo di categorie. Agile: Proposed: Indica gli elementi di lavoro che sono nuovi, non ancora commissionati, o non ancora modificati. InProgress: Indica gli elementi di lavoro che vengono commissionati o su cui si sta lavorando. Complete: Indica gli elementi di lavoro che sono stati implementati. Bug: Oltre ai metastati di agile, include il metastato Resolved che indica i bug che sono stati risolti. Suggerimenti: Requested, Received, Reviewede Declined. Per ulteriori informazioni, vedere Stati del flusso di lavoro, metastati e configurazione del processo.
States	Specifica una raccolta di elementi State che associano gli stati del flusso di lavoro dei tipi di elementi di lavoro ai metastati. <States>    <State . . . />    . . . </States>	Elemento obbligatorio per BugWorkItems, FeedbackResponseWorkItems, FeedbackRequestWorkItems, RequirementWorkItems e gli elementi TaskWorkItems. Gli elementi di State sono utilizzati per assegnare gli stati del flusso di lavoro a metastati.
TaskWorkItems	Specifica la categoria che corrisponde a elementi attività e associa gli stati del flusso di lavoro di attività ai metastati. <TaskWorkItems category="CategoryName">    <States>       <State . . . />       . . .    </States> </TaskWorkItems>	Necessario. NomeCategoria deve corrispondere a un gruppo di categorie definito per il progetto team.Specificare i gruppi di categorie utilizzando il file Categories.xml. Le pagine dell'area e di backlog elencano gli elementi di lavoro che corrispondono ai valori di stato specificati nell'elemento States.
TypeField	Specifica il nome di riferimento di un campo in cui si fa riferimento al valore per supportare un tipo di attività per un'area funzionale supportata.Questo elemento viene specificato nel contenitore TypeFields. <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > È possibile specificare il formato solo quando type="RemainingWork".È possibile specificare qualsiasi stringa di testo per TimeUnitString che si desidera sia visualizzata sulle barre della capacità della pagina di backlog iterazione corrente e nell'area di attività.	Necessario.È necessario specificare i campi che corrispondono ai campi utilizzati nei tipi di elementi di lavoro per acquisire informazioni specifiche. Per le pagine dell'area di attività e di backlog: Activity: utilizzato per supportare la funzionalità capacità-da-attività.Specificare un campo definito per il tipo di attività di elemento di lavoro utilizzato per specificare il tipo di attività da eseguire. Effort: specifica il campo utilizzato per calcolare la velocità del team.Specificare un campo definito per il tipo del backlog dell'elemento di lavoro utilizzato per acquisire il livello di lavoro o la valutazione relativa alla quantità di lavoro che un elemento di backlog richiederà per l'implementazione. Order: specifica il campo utilizzato per definire l'ordinamento degli elementi di backlog nelle pagine del backlog iterazione e nelle pagine dell'area attività.Specificare il campo utilizzato per acquisire la priorità relativa assegnata agli elementi di backlog.Gli elementi di lavoro vengono elencati nella pagina secondo l'ordine crescente come definito dal campo per questo tipo. RemainingWork: specifica il campo utilizzato per calcolare il lavoro rimanente e i grafici di burn-down.Specificare il campo utilizzato per acquisire il numero di ore o di giorni rimanenti per il complemento di un'attività. Il valore specificato per format viene utilizzato nelle pagine di backlog e dell'area attività laddove è riportato il lavoro restante.Quando ad esempio si segnalano capacità-da-attività o capacità del membro del team, o accanto all'intestazione di colonna, gli stati dell'attività nell'area attività. Per TimeUnitString, specificare una stringa di testo che si desidera utilizzare per mostrare il valore temporale, come le ore o i giorni. I valori seguenti, ad esempio, sono tutti validi: format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team: specifica il campo utilizzato per associare le pagine di backlog e dell'area attività ad un team.Questo campo deve mantenere il valore predefinito, System.AreaPath. Per il form di richiesta di informazioni: Nota Non è necessario modificare le assegnazioni predefinite eseguite per i seguenti elementi TypeField.Queste assegnazioni corrispondono ai campi utilizzati per acquisire le informazioni corrispondenti nel tipo di richiesta di feedback dell'elemento di lavoro. ApplicationStartInformation: specifica il campo utilizzato per acquisire il percorso per eseguire l'applicazione. ApplicationLaunchInstructions: specifica il campo utilizzato per acquisire le istruzioni di avvio. ApplicationType: specifica il campo utilizzato per acquisire il tipo di applicazione.I tipi elencati corrispondono ai valori consentiti specificati nella definizione del tipo per la richiesta di informazioni.
TypeFields	Specifica una raccolta di elementi TypeField. <TypeFields>    <TypeField . . . />    . . . </TypeFields>	Necessario. È necessario specificare i tipi di campi a cui si desidera fare riferimento per supportare le funzionalità presenti nel backlog, nell'area attività e al form di richiesta di informazioni.
TypeFieldValue	Specifica il nome di un tipo di applicazione da visualizzare nel form di richiesta di informazioni. <TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>	Necessario.Non personalizzare. Le assegnazioni predefinite corrispondono ai valori consentiti specificati nella definizione di tipo del form di richiesta di informazioni. <TypeFieldValues>    <TypeFieldValue value="Web application" type="WebApp" />    <TypeFieldValue value="Remote machine" type="RemoteMachine" />    <TypeFieldValue value="Client application" type="ClientApp" /> </TypeFieldValues>
TypeFieldValues	Specifica una raccolta di elementi TypeFieldValue. <TypeFieldValues>    <TypeFieldValue . . . />    . . . </TypeFieldValues>	Obbligatorio per l'elemento TypeFieldValue quando type="ApplicationType". È necessario specificare i valori per i tipi di campi che si desidera visualizzare nel form di richiesta di informazioni.
Weekends	Elemento contenitore utilizzato per specificare i giorni non lavorativi. <Weekends>    <DayOfWeek> . . . </DayOfWeek >    . . . </ Weekends >	Opzionale. Specificare i giorni non lavorativi quando si desidera tenere conto di questi nel calcolo della capacità e dei grafici di burn-down.

Torna all'inizio

Vedere anche

Riferimenti

Gestione configurazione del processo witadmin []

Concetti

Aggiornare un progetto team aggiornato per accedere alle nuove funzionalità

Personalizzare le pagine di backlog e dell'area attività mediante la configurazione del processo