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 ihre externe 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: Die Angabe der Hierarchie-Ebene hilft dem System, die Tiefe der Verschachtelung effizient zu verarbeiten.