Daten importieren und exportieren

TskVlo unterstützt den Import von Einträgen aus CSV und den Export von Board-Daten als CSV oder JSON — direkt in den Board-Einstellungen oder über die REST-API für Automatisierungen.

Ein Board exportieren

Öffne das Board, gehe zu Board-Einstellungen → Import / Export und wähle ein Format:

• CSV exportieren — eine Zeile pro Eintrag mit Spalten für Titel, Gruppe und alle Board-Felder. Lässt sich in Excel, Google Sheets oder jedem Tabellenkalkulationsprogramm öffnen.
• JSON exportieren — ein strukturierter Export mit Board-Metadaten, Felddefinitionen, Gruppen und Einträgen samt Feldwerten. Nützlich für Backups oder Entwickler-Tooling.

Der Download startet sofort; jedes Workspace-Mitglied kann exportieren.

Export über die API

Für geplante Backups oder Skripte rufst du den Export-Endpunkt mit einem API-Token auf:

curl -H "Authorization: Bearer $TOKEN" \
  "https://dash.tskvlo.app/api/boards/BOARD_ID/export?format=csv" \
  -o board.csv

Nutze ?format=json für die JSON-Variante.

Einträge aus CSV importieren

CSV vorbereiten

Deine CSV muss eine Kopfzeile haben. Die Spalte Title ist Pflicht. Andere Spaltennamen werden automatisch mit Feldnamen auf dem Board abgeglichen.

Optional: füge eine Group-Spalte hinzu, um Einträge in bestimmte Gruppen einzusortieren.

Beispiel:

Title,Group,Status,Priorität
Login-Bug beheben,Sprint 14,In Bearbeitung,Hoch
Onboarding-Doku aktualisieren,Backlog,,Mittel

Einträge ohne übereinstimmende Gruppe werden in die erste Gruppe eingefügt.

Import ausführen

1. Öffne das Board und gehe zu Board-Einstellungen → Import / Export.
2. Klicke unter Einträge aus CSV importieren auf CSV-Datei wählen und wähle deine Datei aus.
3. Klicke auf Importieren.

TskVlo bestätigt, wie viele Einträge importiert wurden. Beachte: Viewer können nicht importieren — du brauchst eine Rolle mit Bearbeitungsrechten auf dem Board.

Feldspalten, die keinem Feldnamen entsprechen, werden stillschweigend übersprungen.

Du kannst auch programmatisch importieren, indem du die Datei als Multipart-Upload an https://dash.tskvlo.app/api/boards/BOARD_ID/import sendest.

Von einem anderen Tool migrieren

1. Exportiere Daten aus deinem aktuellen Tool als CSV.
2. Benenne Spalten um, damit sie deinen TskVlo-Feldnamen entsprechen (oder lege zuerst passende Felder an).
3. Importiere die Datei über Board-Einstellungen → Import / Export.

Zeitdaten exportieren

Für Zeitberichte nutze den Berichte-Button in der Board-Toolbar. Siehe Zeiterfassungsberichte lesen.

Tipps

• Teste mit einer kleinen CSV (5–10 Zeilen) vor dem Import von Hunderten von Einträgen.
• Exports enthalten keine Dateianhänge — lade diese einzeln herunter.