# Zugriff-Benutzer importieren - CSV

{% hint style="info" %}
Wenn Ihre Organisation Verzeichnisse für die Zugriffskontrolle verwendet, siehe [Benutzer mit Verzeichnissen verwalten](https://app.gitbook.com/s/NRq5qDDjsYNxwNzF1bcB/users-and-permissions/manage-users-in-your-organization/directories-for-user-group-management) bevor Sie Änderungen vornehmen. Dort wird erklärt, wie Verzeichnisse beeinflussen, wo Benutzer verwaltet werden und welche Berechtigungen gelten.
{% endhint %}

Um die gleichzeitige Verwaltung mehrerer Verkada-Zugriffskontrollbenutzer zu erleichtern, können Access-Admins die Benutzer in ihren Organisationen über eine CSV-Datei (Comma-Separated Values) exportieren, importieren und Änderungen daran vornehmen.

{% hint style="warning" %}
Wenn Sie mehrere Benutzer mit demselben Namen haben (bereits in Command oder in der CSV), die keine E-Mail-Adressen haben, erstellt der Import doppelte Benutzer mit demselben Namen.
{% endhint %}

***

## Vorhandene Benutzer exportieren

Um zu vermeiden, dass die Benutzerliste jedes Mal manuell erstellt werden muss, wenn Sie Benutzer aktualisieren, können Sie die aktuelle Benutzerliste aus Command exportieren und als Vorlage für Ihre Importdatei verwenden.

{% stepper %}
{% step %}
**Navigieren Sie in Verkada Command zu Alle Produkte > Zugriff.**
{% endstep %}

{% step %}
**Klicken Sie im linken Menü auf Zugriffsbenutzer und Gruppen.**
{% endstep %}

{% step %}
**Klicken Sie auf Exportieren > Benutzer exportieren, um die CSV-Datei herunterzuladen.**
{% endstep %}
{% endstepper %}

***

## Erforderliche Felder

Wenn Sie Zugriffsbenutzer importieren, sind diese Felder erforderlich:

* **Vorname**
* **Nachname**

Wenn Sie Zugriffsbenutzer überschreiben, *mindestens eines* dieser Felder ist erforderlich:

* **userId**
* **externalId**
* **E-Mail**

{% hint style="danger" %}

* Der **E-Mail** Feld ist erforderlich, damit Benutzer auf die **Verkada Pass** App zugreifen können, und für Benutzer, denen eine [Zugriffskontrollrolle](https://help.verkada.com/access-control/de/erste-schritte/roles-and-permissions-for-access-control) in Command zugewiesen wurde.
* Der **userId** Feld wird von Verkada generiert und kann zur Identifizierung von Benutzern verwendet werden.
  {% endhint %}

Beim Zuweisen von Kartennummern zu Benutzern sind die folgenden Felder erforderlich:

* **cardFormat**
* **facilityCode** (falls vom Kartenformat erforderlich)
* **cardNumber** (falls vom Kartenformat erforderlich)
* **cardNumberHex** (falls vom Kartenformat erforderlich)

{% hint style="warning" %}
CSV-Uploads für Benutzer können nicht zum Löschen von Anmeldeinformationen verwendet werden. Außerdem werden Anmeldeinformationen, die zu vorhandenen Benutzern gehören, nicht neuen Benutzern zugewiesen. Sie können Anmeldeinformationen mithilfe der [Anmeldeinformations-Import](https://help.verkada.com/access-control/de/benutzer-und-anmeldedaten/commission-access-control-cards/import-and-export-credentials-with-csv-files) Funktion neu zuweisen.
{% endhint %}

***

## Spaltenüberschriften für den CSV-Upload

Auf der [**Hochladen**](#h_763fa8346a) Seite des Benutzerimports sollten Sie einige Dinge beachten:

* **Erforderliche Spalten:** Erforderliche Spalten sind mit einem Sternchen markiert. Pro Zeile ist mindestens eines der Felder mit einem Sternchen erforderlich. Wenn eine Zeile keine der erforderlichen Spalten enthält, wird der Upload für diesen Benutzer fehlschlagen.
* **Schlüsselspalten:** Schlüsselspalten sind mit einem . markiert *Mindestens eine* Schlüsselspalte ist erforderlich, um vorhandene Benutzer abzugleichen, wenn Sie Benutzerdaten überschreiben müssen.
* **Additiv:** Wenn eine Spalte mit , markiert ist, werden beim Überschreiben vorhandener Benutzer neue Werte dem Benutzerprofil hinzugefügt. Vorhandene Werte werden nicht entfernt.
* **Format für Startdatum und Enddatum:** MM/TT/JJJJ hh:mm:ss AM/PM

{% hint style="warning" %}
Sie können mehr als ein **Kfz-Kennzeichen**, und **Gruppe** einem Benutzer hinzufügen. Jeder Eintrag muss durch ein Semikolon getrennt werden.
{% endhint %}

***

## Benutzer in großen Mengen importieren

{% hint style="warning" %}
Der CSV-Upload unterstützt bis zu 20.000 Benutzer.
{% endhint %}

{% stepper %}
{% step %}
**Navigieren Sie in Verkada Command zu Alle Produkte > Zugriff.**
{% endstep %}

{% step %}
**Klicken Sie im linken Menü auf Zugriffsbenutzer und Gruppen.**
{% endstep %}

{% step %}
**Klicken Sie auf Importieren > Benutzer importieren.**
{% endstep %}

{% step %}
**Beim Hochladen:**

a. (Optional) Klicken Sie auf [**Vorlage herunterladen**](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A) um die von Verkada empfohlene Vorlage als Basis für Ihren Upload zu verwenden.\
b. Unter **CSV hochladen,** ziehen Sie eine CSV-Datei mit Ihren Benutzerinformationen per Drag-and-drop hinein oder wählen Sie **auf Ihrem Computer auswählen**\
c. Klicken Sie auf **Fortfahren** um fortzufahren zu **Konfigurieren**.

**Hinweis:** Wenn Ihre CSV-Datei Sonderzeichen enthält, stellen Sie sicher, dass sie in der CSV-UTF-8-Kodierung codiert ist.
{% endstep %}

{% step %}
**Bei Konfigurieren:**

a. **Vorhandene Benutzer überschreiben:** Wenn *ja* ausgewählt ist, wird jeder Benutzer, der übereinstimmt mit **userId, externalId,** oder **E-Mail** (in dieser hierarchischen Reihenfolge) mit den Informationen in der CSV aktualisiert.\
b. **Benutzer aus ausgelassenen Gruppen entfernen:** Wählen Sie *ja* aus, um Benutzer aus allen Gruppen zu entfernen, die in der CSV nicht angegeben sind. Bei Benutzern ohne angegebene Gruppe (eine leere Zelle) wird die Gruppenmitgliedschaft nicht geändert.\
c. **Pass-App-Einladungen senden:** Senden Sie einen Download-Link für die Verkada Pass-App an alle Benutzer, nur neue Benutzer oder keine Benutzer. Wir empfehlen, diesen Link an neue Benutzer zu senden.\
d. Klicken Sie auf **Weiter, Spalten prüfen.**
{% endstep %}

{% step %}
**Bei Spalten prüfen:**

a. Überprüfen Sie die Informationen in den Spalten, die Sie importieren.\
b. Wenn einige Spalten nicht importiert werden können, wird auf diesem Bildschirm eine Meldung angezeigt, die detailliert angibt, welche Spalten für den Import nicht erkannt wurden.\
c. Klicken Sie auf **Weiter, Zeilen prüfen.**
{% endstep %}

{% step %}
**Bei Zeilen prüfen:**

a. Wenn in einer Zeile Probleme erkannt werden, wird eine Meldung angezeigt, die das Problem beschreibt.\
b. Klicken Sie auf **Zeilen anzeigen** neben einem Problem, um zu sehen, welche Zeilen betroffen sind.\
c. Korrigieren Sie die Probleme in der CSV-Datei und starten Sie den Upload erneut. Obwohl Zeilen mit diesen Fehlern hochgeladen werden können, ist es sehr unwahrscheinlich, dass sie erfolgreich sind.

**Hinweis**: Diese erste Überprüfung beschreibt nicht alle möglichen Fehler, z. B. Konflikte mit vorhandenen Benutzerdaten.
{% endstep %}

{% step %}
**Klicken Sie auf Import fortsetzen.**

a. Sobald der Import abgeschlossen ist, erhalten Sie eine E-Mail mit Einzelheiten zum Erfolg des Imports.\
b. Wenn es fehlgeschlagene Importe gibt, klicken Sie auf **CSV mit Fehlern herunterladen** um die Fehler anzuzeigen, die zum Fehlschlagen des Imports geführt haben. [UsersTemplate.csv](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A)
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Kleinere Fehler, wie die Neuzuweisung von Anmeldeinformationen oder ungültige Kfz-Kennzeichen, blockieren keine Benutzer-Uploads. Benutzer, die mit diesen Fehlern erstellt wurden, können aus der E-Mail heruntergeladen werden, die nach Abschluss des Imports gesendet wird. Wenn Sie die Fehler korrigieren und der Benutzer keine E-Mail hat, können Sie seine **userId** angeben, um die Erstellung doppelter Benutzer zu verhindern.
{% endhint %}