Zuordnen von Microsoft Project-Feldern zu Team Foundation-Feldern

Artikel
05/16/2015

Sie können ändern, wie in Team Foundation gespeicherte Arbeitsaufgabenfelder Feldern zugeordnet werden, die für Microsoft Project definiert sind. Sie können ändern, wie bestimmte Felder veröffentlicht werden, und den Standardlinktyp festlegen, der beim Erstellen von hierarchischen Links, Strukturlinks und Abhängigkeitslinks verwendet wird.

Microsoft Project verwendet im Gegensatz zu Microsoft Excel eine begrenzte Anzahl von Spalten, einschließlich vordefinierter Spalten wie Aufgabenname und benutzerdefinierte Felder. Wenn ein Benutzer Arbeitsaufgabendaten in einer Microsoft Project-Datei veröffentlicht oder aktualisiert, bestimmt die Feldzuordnung, welche Felder in der Arbeitsaufgaben-Datenbank den Spalten in Microsoft Project entsprechen.

Die Zuordnungen können angepasst werden, beispielsweise zur Unterstützung eines von Ihnen erstellten Felds oder um Felder vordefinierten Spalten statt benutzerdefinierten Spalten zuzuordnen. Eine vollständige Dokumentation zur Feldzuordnungsdatei für Microsoft Project finden Sie unter Hinzufügen oder Ändern der Zuordnung von Projektfeldern zu TFS-Feldern.

Sie passen die Zuordnung an, indem Sie die Datei "FileMapping.xml" ändern. In der folgenden Tabelle sind die Namen der Datei, des Ordners und des Plug-Ins für die Prozessvorlagen für Microsoft Solutions Framework (MSF) zusammengefasst. Das Plug-In enthält die Definition der Aufgabe zum Hochladen der Datei in die Teamprojektsammlung.

Dateiname:

FileMapping.xml

Ordnername:

Klassifizierung

Plug-In-Name:

Microsoft.ProjectCreationWizard.Classification

Weitere Informationen finden Sie unter Definieren der anfänglichen Bereiche und Iterationen im Klassifizierungs-Plug-In.

Angeben der Zuordnung von Feldern

Sie geben zugeordnete Felder mit dem Mapping-Element und der folgenden Syntaxstruktur an:

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

In der folgenden Tabelle werden die Attribute des Mapping-Elements beschrieben.

Attribut	Beschreibung
WorkItemTrackingFieldReferenceName	Erforderlich. Gibt den Verweisnamen eines Felds in einem Typ von Arbeitsaufgabe an.
ProjectField	Erforderlich. Gibt den Namen einer Spalte in Microsoft Project an. Geben Sie vordefinierte Spaltennamen 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 dem Benutzer als Spaltenname angezeigt wird. Wenn dieses Attribut nicht angegeben ist, wird der Name des Felds im Typ der Arbeitsaufgabe verwendet.
ProjectUnits	Dies ist optional. Gibt den Einheitentyp an, der beim Zuordnen eines Typs von Feld zu Microsoft Project verwendet werden soll. Gültige Werte sind pjMinute, pjHour, pjDay, pjWeek und pjMonthUnit.
PublishOnly	Dies ist optional. Wenn das Attribut 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. Standardmäßig ist dieses Attribut auf false festgelegt. Standardmäßig ist dieses Attribut nur für Startdatum und Abschlussdatum auf true festgelegt.
IfSummaryRefreshOnly	Dies ist optional. Falls auf true festgelegt, 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 Microsoft Project. Die Werte von "Veröffentlichen" und "Aktualisieren" sind für die Zusammenfassungsaufgabe 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. Standardmäßig ist dieses Attribut auf false festgelegt. Hinweis Das IfSummaryRefreshOnly-Attribut hat Vorrang vor dem PublishOnly-Attribut.Weitere Informationen finden Sie unter Anpassen der Microsoft Project-Feldzuordnungsdatei. Das IfSummaryRefreshOnly-Attribut ist für die Felder Ursprüngliche Schätzung, Verbleibende Arbeit und Abgeschlossene Arbeit standardmäßig auf true festgelegt.

Angeben der Felder für Synchronisierung, Links und Anlagen

Zusätzlich zum Mapping-Element bestimmen zwei weitere Elemente, wie Felder synchronisiert werden und welches Feld Links und Anlagen unterstützt.

Das SyncField-Element gibt an, welche Spalte als Synchronisierungsfeld fungiert. Das Synchronisierungsfeld hat den Titel "Veröffentlichen und aktualisieren". Über dieses Feld kann der Benutzer angeben, ob eine Aufgabenzeile veröffentlicht oder lediglich aktualisiert werden soll.

Sie verwenden die folgende XML-Syntax, um anzugeben, welche Spalte dem Synchronisierungsfeld zugeordnet wird. Sie legen das "ProjectField"-Attribut auf eine gültige Spalte in Microsoft Project fest.

<SyncField ProjectField="" />

Das LinksField-Element gibt die Spalte "Links und Anlagen" an. Mithilfe der Spalte "Links und Anlagen" können Benutzer angeben, ob für eine bestimmte Aufgabenzeile Links oder Anlagen vorhanden sind.

Sie verwenden die folgende XML-Syntax, um anzugeben, welche Spalte dem Feld "Links und Anlagen" zugeordnet wird. Sie legen das "ProjectField"-Attribut auf eine gültige Spalte in Microsoft Project fest.

<LinksField ProjectField="" />

Standardfeldzuordnungen

Das folgende Beispiel veranschaulicht, wie durch die Prozessvorlage für MSF for Agile Software Development Spalten in Microsoft Project Feldern in Arbeitsaufgaben zugeordnet werden.

<?xml version="1.0" encoding="utf-8"?>
<MSProject>
  <Mappings>
    <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" />
    <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="Work Item ID" />
    <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" />
    <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="State" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" />
    <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="Work Item Priority" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="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.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
    <LinksField ProjectField="pjTaskText26" />
    <SyncField ProjectField="pjTaskText25" />
  </Mappings>
</MSProject>

Siehe auch

Konzepte

Definieren der anfänglichen Bereiche und Iterationen im Klassifizierungs-Plug-In

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

Anpassen der Microsoft Project-Feldzuordnungsdatei

Freigeben über