Import der Organisation

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

Interface Client

• api: org / org_manager / org_tree
• variant: standard

Dieses Interface ermöglicht den Import der Organisationsstruktur, der Zuordnung von Managern zu Einheiten sowie der hierarchischen Beziehungen zwischen Einheiten.

Daten für den Organisations-Import

Stellt die einzelnen Einheiten (Abteilungen, Teams, etc.) dar.

Column Name	Data type	Not Null	Bemerkung
org_external_id	VARCHAR(32)	✓	Externe ID: identifiziert die Organisationseinheit
acronym	VARCHAR(10)	✓	Kürzel der Einheit
org_text	VARCHAR(255)		Bezeichnung der Einheit
valid_from	DATE	✓	Gültig von
valid_to	DATE	✓	Gültig bis
role_request_locked	BOOLEAN	✓	Wenn true, ist die Beantragung von Rollen für diese OE gesperrt

Wichtig:

Bestehende Organisationseinheiten werden aktualisiert oder neu angelegt. Manuell im System angelegte Einheiten, die als “Direct Assignment” markiert sind, bleiben vom automatischen Löschprozess ausgeschlossen.

Daten für den Manager-Zuordnung-Import

Ordnet Benutzern Manager-Rollen für bestimmte Organisationseinheiten zu.

Feld	Datentyp	Nicht NULL	Bemerkung
ORG_EXTERNAL_ID	VARCHAR(32)	✓	Externe ID der Organisationseinheit
USR_EXTERNAL_ID	VARCHAR(32)	✓	Externe ID des Benutzers (Managers)

Wichtig:

Der Import der Manager erfolgt als Snapshot: Alle nicht in der aktuellen Lieferung enthaltenen Manager-Zuordnungen werden automatisch aus dem System entfernt. Es müssen immer alle aktuell gültigen Manager geliefert werden.

Daten für den Organisationsbaum-Import

Definiert die Hierarchie und Abhängigkeiten zwischen den Organisationseinheiten.

Feld	Datentyp	Nicht NULL	Bemerkung
ORG_EXTERNAL_ID	VARCHAR(32)	✓	Externe ID der übergeordneten Einheit
DEPENDENT_ORG_EXTERNAL_ID	VARCHAR(32)	✓	Externe ID der untergeordneten Einheit
VALID_FROM	DATE	✓	Gültig von
VALID_TO	DATE	✓	Gültig bis
GENERATION	INTEGER	✓	Ebene in der Hierarchie

Wichtig:

Der Organisationsbaum wird bei jedem Import vollständig geleert und anhand der gelieferten Daten neu aufgebaut.

Technische Hinweise

• Identifikation: Organisationseinheiten werden über die org_external_id identifiziert. Diese muss nicht zwingend global eindeutig sein, wenn sie in verschiedenen Kontexten (z.B. unterschiedliche Zeiträume) verwendet wird, sollte aber im aktuellen Snapshot konsistent sein.
• Synchronisations-Logik:
  • Bei Managern führt ein Fehlen eines Datensatzes in der Lieferung zum sofortigen Entzug der Manager-Berechtigung für die jeweilige OE.
  • Beim Organisationsbaum müssen immer alle Ebenen und Verknüpfungen geliefert werden, um die vollständige Struktur abzubilden.
• Hierarchie-Ebenen: Das Feld generation hilft dem System, die Tiefe der Verschachtelung effizient zu verarbeiten.