Caricare o scaricare il file di mapping di Microsoft Project [TFSFieldMapping]

Usare TFSFieldMapping per caricare e scaricare il file di mapping di Microsoft Project. Questo file controlla in che modo Microsoft Project pubblica le attività in un progetto team connesso a un'istanza locale di Team Foundation Server (TFS). Ad esempio, è possibile modificare il file per supportare i campi aggiunti ai tipi di elementi di lavoro oppure modificare le modalità di pubblicazione e di aggiornamento dei campi esistenti.

È possibile specificare i campi TFS da mappare ai campi Project. Il comportamento di pubblicazione può essere controllato anche attraverso l'attributo PublishOnly, che consente di definire campi speciali, come il campo di contesto. Per la sintassi XML completa del file di mapping, vedere Personalizzare il file di mapping campi di Microsoft Project. Questo file è lo stesso definito nel modello di processo usato per creare il progetto team. Vedere Eseguire il mapping di campi da Microsoft Project a Team Foundation.

Lo strumento da riga di comando TFSFieldMapping funziona solo se viene eseguito in un'istanza locale di TFS. Per eseguire lo strumento, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e digitare:

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\14.0
NotaNota

Anche se si accede con le autorizzazioni amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server che esegue Windows Server 2008. Per aprire un prompt dei comandi con privilegi elevati, scegliere Start, aprire il menu di scelta rapida per Prompt dei comandi, quindi scegliere Esegui come amministratore. Per altre informazioni, vedere il sito Web Microsoft.

Requisiti

Per usare il comando TFSFieldMapping, è necessario essere membri del gruppo di sicurezza Team Foundation Administrators o Project Administrators. Per altre informazioni, vedere Riferimento alle autorizzazioni per Team Foundation Server.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Argomento

Descrizione

upload | download

Specifica se scaricare o caricare il file di mapping del campo.

/collection:CollectionURL

Specifica l'URI della raccolta di progetti team nel seguente formato: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta

Se non si specifica una directory virtuale da usare, è necessario utilizzare il formato seguente:

http://NomeServer:Porta/NomeRaccolta

Se si è già connessi al server, è possibile specificare il nome descrittivo del server invece dell'URI.

/teamproject: NomeProgetto

Specifica il nome del progetto team di cui si vogliono modificare i parametri di mapping. Se il nome contiene degli spazi, racchiuderlo tra virgolette.

/mappingfile: FileMapping

Specifica il nome e il percorso del file di mapping.

  1. Aprire una finestra del prompt dei comandi in cui è stato installato il progetto e Team Explorer o TFS, quindi immettere:

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0
    
    SuggerimentoSuggerimento

    Il progetto non è necessario per scaricare il file di mapping, ma lo è per caricarlo.

  2. Scaricare il file di mapping immettendo il seguente comando:

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
    
    SuggerimentoSuggerimento

    Se un nome contiene degli spazi, racchiuderlo tra virgolette.

  3. Aprire il file di mapping in un editor di testo o in un editor XML.

  4. Aggiungere i nuovi mapping o modificare quelli esistenti nel seguente formato:

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

    Ad esempio, per aggiungere altri campi di pianificazione a un progetto team creato con il modello di processo Scrum, aggiungere i seguenti mapping:

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="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.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    

    Il modello Scrum predefinito esegue il mapping del campo Lavoro rimanente solo nel progetto.

    NotaNota

    Per un elenco completo di tutti i valori del campo Office Project per l'attributo ProjectField, vedere Mapping di campi in Microsoft Project.

  5. (Facoltativo) Indicare se il campo deve essere pubblicato, ma non aggiornato. Aggiungere l'attributo PublishOnly alla sezione del mapping del campo e impostare l'attributo su true. L'attributo può essere usato per consentire ai membri del team di visualizzare un valore del campo, ma non di modificarlo in Team Foundation.

  6. (Facoltativo) Indicare come aggiornare le attività di riepilogo nel progetto. Aggiungere l'attributo fSummaryRefreshOnly="true" per indicare che il campo non viene mai pubblicato nel database degli elementi di lavoro, ma viene aggiornato da questo database quando la riga per il campo è un'attività di riepilogo nel progetto, l'attività di riepilogo ha la condizione Pubblica e aggiorna=Sì e l'attività di riepilogo contiene almeno un'attività figlio pubblicata in TFS.

  7. Salvare e caricare il file:

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
    
Mostra: