Mapping di campi da Microsoft Project a Team Foundation

È possibile personalizzare la modalità di mapping dei campi dell'elemento di lavoro archiviati in Team Foundation ai campi definiti per Microsoft Project. È possibile modificare la modalità con cui campi specifici vengono pubblicati e designano il tipo di collegamento predefinito da utilizzare quando si creano collegamenti gerarchici o della struttura ad albero e collegamenti di dipendenza.

A differenza di Microsoft Excel, Microsoft Project utilizza un set limitato di colonne, che include colonne predefinite, ad esempio Nome attività, e campi personalizzati. Quando un utente pubblica o aggiorna dati degli elementi di lavoro in un file di Microsoft Project, il mapping dei campi determina i campi nel database degli elementi di lavoro che corrispondono alle colonne in Microsoft Project.

È possibile personalizzare i mapping, ad esempio, perché supportino un campo creato o per eseguire il mapping di campi a colonne predefinite anziché a colonne personalizzate. Per la documentazione completa sul file di mapping dei campi di Microsoft Project, vedere Personalizzazione di mapping campi di Microsoft Project.

Per personalizzare il mapping, è necessario modificare il file FileMapping.xml. Nella tabella seguente è incluso un riepilogo dei nomi del file, della cartella e del plug-in per i modelli di processo per Microsoft Solutions Framework (MSF). Il plug-in contiene la definizione dell'attività per il caricamento del file nell'insieme di progetti team.

In questo argomento

• Definizione della modalità di mapping dei campi

• Indicazione dei campi utilizzati per la sincronizzazione, i collegamenti e gli allegati

• Mapping dei campi predefiniti

Definizione della modalità di mapping dei campi

Per specificare i campi mappati, è necessario utilizzare l'elemento Mapping e la struttura di sintassi seguente:

<Mappings>
   <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
            ProjectField=""
            ProjectName=""
         ProjectUnits=""
         PublishOnly=""
         IfSummaryRefreshOnly=""/>
</Mappings>

Nella tabella seguente vengono descritti gli attributi dell'elemento Mapping.

Attributo	Descrizione
WorkItemTrackingFieldReferenceName	Obbligatorio. Specifica il nome di riferimento di un campo in un tipo di elemento di lavoro.
ProjectField	Obbligatorio. Specifica il nome di una colonna in Microsoft Project. Specificare le colonne predefinite 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	Facoltativo. Specifica il nome visualizzato dall'utente come nome della colonna. Se questo attributo non è specificato, viene utilizzato il nome del campo nel tipo di elemento di lavoro.
ProjectUnits	Facoltativo. Specifica il tipo di unità da utilizzare quando si esegue il mapping di un tipo di campo a Microsoft Project. Tra i valori validi sono compresi pjMinute, pjHour, pjDay, pjWeek e pjMonthUnit.
PublishOnly	Facoltativo. Se impostato su true, indica che il campo viene pubblicato nel database degli elementi di lavoro, ma non viene 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. Per impostazione predefinita, questo attributo è impostato su false. Per impostazione predefinita, questo attributo è impostato su true solo per Data di inizio e Data di fine.
IfSummaryRefreshOnly	Facoltativo. Se impostato su true, indica che il campo non viene mai pubblicato nel database degli elementi di lavoro, ma viene aggiornato dal database degli elementi di lavoro quando si verificano anche le condizioni seguenti: La riga relativa al campo corrisponde a un'attività di riepilogo in Microsoft Project. Per l'attività di riepilogo i valori di Pubblica e Aggiorna 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. Per impostazione predefinita, questo attributo è impostato su false. Nota L'attributo IfSummaryRefreshOnly prevale sull'attributo PublishOnly.Per ulteriori informazioni, vedere File di mapping campi di Microsoft Project. Per impostazione predefinita, l'attributo IfSummaryRefreshOnly è impostato su true per i campi Stima originale, Lavoro rimanente e Lavoro completato.

Indicazione dei campi utilizzati per la sincronizzazione, i collegamenti e gli allegati

Oltre all'elemento Mapping, altri due elementi consentono di determinare la modalità di sincronizzazione dei campi e i campi che supporteranno collegamenti e allegati.

L'elemento SyncField specifica la colonna che funge da campo di sincronizzazione. Il campo di sincronizzazione ha come titolo "Pubblica e aggiorna" e consente all'utente di indicare se una riga dell'attività viene pubblicata o solo aggiornata.

Utilizzare la sintassi XML seguente per specificare la colonna mappata al campo di sincronizzazione. È necessario impostare l'attributo ProjectField su una colonna valida in Microsoft Project.

<SyncField ProjectField="" />

L'elemento LinksField specifica la colonna dei collegamenti e degli allegati. Utilizzando la colonna dei collegamenti e degli allegati, gli utenti possono indicare se una determinata riga dell'attività include collegamenti o allegati.

Utilizzare la sintassi XML seguente per specificare la colonna mappata al campo dei collegamenti e degli allegati. È necessario impostare l'attributo ProjectField su una colonna valida in Microsoft Project.

<LinksField ProjectField="" />

Mapping dei campi predefiniti

Nell'esempio seguente viene illustrato il modo in cui il modello di processo MSF for Agile Software Development esegue il mapping di campi presenti negli elementi di lavoro a colonne in Microsoft Project.

<?xml version="1.0" encoding="utf-8"?>
<MSProject>
  <Mappings>
    <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" />
    <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="Work Item ID" />
    <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" />
    <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="State" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" />
    <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="Work Item Priority" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
    <LinksField ProjectField="pjTaskText26" />
    <SyncField ProjectField="pjTaskText25" />
  </Mappings>
</MSProject>

Vedere anche

Concetti

Definizione delle aree e delle iterazione iniziali nel plug-in Classification

File di mapping campi di Microsoft Project

Personalizzazione di aree funzionali all'interno di un modello di processo

Altre risorse

Personalizzazione di mapping campi di Microsoft Project