Aus CSV oder Excel importieren

Wer eine bestehende Struktur nach roleALPHA bringt, will sie nicht einzeln eintippen. Der Import übernimmt viele Datensätze auf einmal — Entitäten (Personen, Rollen, Vorhaben …) genauso wie Beziehungen zwischen ihnen.

So kommst du hin

Auf jeder Modulseite steht neben „Neues …” der Knopf „Importieren”. Er nimmt das Modul mit: der Objekttyp ist im Assistenten schon vorgewählt.

Der Knopf erscheint nur für Administrator:innen — der Import darf viele Datensätze auf einmal anlegen und ändern, und das ist eine Admin-Aufgabe.

Die vier Schritte

1. Auswählen — Entitäten oder Beziehungen, Objekttyp, Datei (.csv, .xlsx). Hat eine Excel-Datei mehrere Tabellenblätter, fragt roleALPHA, welches gemeint ist.
2. Zuordnen — welche Spalte deiner Datei füllt welches Feld. Was du nicht zuordnest, bleibt leer; Pflichtfelder des Objekttyps müssen dabei sein.
3. Prüfen — roleALPHA liest die Datei durch und zeigt, was entstehen und was sich ändern würde, bevor etwas passiert. Fehlerhafte Zeilen werden einzeln benannt.
4. Importieren — die Datensätze entstehen als Entwürfe.

Bestehendes erkennen statt verdoppeln

Damit ein zweiter Import nicht alles ein zweites Mal anlegt, braucht roleALPHA ein Merkmal, an dem es einen Datensatz wiedererkennt:

• Kennung (empfohlen) — deine eigene Nummer aus dem Vorsystem.
• UUID — die interne Kennung aus roleALPHA. Nur sinnvoll, wenn du sie vorher exportiert hast.

Zeilen mit bekanntem Merkmal werden geändert, unbekannte angelegt. Wer die Zuordnung falsch wählt, bekommt Dubletten — deshalb steht sie im ersten Schritt und nicht am Ende.

Beziehungen importieren

Eine Beziehungszeile nennt beide Enden und den Beziehungstyp. Die Enden werden über Kennung oder UUID aufgelöst; roleALPHA prüft dabei, ob der Typ für dieses Paar überhaupt vorgesehen ist. Passt er nicht, wird die Zeile benannt und nicht stillschweigend anders verknüpft.

Was der Import NICHT tut

• Er veröffentlicht nicht von sich aus. Alles entsteht als Entwurf und durchläuft die Freigabe wie jede andere Änderung.
• Er löscht nichts, solange du das nicht ausdrücklich einschaltest.
• Er umgeht keine Rechte. Fehlt dir das Schreibrecht in einem Modul, scheitert die Zeile — der Import ist kein Nebeneingang.

Große Dateien

Der Server verarbeitet 500 Datensätze pro Anfrage; größere Importe werden automatisch aufgeteilt, darum musst du dich nicht kümmern. Der Fortschritt ist während des Laufs sichtbar.

Willst du einen großen Import erst einmal folgenlos durchspielen, ordne ihn einem Szenario zu: dann liegen die Entwürfe gebündelt und lassen sich gemeinsam freigeben oder verwerfen.

Verwandt

• Customer ID — die eigene Kennung, an der Wiedererkennung hängt
• Drafts – Entwürfe — was mit den Entwürfen passiert
• Szenarien und Sammelvorschläge — einen Import gebündelt freigeben oder verwerfen
• Datenquellen & Connectoren — laufender Abgleich statt einmaliger Übernahme