Riferimento agli elementi XML per il mapping di campi per l'integrazione TFS-Project Server

Personalizzando i mapping dei campi, è possibile definire quali campi in Visual Studio Team Foundation Server (TFS) e Microsoft Project Server devono essere mantenuti sincronizzati e quali vengono aggiornati nella coda di stato per Project Server e in Team Foundation.

È necessario mantenere un set di mapping dei campi per ogni raccolta di progetti team che ospita i progetti team che si vuole sincronizzare con Project Server. Per recuperare i mapping dei campi, è possibile scaricarli in un file dalla raccolta. Dopo aver modificato il file, è possibile caricarlo nella raccolta e le modifiche verranno applicate a tutti i progetti team definiti per la raccolta specificata. Per altre informazioni su come scaricare e caricare i mapping dei campi, vedere Personalizzare il mapping dei campi tra TFS e Project Server.

In questo argomento

• Campi obbligatori

• Campi predefiniti mappati

• Elementi e attributi di mapping

• Mapping dei campi predefiniti

Campi obbligatori

I campi seguenti devono essere mappati per supportare la sincronizzazione dei dati. Se i campi usati per pianificare il lavoro sono stati personalizzati, è necessario personalizzare i mapping in modo che facciano riferimento ai campi in uso.

• System.Title deve essere mappato a pjTaskName.

• System.AssignedTo deve essere mappato a pjResourceNames.

• Il campo usato per tenere traccia dell'inizio del lavoro in Team Foundation deve essere mappato a pjTaskStart. Per impostazione predefinita, questo campo è Microsoft.VSTS.Scheduling.StartDate.

• Il campo usato per tenere traccia del lavoro completato in Team Foundation deve essere mappato a pjTaskFinish. Per impostazione predefinita, questo campo è Microsoft.VSTS.Scheduling.FinishDate.

Campi predefiniti mappati

Per ogni campo di TFS è possibile specificare due mapping. Nel primo mapping si specifica il campo di Project che viene aggiornato dal campo di TFS nella coda di stato. Nel secondo mapping si specifica il campo di Project che aggiorna il campo di TFS. È anche possibile specificare se il campo di TFS viene visualizzato nel form elemento di lavoro e la modalità di aggiornamento dei campi mirror e di riferimento.

Di tutti i campi di Project di cui è stato eseguito il mapping viene eseguito anche il mirroring per impostazione predefinita, quindi i valori vengono archiviati in TFS.

La tabella seguente descrive i mapping predefiniti assegnati ai campi di Team Foundation. È possibile specificare il modo in cui verranno aggiornati i campi mirror e di riferimento. È possibile impostare OnConflict su PSWins per sovrascrivere il valore in Team Foundation con il valore di Project Server. Se si lascia l'attributo OnConflict non specificato, i campi mantengono valori diversi. Per altre informazioni, vedere la tabella Elementi field e relativi attributi più avanti in questo argomento.

Per altre informazioni sui campi mirror e il processo di sincronizzazione, vedere Informazioni sulla gestione degli aggiornamenti a campi specifici.

È possibile visualizzare più campi di Project nella scheda Project Server di un form elemento di lavoro in Team Foundation se vengono aggiunti ai mapping dei campi. Per altre informazioni su questa scheda, vedere Campi di Project Server aggiunti a TFS per supportare la sincronizzazione dei dati.

Elementi e attributi di mapping

L'elemento field consente di specificare un campo di riferimento in Team Foundation da sincronizzare. Tutti gli elementi field sono inclusi negli elementi contenitore mappingFile, persistables e Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping.

L'esempio seguente illustra la struttura di annidamento degli elementi XML. Per visualizzare i mapping predefiniti, vedere Mapping predefiniti più avanti in questo argomento.

<mappingFile>
   <persistables>
      <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
         <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
            <tfsToTarget>
               <target provider="ProjectServerStatusQueue" name="pjTaskName" />
            </tfsToTarget>
            <targetToTfs>
               <target provider="ProjectServerPublished" name="pjTaskName" />
            </targetToTfs>
         </targetToTfs>
      </field>

         . . .

    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Sintassi degli elementi dei campi

La sintassi seguente definisce gli attributi dell'elemento field:

<field tfsName="FieldName" tfsMirrorName="FieldMirrorName" displayTfsField="true | false" displayTfsMirror=" true | false" onConflict="PSWin">

Sintassi dell'elemento Target

La sintassi seguente definisce gli attributi dell'elemento target:

<target provider="ProviderName" name="ProjectFieldName" />

Per determinare il nome del campo, anteporre il prefisso "pj" al nome descrittivo concatenato. Ad esempio, il nome del campo per Status Manager è pjStatusManager, mentre il nome del campo per Custom 01 è pjCustom01.

Elementi field e relativi attributi

La tabella seguente descrive i sottoelementi e gli attributi dell'elemento field. Un campo di Team Foundation viene mappato a un campo delle risorse di Project di cui si vuole aggiornare il valore durante la sincronizzazione dello stato. Un campo di Team Foundation viene mappato a un campo delle attività di Project il cui valore aggiornerà Team Foundation Server durante la sincronizzazione della pubblicazione. Le unità dei campi da mappare devono inoltre essere conformi ai criteri stabiliti. Per altre informazioni, vedere Limitazioni relative al mapping dei campi di Project Server nell'integrazione con TFS.

Mapping predefiniti

Il codice seguente elenca i mapping dei campi predefiniti che vengono definiti quando si esegue il comando TfsAdmin ProjectServer /UploadFieldMappings e si specifica l'opzione /useDefaultFieldMappings. È possibile scaricare questi mapping in un file e aggiungervi elementi o modificare gli attributi dei campi elencati.

Per un elenco di tutti i campi che vengono aggiunti a un tipo di elemento di lavoro quando si aggiunge tale tipo alla sincronizzazione dei dati, vedere Campi di Project Server aggiunti a TFS per supportare la sincronizzazione dei dati.

<mappingFile>
  <persistables>
    <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
      <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskName" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskName" />
        </targetToTfs>
      </field>
      <field tfsName="System.AssignedTo" tfsMirrorName="Mirror.System.AssignedTo" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskResourceNames" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskResourceNames" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.CompletedWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.CompletedWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceActualWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskActualWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.RemainingWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.RemainingWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceRemainingWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskRemainingWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.OriginalEstimate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.OriginalEstimate" displayTfsField="false" displayTfsMirror="true" onConflict="PSWin">
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskBaselineWork" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.StartDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.StartDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceStart" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskStart" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.FinishDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.FinishDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceFinish" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskFinish" />
        </targetToTfs>
      </field>
    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Vedere anche

Riferimenti

Gestire i mapping dei campi per l'integrazione TFS-Project Server

Concetti

Limitazioni relative al mapping dei campi di Project Server nell'integrazione con TFS

Campi di Project Server aggiunti a TFS per supportare la sincronizzazione dei dati

Amministrare l'integrazione di Team Foundation Server e Project Server

Altre risorse

Personalizzare il mapping dei campi tra TFS e Project Server