> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/de/benutzer-and-anmeldedaten/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md). # Zutrittsbenutzer importieren - CSV {% hint style="info" %} Wenn Ihre Organisation Verzeichnisse für die Zugriffskontrolle verwendet, siehe [Benutzer mit Verzeichnissen verwalten](/command/de/benutzer-und-berechtigungen/manage-users-in-your-organization/directories-for-user-group-management.md) 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 Zugriffsadministratoren Benutzer in ihren Organisationen über eine durch Kommas getrennte Wertedatei (CSV) exportieren, importieren und Änderungen daran vornehmen. {% hint style="warning" %} Wenn Sie mehrere Benutzer mit demselben Namen (bereits in Command oder in der CSV), die keine E-Mail-Adressen haben, wird der Import doppelte Benutzer mit demselben Namen erstellen. {% endhint %} *** ## Vorhandene Benutzer exportieren Um zu vermeiden, dass Sie die Benutzerliste jedes Mal manuell erstellen müssen, wenn Sie Benutzer aktualisieren müssen, können Sie die aktuelle Benutzerliste aus Command exportieren, um sie als Vorlage für Ihre Importdatei zu 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 herunterzuladen.** {% endstep %} {% endstepper %} *** ## Pflichtfelder 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" %} * Das **E-Mail** Feld ist erforderlich, damit Benutzer auf das **Verkada Pass** App zugreifen können, und Benutzern wird eine [Zugriffskontrollrolle](/access-control/de/erste-schritte/roles-and-permissions-for-access-control.md) in Command zugewiesen. * Das **userId** Das 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 verwendet werden, um Anmeldedaten zu löschen. Außerdem werden Anmeldedaten, die bestehenden Benutzern gehören, nicht neuen Benutzern neu zugewiesen. Sie können Anmeldedaten mit der [Anmeldedaten-Import](/access-control/de/benutzer-and-anmeldedaten/commission-access-control-cards/import-and-export-credentials-with-csv-files.md) 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 gekennzeichnet :asterisk:. Pro Zeile ist mindestens eines der Felder mit Sternchen erforderlich. Wenn eine Zeile keine der erforderlichen Spalten enthält, schlägt das Hochladen dieses Benutzers fehl. * **Schlüsselspalten:** Schlüsselspalten sind mit einem :key:. *Mindestens eine* Schlüsselspalte ist erforderlich, um vorhandene Benutzer abzugleichen, wenn Sie Benutzerdaten überschreiben müssen. * **Hinzugefügt:** Wenn eine Spalte mit :plus:gekennzeichnet ist, werden beim Überschreiben vorhandener Benutzer neue Werte zum 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" %} Um die Telefonnummer eines Benutzers automatisch zu verifizieren, fügen Sie die Nummer in einem der folgenden Formate in die CSV ein: * +1 XXX XXX XXXX * +1 XXX-XXX-XXXX {% endhint %} {% hint style="info" %} Sie können mehr als ein **Kennzeichen** oder **Gruppe** zu einem Benutzer hinzufügen. Jeder Eintrag muss durch ein Semikolon getrennt werden. {% endhint %} *** ## Benutzer massenhaft 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:** 1. (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 Grundlage für Ihren Upload zu verwenden. 2. Unter **CSV hochladen,** ziehen Sie eine CSV-Datei mit Ihren Benutzerinformationen per Drag & Drop oder wählen Sie **auf Ihrem Computer auswählen.** 3. Klicken Sie auf **Weiter** um fortzufahren mit **Konfigurieren**. {% hint style="warning" %} Wenn Ihre CSV-Datei Sonderzeichen enthält, stellen Sie sicher, dass sie in UTF-8 codiert ist. {% endhint %} {% endstep %} {% step %} **Beim Konfigurieren:** 1. **Vorhandene Benutzer überschreiben:** Wenn *ja* ausgewählt ist, wird jeder Benutzer, der mit **userId, externalId,** oder **E-Mail** (in genau dieser hierarchischen Reihenfolge) übereinstimmt, mit den Informationen in der CSV aktualisiert. 2. **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 (leeres Feld) wird die Gruppenmitgliedschaft nicht geändert. 3. **Pass-App-Einladungen senden:** Senden Sie allen Benutzern, nur neuen Benutzern oder keinen Benutzern einen Download-Link zur Verkada Pass-App. Wir empfehlen, diesen Link an neue Benutzer zu senden. 4. Klicken Sie auf **Als Nächstes: Spalten prüfen.** {% endstep %} {% step %} **Beim Prüfen der Spalten:** 1. Überprüfen Sie die Informationen in den Spalten, die Sie importieren. 2. Wenn Spalten nicht importiert werden können, wird auf diesem Bildschirm eine Meldung angezeigt, die angibt, welche Spalten für den Import nicht erkannt wurden. 3. Klicken Sie auf **Als Nächstes: Zeilen prüfen.** {% endstep %} {% step %} **Beim Prüfen der Zeilen:** 1. Wenn in einer Zeile Probleme erkannt werden, wird eine Meldung angezeigt, die das Problem beschreibt. 2. Klicken Sie auf **Zeilen anzeigen** neben einem Problem, um zu sehen, welche Zeilen betroffen sind. 3. Beheben Sie die Probleme in der CSV und starten Sie den Upload neu. Obwohl Zeilen mit diesen Fehlern hochgeladen werden können, ist es sehr unwahrscheinlich, dass sie erfolgreich sind. {% hint style="warning" %} Diese erste Prüfung beschreibt nicht alle möglichen Fehler, z. B. Konflikte mit vorhandenen Benutzerdaten. {% endhint %} {% endstep %} {% step %} **Klicken Sie auf Import fortsetzen.** 1. Sobald der Import abgeschlossen ist, erhalten Sie eine E-Mail mit Einzelheiten zum Erfolg des Imports. 2. Wenn es fehlgeschlagene Importe gibt, klicken Sie auf **CSV mit Fehlern herunterladen** um die Fehler anzuzeigen, die zum Fehlschlag 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" %} Geringfügige Fehler, wie neu zugewiesene Anmeldedaten oder ungültige Kennzeichen, blockieren den Benutzer-Upload nicht. 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 das Erstellen doppelter Benutzer zu verhindern. {% endhint %} --- # 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, and the optional `goal` query parameter: ``` GET https://help.verkada.com/access-control/de/benutzer-and-anmeldedaten/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.