Personalizzare il file di mapping campi di Microsoft Project

È possibile personalizzare la modalità di mapping dei campi elemento di lavoro definiti in Team Foundation ai campi in Microsoft Project e modificare la modalità di pubblicazione di campi specifici. Microsoft Project include campi predefiniti, ad esempio Nome attività e campi personalizzati. Quando si pubblicano o si aggiornano i dati dell'elemento di lavoro in Microsoft Project, il mapping campi determina quali campi nel database degli elementi di lavoro corrispondono ai campi in Microsoft Project.

Per informazioni sull'uso di Project e TFS per tenere traccia del lavoro, vedere Creare il backlog e le attività tramite Project.

Per modificare i mapping campi per un progetto team, esportare e importare il file di mapping di Microsoft Project mediante lo strumento da riga di comando TFSFieldMapping.

elemento Mapping

Per specificare un mapping tra un campo elemento di lavoro e una colonna del progetto si usa l'elemento Mapping.

Per specificare un mapping tra un campo del tipo di elemento di lavoro e un campo Microsoft Project si usa la seguente sintassi XML. L'elemento Mapping viene quindi usato per specificare un mapping campi.

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly="">
         IfSummaryRefreshOnly=""/>

Attributi

La tabella seguente descrive gli attributi che è possibile usare con l'elemento Mapping.

L'esempio seguente mostra come eseguire il mapping di un campo del tipo di elemento di lavoro che contiene il titolo al campo Microsoft Project del nome dell'attività:

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

La seguente sintassi XML mostra un esempio più complesso di come eseguire il mapping del campo del tipo di elemento di lavoro che contiene la data di inizio al campo Microsoft Project della data di inizio. Poiché il campo viene calcolato, viene specificato di eseguire la pubblicazione ma non l'aggiornamento, in modo da non introdurre errori in seguito agli aggiornamenti di Team Explorer.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

Elemento ReservedField

L'elemento facoltativo ReservedField funziona in modo da supportare i collegamenti gerarchici definiti tra le attività.

Se questo elemento non viene specificato nel mapping, Microsoft Project usa il campo predefinito pjNumber20.

Elemento SyncField

Il campo di sincronizzazione consente di controllare il comportamento di pubblicazione e di aggiornamento di ciascuna attività. Il campo viene visualizzato sotto forma di colonna con il titolo Pubblica e aggiorna quando si usa la visualizzazione Foglio attività di Team System.

È necessario specificare un campo di sincronizzazione nel file di mapping del campo Microsoft Project. Usare la sintassi XML seguente per specificare il campo nel campo di sincronizzazione. Per specificare un campo di sincronizzazione, usare l'elemento SyncField. L'attributo ProjectField deve essere impostato su un campo Office Project valido.

<SyncField ProjectField="" />

Il seguente esempio mostra come specificare pjTaskText25 come campo di sincronizzazione:

<SyncField ProjectField="pjTaskText25" />

Per altre informazioni su come usare il campo di sincronizzazione in Office Project, vedere Pubblicare o aggiornare gli elementi di lavoro in Project [reindirizzato].

Elemento ResourceNameSeparator

È possibile usare ResourceNameSeparator per definire il carattere che distingue i nomi di risorsa che si trovano in una stringa. Gli utenti e le risorse di Team Foundation sono sincronizzati con gli utenti del servizio directory Active Directory. I nomi degli utenti e delle risorse possono includere un delimitatore, ad esempio una virgola, per separare il cognome, il nome e il secondo nome di una risorsa.

Si tratta di un elemento facoltativo. Se questo elemento non è specificato nel mapping, Microsoft Project separa i nomi delle risorse usando i mapping predefiniti definiti nella seguente tabella:

Per specificare un carattere diverso rispetto a quelli elencati nella tabella precedente, è possibile definire ResourceNameSeparator usando la seguente sintassi:

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

Il seguente esempio mostra come specificare il carattere "*" come separatore da usare in Office Project quando il carattere Team Foundation è "-":

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

Tipo di collegamento di gerarchia

Quando si creano attività di riepilogo in Microsoft Project, viene creato un collegamento ad albero tra l'attività di riepilogo, l'attività padre e le attività subordinate o figlio. Office Project usa l'elemento predefinito System.LinkTypes.Hierarchy per creare questi collegamenti.

Tipo di collegamento di dipendenza

Quando si creano collegamenti tra le attività in Microsoft Project, viene creato un collegamento di dipendenza tra le attività. All'attività predecessore viene assegnato un collegamento Predecessore, mentre all'attività successore viene assegnato un collegamento Successore. Si tratta delle designazioni predefinite definite per il tipo di collegamento System.LinkTypes.Dependency.

Mapping di attributi che influiscono sulla pubblicazione e l'aggiornamento

I campi di mapping e i valori del campo Microsoft Project seguenti determinano se un valore di un elemento di lavoro è pubblicato o aggiornato:

• Il valore di Pubblica e Aggiorna per ciascun elemento di lavoro.

• Il valore dell'attributo PublishOnly per uno specifico campo di mapping.

• Il valore di IfSummaryRefreshOnly per uno specifico campo di mapping.

• La classificazione dell'attività come attività di riepilogo o padre.

  Un'attività padre è un'attività che ha almeno un'attività figlio pubblicata in Team Foundation Server.

Per gli elementi di lavoro che non sono attività di riepilogo

La tabella seguente indica se un elemento di lavoro diverso da un'attività di riepilogo o padre è pubblicato o aggiornato in base agli attributi del campo di mapping e specifica l'assegnazione per il valore Pubblica e Aggiorna dell'elemento.

Per gli elementi di lavoro che sono attività di riepilogo

Se vengono soddisfatti i criteri dell'attività di riepilogo e IfSummaryRefreshOnly è true, il valore sostituisce il valore PublishOnly. La tabella seguente indica se un'attività di riepilogo o padre è pubblicata o aggiornata in base all'assegnazione indicata per il valore Pubblica e Aggiorna e gli attributi del campo di mapping.

Vedere anche

Concetti

Riferimento all'elemento tipo di collegamento

Aggiungere o modificare la modalità di mapping dei campi di Project ai campi TFS