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.

Migration von einem anderen Helpdesk

So wechseln Sie von Zendesk, Freshdesk, Help Scout oder einem anderen Ticketsystem. Der Dateiimport von Fesk erstellt Tickets aus CSV oder JSON. Er verbindet sich nicht mit dem bisherigen Dienst und stellt kein vollständiges Gesprächsarchiv wieder her.

1. Export vorbereiten

Bewahren Sie eine unveränderte Kopie des Exports und der Anhänge auf. Bereiten Sie eine Zeile pro Ticket in einer UTF-8-CSV-Datei oder ein Objekt pro Ticket in einem JSON-Array vor. Bei einem verschachtelten API-Export müssen Sie die Ticketfelder zuerst in diese flache Struktur überführen.

| Quelle | Felder für Fesk vorbereiten | |---|---| | Zendesk | Ticket-ID → Externe ID; Betreff → Titel; ausgewählter Tickettext → Beschreibung | | Freshdesk | Ticket-ID → Externe ID; Betreff → Titel; ausgewählter Tickettext → Beschreibung | | Help Scout | Gesprächs-ID → Externe ID; Betreff → Titel; ausgewählter Gesprächstext → Beschreibung |

Das sind Zuordnungsbeispiele, keine vorgeschriebenen Spaltennamen. Ordnen Sie nach dem Hochladen die tatsächlichen Spalten Ihrer Datei zu. Verwenden Sie beim Zusammenführen mehrerer Quellen Präfixe wie zendesk-123 und freshdesk-123, damit unterschiedliche Tickets nicht als Duplikate gelten.

2. Ziel vorbereiten

Legen Sie Status und Tickettypen im Ziel-Workspace an und fügen Sie die zuständigen Bearbeiter hinzu. Ordnen Sie alte Status den konfigurierten Bezeichnungen oder Slugs des Ziels und Prioritäten den Werten low, medium, high oder critical zu. E-Mail-Adressen für Zuweisungen müssen aktiven Projektmitgliedern gehören. Der Dateiimport erstellt keine Benutzer und versendet keine Einladungen. Eine Melder-E-Mail wird nur einem vorhandenen Projektmitglied zugeordnet; andernfalls wird der importierende Benutzer als Ersteller eingetragen.

3. Testimport prüfen, dann importieren

Laden Sie eine kleine, repräsentative Auswahl hoch, ordnen Sie die Spalten zu und prüfen Sie Validierungsfehler vor dem Ausführen. Kontrollieren Sie Beschreibung, Datum, Zuweisung, Status und externe ID der erstellten Tickets. Speichern Sie eine Zuordnungs-Voreinstellung für die restlichen Dateien. Pro Datei gelten 5 MB und 10.000 Zeilen. Teilen Sie größere Exporte auf, behalten Sie externe IDs bei und aktivieren Sie bei Wiederholungen Duplikate überspringen. Vorhandene Tickets werden dabei übersprungen, nicht aktualisiert.

Eine feste Migrationsdauer gibt es nicht. Messen Sie die Verarbeitung einer repräsentativen Auswahl und rechnen Sie deren Dauer auf Ihre Zeilenzahl hoch. Planen Sie zusätzlich Zeit für Exportvorbereitung, Validierung und Abgleich ein. Bis zu 500 Zeilen werden direkt verarbeitet, größere Importe im Hintergrund. Warten Sie im Import-Verlauf auf den Abschluss, bevor Sie die nächste Datei importieren. Halten Sie das Quellsystem verfügbar, bis Anzahl und Stichproben der Tickets stimmen. Die Umstellung der Postfächer erfolgt gesondert.

4. Umfang und Rücknahme kennen

Der Dateiimport unterstützt Ticketfelder, Beschreibungstext, ursprüngliche Erstellungsdaten und externe IDs. Einzelne Antworten, interne Notizen, Anhänge, Änderungsverläufe, bisherige Ticketnummern, Benutzerkonten und Passwörter werden nicht importiert. Fesk vergibt eigene Ticketnummern. Bewahren Sie das Originalarchiv für Gesprächsverläufe und Anhänge auf. Links in einer Beschreibung benötigen weiterhin Zugriffsrechte auf ihr ursprüngliches Ziel.

Einen fehlerhaften Testimport oder abgeschlossenen Stapel nehmen Sie über Import-Verlauf → Zurückrollen zurück. Dabei werden die von diesem Import erstellten Tickets als gelöscht markiert, auch nachträglich bearbeitete Tickets. Diese Änderungen bleiben nicht als eigene Tickets erhalten. Das Quellsystem wird nicht verändert. Prüfen Sie einen Testimport, bevor das Team mit den importierten Tickets arbeitet.

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 | - | | Beschreibung | Beschreibungstext des Tickets | Leer | | 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