Condividi tramite

Eseguire il mapping di campi da Microsoft Project a Team Foundation

  • Articolo

È possibile personalizzare il modo in cui campi elemento di lavoro che vengono archiviati in Team Foundation vengono mappati ai campi definiti per Microsoft Project. È possibile modificare la modalità di pubblicazione di campi specifici e definire il tipo di collegamento predefinito da usare quando si creano collegamenti gerarchici o di struttura ad albero e collegamenti di dipendenza.

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

È possibile personalizzare i mapping, ad esempio, per supportare un campo che è stato creato oppure per eseguire il mapping di campi a colonne predefinite anziché a colonne personalizzate. Per la documentazione completa sul file di mapping campi per Microsoft Project, vedere Aggiungere o modificare la modalità di mapping dei campi di Project ai campi TFS.

È possibile personalizzare il mapping modificando il file FileMapping.xml. La tabella seguente elenca i 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à che carica il file nella raccolta di proiezione del team.

Nome del file:

FileMapping.xml

Nome della cartella:

Classificazione

Nome del plug-in:

Microsoft.ProjectCreationWizard.Classification

Per altre informazioni, vedere Definire il plug-in di classificazione.

Specificare la modalità di mapping dei campi

Specificare i campi mappati usando l'elemento Mapping e la struttura di sintassi seguente:

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

La tabella seguente illustra gli attributi dell'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 una colonna in Microsoft Project. Specificare i nomi di colonna predefiniti aggiungendo il prefisso "pj" al nome, ad esempio pjTaskName per la colonna Nome attività. Specificare i campi personalizzati come pjTaskText seguiti da un numero, ad esempio pjTaskText11.

ProjectName

Parametro facoltativo. Specifica il nome da visualizzare come nome colonna all'utente. Se questo attributo viene omesso, viene usato il nome del campo nel tipo di elemento di lavoro.

ProjectUnits

Parametro facoltativo. Specifica il tipo di unità da usare quando si esegue il mapping di un tipo di campo per Microsoft Project. I valori validi sono pjMinute, pjHour, pjDay, pjWeek e pjMonthUnit.

PublishOnly

Parametro facoltativo. Se impostato su true, indica che il campo viene pubblicato nel database degli elementi di lavoro, ma non aggiornato. Questo valore è in genere usato per i 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, solo Data di inizio e Data di fine hanno questo attributo impostato su true.

IfSummaryRefreshOnly

Parametro 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 anche quando si verificano le condizioni seguenti:

  • La riga per il campo è un'attività di riepilogo in Microsoft Project.

  • I valori Pubblica e Aggiorna dell'attività di riepilogo sono impostati su Yes.

  • L'attività di riepilogo contiene almeno un'attività figlio che è associata a Team Foundation Server.

Eventuali aggiornamenti o calcoli eseguiti da Microsoft Project possono sovrascrivere il valore che viene aggiornato dal database degli elementi di lavoro nel piano del progetto. Tuttavia, il valore modificato non viene mai salvato nel database degli elementi di lavoro. Questo attributo viene in genere usato per i campi di riepilogo che, se pubblicati nel database degli elementi di lavoro, causano incoerenze dei dati.

Se impostato su false, indica che il campo può essere pubblicato e aggiornato. Per impostazione predefinita, questo attributo è impostato su false.

Nota

L'attributo IfSummaryRefreshOnly sostituisce l'attributo PublishOnly.Per altre informazioni, vedere Personalizzare il 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.

Specificare i campi per la sincronizzazione, i collegamenti e gli allegati

Oltre all'elemento Mapping altri due elementi determinano la sincronizzazione dei campi e i campi che supporteranno collegamenti e allegati.

L'elemento SyncField specifica quale colonna viene usata come campo di sincronizzazione. Il campo di sincronizzazione è denominato "Pubblica e aggiorna" e consente all'utente di indicare se una riga dell'attività viene pubblicata o solo aggiornata.

Usare la sintassi XML seguente per specificare quale colonna è mappata al campo di sincronizzazione. Impostare l'attributo ProjectField su una colonna valida in Microsoft Project.

<SyncField ProjectField="" />

L'elemento LinksField specifica la colonna collegamenti e allegati. Usando questa colonna, gli utenti possono indicare se una particolare riga dell'attività prevede collegamenti o allegati.

Usare la sintassi XML seguente per specificare quali colonne sono mappate al campo collegamenti e allegati. Impostare l'attributo ProjectField su una colonna valida in Microsoft Project.

<LinksField ProjectField="" />

Mapping dei campi predefiniti

L'esempio seguente mostra in che modo il modello del processo MSF per Agile Software Development mappa i campi negli elementi di lavori alle 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

Definire il plug-in di classificazione

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

Personalizzare il file di mapping campi di Microsoft Project