Importieren, Aktualisieren und Exportieren von Massenarbeitselementen mit CSV-Dateien in Azure Boards

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

Um Arbeitsaufgaben in Massen zu importieren, muss die CSV-Datei die Felder "Arbeitselementtyp " und "Titel " enthalten. Sie können bei Bedarf andere Felder aufnehmen. So importieren Sie eine CSV-Datei:

• Schließen Sie das ID-Feld nicht ein.
• Wenn die CSV-Datei aus einem anderen Projekt exportiert wurde, entfernen Sie Felder, die einen bestimmten Wert für das Quellprojekt enthalten. Sie können z. B. "Bereichspfad", "Tags" für eine Liste der Standardfelder unter "Arbeitselementfeldindex" entfernen.
• Beim Importieren von Testfällen müssen Sie das Feld "Testschritte " einschließen. Weitere Informationen finden Sie unter Massenimport oder Exportieren von Testfällen. Schließen Sie keine Felder "Zugewiesen an", "Geändert am", "Erstellt von" oder "Bundesland" ein.
• Stellen Sie sicher, dass die Felder "Arbeitselementtyp " und "Titel " in der CSV-Datei enthalten sind.
• Stellen Sie sicher, dass der Arbeitsaufgabentyp ein gültiger Typ im Zielprojekt ist.
• Stellen Sie sicher, dass die Felder in der CSV-Datei mit den Feldern fi=oder dem Arbeitsaufgabentyp im Zielprojekt übereinstimmen.
• Wenn Sie eine CSV-Datei importieren, die Arbeitsaufgaben enthält, die ungültige Werte enthalten, müssen Sie nach dem Importieren der Datei die Arbeitsaufgaben bearbeiten, um die ungültigen Werte zu beheben, bevor Sie die Arbeitsaufgaben speichern können.

Führen Sie die folgenden Schritte aus, um neue Arbeitselemente zu importieren.

1. Erstellen Sie eine lokale Datei vom Typ import.csv, und öffnen Sie sie in Visual Studio Code oder Excel.

2. 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
   

3. Öffnen Sie im Webportal für Ihr Projekt Boards>Abfragen, und wählen Sie dann Arbeitselemente importieren aus.

   

4. 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.

5. Ü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.

6. 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:

  1. Importieren Sie die Arbeitsaufgaben mit dem Standardstatus "Neu ".
  2. Exportieren Sie die importierten Arbeitselemente in eine CSV-Datei.
  3. Aktualisieren Sie die Werte des Felds "Status" in der exportierten CSV-Datei.
  4. 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

1. 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","",
   

2. 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 customer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
   "276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",
   

3. Speichern Sie die Datei, und importieren Sie sie, wie im vorherigen Abschnitt beschrieben.

4. Die Ergebnisliste mit Arbeitselementen, die Wertänderungen enthalten, wird fett hervorgehoben. Wählen Sie Elemente speichern aus, um die Änderungen anzuwenden.

   

5. 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.

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.

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.