Zusammenfassung: ◀▼
Mithilfe einer CSV-Datei können Sie mehrere Organisationen gleichzeitig importieren oder aktualisieren. Dadurch sparen Sie Zeit, weil Sie sie nicht einzeln hinzufügen müssen. Die CSV-Datei muss bestimmte Formatierungsregeln und Größenbeschränkungen einhalten, und Sie müssen ein Administrator sein, um Importe durchzuführen. Der Prozess unterstützt die Standardorganisationsdaten und angepasste Felder, unterliegt jedoch bestimmten Einschränkungen; beispielsweise ist die Importreihenfolge nicht garantiert und es darf in einer Datei keine doppelten Einträge geben. Im Importverlauf können Sie den Fortschritt verfolgen.
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 beim Massenimport mit dem Datenimportprogramm
Sie können für Benutzer und Organisationen nur die wichtigsten Daten importieren. Wenn Sie Daten importieren möchten, die nicht in der untenstehenden Tabelle aufgeführt sind, müssen Sie die REST-API von Zendesk verwenden. Weitere Informationen finden Sie unter Importieren von Benutzern mit der Zendesk-API.
- Bei Datenimportprogramm darf die CSV-Importdatei 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.
- 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.
- Die Datensätze können in einer anderen Reihenfolge erstellt oder aktualisiert werden als der, in der sie in der CSV-Datei enthalten sind.
- 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, verwenden Sie eine CSV-Datei (durch Kommas getrennte Werte). In diesem Abschnitt wird 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. |
| details | Details zur Organisation, z. B. Adresse. Diese Informationen sind nur für Agenten sichtbar, nicht für Endbenutzer. Nutzen Sie dieses Feld statt der Kopfzeile default, wenn Sie das Datenimportprogramm verwenden. |
| domain_names | Die Domänennamen der Organisation zum Zuordnen von Benutzern. Wenn Sie mehrere Domänennamen für eine Organisation angeben, trennen Sie diese durch einen senkrechten Strich (|). |
| group_id | 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, können Sie Stichwörter für die Organisation festlegen. Geben Sie die Stichwörter jeweils durch einen senkrechten Strich ( | ) getrennt ein. 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> | 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 Feldschlüssel für ein Organisationsfeld zu finden, lesen Sie den Beitrag Ermitteln des Feldschlüssels oder der Feld-ID eines angepassten Felds. 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. |
Importieren von Organisationen 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.
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.
- 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.
- Wählen Sie unter Importoptionen eine der folgenden Optionen aus:
- 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.