> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/de/administration/import-collaborateurs.md).

# Wie importiere ich Mitarbeiter in großen Mengen?

### Einleitung

Die Importfunktion ermöglicht es, Mitarbeiter in großen Mengen aus einer Datei hinzuzufügen oder zu synchronisieren, ohne sie einzeln hinzufügen zu müssen.

### Funktionsweise

#### Schritt 1 — Verarbeitungsverlauf

Über die Verwaltung der Mitarbeiter gelangen Sie zur Seite **Import** die die Historie der vorherigen Synchronisierungen auflistet.

#### Schritt 2 — Importtyp wählen

Wählen Sie den Vorgangstyp: **Hinzufügen**, **Löschen** oder **Spiegel-Synchronisierung**.

#### Schritt 3 — Datei hochladen

Laden Sie die Excel- oder CSV-Datei mit den Mitarbeitern hoch.

#### Schritt 4 — Warnungen prüfen

Das System analysiert die Datei und zeigt einen Bericht über**Warnungen** zu den erkannten Anomalien an (ungültige Zeilen, fehlende Felder usw.).

#### Schritt 5 — Analyse überprüfen

Ein Bericht zu**Analyse** beschreibt die auszuführenden Vorgänge (Erstellungen, Aktualisierungen, Löschungen).

#### Schritt 6 — Ausführung starten

Bestätigen Sie, um den **Runner** zu starten, der die Vorgänge anwendet. Der Status wird live aktualisiert.

#### Vorgangsarten

* **Hinzufügen** (Upsert): neue Mitarbeiter erstellen oder vorhandene aktualisieren
* **Löschen** (Delete): Mitarbeiter entfernen
* **Spiegel-Synchronisierung** (Mirror): die vollständige Liste ersetzen — die in der Datei fehlenden Mitarbeiter werden entfernt

#### Testmodus (Dry Run)

Vor dem tatsächlichen Ausführen der Änderungen kann eine Simulation gestartet werden. Der Testmodus zeigt einen Bericht der geplanten Vorgänge an, ohne sie anzuwenden.

Die Simulation wird **erforderlich** für eine Datei, die eine Anmeldekennung zuweist oder ändert: Dies ist der einzige Ort, an dem Sie vor der Ausführung sehen, wie viele E-Mail-Adressen keine Kennungen mehr sind.

#### Mitarbeiter ohne E-Mail-Adresse

Die Vorlage enthält eine Spalte **Benutzername** und eine Spalte **TV-PIN-Code**, neben der Spalte **E-Mail**. Sie ermöglichen es, Mitarbeiter zu importieren, die keine geschäftliche E-Mail-Adresse haben.

* Jede Zeile muss mindestens eine Kennung enthalten: eine E-Mail-Adresse oder eine Anmeldekennung.
* Eine Zeile, die ohne E-Mail-Adresse eine Anmeldekennung zuweist, muss einen 4-stelligen Code enthalten, sonst hätte der Mitarbeiter keine Möglichkeit, sein Konto zu aktivieren.
* Dieselbe Kennung darf in der Datei nicht zweimal vorkommen.

Zeilen, die diese Regeln nicht einhalten, werden im Warnbericht vor jeder Schreiboperation gemeldet: Die Datei wird nicht ausgeführt, solange sie nicht korrigiert wurden. Siehe [Wie füge ich einen Mitarbeiter ohne E-Mail-Adresse hinzu?](/de/administration/collaborateur-sans-email.md).

#### Nachverfolgung der Nachrichten

Jeder Synchronisierungsvorgang erzeugt Nachverfolgungsnachrichten, die das Ergebnis für jeden Mitarbeiter anzeigen (Erfolg, Fehler usw.).

### Alternative: SCIM-Provisioning

Für eine automatische und kontinuierliche Synchronisierung mit einem Unternehmensverzeichnis (Azure Active Directory, Okta usw.) siehe den Artikel "Automatische Bereitstellung von Mitarbeitern (Provisioning / SCIM)".

### Was der Assistent tun kann

Der Assistent kann keinen Massenimport starten. Er kann die Funktionsweise erklären und zur Verwaltungsoberfläche führen. Mit dem Bereich Administration kann der Assistent Mitarbeiter einzeln hinzufügen.