Anpassen von Feldzuordnungen zwischen Project Server und Team Foundation Server

Um Daten zwischen einem Enterprise-Projektplan und einem Teamprojekt zu synchronisieren, müssen Sie die Arbeitsaufgabenfelder in Visual Studio Team Foundation Server 2012 mit den Feldern in Microsoft Project Server zuordnen.Sie können Felder hinzufügen und angeben, wie sie synchronisiert werden, indem Sie die Feldzuordnungen anpassen.In Project können Sie integrierte und benutzerdefinierte Felder zuordnen.Sie können z. B. Daten freigeben, die sich nicht auf Zeitpläne (z. B. Kostenstellen, Teamnamen oder Systemzustand) beziehen, wenn Sie den Zuordnungen die Felder hinzufügen, in denen diese Typen von Daten gespeichert werden.

Sie verwalten einen Satz von Feldzuordnungen für jede Teamprojektsammlung, die Teamprojekte hostet, die Sie mit Project Server synchronisieren möchten.Sie müssen die Feldzuordnungen für jede Teamprojektsammlung definieren, die Sie einer Instanz von Project Web Access oder Projekt Web App (PWA) zugeordnet haben.Sie können die Standardzuordnungen hochladen, oder Sie können eine Zuordnungsdatei anpassen und hochladen.Informationen zum Hochladen der Standardzuordnungen finden Sie weiter unten in diesem Thema unter Hochladen von Zuordnungen.

Vorsicht
Die Zuordnungen für die Integration von Team Foundation Server (TFS) und Project Server sich von der Feldzuordnungsdatei für Microsoft Project unterschiedlich.Weitere Informationen finden Sie unter Microsoft Project-Feldzuordnungsdatei.

Wie in der folgenden Abbildung gezeigt, werden die Zuordnungen in fünf Schritten angepasst:

Anpassen der Feldzuordnungen zwischen Team Foundation Server und Project Server

Wichtig

Sie können die Zuordnungsdatei so oft aktualisieren, wie Sie möchten.Die auf der Registerkarte Project Server angezeigten Felder werden für jeden Typ von Arbeitsaufgabe aktualisiert, die in die Datensynchronisierung einbezogen wird.Sie dürfen die Definitionen für die Registerkarte Project Server nicht manuell ändern.Weitere Informationen finden Sie unter Anpassen der Registerkarte Project Server weiter unten in diesem Thema.

In diesem Thema

• Standardzuordnungen

• Bestimmen von weiteren zuzuordnenden Feldern

• Herunterladen von Zuordnungen in eine Datei

• Aktualisieren von Zuordnungen

• Hochladen von Zuordnungen

• (Optional) Anpassen der Registerkarte Project Server

Hinweis
Ein Demonstrationsvideo finden Sie auf der folgenden Seite der Microsoft-Website: Verwalten von Feldzuordnungen für die Integration von Team Foundation Server und Project Server.

Erforderliche Berechtigungen

Zum Ausführen der Verfahren in diesem Thema muss die Berechtigung Project Server-Integration verwalten auf Zulassen festgelegt sein.Außerdem muss dem Dienstkonto für Team Foundation Server die Berechtigung Project Server-Integration verwalten gewährt werden.Weitere Informationen finden Sie unter Zuweisen von Berechtigungen für die Unterstützung der Integration von Project Server und Team Foundation Server.

Standardzuordnungen

Die Zuordnungen bestimmen, welche Felder synchronisiert werden, wenn ein Benutzer Informationen in Team Foundation oder Project Server aktualisiert.Jeder der folgenden Synchronisierungstypen verfügt über einen eigenen Satz von Zuordnungen:

• Für die Veröffentlichungssynchronisierung werden die Daten in Team Foundation mit den Daten in Project Server aktualisiert.Mit dem targetToTfs-Element geben Sie das Feld in Project Server an, von dem das Feld in Team Foundation aktualisiert wird.

• Zur Statussynchronisierung werden die Daten in Team Foundation an die Statuswarteschlange in Project Server übermittelt.Mit dem tfsToTarget-Element geben Sie das Feld an, mit dem das Statuswarteschlangenfeld in Project Server aktualisiert wird.

Weitere Informationen über diese beiden Typen von Synchronisierung finden Sie unter Übersicht zum Synchronisierungsprozess für die Integration von Team Foundation Server und Project Server.

In der folgenden Tabelle ist der Standardsatz von Feldern aufgeführt, die zwischen Team Foundation und Project Server zugeordnet werden.Die Tabelle gibt auch an, welche Typen von Arbeitsaufgaben die Felder auf der Grundlage der Standardprozessvorlagen verwenden, die TFS bereitstellt.Sie sollten diese Zuordnungen nicht ändern, wenn Sie einem Teamprojekt zuordnen, das von einer Prozessvorlage erstellt wurde, die auf Agile Software oder Process Capability Maturity Model Integrations-(CMMI) ist.Wenn Sie einem Teamprojekt zuordnen, das von der Scrum-Prozessvorlage erstellt wurde, müssen Sie einige Änderungen vornehmen, während Erforderliche Änderungen, zu setzen, wenn, Zuordnen zu einem Teamprojekt, das von der Scrum-Prozessvorlage erstellt wurde weiter unten in diesem Thema beschrieben werden.

Weitere Informationen zu Zuordnungen und dem Synchronisierungsprozess finden Sie unter XML-Elementverweis für Feldzuordnungen für die Integration von Team Foundation Server und Project Server.

Zurück nach oben

Erforderliche Änderungen, zu setzen, wenn, Zuordnen zu einem Teamprojekt, das von der Scrum-Prozessvorlage erstellt wurde

Es gibt zwei Änderungen, die Sie vornehmen müssen, um Datenfluss von einem Teamprojekt zu aktivieren, das entweder von Scrum 2.0 oder einer Scrum 1.0-Prozessvorlage erstellt wird.Sie müssen die abgeschlossene Arbeit und Ursprüngliche Schätzung der Arbeitsaufgabentyp Aufgabe hinzufügen, und Sie müssen die Elemente entfernen, die das Feld Verbleibende Arbeit erfordern, leer sein, wenn ein Teammitglied den Zustand zu Fertig oder zu Entfernt ändert.

Um die Scrum-Aufgabentypdefinition aktualisieren

1. Öffnen Sie ein Eingabeaufforderungsfenster, in dem entweder Visual Studio oder Team Explorer installiert ist und geben Sie Folgendes ein:

   cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
   

   Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.

2. Um die Typdefinition für Aufgabe zu exportieren, geben Sie den folgenden Befehl ein und ersetzen die Argumente für die hier, wo CollectionURL die URL einer Teamprojektsammlung angibt, Projektname angibt den Namen eines Teamprojekts angezeigt werden, das in der Auflistung definiert ist und "DirectoryPath\FileName.xml" den Namen und den Speicherort angibt damit die Datei exportiert.Wählen Sie dann EINGABETASTE aus.

   witadmin exportwitd /collection: /p:"ProjectName" /n:"Task" /f:"DirectoryPath\FileName.xml"
   

3. In einem Text-Editor oder in Visual Studio, öffnen Sie die Datei, die exportierten.

4. Innerhalb des FIELDS Definitionsabschnitts fügen Sie diesen Codeausschnitt vor dem Element für verbleibende Arbeit hinzu:

   <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">
      <HELPTEXT>The number of units of work that have been spent on this task</HELPTEXT>
   </FIELD>
   <FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">
      <HELPTEXT>Initial value for Remaining Work - set once, when work begins. </HELPTEXT>
   </FIELD>
   

5. Innerhalb des Abschnitts <WORKFLOW> entfernen Sie den folgenden Codeausschnitt von <STATE value="Done"> und von <STATE value="Removed"> Definitionen:

   <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
      <EMPTY />
   </FIELD>
   

6. Innerhalb des <FORM>-Abschnitts fügen Sie die folgenden Control-Elemente hinzu:

   <Control FieldName="Microsoft.VSTS.Scheduling.OriginalEstimate" Type="FieldControl" Label="Original Estimate:" LabelPosition="Left" />
   <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed:" LabelPosition="Left" />
   

7. Speichern und schließen Sie die Datei.

8. Importieren Sie die Datei und die Daten für die Argumente ersetzen, die angezeigt werden.

   witadmin importwitd /collection: /p:"ProjectName" /f:"DirectoryPath\FileName.xml"
   

9. Aktualisieren Sie das Teamprojekt oder Arbeitsaufgabenseite, die Änderungen zu überprüfen.

Weitere Informationen finden Sie unter Exportieren und Importieren von Arbeitsaufgabentypen eines vorhandenen Projekts, Definieren von Arbeitsaufgabenfeldern und Entwerfen und Anpassen eines Arbeitsaufgabenformulars.

Zurück nach oben

Bestimmen von weiteren zuzuordnenden Feldern

Bestimmen Sie die folgenden Informationen für jedes Feld, das Sie zusätzlich zu den Standardfeldern synchronisieren möchten:

• Der Verweisname des Felds in Team Foundation.Wenn Sie ein Feld in Project Server mit einem Feld synchronisieren möchten, das Sie in Team Foundation erstellen müssen, erstellen Sie zunächst das Feld in jedem Typ von Arbeitsaufgabe, die Sie synchronisieren.Weitere Informationen finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM und Definieren von Arbeitsaufgabenfeldern.

• Der Name des Felds in Project Server, mit dem das Feld in Team Foundation aktualisiert wird.Eine Liste der verfügbaren Felder finden Sie unter Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server.

• Der Name des in Project Server zu aktualisierenden Felds und der Name des Felds in Project Server, durch das das Spiegelfeld in Team Foundation Server aktualisiert wird.

• Ob die Felder auf dem Arbeitsaufgabenformular angezeigt werden sollen.Für Felder, die im Arbeitsaufgabenformular angezeigt werden sollen, legen Sie den Wert des displayTfsField-Attributs auf true fest.Für ein Arbeitsaufgabenformular legen Sie den Wert des displayTfsMirror-Attributs auf true fest.

• Ob Datenkonflikte aufgelöst werden sollen, indem zugelassen wird, dass der Wert des Felds in Team Foundation den Wert des Felds in Project Server überschreibt, oder ob beide Werte beibehalten werden sollen.Von dieser Entscheidung hängt der Wert des onConflict-Attributs ab.Wenn onConflict=”PsWins” festgelegt ist, überschreibt der Wert des Felds in Project Server den Wert des Felds in Team Foundation.Weitere Informationen finden Sie unter Field Elements and Attributes.

• Weitere Werte, die Sie definieren müssen, um Auswahllisten oder benutzerdefinierte Nachschlagetabellen in Project Server zu unterstützen.

Zurück nach oben

Einschränkungen von Daten, die Sie zuordnen können

Wenn Sie festgelegt haben, welche Felder Sie zuordnen möchten, beachten Sie die folgenden Einschränkungen:

• Sie können nur aufgabenbezogene Informationen (pjTask*-Felder) von Project Server an Team Foundation Server senden.

• Sie können nur auf Ressourcen bezogene Informationen (pjResource* Felder) von Team Foundation Server an die Statuswarteschlange von Project Server senden.

• Das Feld "Titel" ist das einzige Feld, das an sowohl an Team Foundation Server als auch an die Statuswarteschlange gesendet werden kann.

• Rollupinformationen werden automatisch für die Felder Zugewiesen an, Abgeschlossene Arbeit und Verbleibende Arbeit berechnet.Sie können keine weiteren Felder zuordnen und Rollupinformationen für sie berechnen lassen.Weitere Informationen finden Sie unter Arbeiten mit Ressourcenrollup in Enterprise-Projekten mit Zuordnung zu Teamprojekten .

• Sie müssen sicherstellen, dass der Datentyp oder die Einheit jedes Felds, das Sie zuordnen, den Feldzuordnungskriterien für Standard- und benutzerdefinierte Enterprise-Felder entsprechen.Weitere Informationen finden Sie im Abschnitt "Data Types and Feld Mapping Criteria" unter Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server.

• Sie können Felder zuordnen, die Auswahllisten in Team Foundation zugeordnet sind.Allerdings müssen Sie in Project Server Nachschlagetabellen entsprechend den Auswahllisten erstellen.Auswahllisten und Nachschlagetabellen können nicht automatisch synchronisiert werden.

Weitere Informationen finden Sie unter Einschränkungen bei der Zuordnung von Project Server-Feldern für die Integration in Team Foundation Server.

Zurück nach oben

Beispiel: Zuordnen des Teamnamens, der in Project angezeigt werden soll

Im folgenden Beispiel wird das benutzerdefinierte Zeichenfolgenfeld in Team Foundation, MyCompany.MyOrg.DevTeamName, zu einem benutzerdefinierten Project Server, Mein Unternehmens-Team-Name zugeordnet.Sie können den Namen des Teams, das einer Aufgabe zugeordnet ist, in Project Professional mithilfe dieses Beispiels anzeigen.

<field tfsName="MyCompany.MyOrg.DevTeamName" tfsMirrorName="Mirror.MyCompany.MyOrg.DevTeamName" displayTfsField="false" displayTfsMirror="false" onConflict="DoNothing">
   <tfsToTarget>
   <target provider="ProjectServerStatusQueue" name=" My Company Team Name" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" My Company Team Name" />
   </targetToTfs>
</field>

Keines der Felder wird im Arbeitsaufgabenformular angezeigt.Wenn die Werte nicht übereinstimmen, bleibt der eigene Wert jedes Feld erhalten.

Zurück nach oben

Beispiel: Anzeigen des Bereichs und der Iterationspfade in Project

Sie können die Felder Bereich (System.AreaPath) und Iteration (System.IterationPath) in Team Foundation zuordnen, sodass diese in den Projektplänen angezeigt werden.Da diese Strukturpfadfelder häufig geändert werden, Sie sollten sie als Textfelder in Project zuordnen.Projektmanager, die diese Felder verwenden, müssen den vollständigen Bereichspfad oder Iterationspfad manuell eingeben.

Wichtig

Die aktuelle Implementierung der Integration von Team Foundation Server und Project Server unterstützt keine automatische Synchronisierung von Listen zulässiger Werte, Auswahllisten, globalen Listen oder Strukturpfadlisten, die für zugeordnete Felder definiert werden, zwischen den beiden Serverprodukten.Um ein optimales Verhalten zu erreichen, müssen Sie manuelle Einträge im Projektplan vornehmen, die denen in Team Foundation entsprechen.Wenn Sie einen Eintrag angeben, der nicht gültig ist, wird beim Veröffentlichen des Plans ein Validierungsdialogfeld angezeigt.

Um einem Projektplan die Felder Bereich und Iteration hinzuzufügen, führen Sie die folgenden Aktionen aus:

1. Fügen Sie Project Server zwei Kundenunternehmensfelder hinzu, und beschriften Sie sie mit Bereich (TFS) und Iteration (TFS).

   Weitere Informationen finden Sie auf der folgenden Seite auf der Microsoft-Website: Creating Lookup Tables and Enterprise Custom Fields.

2. Exportieren Sie die Feldzuordnungen aus der Teamprojektsammlung, in der die Teamprojekte definiert sind.

   Weitere Informationen finden Sie weiter unten in diesem Thema unter dem Herunterladen von Zuordnungen in eine Datei.

3. Fügen Sie folgenden Code in die Datei ein:

   <field tfsName="System.AreaPath" tfsMirrorName="Mirror.System.AreaPath" displayTfsField="true" displayTfsMirror="true">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Area (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Area (TFS)" />
           </targetToTfs>
         </field>
         <field tfsName="System.IterationPath" tfsMirrorName="Mirror.System.IterationPath" displayTfsField="true" displayTfsMirror="true">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Iteration (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Iteration (TFS)" />
           </targetToTfs>
         </field>
   

4. Importieren Sie die aktualisierte Feldzuordnungsdatei, wie unter Hochladen von Zuordnungen weiter unten in diesem Thema beschrieben.

5. Synchronisieren Sie den Projektplan mit Project Server.

6. Fügen Sie zwei neuen Spalten für die neuen Felder Bereich (TFS) und Iteration (TFS) dem Projektplan hinzu.

In Team Foundation an den Feldern Bereich und Iteration vorgenommene Änderungen werden mit diesen Feldern im Projektplan synchronisiert.Zudem können Sie diese Felder in Project aktualisieren und die Änderungen in Team Foundation veröffentlichen, wenn Sie Werte angeben, die in Team Foundation definiert wurden.

Zurück nach oben

Herunterladen der Zuordnungen in eine Datei

Hinweis

Sie können Zuordnungen nur aus der Teamprojektsammlung herunterladen, in die sie hochgeladen wurden.Wenn Sie die Standardzuordnungen in eine Datei herunterladen möchten, müssen Sie zunächst die Standardzuordnungen hochladen, wie in So laden Sie die Standardzuordnungen hoch weiter unten in diesem Thema beschrieben.Alternativ können Sie den Inhalt der Standardzuordnungen kopieren.Weitere Informationen finden Sie unter Default Field Mappings.

So laden Sie die Zuordnungen in eine Datei herunter

1. Um das TfsAdmin Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster in dem entweder Visual Studio oder Team Explorer installiert ist und geben Sie Folgendes ein:

   cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
   

   Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%..

2. Geben Sie den folgenden Befehl ein, und drücken Sie die EINGABETASTE.

   TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filePath:MappingFile 
   

   Ersetzen Sie tpcUrl durch die URL (Uniform Resource Locator) der Teamprojektsammlung, und ersetzen Sie MappingFile durch den Pfad und den Namen der Datei, die Sie anpassen.

3. Warten Sie, bis die folgenden Meldungen angezeigt werden:

   "Zuordnungsdatei" wird in die Teamprojektsammlung "Teamprojektsammlungs-URL" heruntergeladen.

   Sie haben die Feldzuordnungsdatei "Zuordnungsdatei" erfolgreich in die Teamprojektsammlung "Teamprojektsammlungs-URL" heruntergeladen.

Zurück nach oben

Aktualisieren der Zuordnungen

Für jedes Feld, das Sie der Zuordnungsdatei hinzufügen möchten, geben Sie das field-Element sowie seine Unterelemente und Attribute an.Weitere Informationen finden Sie unter XML-Elementverweis für Feldzuordnungen für die Integration von Team Foundation Server und Project Server.

Zurück nach oben

Hochladen der Zuordnungen

Zuordnungen werden mit dem UploadFieldMappings-Befehl hochgeladen.Sie können mit der /usedefaultfieldmapping-Option die Standardzuordnungen hochladen.Andernfalls müssen Sie eine Datei angeben, die die Zuordnungselemente enthält.

So laden Sie die Standardzuordnungen hoch

1. Geben Sie an der Eingabeaufforderung folgenden Befehl ein, und drücken Sie dann die EINGABETASTE.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /usedefaultfieldmappings
   

   Ersetzen Sie tpcUrl durch die URL der Teamprojektsammlung.

2. Warten Sie, bis die folgenden Meldungen angezeigt werden:

   Die Standardfeldzuordnungen werden in "Sammlungs-URI" hochgeladen.

   Sie haben erfolgreich Feldzuordnungen in die Sammlung "Sammlungs-URI" hochgeladen.

So laden Sie die Zuordnungen aus einer Datei hoch

1. Geben Sie an der Eingabeaufforderung folgenden Befehl ein, und drücken Sie dann die EINGABETASTE.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:MappingFile /force
   

   Ersetzen Sie tpcUrl durch die URL der Teamprojektsammlung, und ersetzen Sie MappingFile durch den Pfad und den Namen der benutzerdefinierten Zuordnungsdatei.Geben Sie /force an, wenn Sie die vorhandenen Zuordnungen aktualisieren.

2. Warten Sie, bis die folgenden Meldungen angezeigt werden:

   "Zuordnungsdatei" wird in die Teamprojektsammlung "Teamprojektsammlungs-URL" hochgeladen.

   Sie haben die Feldzuordnungsdatei "Zuordnungsdatei" erfolgreich in die Teamprojektsammlung "Teamprojektsammlungs-URL" hochgeladen.

Zurück nach oben

Anpassen der Registerkarte Project Server

Wenn Sie einem Teamprojekt einen Enterprise-Projektplan zuordnen, wird dem Arbeitsaufgabenformular die Registerkarte Project Server hinzugefügt, wie in der folgenden Abbildung gezeigt.Die Registerkarte wird nur den Typen von Arbeitsaufgaben hinzugefügt, die Sie für die Einbeziehung in die Datensynchronisierung angeben.Sie passen diese Registerkarte an, indem Sie für Felder, die auf dem Formular angezeigt werden sollen, das displayTfsField-Attribut oder das displayTfsMirror-Attribut auf true festlegen.

Registerkarte Project Server

Wichtig

Die für die Teamprojektsammlung definierten Feldzuordnungen bestimmen die Felder, die auf der Registerkarte Project Server angezeigt werden.Nachdem einem Arbeitsaufgabentyp für ein Teamprojekt diese Registerkarte hinzugefügt wurde, können Sie sie aktualisieren, indem Sie die Feldzuordnungen für die Teamprojektsammlung ändern.Wenn Sie das Arbeitsaufgabenformular manuell anpassen, indem Sie der Registerkarte Project Server Felder hinzufügen oder deren Position auf dem Formular ändern, wird die Registerkarte möglicherweise nicht automatisch mit Änderungen aktualisiert, die Sie zukünftig an den Feldzuordnungen vornehmen.Bei Vorliegen dieser Bedingung können Sie die Registerkarte manuell ändern.Weitere Informationen finden Sie unter Der Definition hinzugefügte XML-Elemente für den Arbeitsaufgabentyp.

Weitere Informationen zu den einzelnen Standardfeldern, die auf der Registerkarte Project Server angezeigt werden, finden Sie unter Für die Unterstützung der Datensynchronisierung hinzugefügte Project Server-Felder.

Zurück nach oben

Siehe auch

Aufgaben

Konfigurieren der Integration von Team Foundation Server und Project Server

Konzepte

Angeben von für die Synchronisierung verfügbaren Arbeitsaufgabentypen

Verwalten der Integration von Team Foundation Server und Project Server