🚀 Kurzüberblick
Mit dem Teams-CSV-Upload legst du viele Teams auf einmal an oder aktualisierst sie.
Jede Zeile steht für ein Team (eindeutig per external_id).
Unterstützt: Anlegen und Aktualisieren.
Nach dem Import siehst du, wie viele Teams erstellt oder aktualisiert wurden.
🛠️ Bevor du beginnst
Rechte: Kunden Admin
Dateiformat: .csv • Kodierung: UTF-8 • Trennzeichen: , (Komma)
Mehrfachwerte: mit Pipe | trennen (z. B. TEAM-001|TEAM-002).
Max. Dateigröße: 32 MB (≈ 150.000 Zeilen möglich).
⚠️ Stolpersteine:
Falsches Trennzeichen ; statt , → Datei wird abgewiesen.
Unbekannte Spaltennamen im Header → Datei wird abgewiesen.
Unterschiedliche Spaltenanzahl (Header vs. Zeile) → Upload-Fehler.
parent_teams oder users referenzieren Einträge, die nicht existieren → Zeile ungültig.
📑 Schritt-für-Schritt-Anleitung (Teams)
1) CSV herunterladen
Öffne Teams unter /app/teams.
Klicke CSV-Vorlage herunterladen (oben rechts).
2) CSV bearbeiten
Öffne die Datei in Excel, Google Sheets o. ä.
Fülle mindestens die Pflichtspalte external_id und name aus.
Falls im Unternehmen keine external_id vorhanden ist, bitten wir euch, die Teams entsprechend euren Wünschen zu nummerieren.
Mehrfachwerte in parent_teams und users mit | trennen.
Speichere als CSV (UTF-8, Komma-getrennt).
3) CSV hochladen
Gehe zu /app/teams → CSV-Datei hochladen.
Wähle deine Datei aus.
(Optional) Teams aktivieren/deaktivieren
⚠️ Wichtig: Lies zuerst den Abschnitt
„Teams aktivieren/deaktivieren“.
Falsche Nutzung kann viele Teams unbeabsichtigt blockieren.
Weiter → Vorschau prüfen:
✅ Grün = Zeile gültig
❌ Rot = Fehler (mit Maus darüber fahren für Details)
Fehler ggf. in der CSV korrigieren und neu hochladen.
Importieren → Abschlussmeldung zeigt erstellt/aktualisiert.
⚠️ Wichtiger Hinweis: Teams aktivieren/deaktivieren
Wenn die Option „Enable/Disable Teams“ aktiv ist, gilt:
Alle Teams in deiner CSV werden aktiv gesetzt (auch zuvor blockierte).
Alle Teams, die nicht in der CSV stehen, werden blockiert.
✅ Sinnvoll, wenn du eine vollständige, aktuelle Teamliste hochlädst.
❌ Riskant, wenn du nur ein paar Teams neu anlegst oder kleine Änderungen machst.
📌 Empfehlung: Nur bei Vollabgleichen aktivieren. Für Teil-Updates deaktiviert lassen.
📋 Spalten-Referenz (Teams)
Spaltenname | Beschreibung (geschäftlich) | Pflicht | Typ | Mehrfach? | Format / Regeln | Beispiel(e) | Häufige Fehler |
external_id | Eindeutige Team-ID (frei wählbar, zum Abgleichen) | Ja | Text | Nein | eindeutig pro Team | TEAM-100 | fehlt, doppelt |
name | Teamname | Ja | Text | Nein | sinnvoller Klarname | Product Engineering | fehlt |
type | Teamtyp/Kategorie | Nein | Text | Nein | frei (z. B. „Department“, „Squad“) | Department | – |
description | Kurzbeschreibung | Nein | Text | Nein | frei | Ensures product quality | – |
goal | Teamziel | Nein | Text | Nein | frei | Improve release cadence | – |
parent_teams | Übergeordnete Teams (per external_id) | Nein | Text | Ja | ` | `-getrennt; jede ID muss existieren (in System oder in derselben CSV) | `TEAM-001 |
users | Mitglieder (per E-Mail oder Staff-ID) | Nein | Text | Ja | ` | `-getrennt; jeder Wert muss zu existierendem User passen |
Annahme: „Staff-ID“ entspricht der im System geführten Personal-/Mitarbeiternummer (z. B. personal_number).
🧠 Verarbeitungslogik
Datei wird zeilenweise verarbeitet.
Schlüssel: external_id (Teams).
Existiert die external_id → Update; existiert nicht → Create.
Leere Werte in nicht-Pflichtspalten sind erlaubt und werden als leer gespeichert.
Referenzen müssen auflösbar sein:
parent_teams: jede external_id existiert im System oder in derselben Datei.
users: jede E-Mail oder Staff-ID verweist auf existierenden User.
❌ Typische Fehlermeldungen & Lösungen (Teams)
„Unsupported delimiter.“ → Datei mit Komma , speichern (nicht ;).
„The uploaded file contains unsupported fields: …“ → Unbekannte Spalten im Header entfernen/berichtigen.
„The number of fields … does not match the header.“ → Spaltenanzahl je Zeile prüfen.
„Team with provided external id does not exist …“ (bei parent_teams) → Eltern-ID im System anlegen oder in derselben CSV mitliefern.
„User not found for value …“ (bei users) → E-Mail/Staff-ID prüfen; User muss existieren.
„Row invalid: required field missing (external_id/name).“ → Pflichtwerte ergänzen.
📝 Beispiele
Minimal gültige Teams-CSV (nur Pflichtfelder)
external_id,name
TEAM-001,Head Office
TEAM-002,Customer Support
📥 Download: Teams_Minimal.csv
Vollständige Teams-CSV (alle Felder)
external_id,name,type,description,goal,parent_teams,users
TEAM-100,Product Engineering,Department,Builds and ships product features,Improve release cadence,TEAM-001,[email protected]|[email protected]|staff_id_42
TEAM-200,QA & Testing,Squad,Ensures product quality,Reduce defect leakage,TEAM-100,[email protected]|staff_id_77
📥 Download: Teams_Full.csv
✅ Checkliste vor dem Upload (Teams)
Datei als CSV (UTF-8, Komma) gespeichert
Pflichtspalten gefüllt: external_id, name
Mehrfachwerte in parent_teams/users mit |
Alle referenzierten parent_teams existieren (System oder gleiche CSV)
Alle users (E-Mail oder Staff-ID) existieren
Header ohne Tippfehler, gleiche Spaltenanzahl in jeder Zeile
Datei < 32 MB
❓ FAQ (Teams)
Kann ich mehrere Parent-Teams zuweisen?
→ Ja, per | getrennt (TEAM-001|TEAM-050).
Wie ordne ich Nutzer zu?
→ In users E-Mails oder Staff-IDs per | trennen. Die Nutzer müssen bereits existieren.
Kann ich Teams deaktivieren?
→ Ja, über Enable/Disable Teams. Achtung: Teams, die nicht in der CSV stehen, werden dann blockiert.
Spielt die Spaltenreihenfolge eine Rolle?
→ Ja, halte dich an die Vorlage, um Mismatch-Fehler zu vermeiden.
Gibt es eine Zeilenbegrenzung?
→ Praktisch bis ca. 150.000 Zeilen (32 MB), Import erfolgt in Batches.