Hochladen einer CSV-Datei in eine Quelle

Hinweis: Sie müssen die Berechtigungen Quelle – Verwalten und Kommentar – Verwalten als Automation Cloud-Benutzer oder die Berechtigungen Quellenadministrator und Nachrichten bearbeiten als Legacy-Benutzer zugewiesen haben, um CSV-Dateien in eine Quelle hochzuladen.

Um Daten aus einer CSV-Datei in eine Datenquelle hochzuladen, führen Sie die folgenden Schritte aus:

Hinweis:

• Das Aktualisieren von etwas anderem als Benutzereigenschaften führt dazu, dass allgemeine Feldanmerkungen in zugehörigen Datasets verloren gehen. Zum Beispiel das Aktualisieren vorhandener Nachrichten in einer Quelle, das Ändern von Nachrichteneigenschaften wie Nachrichtentext, gesendet_at Zeitstempel und an oder von. Stellen Sie sicher, dass Sie die aktuelle Modellversion in den zugehörigen Datasets anheften, bevor Sie dies tun.

• For details on creating a data source, check Creating or deleting a data source in the GUI.

1. Navigieren Sie zur Seite Administrator .
2. Wählen Sie die Registerkarte Quellen aus und suchen Sie die Quelle, in die Sie Daten hochladen möchten.
3. Wählen Sie das Hochladesymbol auf der Datenquellenkarte aus.
4. Verwenden Sie Datei auswählen , um eine CSV-Datei von Ihrem Computer auszuwählen.
5. Wählen Sie die CSV-Datei aus, die Sie hochladen möchten. Stellen Sie sicher, dass die Datei die folgenden Kriterien erfüllt:
   • Die Datei muss Header in der ersten Zeile enthalten und durch Komma oder Tabstopp getrennt sein.
   • Die Datei muss mindestens drei Spalten enthalten:
     • Nachricht: Der Nachrichtentext.
     • Zeitstempel: Wann die Nachricht erstellt wurde.
     • Eindeutige ID: Ein eindeutiger Bezeichner für jede Nachricht.
   • Alle Textfelder müssen in doppelte Anführungszeichen in der Datei enthalten sein.
   • Die Datei muss als UTF-8, UTF-16 oder UTF-32 codiert sein. Die Plattform erkennt automatisch die richtige Codierung.
   • Die Datei muss höchstens 128 MiB haben. Teilen Sie größere Dateien in mehrere Dateien mit jeweils weniger als 128 MiB auf.
6. Wählen Sie die erforderlichen Spalten aus, in denen die Dropdown-Menüs die in der CSV-Datei erkannten Spaltenheader enthalten:
   • NachrichtenID-Spalte – Eine Spalte mit einer eindeutigen ID, die die Nachricht identifizieren kann. Die Nachrichten-IDs dürfen nur alphanumerische ASCII-Zeichen (AZ, az, 0-9) und Satzzeichen enthalten, mit Ausnahme von Schrägstrichen /.
     Hinweis: Wenn in der Quelle vorhandene Nachrichten mit derselben ID vorhanden sind, werden diese entsprechend dem Inhalt der neuen Datei aktualisiert.

   • Nachrichtenspalte – Die Spalte, die den Nachrichtentext enthält, den Sie in der Plattform analysieren möchten.
   • Timestamp Column - The column that contains the date and time when the message was recorded. The timestamp format is flexible, and the platform infers it automatically. For more details, check Using the correct formats.
7. Sie können die folgenden zusätzlichen Spalten auswählen, wenn Sie Daten haben, die Betreffzeilen, Threads oder Teilnehmer enthalten, die in der Regel in Fällen oder E-Mail-Threads auftreten:
   • Betreffspalte – Die Spalte, die den Betreff der Nachricht enthält.
   • Absenderspalte – Die Spalte, die den Absender enthält.
   • Spalte „An“ – Die Spalte, die einen oder mehrere Empfänger enthält. Stellen Sie sicher, dass mehrere Empfänger durch ein Semikolon ; getrennt sind.
   • Cc-Spalte – Die Spalte, die einen oder mehrere Empfänger im Cc-Feld enthält. Stellen Sie sicher, dass mehrere Empfänger durch ein Semikolon ; getrennt sind.
     • For more details on using the correct formats in the Sender, To, and Cc fields, check Using the correct formats.
   • Spalte „Thread-ID“ – Die Spalte, die die Thread-ID der Nachricht enthält. Die Thread-ID verknüpft verschiedene Nachrichten mit demselben Thread.
8. Sie können die zusätzlichen Benutzereigenschaften auswählen, die Sie mit den Nachrichten hochladen möchten. Benutzereigenschaften sind kontextbezogene Metadaten, die jeder Nachricht zugeordnet sind, die Sie in der Plattform filtern können. Die Machine-Learning-Modelle in der Plattform können auch diese Benutzereigenschaften nutzen, die von folgenden Typen sind:
   • String-Benutzereigenschaften sind kategorische Metadaten, z. B. IDs, Länder, Gegenparteien usw.
   • Zahlen-Benutzereigenschaften sind numerische Metadaten, z. B. NPS, E-Mail-Statistiken, Beträge usw.
   Hinweis: Wenn Ihre Datei eine NPS-Punktzahl als Benutzereigenschaft enthält, müssen Sie dies als Zahleneigenschaft einschließen und dürfen sie nur NPS nennen, um native NPS-Diagramme auszulösen, die in die Plattform geladen werden.

9. Nachdem Sie alle Benutzereigenschaften ausgewählt haben, wählen Sie Hochladen aus.

   Sie werden aufgefordert, die hochgeladenen Nachrichten in einem Dataset zu überprüfen, das die Quelle enthält, in die Sie Daten hochgeladen haben. Wenn die Quelle keinen Datasets zugeordnet ist, können Sie ein neues Dataset erstellen, um zu überprüfen, ob der Upload wie erwartet ist.

   Hinweis: Wenn Sie bei der Auswahl der Benutzereigenschaften einen Fehler gemacht haben, können Sie dieselbe Datei erneut hochladen. Die Plattform verwendet die Spalten-ID als Bezeichner, um die vorhandenen Nachrichten und Eigenschaften zu überschreiben. Dies wirkt sich nicht auf Beschriftungen aus, die auf vorhandene Nachrichten angewendet werden.

Verwenden der richtigen Formate

Das Format Absender/An/CC

Stellen Sie sicher, dass:

• Die Anzahl der Empfänger überschreitet nicht die maximale Anzahl von 2.048 pro Thread.
• Der Absender oder Empfänger darf das Limit von 512 Zeichen nicht überschreiten.
• Es gibt nur ein Semikolon in einer Zeile. Zum Beispiel ist Folgendes falsch formatiert: [e-mail] ; [e-mail].

Obwohl die Plattform alle Leerzeichen vor oder nach einem Empfänger entfernt, führt sie keine zusätzliche Datenbereinigung durch. Im Folgenden finden Sie einige Formatbeispiele, die Sie für Ihre Daten verwenden können:

• Beispiel 1: zuerst:bild vgen Seiteruf <[e-mail]>; John Smith <[e-mail]>
• Beispiel 2: [e-mail] ;[e-mail]
• Beispiel 3: [e-mail] ; [e-mail]

Die Plattform trennt die verschiedenen Empfänger durch Semikolon ;.

Stellen Sie vor dem Hochladen Ihrer Daten sicher, dass die E-Mails entsprechend formatiert sind.

Hinweis: Bei einem Standard-Anwendungsfall mit Threads, wie z. B. E-Mail-Threads, darf jede Absenderzelle nur einen Absender enthalten.

Das Zeitstempelformat

Wenn das von Ihnen gewählte Zeitstempelformat für die Reihenfolge von Tagen, Monaten und Jahren nicht eindeutig ist, wie z. B. 01/02/03 10:10, können Sie die richtige Interpretation vorschlagen:

• 2. Januar 2003 - Keine
• 1. Februar 2003 – Tag zuerst
• 3. Februar 2001 – Jahr zuerst
• 2. März 2001 – Tag zuerst + Jahr zuerst

Um Mehrdeutigkeit zu vermeiden, wird empfohlen, Zeitstempel im Format RFC 3339 anzugeben. Zum Beispiel 2020-01-31T12:34:56Z für UTC oder mit einer Zeitzone: 2020-08-031T11:20:60-08:00.

Fehlersuche und ‑behebung

Hinweis: Wenn Ihr CSV-Upload mitten im Upload fehlschlägt, können Sie dieselbe CSV-Datei erneut hochladen, nachdem Sie den Fehler behoben haben. Wenn die Nachrichten-IDs und der Text (Betreff und Text) bereits hochgeladener Nachrichten unverändert bleiben, werden Ihnen beim Wiederholen des Uploads keine zusätzlichen AI Units oder Platform Units in Rechnung gestellt.

Dieser Abschnitt enthält die möglichen Fehlermeldungen, die während des Upload-Vorgangs auftreten können, und die Lösungen für jede von ihnen.

In den folgenden Fehlermeldungen wird {something} kontextbezogenen Informationen darüber zugeordnet, wo der Fehler aufgetreten ist. Darüber hinaus ist die Art und Weise, wie wir auf eine Position in der Datei verweisen, standardisiert:

String	Erweitert auf:
{Position}	Datensatz {row-number} in Zeile {line-number} Spalte {column-number} (Byte {byte-number})

Der Titel der Fehlermeldung wird zusammen mit einer Beschreibung angezeigt, wie in der folgenden Abbildung zu sehen ist:

Hinweis: Wenn ein anderer Fehler als die in der Tabelle aufgeführten auftritt, wiederholen Sie den Upload.

Fehlerart	Fehlermeldung	Beschreibung
Nicht genügend Spalten	Die CSV-Datei enthält nur {number-columns} Spalten, aber mindestens 3 sind erforderlich, d. h. text, timestamp und id.	Die hochgeladene CSV-Datei enthält nicht mindestens 3 Spalten, oder die Plattform hat die Codierung der Datei falsch erkannt.
Ungültige Codierung	Die Datei enthält ungültige Zeichen, bei denen die Codierung als {detected-encoding} erkannt wird.	Die Datei ist nicht korrekt als UTF-8, UTF-16 oder UTF-32 codiert. Die Plattform erkennt das Format der Datei automatisch.
Ungültiger Header	string:ti:er' stimmt nicht mit '(^delimiter|id|message|timestamp |timestamp_default_utc_offset |timestamp_day_first|timestamp_year_first\\Z)|(^(?P<property_type>number|string):(?P<name>\\w(?:[\\w]{0,30}\\w)?)\\Z)'überein	Wenn ein Spalten-Header ein ungültiger Name für eine Benutzereigenschaft ist, gibt die Plattform die Standardmeldung zurück, wenn das Schema einer Anforderung ungültig ist. Vergewissern Sie sich, dass jeder Spaltenheader ein gültiges Format für seinen Zweck hat. Die maximale Länge für einen Spalten-Header beträgt 32 alphanumerische Zeichen.
Ungleiche Zeilenlängen	Die CSV-Datei enthält ungleiche Zeilenlängen. Nachricht {position} hat {number} Felder, aber der vorherige Datensatz hat {number} Felder.	Die CSV-Datei enthält Zeilen mit unterschiedlicher Anzahl von Zellen oder die nicht mit der Anzahl der Header übereinstimmen.
ID-Format	Ungültige Nachrichten-ID für {record}. IDs dürfen nur aus alphanumerischen ASCII-Zeichen und Satzzeichen bestehen, mit Ausnahme des Schrägstrichs /. Zellenwert: { Cell-value}.	Tritt auf, wenn ein ID-Feld aus ungültigen Zeichen besteht, wie in der Fehlermeldung beschrieben.
ID-Länge	Die ID ist zu lang für Nachricht {record}. Sie hat {number} Bytes, die höchstens 1024 erwartet werden.	Tritt auf, wenn ein ID-Feld länger als die maximal zulässige Länge von 1024 Zeichen ist.
Zeitstempelformat	Falsch formatierter Zeitstempel in Nachricht {position}: {timestamp-error-message}. Zellenwert: { Cell-value}.	Tritt auf, wenn ein Zeitstempelfeld nicht geparst werden konnte.
Nachrichtenlänge	Nachricht ist zu lang für Nachricht {position}. Sie hat {number} Bytes, die höchstens 65536 erwartet werden.	Tritt auf, wenn ein Nachrichtenfeld länger als die maximal zulässige Länge von 65536 Zeichen ist.
Format der Zahleneigenschaft	Falsch formatierte Zahl in Meldung {position}: {number-error-message}. Zellenwert: { Cell-value}.	Tritt auf, wenn ein Zahlenbenutzereigenschaftsfeld nicht geparst werden konnte. Die Plattform sollte jedes Format zulassen, das sinnvollerweise als Zahl dekodiert werden kann.
Eigenschaftslänge	Eigenschaft ist zu lang für Nachricht {position}. Sie hat {number} Bytes, die höchstens 4096 erwartet werden.	Tritt auf, wenn ein Benutzereigenschaftsfeld länger als die maximal zulässige Länge von 4096 Zeichen ist.
Unbekannter Fehler	Unbekannter CSV-Fehler: {underlying-error-message}.	Wenn ein unbekannter Fehler auftritt, wiederholen Sie den Upload.