XML-Elementverweis für Feldzuordnungen für die Integration von Team Foundation Server und Project Server

Aktualisiert: April 2011

Durch das Anpassen der Feldzuordnungen können Sie festlegen, welche Felder in Visual Studio Team Foundation Server 2010 und Project Server synchronisiert bleiben sollen und welche Felder in der Statuswarteschlange für Project Server und in Team Foundation aktualisiert werden.

Sie verwalten einen Satz von Feldzuordnungen für jede Teamprojektsammlung, die Teamprojekte hostet, die Sie mit Project Server synchronisieren möchten. Um die Feldzuordnungen abzurufen, können Sie sie aus der Teamprojektsammlung in eine Datei herunterladen. Nachdem Sie die Datei geändert haben, können Sie sie in die Teamprojektsammlung hochladen, und die Änderungen werden auf alle Teamprojekte angewendet, die für diese Sammlung definiert sind. Weitere Informationen zum Herunterladen oder Hochladen von Feldzuordnungen finden Sie unter Anpassen von Feldzuordnungen zwischen Project Server und Team Foundation Server.

In diesem Thema

• Pflichtfelder

• Standardfelder, die zugeordnet werden

• Zuordnen von Elementen und Attributen

• Standardfeldzuordnungen

Pflichtfelder

Zur Unterstützung der Datensynchronisierung müssen die folgenden Felder zugeordnet werden. Wenn Sie die Felder angepasst haben, die zum Planen der Arbeit verwendet werden, müssen Sie die Feldzuordnungen anpassen, damit sie auf die Felder verweisen, die Sie verwenden.

• PjTaskName muss System.Title zugeordnet sein.

• PjResourceNames muss System.AssignedTo zugeordnet sein.

• Das Feld, das Sie in Team Foundation zum Nachverfolgen des Arbeitsbeginns verwenden, muss pjTaskStart zugeordnet sein. Standardmäßig lautet dieses Feld Microsoft.VSTS.Scheduling.StartDate.

• Das Feld, das Sie in Team Foundation zum Nachverfolgen abgeschlossener Arbeit verwenden, muss pjTaskFinish zugeordnet sein. Standardmäßig lautet dieses Feld Microsoft.VSTS.Scheduling.FinishDate.

Zurück nach oben

Standardfelder, die zugeordnet werden

Sie können für jedes Feld in Team Foundation zwei Zuordnungen angeben. In der ersten Zuordnung geben Sie das Feld in Project an, das vom Feld in Team Foundation in der Statuswarteschlange aktualisiert wird. In der zweiten Zuordnung geben Sie das Feld in Project an, das das Feld in Team Foundation aktualisiert. Außerdem können Sie angeben, ob das Feld in Team Foundation im Arbeitsaufgabenformular angezeigt wird und wie Aktualisierungen an Referenz- und Spiegelfeldern vorgenommen werden.

Standardmäßig werden alle zugeordneten Projektfelder auch gespiegelt, was bedeutet, dass deren Werte in Team Foundation gespeichert werden.

In der folgenden Tabelle werden die Standardzuordnungen für Felder in Team Foundation beschrieben. Sie können angeben, wie Referenz- und Spiegelfelder aktualisiert werden sollen. Sie können OnConflict auf PSWins festlegen, um den Wert in Team Foundation mit dem Wert aus Project Server zu überschreiben. Wenn Sie das OnConflict-Attribut nicht angegeben lassen, bleiben die Werte in den Feldern unterschiedlich. Weitere Informationen finden Sie weiter unten in diesem Thema in der Tabelle Field-Elemente und -Attribute.

Weitere Informationen zu Spiegelfeldern und den drei Synchronisierungstypen finden Sie unter Übersicht zum Synchronisierungsprozess für die Integration von Team Foundation Server und Project Server.

Sie können auf der Registerkarte Project Server eines Arbeitsaufgabenformulars in Team Foundation mehrere Project-Felder anzeigen, wenn Sie diese den Feldzuordnungen hinzufügen. Weitere Informationen zu dieser Registerkarte finden Sie unter Für die Unterstützung der Datensynchronisierung hinzugefügte Project Server-Felder.

Zurück nach oben

Zuordnen von Elementen und Attributen

Sie geben mit einem field-Element ein Verweisfeld in Team Foundation an, das synchronisiert werden soll. Alle field-Elemente befinden sich in den Containerelementen mappingFile, persistables und Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping.

Im folgenden Beispiel wird die Schachtelungsstruktur von XML-Elementen gezeigt. Informationen zum Anzeigen der Standardzuordnungen finden Sie unter Standardzuordnungsdatei weiter unten in diesem Thema.

<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>

Feldelementsyntax

Die folgende Syntax definiert die Attribute des field-Elements:

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

Syntax des target-Elements

Die folgende Syntax definiert die Attribute des target-Elements:

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

Um den Feldnamen zu bestimmen, stellen Sie dem verketteten Anzeigenamen "pj" voran. Der Feldname für Status-Manager ist z. B. pjStatusManager, und der Feldname für Benutzerdefiniert 01 ist pjCustom01.

Zurück nach oben

field-Elemente und -Attribute

In der folgenden Tabelle werden die Unterelemente und Attribute des field-Elements beschrieben. Sie ordnen ein Team Foundation-Feld einem Project-Ressourcenfeld zu, dessen Wert bei der Statussynchronisierung aktualisiert werden soll. Sie ordnen ein Team Foundation-Feld einem Projektaufgabenfeld zu, durch dessen Wert Team Foundation Server bei der Veröffentlichungssynchronisierung aktualisiert wird. Zudem müssen die Einheiten der Felder, die Sie zuordnen, den festgelegten Kriterien entsprechen. Weitere Informationen finden Sie unter Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server.

Element	Attribut	Beschreibung
field		Gibt das Feld in Team Foundation an, das zugeordnet werden soll, und gibt an, wie das Feld zugeordnet werden soll.
	tfsName	Gibt den Verweisnamen des zu synchronisierenden Felds in Team Foundation an. Sie müssen ein Feld angeben, das in der Teamprojektsammlung definiert ist. Sie können alle Felder in einer Teamprojektsammlung aufführen, indem Sie den witadmin listfields-Befehl ausführen. Weitere Informationen finden Sie unter Verwalten von Arbeitsaufgabenfeldern [witadmin].
	tfsMirrorName	Erforderlich. Gibt den Verweisnamen an, unter dem den Wert des Project Server-Felds in Team Foundation Server gespeichert werden soll. Sie können dem Verweisnamen "Mirror" voranstellen. Sie können z. B. Mirror.System.Title für System.Title angeben. Hinweis Von Ihnen angegebene Spiegelfelder werden automatisch erstellt.Sie müssen der Typdefinition einer Arbeitsaufgabe keine Spiegelfelder hinzufügen.
	displayTfsField	Optional. Standardmäßig ist dieses Attribut auf true festgelegt. Wenn dieses Attribut auf true festgelegt ist, wird das Feld auf der Registerkarte Project Server des Arbeitsaufgabenformulars in Team Foundation angezeigt. Wenn dieses Attribut auf false festgelegt ist, wird das Feld nicht im Formular angezeigt. Standardmäßig werden im Formular nur die Felder Abgeschlossene Arbeit und Verbleibende Arbeit angezeigt.
	displayTfsMirror	Optional. Standardmäßig ist dieses Attribut auf true festgelegt. Wenn dieses Attribut auf true festgelegt ist, wird das Feld auf der Registerkarte Project Server des Arbeitsaufgabenformulars in Team Foundation angezeigt. Wenn dieses Attribut auf false festgelegt ist, wird das Feld nicht im Formular angezeigt.
	onConflict	Optional. Gibt an, wie das Synchronisierungsmodul Referenz- und Spiegelfelder aktualisiert. Der einzig gültige Wert ist PSWin. Wenn dieses Attribut auf PSWin festgelegt ist und der aktuelle Wert, der aus Project Server veröffentlicht wird, vom Wert im Spiegelfeld abweicht, wird der Wert des Felds aktualisiert. Wenn Sie dieses Attribut nicht definieren, geben Sie an, dass doppelte Buchführung verwendet werden soll. Das heißt, der Wert in Project kann vom Wert in Team Foundation abweichen. Die Werte der Felder "Titel", "Zugewiesen an", "Startdatum" und "Enddatum" werden standardmäßig immer durch die Werte in Project ersetzt. Standardmäßig wird nur für die Felder Abgeschlossene Arbeit und Verbleibende Arbeit die doppelte Buchführung verwendet.
tfsToTarget		Gibt den Namen des Felds in Project an, das von Team Foundation aktualisiert wird.
target		Gibt das Ziel an, das Aktualisierungen von Team Foundation empfangen soll.
	provider	Gibt den Namen des Aktualisierungsanbieters an. Für tfsToTarget ist ProjectServerStatusQueue der einzige gültige Wert.
	name	Gibt den Namen des Project-Felds an, das mit dem Wert in Team Foundation aktualisiert wird. In Project Server können Sie nur integrierte oder benutzerdefinierte Enterprise-Felder zuordnen. Eine Liste der verfügbaren Felder finden Sie unter Fields Available for Mapping to the Status Queue.
targetToTfs		Gibt die Feldzuordnung zum Synchronisieren von Aktualisierungen in Project Server mit Team Foundation Server an.
target		Gibt das Ziel an, das Aktualisierungen von Project Server empfangen soll.
	provider	Gibt den Namen des Aktualisierungsanbieters an. Für targetToTfs ist der einzige gültige Wert ProjectServerPublished.
	name	Gibt den Namen des Felds in Project an, von dem das Feld in Team Foundation aktualisiert wird. Sie können nur integrierte oder benutzerdefinierte Enterprise-Felder zuordnen. Eine Liste der verfügbaren Felder finden Sie unter Fields Available for Mapping from Project Server to Team Foundation Only.

Zurück nach oben

Standardzuordnungen

Im folgenden Code werden die Standardfeldzuordnungen aufgeführt, die definiert werden, wenn Sie den TfsAdmin ProjectServer /UploadFieldMappings-Befehl ausführen und die /useDefaultFieldMappings-Option angeben. Sie können diese Zuordnungen in eine Datei herunterladen und dieser dann Elemente hinzufügen oder die Attribute der aufgeführten Felder ändern.

Eine Liste aller Felder, die einem Typ von Arbeitsaufgabe hinzugefügt werden, wenn Sie diesen Typ in die Datensynchronisierung einbeziehen, finden Sie unter Für die Unterstützung der Datensynchronisierung hinzugefügte Project Server-Felder.

<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" />
        </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" />
        </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>

Zurück nach oben

Siehe auch

Weitere Ressourcen

Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server

Für die Unterstützung der Datensynchronisierung hinzugefügte Project Server-Felder

Verwalten von Feldzuordnungen für die Integration von Team Foundation Server und Project Server

Anpassen von Feldzuordnungen zwischen Project Server und Team Foundation Server

Verwalten der Integration von Team Foundation Server und Project Server

Änderungsprotokoll