> 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 Mitarbeitende in großen Mengen?

### Einführung

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

### Funktionsweise

#### Schritt 1 — Verarbeitungsverlauf

Über die Administration der Mitarbeiter gelangen Sie zur Seite **Import** die den Verlauf der vorherigen Synchronisierungen auflistet.

#### Schritt 2 — Die Importart auswählen

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

#### Schritt 3 — Die Datei hochladen

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

#### Schritt 4 — Die Warnungen ansehen

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

#### Schritt 5 — Die Analyse prüfen

Ein Bericht über '**Analyse** beschreibt ausführlich die Vorgänge, die ausgeführt werden (Erstellungen, Aktualisierungen, Löschungen).

#### Schritt 6 — Die Ausführung starten

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

#### Vorgangsarten

* **Hinzufügen** (Upsert): neue Mitarbeiter anlegen oder bestehende aktualisieren
* **Löschung** (Delete): Mitarbeiter entfernen
* **Spiegel-Synchronisierung** (Mirror): die gesamte Liste ersetzen — Mitarbeiter, die in der Datei fehlen, werden entfernt

#### Testmodus (Dry Run)

Es ist möglich, vor der tatsächlichen Ausführung der Änderungen eine Simulation zu starten. Der Testmodus zeigt einen Bericht über die geplanten Vorgänge an, ohne sie anzuwenden.

Die Simulation wird **erforderlich** für eine Datei, die eine Anmeldekennung zuweist oder ändert: Das ist die einzige Stelle, an der 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** Benutzername **TV-PIN-Code**, neben der Spalte **E-Mail**. Sie ermöglichen den Import von Mitarbeitern, die keine berufliche E-Mail-Adresse haben.

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

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

#### Nachverfolgung der Meldungen

Jeder Synchronisierungsvorgang erzeugt Nachverfolgungsmeldungen, die das Ergebnis für jeden Mitarbeiter angeben (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 Administrationsoberfläche führen. Mit dem Umfang Administration kann der Assistent Mitarbeiter einzeln hinzufügen.