Mehrere Benutzer:innen über eine CSV-Datei importieren
Du kannst eine CSV-Datei aus deinem Shopify-Adminbereich importieren, um neue Admin-Benutzer:innen oder Point of Sale-Benutzer:innen (POS-Benutzer:innen) für Shopify POS zu erstellen und deren Shop-Zugriff für mehrere gleichzeitig zu verwalten.
Du kannst einen CSV-Import verwenden, um die folgenden Änderungen an deinen Benutzerkonten vorzunehmen:
- Neue Admin-Benutzer:innen erstellen
- Neue Point of Sale (POS)-Benutzer:innen für Shopify POS mit zugewiesenen PINs erstellen
- Bestehende Admin- und POS-Benutzerkonten sperren und reaktivieren
Auf dieser Seite
- Überlegungen zur CSV-Datei für die Benutzerverwaltung
- CSV-Beispieldatei zur Benutzerverwaltung herunterladen
- Spaltendefinitionen für die CSV-Datei zur Benutzerverwaltung
- Neue Benutzer:innen in einer CSV-Datei erstellen
- Bestehende Benutzer:innen in einer CSV-Datei sperren oder reaktivieren
- Benutzer:innen mehrere Rollen, Standorte und Shops zuweisen
- Einem/einer Benutzer:in in einer CSV-Datei eine Gruppe zuweisen
- CSV-Datei zur Benutzerverwaltung aus dem Shopify-Adminbereich importieren
- Lösungen für häufige Probleme beim Import der Benutzerverwaltung
- Fehlerbehebung bei Importfehlermeldungen
Überlegungen zur CSV-Datei für die Benutzerverwaltung
Einige Änderungen an Benutzerkonten werden bei einem CSV-Import nicht unterstützt. Verwalte deine Benutzerkonten manuell im Shopify-Adminbereich oder in der Shopify POS-App, wenn ein CSV-Import bestimmte Aktualisierungen nicht abschließen kann. Beachte die folgenden Punkte, wenn du Benutzer:innen über eine CSV-Datei importierst:
- Der Import von CSV-Dateien unterstützt das massenhafte Löschen von Benutzer:innen nicht.
- Du kannst keine Anforderungen zur Zwei-Faktor-Authentifizierung für Benutzer:innen festlegen oder aktualisieren.
- Du kannst die PIN von bestehenden Benutzer:innen für Shopify POS nicht ändern.
- Du kannst über einen CSV-Import keine neuen Rollen, Gruppen oder Standorte erstellen. Rollennamen, Gruppennamen und Standortnamen in deiner Datei müssen mit den bereits in deinem Shopify-Adminbereich vorhandenen Namen übereinstimmen.
- Du kannst mit einem CSV-Import nur bestehende Benutzer:innen sperren oder reaktivieren. Du kannst die Rolle, die zugewiesene Gruppe, den Standort oder den Shop-Zugriff von bestehenden Benutzer:innen nicht ändern.
- Du kannst den Typ von Benutzer:innen nicht ändern, z. B. reine POS-Benutzer:innen in Admin-Benutzer:innen umwandeln.
CSV-Beispieldatei zur Benutzerverwaltung herunterladen
Eine Beispieldatei enthält die erforderlichen Spaltenüberschriften und Beispielwerte für jede Spalte. Du kannst sie als Vorlage nutzen, bevor du deine eigenen Benutzer:innen hinzufügst.
Du kannst eine Beispiel-CSV-Datei für die Benutzerverwaltung auf dieser Seite herunterladen und ansehen oder ein Beispiel auf der Seite Importieren in deinem Shopify-Adminbereich herunterladen.
Um zu erfahren, wie du CSV-Dateien in deiner Tabellenkalkulations-App speichern und bearbeiten kannst, lies den Artikel CSV-Datei öffnen und bearbeiten.
Spaltendefinitionen für die CSV-Datei zur Benutzerverwaltung
Die folgende Tabelle listet jede Spalte der Beispiel-CSV-Datei zur Benutzerverwaltung auf. Die Definitionen erklären, wie die jeweilige Spalte verwendet wird, wenn du Benutzer:innen erstellst oder bestehende Benutzer:innen sperrst oder reaktivierst, einschließlich der Unterschiede zwischen Admin-Benutzer:innen und reinen POS-Benutzer:innen.
| CSV-Spalte | Definition |
|---|---|
| id | Die eindeutige Benutzer-ID für jedes Konto. Wenn du deine Informationen zur Benutzerverwaltung als CSV-Datei exportierst, wird die ID aller Benutzer:innen in der Spalte id aufgeführt. Du findest die ID von Benutzer:innen auch in der Browser-URL, wenn du deren Profil in deinem Shopify-Adminbereich öffnest. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| user_type | Benutzertyp, z. B. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
Eine gültige E-Mail-Adresse. Beim Erstellen:
Beim Sperren oder Reaktivieren:
| |
| phone | Die Telefonnummer der Benutzerin oder des Benutzers. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| given_name | Der Vorname der Benutzerin oder des Benutzers. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| family_name | Der Nachname der Benutzer:in. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| status | Status des Benutzerkontos, wie z. B. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| role_name | Der Name der Rolle, die dem/der Benutzer:in zugewiesen ist. Der Rollenname muss existieren und für diesen Benutzertyp gültig sein. Eine Zeile in einer CSV-Datei kann entweder eine Rolle oder eine Gruppe zuweisen, jedoch nicht beides. Wenn du in derselben Zeile sowohl unter role_name als auch unter group_name einen Wert eingibst, schlägt der Import für diese Zeile fehl. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| group_name | Die dem/der Benutzer:in zugewiesene Gruppe. Gruppen sind nur für Organisationen im Shopify Plus-Plan verfügbar. Eine Zeile in einer CSV-Datei kann entweder eine Gruppe oder eine Rolle zuweisen, jedoch nicht beides. Wenn du in derselben Zeile sowohl unter group_name als auch unter role_name einen Wert eingibst, schlägt der Import für diese Zeile fehl. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| store_name | Der Shop, auf den die Benutzer:in zugreifen kann. Muss exakt mit einem Shop-Namen in deinem Shopify-Adminbereich übereinstimmen. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| pos_location_name | Der POS-Standort, auf den die Benutzer:in zugreifen kann. Der Standortname muss mit einem Standort in diesem Shop übereinstimmen. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| all_current_and_future_locations | Gib Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
| pin | PIN für die Anmeldung bei Shopify POS: eine 4- bis 6-stellige Nummer. Die PIN muss in der CSV-Datei in jeder Zeile, die derselben Benutzer:in innerhalb eines Shops POS-Berechtigungen zuweist, gleich sein. Die PIN kann für dieselbe Benutzer:in je nach Shop unterschiedlich sein. In jedem Shop muss jede PIN eindeutig einem Benutzerkonto zugeordnet sein. Beim Erstellen:
Beim Sperren oder Reaktivieren:
|
Neue Benutzer:innen in einer CSV-Datei erstellen
Um neue Benutzer:innen zu erstellen, lasse die Spalte id in der entsprechenden Zeile leer. Nachdem das Benutzerkonto erstellt wurde, weist der Import der id automatisch einen Wert zu.
Um Benutzer:innen Zugriff auf mehr als einen Standort, eine Rolle oder einen Shop zu gewähren, lies den Abschnitt Benutzer:innen mehrere Rollen, Standorte und Shops zuweisen.
POS-Benutzer:in erstellen
Um eine:n POS-Benutzer:in zu erstellen, gib einen Wert für die folgenden Felder ein:
- Gib
Point of saleim Feld user_type ein. - Gib given_name und family_name ein.
- Um die Benutzerberechtigungen festzulegen, gib einen Wert für eines der folgenden Felder ein:
- role_name und store_name: Wenn deine Organisation über mehr als einen Shop verfügt, sind beide Felder erforderlich.
- group_name: Nur im Shopify Plus-Plan verfügbar. Um zu erfahren, wie du eine Gruppe zuweist, lies den Abschnitt Einem/einer Benutzer:in in einer CSV-Datei eine Gruppe zuweisen.
- Um den Standortzugriff festzulegen, gib einen Wert für die folgenden Felder ein:
- Für den Zugriff auf bestimmte Standorte gib pos_location_name ein und setze all_current_and_future_locations auf
FALSE. - Für den Zugriff auf alle Standorte setze all_current_and_future_locations auf
TRUEund lasse pos_location_name leer.
- Für den Zugriff auf bestimmte Standorte gib pos_location_name ein und setze all_current_and_future_locations auf
- Optional: Gib email, phone oder pin ein. Eine PIN muss eine 4- bis 6-stellige Zahl sein, die innerhalb eines Shops eindeutig ist.
Admin-Benutzer:in erstellen
Um eine:n Admin-Benutzer:in zu erstellen, gib einen Wert für die folgenden Felder ein:
- Gib
Adminim Feld user_type ein. - Gib email ein.
- Um die Benutzerberechtigungen festzulegen, gib einen Wert für die folgenden Felder ein:
- role_name und store_name: Wenn deine Organisation nur einen Shop hat, ist store_name nicht erforderlich. Wenn es sich um eine Rolle auf Organisationsebene handelt, lasse store_name leer.
- group_name: Nur im Shopify Plus-Plan verfügbar. Um zu erfahren, wie du eine Gruppe zuweist, lies den Abschnitt Einem/einer Benutzer:in in einer CSV-Datei eine Gruppe zuweisen.
- Optional: Wenn role_name eine Rolle der POS-Kategorie ist, kannst du in dieser Zeile einen Wert für pin eingeben. Wenn du keine PIN angibst, generiert der Import eine PIN für das Benutzerkonto.
- Wenn role_name eine Rolle der POS-Kategorie ist, musst du den Standortzugriff für das Benutzerkonto festlegen. Gib einen Wert für die folgenden Felder ein:
- Für den Zugriff auf bestimmte Standorte gib pos_location_name ein und setze all_current_and_future_locations auf
FALSE. - Für den Zugriff auf alle Standorte setze all_current_and_future_locations auf
TRUEund lasse pos_location_name leer.
- Für den Zugriff auf bestimmte Standorte gib pos_location_name ein und setze all_current_and_future_locations auf
Bestehende Benutzer:innen in einer CSV-Datei sperren oder reaktivieren
Du kannst bestehende Benutzer:innen sperren oder reaktivieren, indem du deiner CSV-Datei zur Benutzerverwaltung eine Zeile pro Benutzer:in hinzufügst. Die Benutzer:innen werden anhand der id identifiziert.
Um bestehende Benutzer:innen zu sperren oder zu reaktivieren, gib einen Wert für die folgenden Felder ein:
- Gib die id für das Benutzerkonto ein.
- Gib den user_type für das Benutzerkonto ein.
- Wenn es sich um eine:n Admin-Benutzer:in handelt, gib einen Wert für die folgenden Felder ein:
- email: Erforderlich.
- given_name: Optional. Wenn du einen Wert eingibst, muss dieser mit dem Vornamen der Benutzer:in in deinem Shopify-Adminbereich übereinstimmen.
- family_name: Optional. Wenn du einen Wert eingibst, muss dieser mit dem Nachnamen der Benutzer:in in deinem Shopify-Adminbereich übereinstimmen.
- phone: Optional. Wenn du einen Wert eingibst, muss dieser mit der Telefonnummer der Benutzer:in in deinem Shopify-Adminbereich übereinstimmen.
- Wenn es sich um eine:n POS-Benutzer:in handelt, gib einen Wert für die folgenden Felder ein:
- given_name: Erforderlich.
- family_name: Erforderlich.
- email: Wenn für das Konto der Benutzer:in eine E-Mail-Adresse hinterlegt ist, ist dieses Feld erforderlich.
- phone: Wenn für das Konto der Benutzer:in eine Telefonnummer hinterlegt ist, ist dieses Feld erforderlich.
- status: Gib
Suspendedein, um das Konto zu sperren, oderActive, um es zu reaktivieren. Du kannst Benutzer:innen nur sperren, wenn ihr aktueller Status in deinem Shopify-AdminbereichActiveoderInactivelautet. Du kannst Benutzer:innen nur reaktivieren, wenn ihr aktueller StatusSuspendedlautet.
Einer Benutzer:in mehrere Rollen, Standorte und Shops zuweisen
Wenn du neue Benutzer:innen erstellst, kannst du ihnen mit einem einzigen CSV-Datei-Import mehr als eine Rolle, einen POS-Standort und einen Shop zuweisen. Jede Kombination aus Rolle, Standort oder Shop benötigt eine eigene Zeile in der Datei.
Füge für jeden Wert, den du derselben Benutzer:in zuweisen möchtest, eine Zeile hinzu. Gib in jeder Zeile für diese Benutzer:in dieselben Identifikationswerte ein, damit der Import jede Zeile auf genau dieses Benutzerkonto anwendet. Lass id in jeder Zeile leer. Der Import weist die id zu, nachdem das Benutzerkonto erstellt wurde.
Erforderliche Identifikationswerte in jeder Zeile
Damit der Import dieselbe Benutzer:in identifizieren kann, musst du in jeder Zeile deiner CSV-Datei für diese Benutzer:in die folgenden Werte eingeben:
- Für Admin-Benutzer:innen müssen in jeder Zeile für die jeweilige Benutzer:in dieselbe email und derselbe user_type eingegeben werden.
- Bei POS-Benutzer:innen müssen für die jeweilige Person in jeder Zeile dieselben Werte für user_type, given_name, family_name, email und phone eingegeben werden.
Einer Benutzer:in mehrere Rollen im selben Shop zuweisen
Eine einzelne Benutzer:in kann mehr als eine Rolle im selben Shop innehaben, wenn jede Rolle in der CSV-Datei in einer eigenen Zeile aufgeführt ist.
Um einer Benutzer:in mehr als eine Rolle im selben Shop zuzuweisen, musst du pro Rolle eine Zeile in deiner CSV-Datei hinzufügen. Gib in jeder Zeile dieselben Identifikationswerte für diese Benutzer:in ein und füge dann den genauen store_name und role_name hinzu, die in deinem Shopify-Adminbereich aufgeführt sind.
Mehrere POS-Standorte im selben Shop zuweisen
Wenn eine Benutzer:in nur auf bestimmte POS-Standorte in einem Shop zugreifen soll, führst du jeden Standort in einer separaten Zeile auf.
Um einem bzw. einer Benutzer:in Zugriff auf mehrere spezifische POS-Standorte zuzuweisen, musst du in deiner CSV-Datei eine Zeile pro Standort hinzufügen. Gib in jeder Zeile dieselben Identifikationswerte für diese Person ein, trage den im Shopify-Adminbereich aufgeführten pos_location_name ein und setze all_current_and_future_locations in jeder Zeile auf FALSE.
Um beispielsweise einem/einer Benutzer:in dieselbe Rolle an zwei bestimmten Standorten in einem Shop zuzuweisen, füge eine Zeile pro Standort hinzu.
| role_name | pos_location_name | all_current_and_future_locations |
|---|---|---|
Kassierer:in | Standort 1 | FALSE |
Kassierer:in | Standort 2 | FALSE |
Alternativ kannst du, um Zugriff auf alle aktuellen und zukünftigen Standorte zu gewähren, eine einzige Zeile verwenden, in der all_current_and_future_locations auf TRUE gesetzt ist und pos_location_name leer bleibt. Verwende für diese Person in diesem Shop in jeder Zeile denselben Wert (TRUE oder FALSE). Du kannst die Werte in den Zeilen nicht mischen.
Benutzerzugriff über mehrere Shops hinweg zuweisen
Organisationen mit mehr als einem Shop können derselben Person in jedem benötigten Shop Zugriff gewähren.
Wenn ein:e Benutzer:in in mehr als einem Shop Zugriff benötigt, verwende eine Zeile pro Kombination aus Rolle, Shop und Standort. In jeder Zeile musst du dieselben Identifikationswerte für diese Person eingeben, zusammen mit dem exakten store_name, der in deinem Shopify-Adminbereich aufgeführt ist.
Du kannst für jeden Shop demselben oder derselben Benutzer:in mehrere Rollen zuweisen und mehrere POS-Standorte angeben.
Verwende für all_current_and_future_locations und pos_location_name in Erstellungszeilen dieselben Zeilenmuster wie unter Zuweisen mehrerer POS-Standorte im selben Shop. Du kannst all_current_and_future_locations nicht auf TRUE setzen, wenn pos_location_name in dieser Zeile einen Wert enthält.
Das folgende Beispiel weist demselben/derselben POS-Benutzer:in unterschiedlichen Standortzugriff über zwei verschiedene Shops hinweg zu.
| store_name | role_name | pos_location_name | all_current_and_future_locations |
|---|---|---|---|
ShopName_USA | Kassierer:in | ShopName_USA_SF_01 | FALSE |
ShopName_CAN | Shop-Kassierer:in | TRUE |
Wenn eine Zeile für eine:n Benutzer:in fehlschlägt, werden alle Zeilen für diese Person abgelehnt. Nachdem du den Fehler behoben hast, musst du beim nächsten Import alle Zeilen für diese:n Benutzer:in einschließen.
Einem/einer Benutzer:in in einer CSV-Datei eine Gruppe zuweisen
Gruppen sind nur für Organisationen im Shopify Plus-Plan verfügbar. Eine Gruppe bündelt eine oder mehrere Rollen, sodass die Zuweisung einer Gruppe einem/einer Benutzer:in mehrere Rollen gleichzeitig gewähren kann.
Eine Gruppe oder eine einzelne Rolle zuweisen
Jede Zeile in einer CSV-Datei kann entweder eine Gruppe oder eine einzelne Rolle zuweisen, jedoch nicht beides:
- Um eine Gruppe zuzuweisen, gib die Gruppe unter group_name ein und lasse role_name leer.
- Um eine einzelne Rolle zuzuweisen, gib die Rolle unter role_name ein und lasse group_name leer.
Berechtigten Benutzer:innen eine Gruppe zuweisen
Du kannst einem/einer Benutzer:in eine Gruppe zuweisen, wenn mindestens eine Rolle in der Gruppe für diesen Benutzertyp gilt. Rollen in der Gruppe, die nicht für den Benutzertyp gelten, werden nicht gewährt, verursachen aber keinen Fehler. Die Gruppe wird basierend auf den zutreffenden Rollen dennoch erfolgreich zugewiesen.
Du kannst keine Gruppe zuweisen, die keine Rollen hat.
Eine Gruppe über Shops und Standorte hinweg zuweisen
Du musst in deiner CSV-Datei eine Zeile für jeden Shop aufnehmen, in dem die Gruppe eine POS-Rolle gewährt. In jeder dieser Zeilen musst du auch den Standortzugriff festlegen:
- Für den Zugriff auf bestimmte Standorte gib pos_location_name ein und setze all_current_and_future_locations auf
FALSE. Um in einem Shop mehrere spezifische Standorte zu gewähren, füge eine Zeile pro Standort hinzu, mit derselben Gruppe und demselben Shop in jeder Zeile. - Für den Zugriff auf alle Standorte setze all_current_and_future_locations auf
TRUEund lasse pos_location_name leer.
Der Standortzugriff für eine Gruppe wird auf dieselbe Weise validiert wie eine POS-Rolle, die nicht über eine Gruppe zugewiesen wird. Dies schließt ein, dass er nicht mit dem Standortzugriff in Konflikt stehen darf, der demselben/derselben Benutzer:in in einer anderen Zeile gewährt wird.
PINs bei der Zuweisung einer Gruppe festlegen
Für eine PIN gelten dieselben Regeln wie für Benutzer:innen mit mehreren Rollen:
- Gib eine pin nur in einer Zeile deiner CSV-Datei für einen Shop ein, in dem die Gruppe eine POS-Rolle gewährt.
- Eine PIN muss innerhalb eines Shops eindeutig sein, kann sich aber zwischen verschiedenen Shops unterscheiden.
- Gib keine pin in einer Zeile für einen Shop ein, in dem die Gruppe nur Nicht-POS-Rollen gewährt.
Eine Gruppe zuweisen, die eine Organisationsrolle enthält
Wenn eine Gruppe eine Organisationsrolle umfasst, die über POS-Berechtigungen verfügt, gewährt die Organisationsrolle automatisch Zugriff auf alle Standorte, sodass die Anforderung des Standorts pro Shop für sie nicht gilt. Du kannst diese Art von Gruppe auf eine der folgenden Arten zuweisen:
- Eine einzelne Zeile nur für die Gruppe: Gib die Gruppe unter group_name ein und lasse store_name, pos_location_name, all_current_and_future_locations und pin leer. Die Organisationsrolle gewährt automatisch Zugriff auf alle Standorte.
- Explizite Shop-Zeilen: Füge eine Zeile für jeden Shop hinzu, in dem die Gruppe eine POS-Rolle gewährt. Setze in jeder dieser Zeilen all_current_and_future_locations auf
TRUE. Du kannst eine:n Benutzer:in mit einer Organisationsrolle nicht auf einen einzigen Standort beschränken.
Beispiele für die Zuweisung einer Gruppe
Die folgenden Beispiele veranschaulichen, wie eine Gruppe über verschiedene Shops und Standorte hinweg zugewiesen wird. Jede Zeile listet die Werte für group_name, store_name, pos_location_name und all_current_and_future_locations auf.
In den folgenden Beispielen gewährt die Gruppe eine Shop-Rolle und eine POS-Rolle in Shop 1 sowie eine POS-Rolle in Shop 2:
- Beispiel 1 weist die Gruppe mit Zugriff auf alle Standorte in zwei Shops zu. Da die Gruppe in jedem Shop eine POS-Rolle gewährt, musst du in deiner CSV-Datei eine Zeile pro Shop hinzufügen.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Gruppenname | Shop 1 | TRUE | ||
Gruppenname | Shop 2 | TRUE |
- Beispiel 2 weist die Gruppe zwei Shops zu, aber die Gruppe gewährt nur in Shop 1 eine POS-Rolle und in Shop 2 eine reine Shop-Rolle. Füge in deiner CSV-Datei nur für den Shop mit einer POS-Rolle eine Zeile hinzu. Die reine Shop-Rolle in Shop 2 wird ohne eigene Zeile gewährt.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Gruppenname | Shop 1 | TRUE |
- Beispiel 3 weist die Gruppe mit Zugriff auf bestimmte Standorte in zwei Shops zu. Du musst pro Standort eine Zeile in deiner CSV-Datei hinzufügen.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Gruppenname | Shop 1 | Standort 11 | FALSE | |
Gruppenname | Shop 1 | Standort 12 | FALSE | |
Gruppenname | Shop 2 | Standort 21 | FALSE | |
Gruppenname | Shop 2 | Standort 22 | FALSE |
Beispiel 4 weist eine Gruppe zu, die zusätzlich zu einer Shop-Rolle und einer POS-Rolle eine Organisationsrolle mit POS-Berechtigungen enthält. Du kannst diese Gruppe auf eine der folgenden Arten zuweisen:
- Die erste Option ist eine einzige, reine Gruppenzeile, bei der die Organisationsrolle Zugriff auf alle Standorte gewährt.
- Die zweite Option verwendet eine explizite Zeile für jeden Shop, in dem die Gruppe eine POS-Rolle gewährt. In jeder Zeile muss all_current_and_future_locations
TRUEsein, da die Organisationsrolle nicht auf einen einzelnen Standort beschränkt werden kann.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Gruppenname |
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Gruppenname | Shop 1 | TRUE | ||
Gruppenname | Shop 2 | TRUE |
CSV-Datei für die Benutzerverwaltung aus deinem Shopify-Adminbereich importieren
Nachdem du deine CSV-Datei erstellt und im richtigen Format gespeichert hast, kannst du sie auf der Seite Benutzer deiner Organisation hochladen. Der Import wird in deinem Shopify-Adminbereich ausgeführt und meldet alle Zeilen, die nicht verarbeitet werden können.
Schritte:
Gehe in deinem Shopify-Adminbereich zu Einstellungen > Benutzer.
Klicke auf Importieren.
Optional: Klicke auf den Link, um eine Beispiel-CSV-Datei herunterzuladen, und verwende sie dann als Vorlage für deine eigene Datei.
Klicke auf Datei hochladen und wähle dann deine
.csv-Datei aus.
Überprüfe nach Abschluss des Imports die Bestätigung in deinem Shopify-Adminbereich. Wenn Zeilen Fehler aufweisen, erhältst du eine E-Mail mit Details, damit du deine Datei korrigieren und erneut importieren kannst.
Lösungen für häufige Probleme beim Import zur Benutzerverwaltung
Wenn du Probleme beim Hochladen deiner CSV-Datei zur Benutzerverwaltung hast, prüfe, ob das Problem in den folgenden Lösungen aufgeführt ist.
Wenn du Hilfe bei der Fehlerbehebung für eine bestimmte Fehlermeldung benötigst, lies den Abschnitt zur Fehlerbehebung bei Importfehlermeldungen.
Erneuter Import nach der Fehlerbehebung
Wenn ein Import nicht erfolgreich ist, erhältst du eine E-Mail, in der die fehlgeschlagenen Zeilen aufgelistet sind. Importiere deine Datei sorgfältig erneut, damit du keine doppelten Benutzer:innen erstellst.
Importiere nur die Benutzer:innen erneut, bei denen Fehler aufgetreten sind, und nicht die gesamte Datei. Nutze die folgenden Best Practices:
- Korrigiere die fehlgeschlagenen Zeilen und nimm dann jede Zeile für jede:n betroffene:n Benutzer:in in deine neue Datei auf. Wenn für eine:n Benutzer:in drei Zeilen vorhanden waren und eine Zeile einen Fehler verursacht hat, wurden alle drei Zeilen für diese Person abgelehnt. Schließe alle drei korrigierten Zeilen in deinen erneuten Import ein.
- Schließe keine Benutzer:innen ein, die erfolgreich importiert wurden. Diese Konten existieren bereits. Wenn du sie erneut importierst, kann der Fehler
user already exists(Benutzer:in existiert bereits) zurückgegeben werden, doppelte Benutzer:innen erstellt werden oder beides.
Wenn du die gesamte Originaldatei erneut importierst, einschließlich der Zeilen für Benutzer:innen, die bereits erfolgreich erstellt wurden, kann dies zu folgenden Ergebnissen führen:
- Admin-Benutzer:innen: Wenn eine E-Mail-Adresse bereits verwendet wird, erhältst du möglicherweise die Fehlermeldung
user already existsoder einen Fehler aufgrund einer doppelten E-Mail-Adresse. - POS-Benutzer:innen: Das System kann doppelte Datensätze für POS-Benutzer:innen erstellen. POS-Benutzer:innen werden anhand des Namens und verwandter Felder anstelle einer eindeutigen E-Mail-Adresse abgeglichen. Daher kann ein:e zweite:r Benutzer:in mit demselben Namen und derselben Rolle erstellt werden.
- Platzlimits: Wenn der Import Benutzer:innen zählt, die bereits erstellt wurden, erhältst du möglicherweise Fehler wegen überschrittener Platzlimits. Weitere Informationen findest du unter Maximale Anzahl von Benutzer:innen für jeden Preisplan.
Mehrere POS-Benutzer:innen mit demselben Namen erstellen
Wenn die Identifikationswerte für eine:n POS-Benutzer:in in mehreren Zeilen eines Imports (einschließlich nicht aufeinanderfolgender Zeilen) übereinstimmen, behandelt der Import diese Zeilen als dieselbe:n Benutzer:in.
Um in einem Import separate POS-Benutzer:innen mit demselben given_name und family_name zu erstellen, musst du für jede:n Benutzer:in in mindestens einem der folgenden Felder einen anderen Wert eingeben:
- phone
Wenn du mehrere Benutzer:innen mit demselben given_name und family_name nicht anhand unterschiedlicher Werte für email oder phone unterscheiden kannst, musst du jede:n Benutzer:in in einer separaten CSV-Datei importieren.
Dateiformat und Upload-Größe
Die folgenden Probleme beziehen sich auf das CSV-Dateiformat oder die Größe, nicht auf die Werte in deinen Benutzerzeilen:
- Falsches Dateiformat: Deine Datei muss eine
.csv-Datei sein, die mit der unter CSV-Datei öffnen und bearbeiten beschriebenen Codierung gespeichert wurde. - Datei ist zu groß: Wenn deine Datei viele Zeilen hat, teile sie in kleinere Dateien auf und importiere diese nacheinander.
POS-Benutzer:in wird als mehrere Benutzer:innen anstelle von einer Person mit mehreren Rollen angezeigt
Beim Import werden Zeilen derselben POS-Benutzerin bzw. demselben POS-Benutzer zugeordnet, wenn user_type, given_name, family_name, email und phone in jeder Zeile für diese Person übereinstimmen. Wenn einer dieser Werte zwischen den Zeilen abweicht, werden beim Import separate Benutzerkonten erstellt.
Die folgenden Situationen führen oft zu doppelten POS-Benutzer:innen, wenn du eine Person mit mehreren Rollen erwartet hast:
- E-Mail in einer Zeile, in einer anderen nicht: Wenn du email in der ersten Zeile für eine:n POS-Benutzer:in angibst, sie aber in einer anderen Zeile leer lässt, erstellt der Import separate Benutzer:innen. Gib email in jeder Zeile für diese Person an oder lass das Feld in jeder Zeile leer.
- Tippfehler im Namen: Ein Tippfehler in den Namenszeilen kann dazu führen, dass separate Benutzer:innen erstellt werden. Wenn die Groß- und Kleinschreibung beachtet wird, werden beispielsweise
Janein einer Zeile undjanein einer anderen Zeile möglicherweise als unterschiedliche Personen behandelt. Schreibe den Namen der Person in jeder Zeile auf die gleiche Weise. - Telefonnummer in einer Zeile, aber nicht in einer anderen: Wenn du phone in der ersten Zeile für eine:n POS-Benutzer:in angibst, das Feld aber in einer anderen Zeile leer lässt, werden beim Import separate Benutzerkonten erstellt. Gib phone in jeder Zeile für die jeweilige Person an oder lasse das Feld in jeder Zeile leer.
Um das Duplizieren von Benutzerkonten zu vermeiden, stelle sicher, dass user_type, given_name, family_name, email und phone in jeder Zeile für den- bzw. dieselbe:n POS-Benutzer:in in deiner CSV-Datei identisch sind.
Fehler beim Sitzplatzlimit
Für Admin-Benutzer:innen gelten je nach Preisplan deines Unternehmens entsprechende Sitzplatzlimits. Wenn du während eines Imports einen Fehler bezüglich des Sitzplatzlimits erhältst, zählt der Import, wie viele neue Admin-Benutzer:innen durch deine Datei erstellt würden, und gleicht diese Zahl mit dem Sitzplatzlimit deines Plans ab. Wenn du dein Sitzplatzlimit erreicht hast oder kurz davor stehst, reduziere die Anzahl der neuen Admin-Benutzer:innen in deiner CSV-Datei oder überprüfe die Benutzerlimits für deinen Preisplan, bevor du den Import erneut startest.
Benutzerliste exportieren, um doppelte POS-Benutzer:innen zu finden
Wenn du doppelte POS-Benutzer:innen vermutest, kannst du deine Benutzerliste in eine CSV-Datei exportieren und die Zeilen in einer Tabelle vergleichen. Der Export enthält Zeitstempel, die angeben, welches Konto zuerst erstellt wurde.
Informationen dazu, wie Exporte zugestellt werden und wer sie herunterladen kann, findest du unter Informationen zur Benutzerverwaltung als CSV-Datei exportieren.
Schritte:
Gehe in deinem Shopify-Adminbereich zu Einstellungen > Benutzer.
Klicke auf Exportieren.
Klicke im Dialogfeld Benutzer exportieren auf Exportieren.
Sobald du die E-Mail erhältst, klicke auf Datei herunterladen, um die CSV-Datei auf deinem Gerät zu speichern.
Öffne die Datei in einer Tabellen-App und sortiere sie dann nach der Spalte
GIVEN_NAME.Überprüfe im Export die POS-Benutzer:innen mit übereinstimmenden Werten für Vorname, Nachname, E-Mail und Telefonnummer, deren
CREATED_AT-Zeiten identisch sind oder sehr nah beieinander liegen. Bei diesen Konten handelt es sich wahrscheinlich um Duplikate.
Doppelte POS-Benutzer:innen manuell löschen
Du kannst ein doppeltes POS-Benutzerkonto manuell in deinem Shopify-Adminbereich entfernen, ohne eine CSV-Datei zu verwenden.
Schritte:
Gehe in deinem Shopify-Adminbereich zu Einstellungen > Benutzer.
Wähle das doppelte Benutzerkonto aus.
Klicke auf Entfernen.
Doppelte POS-Benutzer:innen massenhaft über eine CSV-Datei löschen
Du kannst doppelte Konten durch einen CSV-Import sperren und diese gesperrten Konten dann gesammelt auf der Seite Benutzer:innen in deinem Shopify-Adminbereich löschen. Das vorherige Sperren der Konten hilft dir, zu überprüfen, welche Konten du entfernst, bevor du sie endgültig löschst.
Schritte:
- Exportiere deine aktuelle Benutzerliste.
- Identifiziere doppelte Konten mithilfe der Vergleichsmethode, die unter Benutzerliste exportieren, um doppelte POS-Benutzer:innen zu vergleichen beschrieben wird.
- Kopiere für jedes duplizierte Konto die Werte für id, user_type, email, phone, given_name und family_name in eine neue CSV-Datei. Verwende dieselbe Spaltenstruktur wie in der Beispiel-CSV-Datei für die Benutzerverwaltung.
- Setze status für jede duplizierte Zeile auf
Suspended. Lasse role_name, group_name, store_name, pos_location_name, all_current_and_future_locations und pin leer. - Importiere die CSV-Datei, um diese Benutzer:innen zu sperren.
- Gehe zu Einstellungen > Benutzer:innen.
- Falls möglich, filtere die Benutzerliste nach Konten mit dem Status Gesperrt. Wähle die von dir gesperrten doppelten Konten aus und lösche sie in einer Sammelaktion.
Fehlerbehebung bei Import-Fehlermeldungen
Wenn ein CSV-Import zur Benutzerverwaltung nicht erfolgreich ist, erhältst du eine E-Mail, die die Fehlermeldung und die betroffenen Zeilen enthält. In den folgenden Abschnitten wird erklärt, was die jeweiligen Meldungen bedeuten und was du in deiner CSV-Datei ändern kannst, bevor du den Import erneut startest.
Wenn du weiterhin Probleme mit deinem CSV-Import hast, wende dich an den Shopify Support.
Fehler in CSV-Dateien
CSV headers are missing or invalid
Die Datei hat keine Header-Zeile oder die Header können nicht verarbeitet werden. Verwende das Beispiel für die Benutzerverwaltung auf der Seite Importieren und behalte die erste Zeile genau wie vorgegeben bei.
CSV file is empty
Die Datei enthält unter dem Header keine Datenzeilen. Füge mindestens eine Zeile hinzu oder vergewissere dich, dass du die gesamte Datei exportiert oder gespeichert hast.
Missing required CSV headers
Eine oder mehrere erforderliche Spalten fehlen. Der Import erwartet beim Importieren einer CSV-Datei für die Benutzerverwaltung die folgenden Header:
- id
- user_type
- phone
- given_name
- family_name
- status
- role_name
- group_name
- store_name
- pos_location_name
- all_current_and_future_locations
- pin
Lösche oder benenne keine Spalten aus der Beispiel-CSV-Datei für die Benutzerverwaltung um.
Found extra CSV headers: [...]
Die Datei enthält Spalten, die in der Liste der zulässigen Spalten nicht aufgeführt sind. Entferne alle Header, die nicht in der Vorlage der CSV-Datei für die Benutzerverwaltung enthalten sind.
Fehler bei der Benutzeridentifikation
user_type must be 'Admin' or 'Point of sale'
Der für user_type festgelegte Wert wird nicht akzeptiert. Setze user_type auf Admin oder Point of sale.
Fehler bei der Erstellung von Admin- oder POS-Benutzer:innen
Die folgende Fehlerbehebung gilt für die Erstellung von neuen Benutzer:innen, wenn das Feld id für die Benutzer:innen leer ist.
Status is required
Lasse in den Zeilen zur Benutzererstellung die Spalte status leer. Der Import legt den status automatisch fest. Wenn du in einer Erstellungszeile einen Wert in der Spalte status eingibst, schlägt der Import für diese:n Benutzer:in fehl. Setze in Zeilen zum Sperren oder Reaktivieren den status entsprechend auf Suspended oder Active.
user_type must be 'Admin' or 'Point of sale'
Der eingegebene user_type ist ungültig. Du musst Admin oder Point of sale eingeben.
Fehler bei der Erstellung von Admin-Benutzer:innen
Die folgende Fehlerbehebung gilt, wenn id leer ist und user_type auf Admin gesetzt ist.
Email is required
Du musst in jeder Zeile einen Wert für email eingeben, wenn du eine:n Admin-Benutzer:in erstellst.
Fehler bei der Erstellung von POS-Benutzer:innen
Die folgende Fehlerbehebung gilt, wenn id leer ist und user_type auf Point of sale gesetzt ist.
given_name is required
Du musst für jede neue Zeile für POS-Benutzer:innen einen Wert für given_name eingeben.
family_name is required
Du musst für jede neue Zeile für POS-Benutzer:innen einen Wert für family_name eingeben.
Fehler bei der Sperrung von Benutzer:innen
Die folgende Fehlerbehebung gilt, wenn id einen Wert aufweist und du den status für ein bestehendes Benutzerkonto änderst.
Suspend operation must have exactly 1 row.
Dein Import enthält mehrere Zeilen, mit denen dieselbe:r Benutzer:in gesperrt oder reaktiviert wird. Füge bei jedem Import pro Benutzer:in nur eine Zeile zum Sperren oder Reaktivieren ein.
Status is required
Das Feld status ist leer. Du musst es entsprechend auf Suspended oder Active setzen.
[...] does not match with user.
Dieser Fehler bedeutet, dass ein Wert in deiner Zeile nicht mit den im Shopify-Adminbereich gespeicherten Daten für die mit der id verknüpfte Person übereinstimmt. Stelle sicher, dass die Werte, die du für jede dieser Spalten in deiner CSV-Datei eingegeben hast, mit den Angaben für diese:n Benutzer:in in deinem Shopify-Adminbereich übereinstimmen:
- given_name
- family_name
- phone
- user_type
Status must be 'suspended' or 'active'.
Setze status entweder auf Suspended oder Active.
[...] must be blank when suspending a user.
Lasse diese Felder in Zeilen, in denen du nur den status änderst, leer:
- role_name
- group_name
- store_name
- pos_location_name
- all_current_and_future_locations
- pin