Beheben von Fehlern bei der Konfiguration von Funktionen
Möglicherweise sind Sie in der Lage, Fehler zu beheben und Warnungen aufzulösen, die der Assistent zum Konfigurieren von Funktionen anzeigt. Diese Probleme treten auf, weil Definitionen im Teamprojekt im Konflikt mit Definitionen in den Prozessvorlagen stehen, die in die Teamprojektauflistung hochgeladen werden. Sie sollten die Prozessvorlage ändern, um den Fehler zu beheben, und den Assistenten erneut ausführen. Stattdessen können Sie auch das Teamprojekt ändern und den Assistenten erneut ausführen.
In diesem Thema
Beheben der Fehler, die vom Assistenten zum Konfigurieren von Funktionen gemeldet werden
Beheben von Fehlern durch Änderung einer Prozessvorlage
Beheben von Fehlern durch Änderung eines Teamprojekts oder einer Teamprojektauflistung
Probleme und Lösungen
Auflösen von Warnungen, die vom Assistenten zum Konfigurieren von Funktionen gemeldet wurden
Auflösen von Warnungen zum Hinzufügen einer ACTION-Anweisung zu einem Arbeitsaufgabentyp
Hinzufügen des Storyboardlinksteuerelements
Hinweis
Wenn Sie beim Ausführen der folgenden Prozeduren auf Probleme stoßen, finden Sie Lösungen möglicherweise in den Foren für Team Foundation Server (TFS), auf den folgenden Seiten auf der Microsoft-Website: Fragen zur Arbeitsaufgabenverfolgung und Fragen zu Prozessvorlagen.
Erforderliche Berechtigungen
Um Prozessvorlagen herunter- und hochladen zu können, müssen Sie Mitglied der Gruppe Projektauflistungsadministratoren sein. Wenn Sicherheitsberechtigungen explizit festgelegt sind, muss die Berechtigung Prozessvorlage verwalten für die Teamprojektauflistung auf Zulassen festgelegt sein.
Um das Befehlszeilentool witadmin ausführen zu können, müssen Sie Mitglied einer der folgenden Gruppen sein: Team Foundation-Administratoren, Projektauflistungsadministratoren oder Projektadministratoren für das Teamprojekt.
Weitere Informationen finden Sie unter Berechtigungsreferenz für Team Foundation Server.
Beheben der Fehler, die vom Assistenten zum Konfigurieren von Funktionen gemeldet werden
Sie können einen Fehler beheben, indem Sie die Prozessvorlage ändern, mit der die neuen Funktionen konfiguriert werden, oder indem Sie das Teamprojekt ändern. Nachdem Sie den Fehler behoben haben, führen Sie den Assistenten erneut aus.
Beheben von Fehlern durch Änderung einer Prozessvorlage
Sie ändern eine Prozessvorlage, indem Sie diese Schritte ausführen:
Laden Sie die Prozessvorlage von Team Foundation Server herunter. Siehe Herunterladen der neuesten Version der Prozessvorlagen.
Ändern Sie eine Definitionsdatei für einen Arbeitsaufgabentyp, Kategorien oder eine Prozesskonfiguration. Siehe Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams.
Laden Sie die Prozessvorlage auf Team Foundation Server hoch. Siehe Prozessvorlagen für eine Teamprojektsammlung für das Hochladen, Herunterladen und Löschen.
Siehe auch Update einer angepassten Prozessvorlage für den Zugriff auf neue Funktionen.
Beheben von Fehlern durch Änderung des Teamprojekts oder der Teamprojektauflistung
Um Fehler zu beheben oder eine Warnung aufzulösen, können Sie das Teamprojekt oder die Teamprojektauflistung mithilfe des Befehls witadmin ändern. Siehe witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung.
Sie können eine Typdefinition exportieren, Änderungen an den Felddefinitionen vornehmen und dann die Typdefinition nach Bedarf importieren. Siehe Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin].
Probleme und Lösungen
Um die Fehler zu beheben, die in der folgenden Tabelle aufgeführt sind, führen Sie die entsprechenden Korrekturmaßnahmen entweder an der Prozessvorlage oder am Teamprojekt aus, und führen Sie den Assistenten erneut aus.
Fehler |
Problem |
Lösung anhand der Prozessvorlage |
Lösung anhand des Teamprojekts |
|---|---|---|---|
TF400613: Der in Kategorie '{0}' angegebene Arbeitsaufgabentyp '{1}' ist nicht vorhanden. |
Ein erforderlicher Arbeitsaufgabentyp fehlt im Teamprojekt, da er umbenannt, entfernt oder nicht hinzugefügt wurde. Benennen Sie entweder die Definition für den angegebenen Arbeitsaufgabentyp um, oder importieren Sie den fehlenden Arbeitsaufgabentyp aus der aktuellen Version der Prozessvorlagen, die mit dem TFS-Upgrade installiert wurden. |
Ändern Sie den Arbeitsaufgabentyp, der in der angegebenen Kategorie definiert wird, sodass ein vorhandener Arbeitsaufgabentyp angegeben wird. |
Um einen Arbeitsaufgabentyp umzubenennen, verwenden Sie witadmin renamewitd. Um einen fehlenden Arbeitsaufgabentyp hinzuzufügen, suchen Sie ihn in der neuesten Prozessvorlage, und importieren Sie ihn mit witadmin importwitd. Siehe Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin]. |
TF400614: Die Kategorie '{0}' ist nicht vorhanden. |
Eine erforderliche Kategorie fehlt in der Kategoriedefinitionsdatei in der Prozessvorlage, die zur Aktualisierung des Teamprojekts ausgewählt wurde. Fügen Sie die fehlende Kategorie hinzu. |
Fügen Sie die fehlende Kategorie der Prozessvorlage hinzu. Siehe Verwenden von Kategorien für Arbeitsaufgabentypen. |
Fügen Sie die fehlende Kategorie dem Teamprojekt hinzu, indem Sie witadmin importcategories verwenden. Siehe Importieren und Exportieren von Kategorien [witadmin]. |
TF400617: Der Typ von Feld '{0}' in Arbeitsaufgabentyp '{1}' steht in Konflikt mit dem Typ des vorhandenen Felds. |
Der Datentyp des Felds, das im hinzugefügten Arbeitsaufgabentyp definiert wird, stimmt nicht mit dem Datentyp überein, der in der Teamprojektauflistung definiert ist. Korrigieren Sie die Zuweisung in der Definition des Arbeitsaufgabentyps, und führen Sie den Assistenten erneut aus. Hinweis Im Upgrade Visual Studio Team Foundation Server 2012 wird das Feld Beschreibung (System.Description) vom Klartextfeldtyp in HTML geändert, um Textformatierung und das Einfügen von Bildern und Links zu unterstützen.In der neuesten Version von Team Foundation Server können Sie den Datentyp zwischen PlainText und HTML wechseln. |
Laden Sie die Prozessvorlage herunter, öffnen Sie die Typdefinition, suchen Sie die FIELD-Zuweisung, ändern Sie das type-Attribut in das Attribut, das für die Auflistung definiert ist, und laden Sie dann die Prozessvorlage hoch. Siehe FIELD (Definition)-Elementverweis. Tipp Um festzustellen, welcher Typ einem Feld zugewiesen ist, führen Sie witadmin listsfields aus. |
Verwenden Sie witadmin changefield, und geben Sie das type-Attribut an. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin]. Hinweis Sie können die Typdefinition für die Teamprojektauflistung nur ändern, wenn der Typ PlainText oder HTML ist. |
TF400618: Der Berichterstellungstyp von Feld '{0}' im Arbeitsaufgabentyp '{1}' steht in Konflikt mit dem Berichterstellungstyp des vorhandenen Felds. |
Ein Berichterstellungsattribut, das einem Feld in einer Arbeitsaufgabentyp-Definition zugewiesen ist, stimmt nicht mit dem Attribut überein, das in der Teamprojektauflistung definiert ist. |
Laden Sie die Prozessvorlage herunter, öffnen Sie die Typdefinition, suchen Sie die FIELD-Zuweisung, und ändern Sie das reportable-Attribut in das Attribut, das für die Auflistung definiert ist. Laden Sie dann die Prozessvorlage hoch. Siehe FIELD (Definition)-Elementverweis. |
Verwenden Sie witadmin changefield, und geben Sie das reportingtype-Attribut an. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin]. |
TF400619: Das SyncNameChanges von Feld '{0}' im Arbeitsaufgabentyp '{1}' steht in Konflikt mit dem SyncNameChanges des vorhandenen Felds. |
Ein syncnamechanges-Attribut, das einem Feld in einer Arbeitsaufgabentyp-Definition zugewiesen ist, stimmt nicht mit dem Attribut überein, das in der Teamprojektauflistung definiert ist. Dieses Attribut gibt an, ob ein Personennamenfeld aktualisiert werden soll, wenn sich dieser Name in Active Directory ändert. |
Laden Sie die Prozessvorlage herunter, öffnen Sie die Typdefinition, suchen Sie die FIELD-Zuweisung, ändern Sie sie so ab, dass sie der Definition in der Auflistung entspricht, und laden Sie dann die Prozessvorlage hoch. Siehe FIELD (Definition)-Elementverweis. |
Verwenden Sie den Befehl witadmin changefield, und geben Sie den /syncnamechanges-Parameter an. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin]. |
TF400620: Der Anzeigename von Feld '{0}' im Arbeitsaufgabentyp '{1}' steht in Konflikt mit dem Anzeigenamen des vorhandenen Felds. |
Der Anzeigename, der einem Feld in einer Arbeitsaufgabentyp-Definition zugewiesen ist, muss mit dem übereinstimmen, der in der Teamprojektauflistung definiert ist. |
Laden Sie die Prozessvorlage herunter, öffnen Sie die Typdefinition, suchen Sie die FIELD-Zuweisung, und ändern Sie sie so ab, dass sie der Definition für die Auflistung entspricht. Laden Sie dann die Prozessvorlage hoch. |
Um den Anzeigenamen für die Teamprojektauflistung zu ändern, verwenden Sie den Befehl witadmin changefield, und geben Sie den /name-Parameter an. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin]. |
TF400621: Der Verweisname von Feld '{0}' im Arbeitsaufgabentyp '{1}' wird bereits von einem Linktyp verwendet. |
Alle Verweisnamen, die Feldern und Linktypen zugewiesen sind, müssen in einer Teamprojektauflistung eindeutig sein. |
Wenn der Linktyp aktiv ist und derzeit zur Verknüpfung von Arbeitsaufgaben verwendet wird, laden Sie die Prozessvorlage herunter, öffnen Sie die Typdefinition, suchen Sie die FIELD-Zuweisung, und ändern Sie die refname-Zuweisung so ab, dass sie der für die Auflösung definierten Zuweisung entspricht. Laden Sie dann die Prozessvorlage hoch. Tipp Um festzustellen, ob ein Linktyp derzeit verwendet wird, erstellen Sie eine Direktlinkabfrage, und filtern Sie dann alle Arbeitsaufgaben heraus, die mit einer anderen Arbeitsaufgabe verknüpft sind, die diesen Linktyp verwendet. |
Wenn der Linktyp nicht aktiv ist oder derzeit nicht zur Verknüpfung von Arbeitsaufgaben innerhalb der Teamprojektauflistung verwendet wird, löschen Sie ihn. Sie können einen Linktyp mit witadmin deletelinktype löschen. Siehe Verwalten von Linktypen [witadmin]. |
TF400624: Der Anzeigename von Kategorie '{0}' steht in Konflikt mit Kategorie '{1}'. |
Sie müssen jeder Kategorie eines Teamprojekts einen eindeutigen Verweisnamen und Anzeigenamen zuordnen. Sie können diesen Fehler beheben, indem Sie die vorhandene Kategorie '{1}' entweder in der Prozessvorlage oder im Teamprojekt umbenennen. |
Laden Sie die Prozessvorlage herunter, ändern Sie die Kategoriedatei, um die Kategorie umzubenennen, und laden Sie dann die Prozessvorlage hoch. Siehe Verwenden von Kategorien für Arbeitsaufgabentypen. |
Exportieren Sie die Kategoriedatei mit witadmin exportcategories, ändern Sie den Anzeigenamen, der der Kategorie '{1}' zugewiesen ist, und importieren Sie die Datei. Siehe Importieren und Exportieren von Kategorien [witadmin]. |
TF400654: Planungstools können nicht konfiguriert werden. |
Eine Zuordnung, die in der CommonConfiguration-Datei definiert ist, gibt ein Feld oder einen Zustand an, das oder der im für das Teamprojekt definierten Arbeitsaufgabentyp nicht vorhanden ist. |
Laden Sie die Prozessvorlage herunter, ändern Sie die CommonConfiguration-Datei, um die Zuordnung zu korrigieren, und laden Sie dann die Prozessvorlage hoch. Siehe Anpassen der Prozesskonfiguration |
Exportieren Sie den Arbeitsaufgabentyp mit witadmin exportwitd, fügen Sie das fehlende Feld oder den fehlenden Zustand hinzu, und importieren Sie den Arbeitsaufgabentyp. Siehe Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin]. |
Weitere Informationen finden Sie in den folgenden Themen:
Auflösen von Warnungen, die vom Assistenten zum Konfigurieren von Funktionen gemeldet wurden
Um Warnungen aufzulösen, die in der folgenden Tabelle aufgeführt sind, folgen Sie den Lösungsschritten, und führen Sie den Assistenten erneut aus.
Warnung |
Problem |
Lösung |
|---|---|---|
TF400609: Die Aktion '{0}' kann nicht zum Arbeitsaufgabentyp '{1}' hinzugefügt werden, da Zustand '{2}' nicht vorhanden ist. |
Ein erforderliches STATE fehlt. |
Siehe das Thema zum Beheben von Fehlern durch Hinzufügen einer ACTION-Anweisung zu einem Arbeitsaufgabentyp. |
TF400610: Die Aktion '{0}' kann nicht zum Arbeitsaufgabentyp '{1}' hinzugefügt werden, da der Übergang von Zustand '{2}' zu '{3}' nicht vorhanden ist. |
Eine erforderliche TRANSITION-Anweisung fehlt. |
Siehe das Thema zum Beheben von Fehlern durch Hinzufügen einer ACTION-Anweisung zu einem Arbeitsaufgabentyp. |
Storyboarding: Arbeitsaufgabentyp '{1}' in Kategorie '{2}' kann keine Registerkarte hinzugefügt werden. |
Das TabGroup-Element fehlt in der Typdefinition. |
Siehe Hinzufügen des Storyboardlinksteuerelements. |
Auflösen von Warnungen zum Hinzufügen einer ACTION-Anweisung zu einem Arbeitsaufgabentyp
Zur Unterstützung der Funktion "Meine Arbeit" fügt der Assistent zum Konfigurieren von Funktionen zwei ACTION-Anweisungen in den Abschnitt für den Workflowübergang der Definition für Aufgaben-Arbeitsaufgabentypen ein. Wenn entweder die Zustände oder die Übergänge für die Umstellung vom Zustand "Neu" zum Zustand "Aktiv" oder vom Zustand "Aktiv" zum Zustand "Neu" fehlen, erhalten Sie eine Warnung.
Um Warnungen aufzulösen, überprüfen Sie den Workflow für den angegebenen Arbeitsaufgabentyp. Ändern Sie gegebenenfalls den Workflow, um die Workflowzustände und -übergänge aufeinander abzustimmen, die für die neueste auf dem aktualisierten TFS installierte Version der Prozessvorlage definiert sind; dies entspricht der Version, mit der Ihr Teamprojekt erstellt wurde. Führen Sie den Assistenten erneut aus. Für Teamprojekte, die auf der Agile-Prozessvorlage basieren, lesen Sie Update des Workflows für Agile-Teamprojekte.
Weitere Informationen finden Sie in den folgenden Themen:
Hinzufügen der Registerkarte für das Storyboardlinksteuerelement
Mit der neuen Storyboarding-Funktion können Sie Arbeitsaufgaben nun mit Storyboards verknüpfen. Hierzu fügen Sie die Registerkarte mit den Storyboard-Linksteuerelementen der Definition des Arbeitsaufgabentyps hinzu. Wenn der Assistent zum Konfigurieren von Funktionen die Registerkarte nicht hinzugefügt hat oder nicht hinzufügen konnte, können Sie sie manuell hinzufügen. In den neuesten Versionen der Prozessvorlagen, die auf dem aktualisierten TFS installiert sind, wird die Registerkarte mit den Storyboard-Linksteuerelementen für alle Backlog-Arbeitsaufgabentypen angezeigt, z. B. "Product Backlog", "User Story" und "Anforderung".
Hinweis
Der Assistent zum Konfigurieren von Funktionen kann die Registerkarte mit den Storyboard-Linksteuerelementen nicht hinzufügen, wenn das TabGroup-Element im FORM-Abschnitt für die Arbeitsaufgabe fehlt.Im folgenden Verfahren wird nur die Registerkarte Storyboard hinzugefügt.Wenn Sie den Standardsatz von Registerkarten für den Backlog-Arbeitsaufgabentyp hinzufügen möchten, finden Sie die Typdefinition in der neuesten Version der Prozessvorlage für das Teamprojekt.Siehe Herunterladen der neuesten Version der Prozessvorlagen.
Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDEErsetzen Sie bei einer 32-Bit-Windows-Edition %programfiles(x86)% durch %programfiles%.
Exportieren Sie die Typdefinitionsdatei für das Backlog-Element, indem Sie die gezeigten Argumente durch Ihre eigenen Daten ersetzen:
witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:"TypeName" /f:"DirectoryPath\FileName.xml" Where: CollectionURL specifies the URL of the team project collection ProjectName specifies the name of your team project defined within the collection TypeName specifies the name of your backlog item, for example User Story or Product Backlog Item. Use the following format for CollectionURL: http://ServerName:Port/VirtualDirectoryName/CollectionName For example: http://srvalm:8080/tfs/DefaultCollection.Öffnen Sie mithilfe eines Text-Editors, z. B. Editor, die Datei.
Fügen Sie diesen Codeausschnitt unmittelbar vor dem </Layout>-Endtag des Backlog-Typs hinzu:
<TabGroup> <Tab Label="Storyboards"> <Control Name="StoryboardsControl" Type="LinksControl"> <LinksControlOptions> <WorkItemLinkFilters FilterType="excludeAll" /> <ExternalLinkFilters FilterType="include"> <Filter LinkType="Storyboard" /> </ExternalLinkFilters> <LinkColumns> <LinkColumn RefName="System.Title" /> <LinkColumn LinkAttribute="System.Links.Comment" /> </LinkColumns> </LinksControlOptions> </Control> </Tab> </TabGroup>Speichern und schließen Sie die Datei.
Importieren Sie die Typdefinitionsdatei, indem Sie diesen Befehl eingeben und dabei die gezeigten Argumente durch Ihre eigenen Daten ersetzen:
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"Überprüfen Sie, ob die Registerkarte im Backlog-Element angezeigt wird.