Tickets importieren & aktualisieren

Übersicht

Importieren Sie Tickets aus einer Excel- oder CSV-Datei, um viele Tickets auf einmal zu erstellen. Sie können einen Import auch verwenden, um bereits vorhandene Tickets zu aktualisieren, zum Beispiel um Kosten oder Status für viele Tickets auf einmal zu ändern.

Zugang zum Ticketimport

Um den Ticketimport zu öffnen:

1. Klicken Sie auf Tickets
2. Wählen Sie aus der Dropdown-Liste Projekt das Projekt aus, in das Sie Tickets importieren möchten
   
3. Öffnen Sie das Mehr Menü und klicken Sie dann auf Tickets importieren
   

Vorbereiten der Importdatei

Die Importdatei muss die folgenden Kriterien erfüllen:

• Es werden nur XLSX- und CSV-Dateien unterstützt.
• Jeder Import umfasst ein einziges Ticketformular. Um Tickets für mehrere Formulare zu importieren, verwenden Sie eine Datei pro Formular.
• Jede Zeile steht für ein Ticket und jede Spalte für ein Ticketformularfeld.
• Jedes Ticket gehört zu einer Ebene, daher benötigt die Datei eine Spalte für die Ebene.

Zeilen, deren Ebenenspalte nicht mit einem vorhandenen Ebenennamen übereinstimmt, werden nicht importiert.

Benennen Sie die Spalten nach den Ticketformularfeldern, um die Zuordnung zu erleichtern. Ohne Spaltenüberschriften ordnen Sie die Spalten stattdessen über die automatisch zugewiesenen Nummern zu.

Tickets über die UUID aktualisieren

Jedes Ticket hat eine UUID, seine eindeutige Kennung. Wenn eine Zeile in Ihrer Datei eine UUID enthält, die mit einem vorhandenen Ticket übereinstimmt, wird dieses Ticket aktualisiert. Zeilen ohne UUID erstellen neue Tickets, sodass eine Datei beides erledigen kann.

Um eine Datei für das Aktualisieren von Tickets vorzubereiten:

1. Exportieren Sie die Tickets, die Sie ändern möchten, nach Excel – mit einer Vorlage, die das Attribut UUID enthält

   Der Standardexport enthält die Spalte UUID bereits. Um sie Ihrer eigenen Vorlage hinzuzufügen, siehe Excel-Vorlagen für den Export von Tickets erstellen.

2. Ändern Sie die Werte, die Sie aktualisieren möchten, und lassen Sie die UUID-Spalte unverändert
3. Importieren Sie die Datei und ordnen Sie die Spalte UUID dem Formularattribut UUID zu

Behalten Sie die Ebenenspalte in der Datei und ordnen Sie sie zu, denn jeder Import benötigt sie. In Zeilen, die ein vorhandenes Ticket aktualisieren, wird ihr Wert ignoriert – ein Import verschiebt ein Ticket niemals auf eine andere Ebene. Um mehrere Tickets auf eine andere Ebene zu verschieben, siehe Mehrere Tickets auf einmal in der Webapp bearbeiten.

Lesen Sie mehr unter Tickets nach Excel exportieren in der Webapp.

Tickets importieren

Um Tickets zu importieren:

1. Wählen Sie aus der Dropdown-Liste ein Ticketformular für die importierten Tickets aus

2. Klicken Sie auf Nach Dateien suchen, um die Ticketdatei von Ihrem Gerät hochzuladen

   Prüfen Sie Vorbereiten der Importdatei weiter oben.

3. Aktivieren Sie die Checkbox Erste Zeile ist eine Kopfzeile, wenn die erste Zeile Ihrer Datei Spaltentitel enthält
4. Lassen Sie die Checkbox Tickets vor dem Import validieren aktiviert, um die Datei zu prüfen, bevor etwas importiert wird, oder deaktivieren Sie sie, um direkt zu importieren
5. Optional: Aktivieren Sie die Checkbox Werte für leere Zellen löschen, damit leere Zellen die Werte löschen, denen sie zugeordnet sind
6. Klicken Sie auf Weiter
   
7. Ordnen Sie die Attribute aus der XLSX- oder CSV-Datei den Attributen des von Ihnen ausgewählten Ticketformulars zu.
   Lesen Sie mehr weiter unten unter Spalten den Formularfeldern zuordnen.
8. Klicken Sie auf Weiter
   
9. Prüfen Sie, was der Import bewirkt, und klicken Sie dann auf Importieren.
   Lesen Sie mehr weiter unten unter Importierte Tickets validieren.
   

Werte für leere Zellen löschen wirkt sich nur auf Zeilen aus, die ein vorhandenes Ticket aktualisieren. Ist die Checkbox deaktiviert, werden leere Zellen übersprungen und das Ticket behält seine aktuellen Werte.

Spalten den Formularfeldern zuordnen

Mit Hilfe der Attributzuordnung können Sie den Inhalt jeder Spalte in Ihrer Datei in das richtige Formularfeld im Ticket einfügen.

Im Fenster für die Attributzuordnung sehen Sie im oberen Teil eine Tabelle für die Zuordnung, während im unteren Teil die Tabelle aus der von Ihnen hochgeladenen Datei angezeigt wird:

1. Die Spalte Formularattribut listet alle Felder des zuvor ausgewählten Formulars auf, zusätzlich UUID.
2. Die Spalte Importiertes Attribut ermöglicht die Zuordnung Ihrer Datei zu den Formularfeldern.
3. Die Spalte Detailliertes Attribut ist nur für Benutzerfelder erforderlich, etwa Autor oder Hochgeladen von.
4. Die Zeilen aus Ihrer Datei werden darunter angezeigt, damit Sie die richtigen Spalten leichter finden, falls Sie keine Spaltenüberschriften verwendet haben, die den Namen der Formularfelder entsprechen.
   

Zum Zuordnen von Attributen:

1. Geben Sie in der Spalte Importiertes Attribut den Wert ein oder wählen Sie aus dem Dropdown-Menü die Spalte aus, die zum Feld in der Spalte Formularattribut gehört
   

   Bei aktivierter Checkbox Erste Zeile ist eine Kopfzeile zeigen die Dropdown-Menüs Ihre Spaltentitel an, und Sie können einen Spaltentitel wie Ebene, Benutzer oder Autor eingeben. Ohne sie werden Spaltennummern wie Spalte1 oder Spalte5 angezeigt.

2. Für Formularfelder, die sich auf einen Benutzer beziehen, etwa Autor oder Zuständiger, geben Sie in der Spalte Detailliertes Attribut den Wert ein oder wählen Sie aus dem Dropdown-Menü den Wertetyp aus, der gebucht werden soll, etwa Benutzername, ID, Firma oder E-Mail
   

Importierte Tickets validieren

Bei aktivierter Checkbox Tickets vor dem Import validieren erscheint nach der Attributzuordnung ein Fenster, das anzeigt, was der Import bewirkt. Es nennt die Anzahl der Tickets, die erstellt werden, die Anzahl der Tickets, die aktualisiert werden, und die Anzahl der Zeilen mit Fehlern, gefolgt von den Fehlern selbst.

Eine Zeile kann aus folgenden Gründen fehlschlagen:

Solange das Fenster Fehler meldet, ist Importieren nicht verfügbar. Korrigieren Sie entweder die Datei, oder importieren Sie nur die gültigen Zeilen.

Fehler korrigieren

Um Fehler zu korrigieren:

1. Klicken Sie auf Zurück
   
2. Korrigieren Sie die Attributzuordnung, oder klicken Sie erneut auf Zurück, um eine korrigierte Datei hochzuladen
3. Klicken Sie auf Weiter
   
4. Sobald keine Fehler mehr vorhanden sind, klicken Sie auf Importieren
   

Nur gültige Zeilen importieren

Um alles zu importieren, was keine Fehler enthält, und den Rest auszulassen:

1. Aktivieren Sie die Checkbox Überprüfungsfehler ignorieren und nur gültige Tickets importieren
2. Klicken Sie auf Importieren
   

Zeilen mit Fehlern werden übersprungen. Das Ergebnis des Imports nennt die Anzahl der erstellten Tickets, die Anzahl der aktualisierten Tickets und die Anzahl der übersprungenen Zeilen.

Tickets für nicht übereinstimmende UUIDs erstellen

Zeilen, deren UUID mit keinem Ticket im Projekt übereinstimmt, können neue Tickets werden, anstatt übersprungen zu werden. Das ist nützlich, wenn Sie eine Datei importieren, die aus einem anderen Projekt exportiert wurde.

Um Tickets für nicht übereinstimmende UUIDs zu erstellen:

1. Aktivieren Sie die Checkbox Überprüfungsfehler ignorieren und nur gültige Tickets importieren
2. Aktivieren Sie die Checkbox Nicht übereinstimmende UUIDs importieren und neue UUIDs erstellen
3. Klicken Sie auf Importieren

Jede dieser Zeilen wird zu einem neuen Ticket mit einer neu erzeugten UUID – der Wert aus Ihrer Datei wird nie übernommen. Zeilen, die aus einem anderen Grund fehlgeschlagen sind, werden weiterhin übersprungen.

Was eine Aktualisierung ändert

Wenn eine Zeile ein vorhandenes Ticket aktualisiert:

• Zugeordnete Spalten, die einen Wert enthalten, überschreiben den aktuellen Wert des Tickets.
• Spalten, die Sie nicht zugeordnet haben, bleiben unverändert.
• Leere Zellen werden übersprungen, sofern Sie nicht Werte für leere Zellen löschen aktiviert haben.
• Die Ebene ändert sich nie, auch dann nicht, wenn die Ebenenspalte einen anderen Wert enthält.
• Das Ticket behält sein Erstellungsdatum, seinen Ersteller und seine Ticketnummer. Sie werden als letzte Person eingetragen, die es bearbeitet hat.

Bei jedem aktualisierten Ticket wird „Ticket wurde per Import aktualisiert.“ im Journal festgehalten, zusammen mit einer Kennzeichnung des Imports, aus dem es stammt. Lesen Sie mehr unter Aktivitäten zu einem Ticket im Journal verfolgen.