Statt Organisationen einzeln hinzuzufügen, können Sie durch den Import einer CSV-Datei mehrere Organisationen auf einmal hinzufügen. Mit dieser Methode können Sie neue Organisationen hinzufügen und vorhandene Organisationen aktualisieren. Für den Massenimport von Organisationen sind Administratorrechte erforderlich. Sie können auch mehrere Benutzer und mehrere angepasste Objektdatensätze auf einmal hinzufügen oder aktualisieren.
Der Massenimport von Organisationen kann nicht rückgängig gemacht werden. Bevor Sie die CSV-Datei mit den Informationen aller Ihrer Organisationen importieren, sollten Sie sie mit einem einzelnen Organisationsdatensatz testen, um sicherzustellen, dass der Upload wie beabsichtigt funktioniert.
Einschränkungen des Massenimports von Benutzern und Organisationen
Sie können für Benutzer und Organisationen nur die wichtigsten Daten importieren. Zum Beispiel ist es bei einem Massenimport möglich, die in der untenstehenden Tabelle beschriebenen Daten zu importieren, nicht aber Zeitzonen, Fotos, Spracheinstellungen usw. Wenn Sie Daten importieren möchten, die nicht in der untenstehenden Tabelle aufgeführt sind, müssen Sie stattdessen die REST-API von Zendesk verwenden. Weitere Informationen finden Sie unter Importieren von Benutzern mit der Zendesk-API und Importieren von Organisationen mit der Zendesk-API.
- Die maximale Anzahl von Zeilen hängt von der Importmethode ab.
- Wenn Sie die Massenaktionen-Seiten zum Importieren neuer und vorhandener Benutzer- und Organisationsdaten verwenden, kann die CSV-Importdatei maximal 2.000 Zeilen enthalten, also eine Kopfzeile und bis zu 1.999 Datenzeilen.
- Wenn Sie das Datenimportprogramm zum Importieren neuer und vorhandener Benutzer- und Organisationsdaten verwenden, darf die Größe der importierten CSV-Datei 1 GB nicht überschreiten. Wir empfehlen eine maximale Anzahl von 500.000 Zeilen, also eine Kopfzeile und bis zu 499.999 Datenzeilen. Außerdem darf jede Zeile nicht mehr als 128 KB umfassen.
- Bei Verwendung des Datenimportprogramms gelten zudem die folgenden Einschränkungen:
- Die CSV-Importdatei kann maximal 200 Spalten enthalten.
- Die CSV-Importdatei kann keine bestimmte Importreihenfolge für Zeilen gewährleisten.
- Die CSV-Importdatei darf Benutzer und Organisationen nicht mehrmals enthalten. Andernfalls kann der Import fehlschlagen.
- Es gibt keine Garantie, dass die Datensätze in der Reihenfolge erstellt oder aktualisiert werden, in der sie in der CSV-Datei erscheinen.
- Sie können jeweils nur eine CSV-Datei importieren. Wenn Sie mehr als die für die CSV-Datei zulässige Anzahl von Zeilen importieren möchten, müssen Sie für jeden Stapel separate Dateien erstellen und diese nacheinander importieren. Beim Importieren ohne Datenimportprogramm können Sie maximal zwei Stapel in die Warteschlange stellen und im Hintergrund abarbeiten lassen. Wenn Sie mehr als zwei Stapel importieren möchten, müssen Sie warten, bis die ersten zwei Stapel importiert sind, bevor Sie weitere hinzufügen können.
- Sie können keine Kontaktinformationen aus den Facebook- oder X (vormals Twitter)-Konten von Endbenutzern per Massenimport hinzufügen. Hierzu müssen Sie die REST-API von Zendesk verwenden. Weitere Informationen finden Sie unter Importieren von Benutzern mit der Zendesk-API.
Erstellen der CSV-Organisationsdatendatei
Um einen Massenimport von Organisationen durchzuführen, brauchen Sie eine CSV-Datei (durch Kommas getrennte Werte). In diesem Abschnitt ist beschrieben, wie Sie diese CSV-Datei einrichten.
- Die Datei muss eine korrekt formatierte CSV-Datei sein und mit UTF-8-Codierung gespeichert werden.
- Die erste Zeile der CSV-Datei ist die Kopfzeile.
- Die Kopfzeile muss alle erforderlichen Felder in der Tabelle unten enthalten sowie alle weiteren in der Tabelle unten aufgeführten Felder, die Sie verwenden möchten.
- Verwenden Sie in der Kopfzeile je nach Importmethode entweder domain_names oder default, aber nicht beide zusammen.
- Wenn Sie keine Daten für ein Feld importieren möchten, geben Sie sie auch nicht in der Kopfzeile an.
- Leere Datenspalten in der Datei überschreiben alle vorhandenen Daten für die betreffende Organisation.
- Fügen Sie in Notizen oder mehrzeiligen angepassten Feldern Zeilenumbrüche hinzu (Alt+Eingabetaste unter Windows bzw. Ctrl+Wahltaste+Eingabetaste unter MacOS).
| Feld | Beschreibung |
|---|---|
| name | Erforderlich. Der Name der Organisation. |
| external_id | Optional, aber empfohlen; erforderlich, wenn Sie die Datensätze künftig mit dem Datenimportprogramm aktualisieren möchten. Eine eindeutige Kennung, z. B. eine Mitarbeiter- oder Kundennummer in einem externen System. |
| notes | Notizen zur Organisation. Notizen sind nur für Agenten sichtbar, nicht für Endbenutzer. |
| domain_names (nur Datenimportprogramm) |
Details zur Organisation, z. B. Adresse. Diese Informationen sind nur für Agenten sichtbar, nicht für Endbenutzer. Nutzen Sie sie anstelle der Kopfzeile default, wenn Sie das Datenimportprogramm verwenden. |
| default (nicht Datenimportprogramm) |
Dient der Zuordnung von Benutzern zu einer Organisation. Geben Sie eine oder mehrere E-Mail-Domänen ein (durch Leerzeichen getrennt, z. B. organisation1.com organisation2.com). Nutzen Sie sie anstelle der Kopfzeile domain_names, wenn Sie das Datenimportprogramm verwenden. Weitere Informationen finden Sie unter Automatisches Hinzufügen von Benutzern zu Organisationen ausgehend von ihrer E-Mail-Domäne. |
| shared | „True“ oder „false“. Gibt an, ob es sich bei der Organisation um eine gemeinsame Organisation handelt. Weitere Informationen finden Sie unter Einrichten einer gemeinsamen Organisation für Endbenutzer. |
| shared_comments | „True“ oder „false“. Damit können alle Benutzer in der Organisation gegenseitig ihre Tickets kommentieren. Das Feld „shared“ muss ebenfalls auf „true“ gesetzt sein. Weitere Informationen finden Sie unter Einrichten einer gemeinsamen Organisation für Endbenutzer. |
| group | Geben Sie eine Standardgruppe für die Organisation ein. Weitere Informationen finden Sie unter Zuordnen einer Gruppe zu einer Organisation. |
| tags | Wenn Benutzer- und Organisationsstichwörter für Zendesk Support aktiviert sind (siehe Hinzufügen von Stichwörtern und Benutzern zu Organisationen), können Sie Stichwörter für die Organisation einrichten. Stichwörter sind durch Leerzeichen zu trennen. Beim Massenimport von Organisationen werden die vorhandenen Organisationsstichwörter durch die Stichwörter in der CSV-Datei ersetzt. Um dies zu verhindern, verwenden Sie zum Aktualisieren von Stichwörtern stattdessen die Tags API. |
| organization_fields.<Feldschlüssel> (nur Datenimportprogramm) |
Beim Massenimport von Organisationen können Sie ein angepasstes Organisationsfeld importieren, indem Sie das Präfix organization_fields. und den entsprechenden Feldschlüssel angeben. Für den Feldschlüssel subscription_date würden Sie beispielsweise Folgendes angeben, um die importierten Werte für dieses Feld festzulegen: organization_fields.subscription_date Um den Schlüssel eines angepassten Organisationsfelds zu ermitteln, klicken Sie auf das Symbol Admin ( Wenn ein Feldwert nicht korrekt formatiert ist, schlägt der Import fehl. Fehlerdetails erscheinen im Importverlaufsprotokoll. Für angepasste Datumsfelder müssen Sie das Format JJ/MM/TT oder JJJJ-MM-TT verwenden. Für Kontrollkästchenfelder müssen Sie entweder True oder False verwenden. Um den Wert für ein Dropdownfeld festzulegen, verwenden Sie das Stichwort, das Sie beim Erstellen der Dropdownliste hinzugefügt haben.
Hinweis: Nachschlagebeziehungsfelder werden beim Importieren von Organisationen über die Seite „Datenimportprogramm“ nicht unterstützt.
Weitere Informationen finden Sie unter Hinzufügen von angepassten Feldern zu Organisationen. |
| custom_fields.<Feldschlüssel> (nicht Datenimportprogramm) |
Beim Massenimport von Organisationen können Sie ein angepasstes Organisationsfeld importieren, indem Sie das Präfix custom_fields. und den entsprechenden Feldschlüssel angeben. Für den Feldschlüssel subscription_date würden Sie beispielsweise Folgendes angeben, um die importierten Werte für dieses Feld festzulegen: custom_fields.subscription_date Um den Schlüssel eines angepassten Organisationsfelds zu ermitteln, klicken Sie auf das Symbol Admin ( Wenn ein Feldwert nicht richtig formatiert ist, schlägt der Import fehl. Sie erhalten per E-Mail eine Fehlermeldung mit den Datensätzen, die nicht gespeichert werden konnten. Für angepasste Datumsfelder müssen Sie das Format JJ/MM/TT oder JJJJ-MM-TT verwenden. Für Kontrollkästchenfelder müssen Sie entweder True oder False verwenden. Um die Werte für die Optionen in einer Dropdownliste festzulegen, verwenden Sie das Stichwort, das Sie beim Erstellen der Dropdownliste hinzugefügt haben.
Hinweis: Wenn es sich bei dem angepassten Organisationsfeld, das Sie importieren, um ein Nachschlagebeziehungsfeld handelt, geben Sie die ID des verknüpften Objekts als Wert für dieses Feld ein. Geben Sie zum Beispiel für eine Organisation die ID der Organisation, für einen Benutzer die Benutzer-ID und für den Datensatz zu einem angepassten Objekt die Datensatz-ID ein. Um die ID einer Organisation, eines Benutzers oder eines Datensatzes zu einem angepassten Objekt zu ermitteln, können Sie Daten aus Ihrem Konto exportieren oder die Organizations API, Users API oder Custom Object Records API verwenden.
Nachschlagebeziehungsfelder werden beim Importieren von Organisationen über die Seite „Datenimportprogramm“ nicht unterstützt. Weitere Informationen finden Sie unter Hinzufügen von angepassten Feldern zu Organisationen. |
), wählen Sie Organisationsfelder aus und klicken Sie dann auf den Namen des angepassten Felds. Der Feldschlüssel erscheint in den Eigenschaften auf der rechten Seite.Importieren der CSV-Organisationsdatendatei
Sie können einen Massenimport durchführen, um neue Organisationen zu erstellen oder Informationen für vorhandene Organisationen zu aktualisieren.
Der Import wird in die Warteschlange gestellt und die Organisationen werden nach Abschluss des Importvorgangs zu Zendesk Support hinzugefügt. Dies sollte je nach Größe der Datei und der Warteschlange ungefähr eine Stunde pro Datei dauern. Weitere Informationen finden Sie unter Einschränkungen des Massenimports von Benutzern und Organisationen.
Importieren von Organisationsdaten mit dem Datenimportprogramm
Mit dem Datenimportprogramm können Sie eine CSV-Datei importieren, die neue Organisationen erstellt oder vorhandene Organisationen aktualisiert, und alle auf der Seite „Datenimportprogramm“ eingeleiteten Importvorgänge protokollieren.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Objekte und Regeln und dann auf Tools > Datenimportprogramm. - Klicken Sie auf Importieren.
- Klicken Sie unter Ziel auf Organisationen.
- Unter Art von Import haben Sie folgende Auswahlmöglichkeiten:
- Nur Datensätze erstellen: Es werden nur neue Organisationen erstellt. Alle Daten in der CSV-Datei, die sich auf vorhandene Organisationen beziehen, werden ignoriert.
- Nur Datensätze aktualisieren: Die Daten für die in der CSV-Datei aufgeführten vorhandenen Organisationen werden ersetzt. Zum Aktualisieren von Organisationen ist die externe ID erforderlich. Alle Daten, die sich auf neue Organisationen beziehen, werden ignoriert.
- Datensätze erstellen und aktualisieren: Es werden neue Organisationen erstellt und Daten für die in Ihrer CSV-Datei aufgeführten Organisationen aktualisiert.
- Ziehen Sie die Datei in den Bereich Datei hochladen oder klicken Sie auf Zum Hochladen hier klicken und wählen Sie die gewünschte CSV-Datei im Dateibrowser aus.
Wenn Sie die Auswahl einer Datei aufheben möchten, klicken Sie neben dem Namen der Datei auf das Symbol „Löschen“ (
). - Klicken Sie auf Weiter.
- Überprüfen Sie die Liste der Feldzuordnungen.
- Wenn die Felder richtig zugeordnet sind, klicken Sie auf Weiter.
- Wenn die Felder nicht richtig zugeordnet sind, klicken Sie auf Zurück. Bearbeiten Sie die CSV-Datei, damit sie den Formatanforderungen entspricht, und laden Sie sie dann noch einmal hoch.
- Überprüfen Sie im Bestätigungsdialogfeld die Importdetails und klicken Sie dann auf Import starten.
Nachdem der Import gestartet wurde, können die importierten Änderungen nicht mehr rückgängig gemacht werden. Sie können den Status eines Importvorgangs im Importverlauf überprüfen.
Verwenden eines Massenaktionen-Imports zum Importieren von Organisationsdaten
Wir empfehlen die Verwendung des Datenimportprogramms. Sie können aber auch die Seiten für Massenaktionen verwenden, um neue und aktualisierte Organisationsdaten zu importieren. Wenn die Importvorgänge von dieser Seite abgeschlossen sind, erhalten Sie eine E-Mail.
- Klicken Sie in der Seitenleiste des Admin Centers auf
Personen und dann auf Massenaktionen > Organisationen importieren. - Wählen Sie die Art des Importvorgangs aus, den Sie durchführen möchten:
-
Neue Organisationen erstellen
-
Vorhandene Organisationen aktualisieren: Verwenden Sie diese Art von Import, um vorhandene Daten für die in Ihrer CSV-Datei aufgeführten Organisationen zu ersetzen.
Das Feld „external_id“ oder „name“ muss in der CSV-Datei enthalten sein, damit die Organisationen identifiziert werden können. Neben einem Feld mit der Angabe der Organisation müssen Sie nur die Felder in die Datei aufnehmen, die Sie aktualisieren möchten. Wenn die Zeile einer Organisation ein leeres Feld enthält, werden die vorhandenen Daten für diese Organisation überschrieben.
-
- Klicken Sie entweder auf Datei auswählen oder auf den Link Ich möchte Daten selbst einfügen.
- Klicken Sie auf Importieren.
Nachdem der Import gestartet wurde, können die importierten Änderungen nicht mehr rückgängig gemacht werden.
- (Optional) Zeigen Sie auf der Seite Admin Center > Objekte und Regeln > Tools > Datenimportprogramm den Status des laufenden Importvorgangs an. Jeder Import wird nach Abschluss im Importverlauf festgehalten.