Statt angepasste Objektdatensätze einzeln hinzuzufügen, können Sie durch den Import einer CSV-Datei eine größere Anzahl von Datensätzen auf einmal hinzufügen und aktualisieren. Für den Massenimport von angepassten Objektdatensätzen sind Administratorrechte erforderlich.
Anforderungen und Beschränkungen
- Die CSV-Importdatei darf eine Größe von 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 32 KB umfassen.
- Die CSV-Importdatei kann maximal 102 Spalten enthalten.
- Fügen Sie denselben Datensatz nicht mehrmals in eine CSV-Datei ein. 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.
- Der Massenimport angepasster Objektdatensätze kann nicht rückgängig gemacht werden. Bevor Sie die CSV-Datei mit den Informationen aller Ihrer aktuellen Datensätze importieren, sollten Sie sie mit einem einzelnen Datensatz testen, um sicherzustellen, dass der Upload wie beabsichtigt funktioniert.
Erstellen einer CSV-Datei mit angepassten Objektdatensätzen
- 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 ein Feld name enthalten. (Optional) Wenn Sie die Datensätze künftig in einer Massenaktion aktualisieren möchten, müssen Sie außerdem ein Feld external_id einfügen. Alle übrigen Feldnamen in der Kopfzeile müssen exakt mit den Feldschlüsseln in Ihrem angepassten Objekt übereinstimmen.
- Um Werte für Dropdownfelder zu importieren, verwenden Sie den Feldschlüssel (field_key) des angepassten Dropdownfelds als Spaltenüberschrift und geben Sie das Stichwort der Optionen an, nicht den benutzerfreundlichen Wert.
- Um Werte für Nachschlagebeziehungsfelder zu importieren, verwenden Sie den Feldschlüssel (field_key) des angepassten Nachschlagebeziehungsfelds als Spaltenüberschrift und geben Sie entweder die ID des Datensatzes oder die externe ID ein. Wenn Sie die ID des Datensatzes verwenden, geben Sie den Wert an. Wenn Sie die externe ID verwenden, formatieren Sie sie wie folgt: external_id:Wert, wobei Wert durch die externe ID des verknüpften Datensatzes ersetzt wird.
- Wenn Sie keine Daten für ein Feld importieren möchten, geben Sie sie auch nicht in der Kopfzeile an.
- Fügen Sie in Notizen oder mehrzeiligen angepassten Feldern Zeilenumbrüche hinzu (Alt+Eingabetaste unter Windows bzw. Ctrl+Wahltaste+Eingabetaste unter MacOS).
Wenn Sie einen Massen-Upload von Datensätzen durchführen, um Ihre vorhandenen Daten in ein neues angepasstes Objekt zu übernehmen, gehen Sie wie unter Planen des Workflows für angepasste Objekte beschrieben vor. Wir empfehlen Ihnen, während des Prozesses für jedes Ihrer angepassten Objekte Tabellen mit diesen Daten zu erstellen. Wenn Sie die Tabelle gemäß den oben genannten Richtlinien sorgfältig so strukturiert haben, dass sie dem in Zendesk erstellten angepassten Objekt entspricht, können Sie sie als CSV-Datei exportieren und für diesen Massen-Upload verwenden. Fügen Sie in diesem Fall eine Spalte external_id und für jeden Datensatz eine ID hinzu, um eine künftige Massenaktualisierung zu ermöglichen.
Importieren einer CSV-Datei mit angepassten Objektdatensätzen
Mit dem Datenimportprogramm können Sie eine CSV-Datei importieren, die neue angepasste Objektdatensätze erstellt oder vorhandene Datensätze aktualisiert, und alle auf der Seite „Datenimportprogramm“ eingeleiteten Importvorgänge protokollieren.
- Bevor Sie Datensätze für ein angepasstes Objekt in einer Massenaktion hochladen können, müssen Sie das angepasste Objekt in Zendesk erstellen.
- Klicken Sie in der Seitenleiste des Admin Centers auf Objekte und Regeln und dann auf Tools > Datenimportprogramm.
- Klicken Sie auf Importieren.
- Unter Art von Import haben Sie folgende Auswahlmöglichkeiten:
- Nur Datensätze erstellen: Es werden nur neue angepasste Objektdatensätze erstellt. Alle Daten in der CSV-Datei, die sich auf vorhandene Datensätze beziehen, werden ignoriert.
- Nur Datensätze aktualisieren: Damit werden Daten für die in der CSV-Datei enthaltenen angepassten Objektdatensätze ersetzt. Alle Daten, die sich auf neue Datensätze beziehen, werden ignoriert.
- Datensätze erstellen und aktualisieren: Es werden neue angepasste Objektdatensätze erstellt und Daten für die in Ihrer CSV-Datei aufgeführten Objektdatensätze aktualisiert.
- Wählen Sie unter Ziel den Namen des angepassten Objekts aus.
- 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 so, dass 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.