File di mapping campi di Microsoft Project

È possibile personalizzare la modalità con cui per i campi definiti per gli elementi di lavoro in Team Foundation viene eseguito il mapping ai campi presenti in Microsoft Project ed è possibile modificare la modalità di pubblicazione di campi specifici.Nel file di mapping dei campi di Microsoft Project, è possibile definire i mapping tra i campi di Team Foundation e di Microsoft Project.Microsoft Project include campi predefiniti, come Nome attività e campi personalizzati.Quando si pubblicano o si aggiornano i dati degli elementi di lavoro in Microsoft Project, il mapping dei campi determina quali campi del database degli elementi di lavoro corrispondono ai campi presenti in Microsoft Project.

Nel file di mapping, è possibile specificare i campi per ogni progetto team.Per recuperare il file di mapping, è necessario scaricarlo da un progetto team.Dopo aver modificato il file, è possibile caricarlo nel progetto team per applicare le modifiche apportate a tutti gli utenti del progetto team.Vedere Modificare la modalità di mapping dei campi in Microsoft Project.

In questo argomento

• Elemento Mapping

• Elemento ReservedField

• Elemento SyncField

• Elemento ResourceNameSeparator

• Tipo di collegamento gerarchico

• Tipo di collegamento di dipendenza

• Attributi di mapping che influiscono su pubblicazione e aggiornamento

Elemento Mapping

Per specificare un mapping tra un campo dell'elemento di lavoro e una colonna del progetto, è necessario utilizzare l'elemento Mapping.

Utilizzare la sintassi XML riportata di seguito per specificare il mapping tra un campo di un tipo di elemento di lavoro e un campo di Microsoft Project.L'elemento Mapping viene quindi utilizzato per specificare il mapping di un campo.

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

Attributi

Nella tabella riportata di seguito vengono descritti gli attributi che possono essere utilizzati con l'elemento Mapping.

Attributo	Descrizione
WorkItemTrackingFieldReferenceName	Necessario.Specifica il nome di riferimento di un campo in un tipo di elemento di lavoro.
ProjectField	Necessario.Specifica il nome di un campo di Microsoft Project.Specificare i nomi dei campi predefiniti anteponendo il prefisso "pj" al nome, ad esempio pjTaskName per la colonna Task Name.Specificare i campi personalizzati come pjTaskText seguito da un numero, ad esempio pjTaskText11.
ProjectName	Opzionale.Specifica il nome visualizzato come nome della colonna in Microsoft Project.Se questo attributo non viene specificato, viene utilizzato il nome campo del tipo di elemento di lavoro.
ProjectUnits	Opzionale.Specifica il tipo di unità da utilizzare quando si esegue il mapping tra un tipo di campo e Microsoft Project.È possibile specificare i valori seguenti: pjMinute, pjHour, pjDay, pjWeek e pjMonthUnit. Nota È possibile specificare ProjectUnits solo per i campi che specificano la durata del tempo o altre unità di tempo.
PublishOnly	Opzionale.Se impostato su true, indica che il campo è stato pubblicato nel database degli elementi di lavoro, ma non è stato aggiornato.Questo valore viene in genere utilizzato per campi calcolati che non devono essere aggiornati in Team Explorer.Se è impostato su false, indica che il campo è pubblicato e aggiornato.Il valore predefinito è false. Nel file di mapping predefinito, i due campi il cui attributo PublishOnly è impostato su true sono Data di inizio e Data di fine.
IfSummaryRefreshOnly	Opzionale.Se impostato su true, indica che il campo non è mai stato pubblicato nel database degli elementi di lavoro, ma è stato aggiornato dal database degli elementi di lavoro se anche l'attributo seguente è true. La riga relativa al campo corrisponde a un'attività di riepilogo in Office Project. I valori Pubblica e aggiorna dell'attività di riepilogo sono impostati su Yes. L'attività di riepilogo contiene almeno un'attività figlio associata a Team Foundation Server. Qualsiasi aggiornamento o calcolo effettuato da Microsoft Project può sovrascrivere il valore aggiornato dal database degli elementi di lavoro nel piano del progetto. Il valore modificato tuttavia non verrà mai salvato nel database degli elementi di lavoro.Questo attributo viene utilizzato in genere per i campi di riepilogo che, se pubblicati nel database degli elementi di lavoro, condurrebbero a incoerenze tra i dati. Se è impostato su false, indica che il campo può essere sia pubblicato che aggiornato.Se non specificato, il valore predefinito è false. Nota Il valore assegnato all'attributo IfSummaryRefreshOnly sostituisce il valore assegnato all'attributo PublishOnly.Per ulteriori informazioni, vedere Campi che influiscono su pubblicazione e aggiornamento più avanti in questo argomento. Nel file di mapping predefinito, l'attributo IfSummaryRefreshOnly è impostato su true per i campi Stima originale, Lavoro rimanente e Lavoro completato.

Nell'esempio riportato di seguito viene illustrato come eseguire il mapping del campo del tipo di elemento di lavoro contenente il titolo al campo di Microsoft Project relativo al nome attività.

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

Nella sintassi XML riportata di seguito viene illustrato un esempio più complesso del modo per eseguire il mapping del campo del tipo di elemento di lavoro contenente la data di inizio al campo di Microsoft Project relativo alla data di inizio.Perché il campo è calcolato, viene specificato che deve essere pubblicato e non aggiornato in modo da impedire che vengano generati errori con gli aggiornamenti di Team Explorer.

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

[!NOTA]

È consigliabile eseguire il mapping dei campi calcolati di Microsoft Project ai campi di sola lettura di Team Foundation.Ciò consente di evitare confusione in modo che i membri del team non tentino di modificare i campi calcolati.

Torna all'inizio

Elemento ReservedField

L'elemento ReservedField ha lo scopo di supportare i collegamenti gerarchici definiti tra le attività ed è un elemento facoltativo.

Se tale elemento non viene specificato nel mapping, Microsoft Project utilizzerà il campo pjNumber20 predefinito.

Torna all'inizio

Elemento SyncField

Il campo di sincronizzazione consente di controllare il comportamento della pubblicazione e dell'aggiornamento per ogni attività.Il campo viene visualizzato come una colonna con il titolo Pubblica e aggiorna quando si utilizza la visualizzazione Foglio attività di Team System.

È necessario specificare un campo di sincronizzazione nel file di mapping dei campi di Microsoft Project.Utilizzare la sintassi XML seguente per specificare quale campo è il campo di sincronizzazione.Per specificare un campo di sincronizzazione, utilizzare l'elemento SyncField.L'attributo ProjectField deve essere impostato su un campo di Office Project valido.

<SyncField ProjectField="" />

Nell'esempio seguente viene illustrato come specificare pjTaskText25 come campo di sincronizzazione:

<SyncField ProjectField="pjTaskText25" />

Per ulteriori informazioni sull'utilizzo del campo di sincronizzazione in Office Project, vedere Pubblicazione o aggiornamento di elementi di lavoro in Office Project.

Torna all'inizio

Elemento ResourceNameSeparator

È possibile utilizzare ResourceNameSeparator per definire il carattere che distinguerà i nomi di risorsa contenuti in una stringa.Utenti e risorse di Team Foundation sono sincronizzati con gli utenti del servizio directory di Active Directory.I nomi di utenti e risorse possono includere un carattere delimitatore, ad esempio una virgola, per separare il cognome, il nome e l'iniziale del secondo nome di una risorsa.

Si tratta di un elemento facoltativo.Se questo elemento non viene specificato nel mapping, Microsoft Project separerà i nomi di risorsa utilizzando i mapping predefiniti specificati nella tabella riportata di seguito.

Se il separatore Active Directory e di elenco del progetto team è	In Office Project sostituire con
,	;
;	:
.	:

Se si desidera specificare un carattere diverso da quelli elencati nella tabella precedente, è possibile definire l'elemento ResourceNameSeparator utilizzando la sintassi seguente:

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

Nell'esempio riportato di seguito viene illustrato come specificare il carattere "*" come separatore da utilizzare in Office Project quando il carattere utilizzato in Team Foundation è "-".

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

Torna all'inizio

Tipo di collegamento gerarchico

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

Torna all'inizio

Tipo di collegamento di dipendenza

Quando si creano collegamenti tra attività in Microsoft Project, vengono creati collegamenti dipendenti tra le attività.All'attività predecessore viene assegnato un collegamento di tipo Predecessore mentre all'attività successore viene assegnato un collegamento di tipo Successore.Queste sono le impostazioni predefinite definite per il tipo del collegamento System.LinkTypes.Dependency.

Torna all'inizio

Attributi di mapping che influiscono su pubblicazione e aggiornamento

I campi di mapping e i valori dei campi di Microsoft Project riportati di seguito determinano se un valore per un elemento di lavoro viene pubblicato o aggiornato.

• Valore del campo Pubblica e aggiorna per ogni elemento di lavoro.

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

• Valore dell'attributo IfSummaryRefreshOnly per uno specifico campo di mapping.

• Classificazione dell'attività come attività di riepilogo o attività padre.

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

Per elementi di lavoro che non sono attività di riepilogo

Nella tabella riportata di seguito viene indicato se un elemento di lavoro che non corrisponde a un'attività di riepilogo o a un'attività padre viene pubblicato o aggiornato in base agli attributi del campo di mapping e all'assegnazione del valore dell'attributo Pubblica e aggiorna dell'elemento.

Pubblica e aggiorna (livello di attività)	Attributo PublishOnly	Il campo viene pubblicato?	Il campo viene aggiornato?
No	True o False	No	No
Solo aggiornamento	True o False	No	Sì
Sì	True	Sì	No
Sì	False	Sì	Sì

Per elementi di lavoro che corrispondono a attività di riepilogo

Se i criteri dell'attività di riepilogo sono soddisfatti e IfSummaryRefreshOnly è true, il relativo valore sostituisce il valore PublishOnly.Nella tabella riportata di seguito viene indicato se un'attività di riepilogo o un'attività padre viene pubblicata o aggiornata in base all'assegnazione del valore dell'attributo Pubblica e aggiorna relativo e agli attributi del campo di mapping.

Pubblica e aggiorna (livello di attività)	Attributo PublishOnly	IfSummaryRefreshOnly Attributo	Il campo viene pubblicato?	Il campo viene aggiornato?
No	True o False	True o False	No	No
Solo aggiornamento	True	True	No	Sì
Solo aggiornamento	True	False	No	Sì
Solo aggiornamento	False	True o False	No	Sì
Sì	True o False	True	No	Sì
Sì	True	False	Sì	No
Sì	False	False	Sì	Sì

Torna all'inizio

Vedere anche

Concetti

Riferimento all'elemento tipo di collegamento

Personalizzare mapping campi di Microsoft Project