Importieren, Aktualisieren und Exportieren von Massenarbeitselementen mit CSV-Dateien in Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Importieren und Exportieren von Arbeitsaufgaben in Massen mithilfe von CSV-formatierten Dateien in Azure Boards. Sie können Excel zwar weiterhin für Massenimporte und -aktualisierungen verwenden, können aber auch das native Feature zum Importieren/Exportieren verwenden, für das Excel nicht erforderlich ist. Weitere Informationen finden Sie unter Massenhinzufügen oder -ändern von Arbeitselementen mit Excel.
Sie können Arbeitselemente per Massenvorgang mithilfe einer CSV-formatierten Datei exportieren. Sie können Excel zwar weiterhin für Massenimporte und -aktualisierungen verwenden, können aber auch das native Exportfeature von Abfragen verwenden, für das Excel nicht erforderlich ist. Weitere Informationen finden Sie unter Massenhinzufügen oder -ändern von Arbeitselementen mit Excel.
Importieren neuer Arbeitselemente
Führen Sie die folgenden Schritte aus, um neue Arbeitselemente zu importieren.
Hinweis
Sie können bis zu 1.000 Arbeitsaufgaben gleichzeitig importieren. Wenn Sie mehr als 1.000 Arbeitsaufgaben zum Importieren haben, unterteilen Sie diese in mehrere Dateien und importieren Sie diese separat.
Erstellen Sie eine lokale Datei vom Typ import.csv, und öffnen Sie sie in Visual Studio Code oder Excel.
Die Datei muss die Felder Arbeitselementtyp und Titel enthalten. Sie können bei Bedarf andere Felder aufnehmen. Eine Liste der Standardfelder finden Sie im Index der Arbeitselementfelder.
Das folgende Beispiel enthält das Feld "Priorität ".
Work Item Type,Title,Priority Issue,Fix issues with code,1 Issue,Merge testing modules,3 Issue,Open private preview for select customers,2 Issue,Enable feature for customer champs,2 Issue,Remove old test code,2Öffnen Sie im Webportal für Ihr Projekt Boards>Abfragen, und wählen Sie dann Arbeitselemente importieren aus.
Wählen Sie Datei auswählen, anschließend Ihre Datei und dann Importieren aus.
Der Importvorgang lädt die importierten Arbeitselemente im nicht gespeicherten Zustand in die Abfrageansicht. Es werden keine IDs zugewiesen.
Überprüfen Sie die Ergebnisse, und wählen Sie dann Elemente speichern aus, um die Arbeitsaufgaben zu speichern.
Tipp
Weisen Sie neuen Arbeitsaufgaben, die Sie hinzufügen, keine IDs zu. Das Zuweisen von IDs führt zu einer Fehlermeldung.
Vom System werden diese Arbeitselemente mit Datenproblemen hervorgehoben. Beheben Sie die Datenprobleme, bevor Sie die Arbeitselemente speichern. In diesem Beispiel befindet sich ein ungültiger Wert im Feld „Priorität“. Korrigieren Sie die Daten, indem Sie das Arbeitselement direkt öffnen. Verwenden Sie stattdessen Massenbearbeitung, um mehrere Arbeitselemente mit demselben Problem zu korrigieren.
Die folgenden Tipps können hilfreich sein.
Links zwischen übergeordneten und untergeordneten Elementen: Sie können über- und untergeordnete Links zwischen importierten Arbeitselementen hinzufügen, indem Sie die Titelspalten einrücken wie unter Kann ich eine CSV-Datei importieren, die hierarchische Links enthält? gezeigt. Sie können jedoch keine anderen Verknüpfungstypen angeben, wenn Sie Arbeitsaufgaben importieren oder aktualisieren.
Standardstatusfeld: Wenn Sie neue Arbeitsaufgaben importieren, wird das Feld "Status " standardmäßig auf "Neu" festgelegt. Sie können während des Importvorgangs keinen anderen Status angeben. Wenn Sie den Status importierter Arbeitsaufgaben ändern müssen, verwenden Sie die folgende Problemumgehung:
- Importieren Sie die Arbeitsaufgaben mit dem Standardstatus "Neu ".
- Exportieren Sie die importierten Arbeitselemente in eine CSV-Datei.
- Aktualisieren Sie die Werte des Felds "Status" in der exportierten CSV-Datei.
- Importieren Sie die aktualisierte CSV-Datei erneut, um die gewünschten Status festzulegen.
Standardfelder "Bereich" und "Iteration": Die Felder "Bereich" und "Iteration " standardmäßig auf dem Knoten der obersten Ebene. Dieses Verhalten tritt auf, da der Importvorgang nicht über den Kontext für diese Felder verfügt, es sei denn, er wird explizit in der CSV-Datei angegeben. Um bestimmte Bereichs- und Iterationspfade während des Imports festzulegen, stellen Sie sicher, dass diese Felder in der CSV-Datei mit den richtigen Werten enthalten sind. Zum Beispiel:
Title,Description,Area Path,Iteration Path "Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"
Aktualisieren vorhandener Arbeitselemente
Erstellen Sie zum Aktualisieren von Arbeitselementen eine Abfrage, die alle Spalten enthält, die Sie exportieren und möglicherweise bearbeiten möchten. Speichern Sie Ihre Abfrage, und wählen Sie "In CSV exportieren" aus, um die data.csv Datei auf Ihrem lokalen Computer zu speichern.
Die exportierte Datei sollte ähnlich wie im folgenden Beispiel aussehen:
ID,Work Item Type,Title,Assigned To,State,Tags "272","Issue","Fix issues with code","Active","", "273","Issue","Merge testing modules","Active","", "274","Issue","Open private preview for select customers","Active","", "275","Issue","Enable feature for customer champs","Active","", "276","Issue","Remove old test code","Active","",Nehmen Sie die gewünschten Änderungen an Ihren Arbeitselementen vor. Ihre CSV-Datei muss die Felder ID, Arbeitselementtyp und Titel enthalten. Alle anderen Felder, die Sie einschließen möchten, sind optional.
Hinweis
Wenn Sie Identitätsfelder importieren, geben Sie den Namen und die E-Mail-Adresse im folgenden Format ein:
"Display Name <email>". Wenn Sie beispielsweise Jamal Hartnett Aufgaben zuweisen möchten, geben Sie"Jamal Hartnett <fabrikamfiber4@hotmail.com>"an. Wenn Sie einen Wert angeben, der nicht als gültige*r Benutzer*in für das System erkannt wird, treten möglicherweise Probleme beim Import auf.Im folgenden Beispiel ändern wir Werte für vorhandene Arbeitsaufgaben.
ID,Work Item Type,Title,Assigned To,State,Tags "272","Issue","Fix issues with code","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active", "273","Issue","Merge testing modules","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active", "274","Issue","Open private preview for select customers","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active", "275","Issue","Enable feature for suctomer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active", "276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",Speichern Sie die Datei, und importieren Sie sie, wie im vorherigen Abschnitt beschrieben.
Die Ergebnisliste mit Arbeitselementen, die Wertänderungen enthalten, wird fett hervorgehoben. Wählen Sie Elemente speichern aus, um die Änderungen anzuwenden.
Arbeitselemente mit Datenproblemen sind rot hervorgehoben und müssen korrigiert werden, bevor Sie sie speichern können. In diesem Beispiel wird im Feld „Zugewiesen zu“ ein ungültiger Wert angezeigt. Korrigieren Sie die Daten, indem Sie das Arbeitselement direkt öffnen. Sie können die Massenbearbeitung verwenden, wenn Sie über viele Arbeitselemente mit demselben Problem verfügen.
Exportieren einer Liste als CSV-Datei
In jeder Abfrage können Sie eine Liste mit Arbeitselementen als durch Trennzeichen getrennte Liste exportieren. Öffnen Sie die Abfrage, und wählen Sie das Aktionssymbol 
und dann Nach CSV exportieren aus.
Hinweis
Erfordert Azure DevOps Server 2019, Update 1 oder höher.
Exportieren und Importieren von Arbeitselementen in ein anderes Projekt
Sie können dieses Feature verwenden, um Arbeitselemente aus einem Projekt zu exportieren und in ein anderes Projekt zu importieren. Bevor Sie sie jedoch in ein anderes Projekt importieren, müssen Sie die Arbeitselement-ID entfernen. Ein Fehler tritt auf, wenn Sie versuchen, neue Arbeitselemente mit einer angegebenen ID in ein Projekt zu importieren.
Importieren von HTML-Feldern
HTML-Felder, z. B. Beschreibungen und Akzeptanzkriterien, enthalten Rich-Text-Formatierungen. Führen Sie die folgenden Aufgaben aus, um sicherzustellen, dass diese Formatierung erhalten bleibt:
- Stellen Sie sicher, dass Ihre CSV-Datei HTML-Tags in den relevanten Feldern enthält.
- Importieren Sie die CSV-Datei in Excel.
Excel behandelt mehrzeilige Textfelder möglicherweise anders, daher ist es wichtig, die Formatierung nach dem Import zu überprüfen. Ersetzen Sie Zeilen, die mit CRLF enden, indem Sie Sätze in <p>... </p> einschließen.
Sie können z. B. die folgende Arbeitsaufgabe importieren, die drei Textzeilen im Feld "Beschreibung " enthält.
Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong> You can include bold text</strong></p><p><em> And italic text</em></p><p><u> Underline text</u></p>"
Konvertieren von mehrzeiligen Feldern in Nur-Text
Um HTML in mehrzeiligen Feldern zu deaktivieren, um sicherzustellen, dass sie Nur-Text sind, können Sie den witadmin changefield Befehl verwenden. Weitere Informationen finden Sie unter "Arbeitselementfelder verwalten".
Beispiel für einen -Befehl:
witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText
Behandeln von Formatierungsinkonsistenzen
Wenn Sie mit HTML-Feldern in verschiedenen Microsoft-Produkten arbeiten, treten möglicherweise Formatierungsinkonsistenzen auf. Hier sind einige Tipps zur Behandlung dieser Probleme:
- Überprüfen Sie die Formatierung nach dem Importieren, um sicherzustellen, dass sie Ihren Anforderungen entspricht.
- Verwenden Sie geeignete HTML-Tags und -Strukturen, um Abweichungen zu minimieren. Sie können mehrere Tags getrennt durch ein Semikolon hinzufügen. Weitere Informationen finden Sie unter Aufgaben, die Sie mit Excel ausführen können.
Weitere Informationen zum Verwalten von HTML-Inhalten und zur Sicherstellung der Kompatibilität finden Sie unter Bereitstellen von Hilfetext, Links oder Webinhalten in einem Arbeitsaufgabenformular.
Häufig gestellte Fragen
F: Kann ich in derselben CSV-Datei neue Elemente importieren und vorhandene Elemente aktualisieren?
A: Auf jeden Fall! Lassen Sie das ID-Feld für alle neuen Arbeitselemente leer. Im folgenden Beispiel gibt der letzte Eintrag für ein Epic keine ID an.
ID,Work Item Type,Title,Assigned To,State,Priority,Tags
"16504","Issue","Fix issues with code",,"To Do","1",
"16505","Issue","Merge testing modules",,"To Do","3",
"16506","Issue","Open private preview for select customers",,"To Do","2",
"16507","Issue","Enable feature for customer champs",,"To Do","2",
"16508","Issue","Remove old test code",,"To Do","2",
,"Epic","Track Telemetry for data imports",,"To Do","2",
F: Kann ich eine CSV-Datei importieren, die hierarchische Links enthält?
A: Ja, Sie können untergeordnete Arbeitselemente hinzufügen, indem Sie Titelspalten einziehen. Im folgenden Beispiel werden drei untergeordnete Issues unter dem bereits definierten Epic hinzugefügt.
ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telemetry for data imports",,,"To Do","2",
,"Issue",,"Fix issues with code",,"To Do","1",
,"Issue",,"Open private preview for select customers",,"To Do","2",
,"Issue",,"Enable feature for customer champs",,"To Do","2",
F: Wie kann ich feststellen, ob meine importierte Datei Fehler enthält?
A: Sie können Tests durchführen, indem Sie z. B. Tags mit Leerzeichen und Bindestrichen hinzufügen und die Tags in den Export einschließen. Der Import sollte demselben Format entsprechen. Probleme mit der Formatierung Ihrer CSV-Datei werden auf der Seite „Ergebnisse“ der Importansicht angezeigt. Sie können die Arbeitselemente erst importieren, wenn die Formatierung und Syntax korrekt sind.
In den Ergebnissen der Arbeitselemente werden immer die Datenfehler aufgelistet, die für einzelne Arbeitselemente gefunden wurden. Beheben Sie die Fehler entweder über das Webportal oder in der CSV-Datei, und importieren Sie sie erneut.
F: Warum erhalte ich Fehler für einige Identitätswerte?
A: Wenn Sie die Webbenutzeroberfläche verwenden, durchläuft die Identitätsauswahl zusätzliche Schritte, um den*die Benutzer*in zu überprüfen. Zuerst wird überprüft, ob die Person ein*e gültige*r Benutzer*in in der Organisation ist. Falls nicht, wird nach der Identität in AAD gesucht. Wenn sich der Benutzer in Microsoft Entra ID, aber nicht in der Organisation befindet, wird dieser Benutzer den gültigen Identitäten hinzugefügt.
Wenn Sie aus CSV importieren, führt die Identitätsauswahl aus Leistungsgründen diese zusätzlichen Schritte nicht durch. Sie überprüft lediglich, ob ein übereinstimmender User Principal Name (UPN) bereits in der Organisation vorhanden ist. Wenn kein übereinstimmender UPN gefunden wird, wird gemeldet, dass die Identität unbekannt ist.
F: Unterstützt der CSV-Import alle Arbeitselementtypen?
A: Nein, der CSV-Import unterstützt die folgenden Arbeitselementtypen nicht:
- Codereviewanforderung
- Code Review Antwort
- Feedback-Anfrage
- Feedback Antwort
- Testfall
- Prüfplan
- Test-Suite
- Freigegebener Parameter
Weitere Informationen finden Sie unter Massenimport oder Exportieren von Testfällen.