> For the complete documentation index, see [llms.txt](https://docs.intratool.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intratool.de/verwaltung/benutzer/benutzer-importieren.md).

# Benutzer importieren

Sie haben die Möglichkeit Benutzer aus einer bereits vorhandenen CSV-Datei zu importieren.

Um den Benutzer-Import vorzunehmen befolgen sie folgende Schritte:

1. Klicken Sie auf **"Benutzer importieren"**.
2. Wählen Sie ein CSV-Datei.
3. Wählen Sie den [Importmodus](#importmodus) (optional).
4. Treffen Sie die [Erweiterten Einstellungen](#erweiterte-einstellungen) (optional).
5. Klicken Sie auf **"Importieren"**.

### Importmodus

Der Importmodus bietet die Möglichkeit, die **Standardeinstellung** (es werden nur Benutzer importiert, die nicht im System vorhanden sind), zu verändern. Die verfügbaren Einstellungen sind:

#### Benutzer aktualisieren

Durch diese Einstellung, werden **bereits vorhandene Benutzer**, **durch die Daten aus der CSV-Datei ersetzt** (sofern sie den gleichen **Benutzernamen** haben). Passwörter werden hierbei nicht aktualisiert.

#### Benutzer löschen

Durch diese Einstellung werden **alle Benutzer aus dem System gelöscht**, die nicht in der CSV-Datei enthalten sind.

### Erweiterte Einstellungen

Innerhalb der erweiterten Einstellungen, können Sie individuelle Bezeichnungen, für die Felder in Ihrer CSV-Datei, einstellen.

Dadurch sind sie nicht gezwungen, die in der [Vorlage](#vorlage-herunterladen) verwendeten Bezeichnungen zu verwenden.

### Vorlage herunterladen

Im folgenden Abschnitt wird gezeigt, wie Sie die CSV-Vorlage für den Benutzerimport herunterladen.

1. Klicken Sie auf **"Benutzer importieren"**.
2. Klicken Sie auf **"hier"**, unterhalb des Felds, für den Upload der CSV-Datei.

### Vorraussetzungen Import-Datei

Damit der Benutzer-Import fehlerfrei vonstatten geht, müssen einige Vorraussetzungen erfüllt sein.

#### Pflichtfelder

* `username`
* `password`
* `first_name`
* `last_name`
* `role_id` des Benutzerrechts, zu dem der Nutzer gehören soll

{% hint style="info" %}
**Wo finde ich die role\_id?**

Die role\_id eines Benutzerrechts finden Sie, wenn Sie ein Benutzerrecht bearbeiten, unter dem Erstell- und Bearbeitungszeitpunkt des Benutzerrechts. Diese Info findet sich im Bearbeitungsfenster unten links in der Ecke.
{% endhint %}

#### Feldeigenschaften

* `username` : Mindestens 4 Zeichen, nur Zeichen von "a-z", "0-9" und "- \_" sind zulässig.
* `password` : Mindestens 6 Zeichen

Alle nachfolgenden Felder werden mit **`1`** (für Ja) und **`0`** (für Nein) ausgefüllt:

* `active`
* `group_account`
* `wants_email_notifications`
* `request_password_change`

Datumsfelder müssen im ISO 8601 Standard "YYYY-MM-DD" ausgefüllt werden, dazu zählen:

* `birthdate`
* `entering_date`
* `leaving_date`

#### Formatierung

Die **Formatierung** der CSV-Datei muss **"Kommasepariert UTF-8"** sein. Diese Einstellung können Sie beim Exportieren/Speichern Ihrer CSV-Datei, in der Textverarbeitungssoftware Ihrer Wahl treffen.

{% hint style="info" %}
**Weitere Hinweise**

* Achten Sie darauf, dass die Datei UTF-8 Codiert sein muss (damit Umlaute übernommen werden).
* Den Namen des Benutzerrechts tragen Sie unter **`user_role`** ein.
* Das Feld `gender` muss in Englischer Sprache angegeben werden: `male / female.`
  {% endhint %}