Anpassen der Microsoft Project-Feldzuordnungsdatei

Sie können die Art und Weise anpassen, wie Felder, die für Arbeitsaufgaben in Team Foundation definiert wurden, Feldern in Microsoft Project zugeordnet werden. Außerdem können Sie ändern, wie bestimmte Felder veröffentlicht werden. Microsoft Project schließt vordefinierte Felder, z. B. "Aufgabenname" und benutzerdefinierte Felder, ein. Wenn Sie Arbeitsaufgabendaten in Microsoft Project veröffentlichen oder aktualisieren, legt die Feldzuordnung fest, welche Felder in der Arbeitsaufgabendatenbank den Feldern in Microsoft Project entsprechen.

Informationen zur Verwendung von Project und TFS zum Nachverfolgen von Arbeitsaufgaben finden Sie unter Erstellen von Backlog und Aufgaben mit Project.

Zum Ändern der Feldzuordnungen für ein Teamprojekt exportieren und importieren Sie die Microsoft Project-Zuordnungsdatei mit dem Befehlszeilentool TFSFieldMapping.

Mapping-Element

Geben Sie die Zuordnung zwischen einem Arbeitsaufgabenfeld und einer Projektspalte mit dem Mapping-Element an.

Geben Sie mit folgender XML-Syntax eine Zuordnung zwischen einem Arbeitsaufgabentypfeld und einem Microsoft Project-Feld an. Mit dem Mapping-Element wird dann eine Feldzuordnung angegeben.

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

Attribute

In der folgenden Tabelle werden die Attribute beschrieben, die mit dem Mapping-Element verwendet werden können.

Attribut	Beschreibung
WorkItemTrackingFieldReferenceName	Erforderlich. Gibt den Verweisnamen eines Felds in einem Arbeitsaufgabentyp an.
ProjectField	Erforderlich. Gibt den Namen eines Felds in Microsoft Project an. Geben Sie vordefinierte Feldnamen an, indem Sie dem Namen "pj" voranstellen, z. B. pjAufgabenname für die Spalte Aufgabenname. Geben Sie benutzerdefinierte Felder als pjAufgabentext gefolgt von einer Zahl an, z. B. pjAufgabentext11.
ProjectName	Dies ist optional. Gibt den Namen an, der als Spaltenname in Microsoft Project angezeigt wird. Wenn Sie dieses Attribut nicht angeben, wird der Feldname des Arbeitsaufgabentyps verwendet.
ProjectUnits	Dies ist optional. Gibt den für die Zuordnung von Feldtypen zu Microsoft Project zu verwendenden Einheitentyp an. Sie können die folgenden Werte angeben: pjMinute, pjHour, pjDay, pjWeek und pjMonthUnit. Hinweis ProjectUnits kann nur für Felder mit einer Zeitdauer oder anderen Zeiteinheiten angegeben werden.
PublishOnly	Dies ist optional. Wenn PublishOnly auf true festgelegt ist, wird das Feld in der Arbeitsaufgabendatenbank veröffentlicht, jedoch nicht aktualisiert. Dieser Wert wird üblicherweise für berechnete Felder verwendet, die in Team Explorer nicht aktualisiert werden sollten. Wenn PublishOnly auf false festgelegt ist, wurde das Feld veröffentlicht und aktualisiert. Der Standardwert ist false. In der Standardzuordnungsdatei ist das PublishOnly-Attribut für die Felder Startdatum und Abschlussdatum auf true festgelegt.
IfSummaryRefreshOnly	Dies ist optional. Wenn IfSummaryRefreshOnly auf true festgelegt ist, wird das Feld nie in der Arbeitsaufgabendatenbank veröffentlicht, jedoch mit den Daten aus der Arbeitsaufgabendatenbank aktualisiert, wenn die folgenden Bedingungen ebenfalls zutreffen: Die Zeile für das Feld ist eine Zusammenfassungsaufgabe in Office Project. Für die Zusammenfassungsaufgabe ist "Veröffentlichen und aktualisieren" auf Yes festgelegt. Die Zusammenfassungsaufgabe enthält mindestens eine an Team Foundation Server gebundene untergeordnete Aufgabe. Von Microsoft Project vorgenommene Aktualisierungen oder Berechnungen können den Wert überschreiben, der im Projektplan mit den Daten aus der Arbeitsaufgabendatenbank aktualisiert wird. Der geänderte Wert wird jedoch nie in der Arbeitsaufgabendatenbank gespeichert. Dieses Attribut wird normalerweise für Zusammenfassungsfelder verwendet, die bei der Veröffentlichung in der Arbeitsaufgabendatenbank zu Inkonsistenzen führen. Wenn IfSummaryRefreshOnly auf false festgelegt ist, kann das Feld veröffentlicht und aktualisiert werden. Wenn nicht anders angegeben, ist der Standardwert false. Hinweis Der Wert, der dem IfSummaryRefreshOnly-Attribut zugewiesen ist, hat Vorrang vor dem zugewiesenen Wert von PublishOnly.Weitere Informationen finden Sie unter Felder, die Veröffentlichung und Aktualisierung betreffen weiter unten in diesem Thema. In der Standardzuordnungsdatei ist das IfSummaryRefreshOnly-Attribut für die Felder Ursprüngliche Schätzung, Verbleibende Arbeit und Abgeschlossene Arbeit auf true festgelegt.

Das folgende Beispiel zeigt, wie das Arbeitsaufgabentypfeld, das den Titel enthält, dem entsprechenden Microsoft Project-Feld für den Aufgabennamen zugeordnet wird:

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

Die folgende XML-Syntax zeigt ein komplexeres Beispiel für das Zuordnen des Arbeitsaufgabentypfelds, das das Startdatum enthält, zum entsprechenden Microsoft Project-Feld für das Startdatum. Da das Feld berechnet wird, wird es zwar veröffentlicht, aber nicht aktualisiert, damit keine Fehler in die Team Explorer-Aktualisierungen übernommen werden.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

Hinweis

Es wird empfohlen, schreibgeschützten Feldern in Microsoft Project berechnete Felder in Team Foundation zuzuordnen.Dadurch kann Verwirrung vermieden und verhindert werden, dass die Teammitglieder berechnete Felder ändern.

ReservedField-Element

Das ReservedField-Element unterstützt hierarchische Links zwischen Aufgaben und ist ein optionales Element.

Wenn dieses Element nicht in der Zuordnung angegeben wird, verwendet Microsoft Project das Standardfeld pjNumber20.

SyncField-Element

Im Synchronisierungsfeld können Sie das Veröffentlichungs- und Aktualisierungsverhalten der einzelnen Aufgaben steuern. Das Feld wird als Spalte mit dem Titel Veröffentlichen und aktualisieren angezeigt, wenn Sie die Ansicht Team System-Aufgabenblatt verwenden.

Sie müssen ein Synchronisierungsfeld in der Microsoft Project-Feldzuordnungsdatei angeben. Geben Sie mit der folgenden XML-Syntax das Synchronisierungsfeld an. Verwenden Sie zum Angeben eines Synchronisierungsfelds das SyncField-Element. Das ProjectField-Attribut muss auf ein gültiges Office Project-Feld festgelegt sein.

<SyncField ProjectField="" />

Im folgenden Beispiel wird gezeigt, wie pjTaskText25 als Synchronisierungsfeld angegeben wird:

<SyncField ProjectField="pjTaskText25" />

Weitere Informationen zum Verwenden des Synchronisierungsfelds in Office Project finden Sie unter Veröffentlichen oder Aktualisieren von Arbeitsaufgaben in Project [umgeleitet].

ResourceNameSeparator-Element

Mit ResourceNameSeparator können Sie das Zeichen definieren, durch das Ressourcennamen in einer Zeichenfolge getrennt werden. Team Foundation-Benutzer und -Ressourcen werden mit den Benutzern des Active Directory-Verzeichnisdiensts synchronisiert. Die Namen für Benutzer und Ressourcen können ein Trennzeichen (z. B. ein Komma) enthalten, um den Nachnamen, Vornamen und Anfangsbuchstaben des zweiten Vornamens einer Ressource zu trennen.

Dies ist ein optionales Element. Wenn dieses Element nicht in der Zuordnung angegeben wird, werden Ressourcennamen in Microsoft Project mit den in der folgenden Tabelle definierten Standardzuordnungen getrennt:

Listentrennzeichen für Active Directory und das Teamprojekt	Ersetzung in Office Project
,	;
;	:
.	:

Wenn Sie ein Zeichen angeben möchten, das nicht in der obigen Tabelle enthalten ist, können Sie ResourceNameSeparator mit der folgenden Syntax definieren:

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

Das folgende Beispiel zeigt, wie das Zeichen "*" als Trennzeichen für Office Project angegeben wird, wenn das Team Foundation-Zeichen "-" ist:

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

Hierarchielinktyp

Wenn Sie Zusammenfassungsaufgaben in Microsoft Project erstellen, wird ein Strukturlink zwischen der Zusammenfassungsaufgabe, der übergeordneten Aufgabe und den untergeordneten Aufgaben erstellt. Office Project erstellt diese Links mithilfe der standardmäßigen System.LinkTypes.Hierarchy.

Abhängigkeitslinktyp

Wenn Sie in Microsoft Project Links zwischen Aufgaben erstellen, erstellen Sie einen abhängigen Link zwischen den Aufgaben. Der Vorgängeraufgabe wird ein Vorgängerlink zugewiesen, und der Nachfolgeraufgabe wird ein Nachfolgerlink zugewiesen. Diese sind die Standardbezeichnungen, die für den System.LinkTypes.Dependency-Linktyp definiert werden.

Zuordnung von Attributen, die Veröffentlichung und Aktualisierung betreffen

Die folgenden Zuordnungsfelder und Microsoft Project-Feldwerte bestimmen, ob ein Wert für eine Arbeitsaufgabe veröffentlicht oder aktualisiert wird:

• Der Wert des Felds Veröffentlichen und aktualisieren für jede Arbeitsaufgabe

• Der Wert des PublishOnly-Attributs für ein bestimmtes Zuordnungsfeld

• Der Wert des IfSummaryRefreshOnly-Attributs für ein bestimmtes Zuordnungsfeld

• Die Klassifizierung der Aufgabe als Zusammenfassungsaufgabe oder übergeordnete Aufgabe

  Eine übergeordnete Aufgabe ist eine Aufgabe mit mindestens einer untergeordneten Aufgabe, die in Team Foundation Server veröffentlicht wird.

Arbeitsaufgaben, die keine Zusammenfassungsaufgaben sind

Der folgenden Tabelle können Sie entnehmen, ob eine Arbeitsaufgabe, die keine Zusammenfassungsaufgabe oder übergeordnete Aufgabe ist, abhängig von den Zuordnungsfeldattributen und der Zuweisung des Werts Veröffentlichen und aktualisieren der Arbeitsaufgabe veröffentlicht oder aktualisiert wird.

Veröffentlichen und aktualisieren (Aufgabenebene)	PublishOnly-Attribut	Wird das Feld veröffentlicht?	Wird das Feld aktualisiert?
Nein	True oder False	Nein	Nein
Nur aktualisieren	True oder False	Nein	Ja
Ja	True	Ja	Nein
Ja	False	Ja	Ja

Arbeitsaufgaben, die Zusammenfassungsaufgaben sind

Wenn die Kriterien für Zusammenfassungsaufgaben erfüllt werden und IfSummaryRefreshOnly auf true festgelegt ist, hat dieser Wert Vorrang vor dem Wert von PublishOnly ab. Der folgenden Tabelle können Sie entnehmen, ob eine Zusammenfassungsaufgabe oder übergeordnete Aufgabe abhängig von der Zuweisung des Werts Veröffentlichen und aktualisieren und den Zuordnungsfeldattributen veröffentlicht oder aktualisiert wird.

Veröffentlichen und aktualisieren (Aufgabenebene)	PublishOnly-Attribut	IfSummaryRefreshOnly Attribut	Wird das Feld veröffentlicht?	Wird das Feld aktualisiert?
Nein	True oder False	True oder False	Nein	Nein
Nur aktualisieren	True	True	Nein	Ja
Nur aktualisieren	True	False	Nein	Ja
Nur aktualisieren	False	True oder False	Nein	Ja
Ja	True oder False	True	Nein	Ja
Ja	True	False	Ja	Nein
Ja	False	False	Ja	Ja

Siehe auch

Konzepte

Linktyp-Elementverweis

Hinzufügen oder Ändern der Zuordnung von Projektfeldern zu TFS-Feldern