Zusammenfassung: ◀▼
Sie können Organisationsdaten anhand einer CSV-Datei mit bestimmten Feldern wie Name, externe ID, Notizen und Stichwörtern importieren. Der Import unterstützt bis zu 2.000 Zeilen pro Datei; dabei müssen Organisationen vor Benutzern importiert werden. Es gibt bestimmte Einschränkungen: Manche Datentypen werden nicht unterstützt, und es kann jeweils nur eine Datei importiert werden. Administratoren müssen den Datenimport aktivieren; bei Aktualisierungen werden vorhandene Daten überschrieben, wenn Felder leer gelassen werden.
Zendesk empfiehlt, zum Importieren von Organisationsdaten das Datenimportprogramm zu verwenden statt der in diesem Beitrag beschriebene Legacy-Seite für Massenaktionen. Es ist aber weiterhin möglich, über die Seite für Massenaktionen neue oder aktualisierte Organisationsdaten zu importieren
- Damit die Daten in Ihrem Zendesk-Konto geschützt sind, ist der Datenimport standardmäßig deaktiviert. Um den Datenexport im Konto zu aktivieren und Zugriff auf die Importseite zu erhalten, muss sich der Kontoinhaber oder ein Administrator an den Zendesk-Kundensupport wenden.
- Wenn Sie einen Massenimport von Benutzern und Organisationen durchführen möchten, müssen Sie die Organisationen zuerst importieren.
Dieser Beitrag enthält die folgenden Themen:
Überlegungen zum Massenimport von Organisationen (Legacy)
Beim Massenimport von Organisationen sind eine Reihe von Einschränkungen und Überlegungen zu beachten.
Einschränkungen beim Massenimport von Benutzern und Organisationen (Legacy)
Sie können für Benutzer und Organisationen nur die wichtigsten Daten importieren. Beispielsweise können Sie die in der folgenden Tabelle beschriebenen Daten importieren. Das Importieren von Zeitzonen, Fotos, Sprachpräferenzen und anderen Daten ist allerdings nicht möglich. 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 und Importieren von Organisationen mit der Zendesk-API.
- Wenn Sie die Seiten für Massenaktionen verwenden, kann die CSV-Importdatei maximal 2.000 Zeilen enthalten, also eine Kopfzeile und bis zu 1.999 Datenzeilen.
- 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-Datei mit Organisationsdaten (Legacy)
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. |
| default | 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). 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. |
| custom_fields.<Feldschlüssel> | 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 Feldschlüssel für ein angepasstes Organisationsfeld zu finden, lesen Sie den Beitrag Ermitteln des Feldschlüssels oder der Feld-ID eines angepassten Felds. 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. |
Importieren von Organisationsdaten von der Seite „Massenaktionen“ aus (Legacy)
Wir empfehlen die Verwendung des Datenimportprogramms. Sie können neue und aktualisierte Organisationsdaten aber auch von der Seite „Massenaktionen“ aus importieren. 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.
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) Auf der Seite Admin Center > Objekte und Regeln > Tools > Datenimportprogramm sehen Sie den Status des laufenden Importvorgangs. Jeder Import wird nach Abschluss im Importverlauf festgehalten.