Skip to main content
Divisionen bilden eine Hierarchie innerhalb genau eines Tenants. Eine Division besitzt einen Namen, optional einen Parent, eine Anzeigereihenfolge unter Geschwistern, optional eine Kostenstelle und serverseitig vergebene Zeitstempel.

Hierarchiemodell

parentId: null erstellt eine Division auf Root-Ebene des Tenants oder verschiebt sie dorthin.

Create-Ablauf

Wenn X-Tenant-ID fehlt, kann die Create-Operation den Tenant aus parentId oder einem eindeutigen Key-Scope ableiten. Senden Sie den Header, wenn mehr als ein Tenant möglich ist.

Root-Division erstellen

Untergeordnete Division erstellen

Parent sicher ändern

Eine Division kann über den öffentlichen Update-Endpoint nicht in einen anderen Tenant verschoben werden.

Patch-Verhalten

  • Lassen Sie Eigenschaften weg, die unverändert bleiben sollen.
  • Setzen Sie parentId: null, um die Division auf Root-Ebene zu verschieben.
  • Setzen Sie die nullable Eigenschaft costCenter: null, um die Kostenstelle zu entfernen.
  • Verwenden Sie vor Hierarchieänderungen einen Dry Run.
  • Speichern Sie nach dem realen Patch den zurückgegebenen Zustand.

Reihenfolge

order ist eine numerische Anzeigereihenfolge unter Geschwisterdivisionen. Das aktualisierte Anbieter-Schema verwendet den OpenAPI-Typ number und enthält die bisherige Integer-Beschränkung multipleOf: 1 nicht mehr. Die Create-Operation dokumentiert bei fehlendem Wert einen serverseitigen Standardwert hinter dem letzten Geschwister. Der öffentliche Vertrag garantiert weder eindeutige Reihenfolgewerte noch eine automatische Neunummerierung. Lesen Sie die resultierende Hierarchie und verwenden Sie die zurückgegebenen Werte.

Öffentliche Einschränkungen

Der öffentliche v1-Vertrag stellt keine Löschoperation für Divisionen bereit. Er definiert außerdem weder eine maximale Hierarchietiefe noch eine garantierte automatische Neunummerierung nach jeder Reihenfolgeänderung. Stimmen Sie Entfernung und Mitarbeiter-Neuzuordnung über den zuständigen Fachprozess ab, halten Sie Hierarchien angemessen begrenzt und lesen Sie die resultierenden Reihenfolgewerte, statt Annahmen zu treffen.
Zuletzt geändert am 28. August 2026