Jira Cloud Dokumentation

Erstelle Vorgänge mit dem CSV-Importer






CSV-Dateien (Comma-Separated Value) sind Textdateien, die tabellarische Daten darstellen und von den meisten Systemen unterstützt werden, die tabellarische Daten verarbeiten, z. B. Spreadsheets und Datenbanken. Mit dem CSV-Importer kannst du Daten aus externen Systemen importieren, die ihre Daten in einem tabellarischen Format exportieren können. Du kannst auch deine eigene CSV-Datei erstellen, um Massenvorgänge zu erstellen und zu aktualisieren.


Du brauchst die Projektberechtigung Vorgang erstellen und die globale Berechtigung Massenänderungen vornehmen für die Projekte, in denen du Vorgänge erstellen willst. Beachte, dass dein Administrator erweiterte Massenimporte durchführen kann. Wenn du Administrator bist, findest du weitere Informationen unter Importieren und Exportieren von Daten.






Bereite deine CSV-Datei vor



Du kannst die Struktur deiner CSV-Datei an das Standard-CSV-Format von Microsoft Excel anlehnen. Felder sollten durch Kommas getrennt werden, und alle Inhalte, die wörtlich behandelt werden müssen (z. B. Kommas, Zeilenumbrüche und Wagenrückläufe), sollten in Anführungszeichen gesetzt werden. Bitte beachte, dass Microsoft Excel und OpenOffice die Werte in den Zellen automatisch in Anführungszeichen setzen, sodass du diese Werte nicht manuell in Anführungszeichen setzen musst. 


Anforderungen an die CSV-Datei: 


  • CSV-Dateien müssen korrekt geformt sein
  • Jede CSV-Datei muss eine Kopfzeile mit einer Zusammenfassungsspalte enthalten. In der Kopfzeile wird festgelegt, wie die Daten aus der zweiten Zeile der CSV-Datei und darüber hinaus den Feldern in den Vorgängen deines Projekts zugeordnet werden sollen. Die Kopfzeile sollte keine Satzzeichen enthalten (abgesehen von den Kommas, die die einzelnen Spalten trennen), sonst funktioniert der Importer möglicherweise nicht richtig.
  • Du kannst keine Kommas für leere Spaltenwerte weglassen. Der zweite Ausschnitt unten lässt zum Beispiel die Kommas für die leeren Felder Beschreibung und Priorität weg, was nicht erlaubt ist.


Dies ist ein gutes Beispiel:


Zusammenfassung, Zugewiesene Person, Berichterstatter, Vorgangstyp, Beschreibung, Priorität
"Testvorgang", bob@example.com, bob@example.com, Aufgabe, ,

Das ist kein gültiges Beispiel:


Zusammenfassung, Zugewiesene Person, Berichterstatter, Vorgangstyp, Beschreibung, Priorität
"Testvorgang", bob@example.com, bob@example.com, 1

Wie du die Daten in deiner CSV-Datei strukturierst


Daten, die sich über mehrere Zeilen erstrecken


Verwende doppelte Anführungszeichen (") in deiner CSV-Datei, um Daten zu erfassen, die sich über mehrere Zeilen erstrecken. Beim Import wird Jira zum Beispiel die folgende Datei als gültige CSV-Datei mit einem einzigen Datensatz behandeln:


Zusammenfassung, Beschreibung, Status
"Anmeldung fehlgeschlagen", "Dies ist auf
einer neuen Zeile", Offen

Sonderzeichen, die wörtlich behandelt werden müssen

Verwende doppelte Anführungszeichen (") um einen Textabschnitt, um alle Sonderzeichen in diesem Abschnitt wörtlich zu behandeln. Sobald die Daten importiert werden, werden diese Sonderzeichen als Teil der Felddaten von Jira gespeichert. Beispiele für Sonderzeichen sind Zeilenumbrüche/Eingabezeichen (wie im obigen Beispiel), Kommas usw.

Um doppelte Anführungszeichen wörtlich zu behandeln, kannst du sie mit einem anderen doppelten Anführungszeichen "entfliehen". Daraus ergibt sich der CSV-Wert:


  • "Ein Klick auf die Schaltfläche ""Hinzufügen"" führt zu einem Seite nicht gefunden Fehler"
    wird nach dem Import in Jira gespeichert als:
  • Ein Klick auf die Schaltfläche "Hinzufügen" führt zu einem Seite nicht gefunden Fehler



Mehrere Werte, die zu einem einzigen Vorgang zusammengefasst werden müssen


Du kannst mehrere Werte in ein Vorgangsfeld importieren, das mehrere Werte akzeptiert (z. B. Fix (für) Version, betrifft Version, Komponente, Stichwörter). Dazu muss deine CSV-Datei für jeden Wert, den du im zugeordneten Vorgangsfeld zusammenfassen möchtest, denselben Spaltennamen enthalten. Die Anzahl der angegebenen Spaltennamen muss der maximalen Anzahl der Werte entsprechen, die in das zugeordnete Feld aggregiert werden sollen. Zum Beispiel:


VorgangsTyp, Zusammenfassung, FixVersion, FixVersion, FixVersion, Komponente, Komponente
bug, "Erster Vorgang", v1, , , Komponente1,
bug, "Zweiter Vorgang", v2, , , Komponente1, Komponente2
bug, "Dritter Vorgang", v1, v2, v3, Komponente1,

Im obigen Beispiel erzeugen das Feld Komponente des zweiten Vorgangs und das Feld Fix Version des dritten Vorgangs beim Import mehrere Werte in den entsprechenden Vorgangsfeldern.

Bitte beachte, dass nur eine begrenzte Anzahl von Vorgangsfeldern mehrere Werte unterstützt. Der CSV-Importer erlaubt dir nicht, aggregierte Daten in Vorgänge zu importieren, die nur einen einzigen Wert unterstützen.

Anhänge


Du kannst Dateien an Vorgänge anhängen, die du mit deiner CSV-Datei erstellt hast. Dazu gibst du die URL deines Anhangs in der Spalte "Anhänge" in deiner CSV-Datei an.


Zugewiesene Person, Zusammenfassung, Beschreibung, Anhang, Kommentar
bob@beispiel.com, "Vorgang, der den Import von CSV-Anhängen demonstriert", "Bitte überprüfen das angehängte Bild unten.", "https://jira-server:8080/secure/attachment/image-name.png", "01/01/2012 10:10;Admin; Dieser Kommentar funktioniert"
bob@beispiel.com, "CSV-Anhang-Import mit Zeitstempel, Autor und Dateiname", "Bitte prüfe das angehängte Bild unten.", "01/01/2012 13:10;bob@beispiel.com;image.png;file://image-name.png", "01/01/2012 10:10;Admin; Dieser Kommentar funktioniert"

URLs für Anhänge unterstützen die Protokolle HTTP und HTTPS und können an einer beliebigen Stelle stehen, auf die deine Jira-Instanz zugreifen können muss. 

Vorgänge, die in mehrere Projekte importiert werden müssen


Du kannst Vorgänge aus deiner CSV-Datei über einen CSV-Datei-Import in verschiedene Projekte importieren. Dazu fügst du deiner CSV-Datei zwei Spalten mit den Überschriften "Projektname" und "Projektschlüssel" hinzu.


Achte darauf, dass jeder Vorgang in deiner CSV-Datei einen Projektnamen und einen Projektschlüssel in der entsprechenden Spalte hat. Der Projektname und der Projektschlüssel sind die Mindestangaben für den Import von Vorgängen aus einer CSV-Datei in bestimmte Projekte.

Im folgenden Beispiel werden der erste und zweite Vorgang in das Projekt "Probe" (mit dem Projektschlüssel "SAMP") importiert, während der dritte Vorgang in das Projekt "Beispiel" (mit dem Projektschlüssel "EXAM") importiert wird:

Vorgangstyp, Zusammenfassung, Projektname, Projektschlüssel
bug, "Erster Vorgang", Probe, SAMP
bug, "Zweiter Vorgang", Probe, SAMP
task, "Dritter Vorgang", Beispiel, EXAM

Arbeitsprotokoll


Deine CSV-Datei kann Arbeitsprotokolleinträge enthalten. Verwende Sekunden, um die aufgewendete Zeit zu erfassen. Zum Beispiel:


Zusammenfassung,Arbeitsprotokoll
Nur aufgewendete Zeit (eine Stunde),3600
Mit einem Datum und einem Autor,2012-02-10 12:30:10;wseliga;120
Mit einem zusätzlichen Kommentar,Die Prüfung hat mich 3 Tage gekostet;2012-02-10 12:30:10;wseliga;259200

Benutzerdefinierte Felder mit Mehrfachauswahl


Deine CSV-Datei kann mehrere Einträge enthalten, um das benutzerdefinierte Mehrfachauswahlfeld mit mehreren Werten zu füllen. Zum Beispiel:


Zusammenfassung,Mehrfachauswahl,Mehrfachauswahl,Mehrfachauswahl
Probevorgang,Wert 1,Wert 2,Wert 3

Kaskadierende Auswahl benutzerdefinierter Felder


Du kannst Werte in ein benutzerdefiniertes Kaskadenauswahlfeld importieren, indem du die folgende Syntax verwendest. Das Trennzeichen "->" ermöglicht es dir, die Hierarchie zu importieren:


Zusammenfassung, Mein kaskadierendes benutzerdefiniertes Feld
Beispiel Zusammenfassung, Übergeordneter Wert -> Untergeordneter Wert

Jira Cloud unterstützt den Import von mehrstufigen kaskadierten Auswahlfeldern per CSV nicht. Hier kannst du den Beitrag verfolgen: JRACLOUD-34202 (Englisch)






Ausführen des CSV-Datei-Import-Assistenten



  1. Klicke in der Navigationsleiste auf Filter > Alle Vorgänge anzeigen.
  2. Klicke auf Mehr () > Vorgänge aus CSV-Datei importieren. 
  3. Wähle die CSV-Quelldatei aus, die du importieren möchtest. Aktiviere das Kontrollkästchen Wenn du keine Konfigurationsdatei hast oder eine neue erstellen möchtest, lass die Option Vorhandene Konfigurationsdatei verwenden deaktiviert. Konfigurationsdateien legen eine Zuordnung zwischen den Spaltennamen in der Kopfzeile deiner CSV-Datei und den Feldern in deiner Installation fest. Du hast die Möglichkeit, am Ende des Importvorgangs eine Konfigurationsdatei zu erstellen.
  4. Klicke auf Weiter und gib die erforderlichen Informationen ein. Wenn in deiner CSV-Datei ein anderes Trennzeichen als ein Komma verwendet wird, gib dieses Zeichen im Feld Trennzeichen an. Wenn das Trennzeichen ein Tab ist, kann es im Format "/t" eingegeben werden.
  5. Klicke auf Weiter und ordne die Spaltenüberschriften deiner CSV-Datei den Feldern in deinem ausgewählten Projekt zu. Wenn du bestimmte Jira-Feldwerte auswählen möchtest, um sie bestimmten CSV-Werten zuzuordnen, aktiviere die Option Feldwert zuordnen. Du musst dem Jira-Feld ein CSV-Feld zuordnen, da alle erstellten Vorgänge eine Zusammenfassung haben müssen. 
  6. Klicke ein weiteres Mal auf Weiter und wähle aus, welche der im vorherigen Schritt ausgewählten CSV-Feldwerte du bestimmten Vorgängen zuordnen möchtest. Du könntest zum Beispiel den CSV-Feldwert "Feature Request" dem Jira Vorgangstyp "New Feature" zuordnen wollen.
  7. Klicke auf Import beginnen, wenn du bereit bist, deine CSV-Daten in Jira zu importieren. Wenn du nach Fehlern oder Warnungen suchen möchtest, klicke auf Validieren, bevor du mit dem Import beginnst. Wenn du eine andere CSV-Datei mit ähnlichen Einstellungen importieren möchtest (z. B. mit ähnlichen Feldwert-Zuordnungen), kannst du die Konfiguration speichern, indem du eine CSV-Konfigurationsdatei herunterlädst. 


Bitte beachte:

  • Wenn du Feldwerte zuordnest, lass ein Feld leer oder lösche den Inhalt, wenn du den Wert unverändert importieren möchtest.
  • Wenn du Probleme mit dem Import hast oder mehr Informationen über den Prozess haben möchtest, kannst du ein detailliertes Protokoll herunterladen.






Tipps für den Import von CSV-Daten in Vorgangsfelder



Im Folgenden findest du einige hilfreiche Tipps, wenn du Daten aus deiner CSV-Datei in bestimmte Vorgangsfelder importierst:


Vorgangsfeld

Importhinweise

Project (Projekt)

CSV-Daten werden auf Projektbasis importiert. Du kannst entweder ein bestehendes Projekt als Ziel angeben oder der Importer erstellt zum Zeitpunkt des Imports automatisch ein neues Projekt oder neue Projekte für dich.

Summary (Zusammenfassung)

Das ist das einzige erforderliche Feld.

Component(s) (Komponente(n))

Du kannst Vorgänge mit mehreren Komponenten importieren, indem du jede Komponente in eine eigene Spalte einträgst.

Affects Version(s)

(Betrifft Version(en))

Du kannst Vorgänge mit mehreren "Betroffenen Versionen" importieren, indem du jede Version in eine eigene Spalte einträgst.

Fix Version(s)

(Fix Version(en))

Du kannst Vorgänge mit mehreren "Fix Versionen" importieren, indem du jede Version in eine eigene Spalte einträgst.

Comment Body

(Kommentar Körper)

Du kannst Vorgänge mit mehreren Kommentaren importieren, indem du jeden Kommentar in separaten Spalten mit demselben Überschriftennamen eingibst.

Due Date

(Fälligkeitsdatum)

Bitte verwende das im zweiten Schritt des CSV-Importassistenten angegebene Datumsformat.

Issue Type

(Vorgangstyp)

Wenn du in deiner CSV-Datei keine Angaben machst, erhalten die importierten Vorgänge den standardmäßigen (d.h. ersten) Vorgangstyp, der in deiner Jira-Instanz angegeben ist.  

Du kannst auch während des Importvorgangs neue Werte erstellen.

Labels

(Stichwörter)

Du kannst Vorgänge mit mehreren Stichwörtern importieren, indem du jedes Stichwort in eine eigene Spalte einträgst.

Priority

(Priorität)

Wenn du in deiner CSV-Datei keine Angaben machst, erhalten importierte Vorgänge die Standardpriorität (d.h. die erste), die du in deiner Jira-Instanz angegeben hast.

Du kannst auch während des Importvorgangs neue Werte erstellen.

Original Estimate

(Ursprüngliche Schätzung)

Der Wert dieses Feldes muss als Anzahl der Sekunden angegeben werden.

Remaining Estimate

(Verbleibende Schätzung)

Der Wert dieses Feldes muss als Anzahl der Sekunden angegeben werden.

Time Spent

(Verwendete Zeit)

Der Wert dieses Feldes muss als Anzahl der Sekunden angegeben werden.

Users

(Benutzer)

Benutzer erstellen

Für jedes Systemfeld, das ein Benutzertyp ist, unterstützen wir:

  • E-Mail
  • Atlassian Konto-ID

Du kannst festlegen, dass der Importer automatisch Jira-Benutzer für alle Werte im Feld Zugewiesne Person oder Reporter erstellt.

  • Die Benutzer werden als aktive Konten in Jira angelegt. Wenn du dich zum ersten Mal bei Jira anmeldest, musst du dir dein Passwort per E-Mail zuschicken lassen.
  • Benutzer, die keinen richtigen Namen haben, erhalten den Teil ihrer E-Mail Adresse (Anmeldename) vor dem "@"-Zeichen als ihren vollständigen Namen in Jira.
  • Wenn du die externe Benutzerverwaltung verwendest, kann der Importprozess keine Benutzer erstellen; stattdessen gibt dir der Importer eine Liste mit allen neuen Benutzern, die erstellt werden müssen. Du musst die Benutzer in deinem externen Benutzer-Repository anlegen, bevor du mit dem Import beginnst.
  • Wenn du eine benutzerbeschränkte Lizenz hast (z. B. eine persönliche Lizenz) und die Anzahl der benötigten Benutzer*innen die Grenze überschreitet, wird der Import abgebrochen. Es wird eine Seite mit einer Liste der Benutzer angezeigt, die nicht erstellt werden können.
  • Wenn Zugewiesene Person und Reporter nicht zugeordnet sind, werden auch keine Benutzer erstellt.


Benutzer aktualisieren

Portal-Only-Kundendaten in Jira Service Management verhalten sich anders als die Daten anderer Benutzerkonten. Wenn die Daten des Portal-Only-Kunden im Import und im Ziel unterschiedlich sind, verwenden wir die Zieldaten.

Mandatory fields

(Pflichtfelder)

Wenn du in Projekte mit Pflichtfeldern importierst, musst du das Feld in das Fenster *Vorgang erstellen* aufnehmen, das dem verwendeten Vorgangstyp zugeordnet ist. Weitere Informationen findest du unter Festlegen des Feldverhaltens. (Englisch)

Other fields

(Andere Felder)

Wenn du andere Felder importieren möchtest, kannst du sie bestimmten benutzerdefinierten Jira-Feldern zuordnen. Wenn deine benutzerdefinierten Felder in Jira noch nicht vorhanden sind, kann der Importer sie automatisch für dich erstellen. Wenn dein benutzerdefiniertes Feld ein Datumsfeld ist, verwende bitte das im zweiten Schritt des CSV-Importassistenten angegebene Datumsformat.


Du kannst die benutzerdefinierten Feldtypen der Auswahlliste (kaskadierend) nicht mit dieser Methode importieren. Klicke stattdessen auf Einstellungen () > System > Aus externem System importieren, um Auswahllistenfelder (kaskadierend) zu importieren.

Wenn du Fragen hast oder Probleme beim CSV-Import auftreten, wende dich bitte an den Atlassian-Support. (Englisch)













Q&A Portal

Im Antwortenportal von Seibert Media kannst du viel lernen und alle deine Fragen zu Jira und zu unseren Produkten stellen.

Video Tutorials

Im YouTube Kanal von Seibert Media findest du praktische Tutorial Videos und Playlists zu Jira und anderen Themen.

Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Link zu dieser Seite: https://seibert.biz/dokujiracloudvorgaengecsvimporter

View this page in english

Diese Seite wurde zuletzt am 28.12.2024 geändert.