> 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, Mitarbeitende in großen Mengen aus einer Datei hinzuzufügen oder zu synchronisieren, ohne sie einzeln hinzufügen zu müssen.

### Funktionsweise

#### Schritt 1 — Verlauf der Verarbeitungen

Gehen Sie in der Mitarbeitendenverwaltung zur Seite **Import** die den Verlauf früherer Synchronisierungen auflistet.

#### Schritt 2 — Importtyp auswählen

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

#### Schritt 3 — Datei hochladen

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

#### Schritt 4 — Warnungen prüfen

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

#### Schritt 5 — Analyse prüfen

Ein Bericht mit**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 ausführt. Der Status wird in Echtzeit aktualisiert.

#### Vorgangstypen

* **Hinzufügen** (Upsert): neue Mitarbeitende anlegen oder vorhandene aktualisieren
* **Löschen** (Delete): Mitarbeitende entfernen
* **Spiegel-Synchronisierung** (Mirror): die vollständige Liste ersetzen — die im Datei fehlenden Mitarbeitenden 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 der geplanten Vorgänge an, ohne sie anzuwenden.

#### Nachverfolgung der Nachrichten

Jeder Synchronisierungsvorgang erzeugt Nachverrichtungsnachrichten, die das Ergebnis für jeden Mitarbeitenden 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 Mitarbeitenden (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 Umfang Verwaltung kann der Assistent Mitarbeitende einzeln hinzufügen.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.steeple.com/de/administration/import-collaborateurs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.