Import / Export

Importieren Sie Tickets in großen Mengen aus CSV- oder JSON-Dateien oder exportieren Sie die Tickets Ihres Projekts als CSV.

Zugriff: Rolle Teamleitung oder höher. Zu finden unter Einstellungen → Import / Export.

Tickets importieren

Datei vorbereiten

Fesk akzeptiert CSV- und JSON-Dateien bis 5 MB und 10.000 Zeilen.

CSV-Format

Eine übliche kommagetrennte Datei mit Kopfzeile:

Title,Status,Priority,Assignee,External ID
Fix login bug,open,high,alice@company.com,JIRA-1234
Add dark mode,in_progress,medium,bob@company.com,JIRA-1235
Update docs,open,low,

Regeln:

• Die erste Zeile muss die Spaltenüberschriften enthalten
• Titel ist das einzige Pflichtfeld, alles andere ist optional
• Quotierte Felder werden unterstützt: "Wert mit, Kommas" oder mehrzeilig "Zeile 1\nZeile 2"
• Kodierung: UTF-8 empfohlen. UTF-16 und ISO-8859-1 werden automatisch erkannt.
• Trennzeichen: Komma, Semikolon oder Tabulator, automatisch anhand der ersten 5 Zeilen erkannt

JSON-Format

Ein Array von Objekten, wobei jedes Objekt ein Ticket ist:

[
  {
    "title": "Fix login bug",
    "status": "open",
    "priority": "high",
    "assignee_email": "alice@company.com",
    "external_id": "JIRA-1234"
  },
  {
    "title": "Add dark mode",
    "status": "in_progress",
    "priority": "medium"
  }
]

Regeln:

• Muss ein JSON-Array von Objekten sein (kein einzelnes Objekt oder verschachtelte Struktur)
• Feldnamen werden zu den Spaltenüberschriften für die Zuordnung

Unterstützte Felder

Nach dem Hochladen ordnen Sie jede Quellspalte einem Fesk-Ticketfeld zu:

| Zielfeld | Akzeptierte Werte | Vorgabe, wenn nicht zugeordnet | |---|---|---| | Titel (Pflicht) | Beliebiger Text | - | | Status | Workflow-Status-Slug oder -Label (z. B. open, In Progress) | Standardstatus des Projekts | | Priorität | low, medium, high, critical | medium | | Tickettyp | Name des Tickettyps (z. B. Bug, Feature Request) | Standardtyp des Projekts | | Zugewiesen an (E-Mail) | E-Mail eines aktiven Projektmitglieds | Nicht zugewiesen | | Melder (E-Mail) | Beliebige E-Mail | Importierende Person | | Erstellungsdatum | ISO-8601, US (MM/TT/JJJJ) oder EU (TT/MM/JJJJ) | Jetzt | | Externe ID | Beliebiger Text (z. B. Jira-Key PROJ-123) | Leer | | Quelltyp | manual, email, api, webhook | manual | | Label | Kommagetrennter Text | Leer | | Fälligkeitsdatum | Beliebiges unterstütztes Datumsformat | Leer | | Überspringen | - | Spalte ignoriert |

Status und Tickettyp müssen mit den in Ihrem Projekt konfigurierten Werten übereinstimmen (Einstellungen → Workflow-Status / Tickettypen). Passt ein Wert nicht, sehen Sie einen Fehler mit Vorschlag: „Status ‚In Review' nicht gefunden, meinten Sie ‚In Progress'?"

Zugewiesen an muss ein aktiver Benutzer sein, der Mitglied des Projekts ist. Deaktivierte E-Mails oder Nicht-Mitglieder erzeugen Zeilenfehler.

Import-Ablauf

1. Hochladen: Datei per Drag-and-drop oder Durchsuchen wählen. Fesk erkennt Format, Kodierung und Trennzeichen automatisch.
2. Spalten zuordnen: Jede Quellspalte wird per Dropdown einem Fesk-Feld zugeordnet. Auto-Vorschläge erscheinen anhand gängiger Überschriften (z. B. „Summary" → Titel). Nicht benötigte Spalten → auf „Überspringen" setzen.
3. Vorschau & Import: Die ersten 10 Zeilen prüfen. Die Validierung läuft über alle Zeilen. Optionen wählen:
   • Ungültige Zeilen überspringen: Zeilen mit Fehlern werden übersprungen, statt den Import zu blockieren
   • Duplikate überspringen: Zeilen, deren externe ID bereits im Projekt existiert, werden übersprungen (verhindert Duplikate beim erneuten Import)
4. Ausführen, Dateien mit ≤500 Zeilen werden sofort importiert. Größere Dateien laufen im Hintergrund, den Status sehen Sie im Import-Verlauf.

Zuordnungs-Voreinstellungen

Wenn Sie regelmäßig aus derselben Quelle importieren (z. B. ein wöchentlicher Jira-Export), speichern Sie Ihre Spaltenzuordnung als Voreinstellung. Beim nächsten Mal wählen Sie sie unter „Voreinstellung laden", um die manuelle Zuordnung zu überspringen.

Einen Import zurückrollen

Ein Fehler passiert? Gehen Sie zum Import-Verlauf und klicken Sie bei jedem abgeschlossenen Import auf Zurückrollen. Das löscht alle durch diesen Import erstellten Tickets weich. Nach dem Import geänderte Tickets werden ebenfalls zurückgerollt, aber in der Bestätigung markiert.

Häufige Probleme

| Problem | Lösung | |---|---| | „Status ‚In Review' nicht gefunden" | Dieser Status existiert nicht im Projekt. Prüfen Sie Einstellungen → Workflow-Status auf gültige Werte. | | „Kein aktives Projektmitglied mit E-Mail" | Die E-Mail ist kein Projektmitglied, oder der Benutzer ist deaktiviert. | | Zeilenzahl überschreitet 10.000 | Teilen Sie Ihre Datei in kleinere Teile. | | Datei größer als 5 MB | Entfernen Sie unnötige Spalten oder teilen Sie die Datei. | | „Ein Import läuft bereits" | Pro Projekt läuft nur ein Import zur Zeit. Warten Sie, bis der aktuelle fertig ist. |

Tickets exportieren

Laden Sie die Tickets Ihres Projekts als CSV-Datei herunter.

Spalten

Wählen Sie, welche Felder der Export enthält. Vorgaben: Ticketnummer, Titel, Status, Priorität, Zugewiesen an, Erstellungsdatum. Weitere Optionen: Beschreibung, Externe ID, Label, Aktualisierungsdatum, Melder.

Filter

Grenzen Sie den Export auf bestimmte Tickets ein. Alle Filter sind optional: Lassen Sie sie leer, um alle nicht gelöschten Tickets des Projekts zu exportieren.

| Filter | Eingabe | Beispiele | |---|---|---| | Status | Ein Workflow-Status-Slug oder -Label aus Ihrem Projekt | open, closed, in_progress | | Priorität | Eines von: low, medium, high, critical | high | | Erstellt nach | Nur Tickets einschließen, die an oder nach diesem Datum erstellt wurden | Datumsauswahl nutzen |

Tipps

• Weich gelöschte Tickets werden automatisch ausgeschlossen
• Die Datei ist UTF-8-kodiert und heißt tickets-export-JJJJ-MM-TT.csv
• Um einen Export in ein anderes Projekt zu re-importieren, nutzen Sie den Import-Tab mit der exportierten CSV
• Große Exporte (Tausende Tickets) werden effizient gestreamt, kein Timeout-Risiko