# 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 %}


---

# Agent Instructions: 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://docs.intratool.de/verwaltung/benutzer/benutzer-importieren.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.