Dateieingangskonnektor

Informationen zum Datei-Eingangskonnektor

Sie können den Eingangskonnektor für Dateien verwenden, um Kundendaten über einen Datei-Upload zu laden. Diese Jobs können so eingeplant werden, dass sie nach einem von Ihnen festgelegten Zeitplan wiederholt werden, oder als einmaliger Datenabruf konfiguriert werden.

Mit Dateieingangsjobs können Sie Daten in den folgenden Formaten hochladen:

• Flache Textdateien mit Trennzeichen (CSV, TSV usw.)
• XLS oder XLSX
• JSON
• WebVTT

Eingangsjob für Dateien einrichten

1. Klicken Sie auf der Seite Aufträge auf Neuer Auftrag.
   
2. Wählen Sie Dateien.
   
3. Geben Sie Ihrem Job einen Namen, damit Sie ihn identifizieren können.
   
4. Wählen Sie das Projekt aus, in das Daten geladen werden sollen.
5. Geben Sie Ihrer Stelle eine Beschreibung, damit Sie ihren Zweck kennen.
6. Klicken Sie auf Weiter.
7. Wählen Sie ein SFTP-Konto aus, das Sie verwenden möchten, oder wählen Sie Neu hinzufügen, um ein neues Konto hinzuzufügen.
   
8. Wenn Sie ein neues Konto hinzufügen, geben Sie die folgenden Informationen für Ihr SFTP-Konto ein:
   • Verbindungsname: Geben Sie der Verbindung einen Namen, damit Sie sie später wiedererkennen können.
   • SFTP-Benutzername: Geben Sie den Benutzernamen für die Verbindung mit Ihrem SFTP-Server ein.
   • SFTP-Kennwort: Geben Sie das Kennwort für die Verbindung mit Ihrem SFTP-Server ein.
   • SFTP-Host: Geben Sie die Host-URL Ihres SFTP-Servers ein.
   • SFTP-Port: Geben Sie Ihren SFTP-Port ein. In der Regel ist dies 22.
   • Ablaufbenachrichtigungen senden: Wenn Ihre SFTP-Anmeldeinformationen nach einer bestimmten Zeit ablaufen sollen, wählen Sie diese Option aus.
   • Tage vor Ablauf: Wenn Sie Ablaufbenachrichtigungen aktivieren, geben Sie an, wie viele Tage Sie vor dem Ablauf benachrichtigt werden möchten. Sie können einen Wert zwischen 1 und 100 Tagen eingeben.
   • Ablaufdatum: Legen Sie das Datum fest, an dem die Anmeldeinformationen ablaufen. Klicken Sie auf das Feld, um einen Kalender zum Auswählen des Datums zu öffnen.
9. Klicken Sie auf Weiter.
10. Wählen Sie den Dateityp aus, den Sie hochladen möchten:
    
    • Durch Trennzeichen getrennte flache Dateien
    • Excel-Dateien (XLS, XLSX)
    • JSON-Dateien
    • WebVTT-Dateien
11. Abhängig von Ihrem ausgewählten Dateityp stehen Ihnen zusätzliche Einstellungen zur Auswahl:
    • Durch Trennzeichen getrennte flache Dateien: Wählen Sie für trennzeichengetrennte Dateien Folgendes:
      
      • Dateikodierung: Wählen Sie das Kodierungssystem der Datei (UTF-8, ASCII usw.)
      • Trennzeichen: Geben Sie das Zeichen ein, das zum Abgrenzen von Dateneinträgen verwendet wird. Standardmäßig ist dies ein Komma für CSV-Dateien.
      • Umschließungszeichen: Geben Sie das Zeichen ein, das die Dateneingabe umschließt. Lassen Sie dieses Feld leer, wenn Keine Umschließung ausgewählt ist.
      • Kein Einschluss: Aktivieren Sie diese Option, wenn Ihre Datei keine Umschließungszeichen enthält.
    • JSON: Geben Sie den JSON-Pfad ein, der die Dokumentdaten enthält, die Sie in XM Discover hochladen möchten. Lassen Sie dieses Feld leer, wenn sich Ihre Dokumente auf Wurzelebene befinden.
      
    • Fahren Sie mit dem nächsten Schritt für Excel und WebVTT fort.
12. Klicken Sie auf Durchsuchen, und wählen Sie den Ordnerpfad auf Ihrem SFTP-Server aus, der die Datei enthält, die Sie hochladen möchten.
    Tipp: Wenn Sie einen Ordnerpfad auswählen, können Sie auf ein Ordnersymbol klicken, um diesen Ordner aufzuklappen. Klicken Sie auf den Ordnernamen, um diesen Ordner auszuwählen, und klicken Sie anschließend auf OK.
13. Geben Sie den regulären Dateinamenausdruck ein, der mit den hochzuladenden Dateien übereinstimmt.
14. Wenn Ihre Dateien komprimiert sind, aktivieren Sie Datei(en) entpacken, und geben Sie den regulären Ausdruck ZIP-Dateiname ein, der mit den Dateien übereinstimmt, die dekomprimiert werden sollen.
    
15. Wenn Ihre Dateien entschlüsselt werden, aktivieren Sie Datei(en) entschlüsseln, und geben Sie Folgendes ein:
    • Regulärer Ausdruck des verschlüsselten Dateinamens: Geben Sie den regulären Dateinamenausdruck für Dateien ein, die entschlüsselt werden sollen.
    • PGP/GPG-Schlüssel: Geben Sie den PGP/GPG-Schlüssel ein, der für die Verschlüsselung verwendet wird.
    • Kennphrase: Geben Sie die Kennphrase für die Entschlüsselung ein.
16. Wenn Ihre Dateien sowohl komprimiert als auch verschlüsselt sind, müssen Sie zuerst auswählen, was passieren soll:
    • Entpacken und dann Entschlüsseln: Dateien werden dekomprimiert und dann entschlüsselt.
    • Entschlüsseln und entpacken: Dateien werden entschlüsselt und dann dekomprimiert.
17. Wählen Sie den Datentyp aus, den Sie importieren möchten:
    
    • Chat: Digitale Interaktionen mit mehreren Dialoglinien zwischen zwei oder mehr Teilnehmern.
    • Call: Rufen Sie Zeugnisse mit mehreren Dialoglinien zwischen 2 oder mehr Teilnehmern an.
    • Feedback: Dokumente, die als einzeilige oder „flache“ Objekte dargestellt werden.
      Tipp: Je nach Dateityp sind einige Datentypen nicht kompatibel. WebVTT-Dateien können beispielsweise nur zum Hochladen von Anrufprotokollen verwendet werden.
18. Sie müssen eine Beispieldatei bereitstellen, die entweder auf Ihrem Computer oder auf Ihrem SFTP-Server gespeichert werden kann:
    • Wählen Sie Beispiel aus Dateiablage herunterladen, wenn die Beispieldatei auf Ihrem SFTP-Server gespeichert ist.
    • Wählen Sie Stichprobe von meinem Computer hochladen, wenn die Probe auf Ihrem Computer gespeichert wird.
19. Bei Bedarf können Sie eine Vorlagendatei zum Herunterladen auswählen. Klicken Sie auf den Link hier, um Ihre ausgewählte Vorlage herunterzuladen. Verwenden Sie diese Datei, um die Daten hinzuzufügen, die Sie in XM Discover importieren möchten. Spezifische Formatierungsinformationen zu den einzelnen Dateien und Datentypen finden Sie auf der folgenden Supportseite: XM Discover Data Formats.
20. Klicken Sie auf die Schaltfläche Beispieldatei auswählen, und wählen Sie die Beispieldatei auf Ihrem Computer oder auf Ihrem SFTP-Server aus.
21. Eine Vorschau der Datei wird angezeigt. Wenn anstelle der Vorschau eine Fehlermeldung oder ein Rohdateiinhalt angezeigt wird, kann es zu Problemen mit den von Ihnen ausgewählten Datenformatoptionen kommen. Auf der Seite “Beispieldateifehler” finden Sie Hilfe bei der Fehlerbehebung für Ihre Datei.
22. Klicken Sie auf Weiter.
23. Passen Sie bei Bedarf Ihre Datenzuordnungen an. Detaillierte Informationen zur Zuordnung von Feldern in XM Discover finden Sie auf der Supportseite Datenzuordnung. Der Abschnitt Standarddatenzuordnung enthält Informationen zu den für diesen Konnektor spezifischen Feldern, und im Abschnitt Zuordnung konversationaler Felder wird beschrieben, wie Daten für dialogorientierte Daten zugeordnet werden.
    
24. Klicken Sie auf Weiter.
25. Bei Bedarf können Sie Regeln für die Ersetzung und Unkenntlichmachung von Daten hinzufügen, um sensible Daten auszublenden oder bestimmte Wörter und Phrasen in Kundenfeedback und Interaktionen automatisch zu ersetzen. Weitere Informationen finden Sie auf der folgenden Supportseite: Datenersetzung und Redaktion.
    
26. Klicken Sie auf Weiter.
27. Bei Bedarf können Sie einen Konnektorfilter hinzufügen, um die eingehenden Daten zu filtern und so einzuschränken, welche Daten importiert werden.
    
28. Sie können auch die Anzahl der in einem einzelnen Job importierten Datensätze begrenzen, indem Sie eine Zahl in das Feld Datensatzlimit angeben eingeben. Geben Sie „Alle“ ein, wenn Sie alle Datensätze importieren möchten.
    Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
29. Klicken Sie auf Weiter.
30. Wählen Sie aus, wann Sie benachrichtigt werden möchten. Weitere Informationen finden Sie unter Jobbenachrichtigungen.
    
31. Klicken Sie auf Weiter.
32. Wählen Sie aus, wie doppelte Belege behandelt werden sollen. Weitere Informationen finden Sie unter Behandlung von Duplikaten.
    
33. Wählen Sie Inkrementelle Läufe einplanen, wenn Ihr Job periodisch nach einem Zeitplan ausgeführt werden soll, oder Einmaligen Pull einrichten, wenn der Job nur einmal ausgeführt werden soll. Weitere Informationen finden Sie unter Jobeinplanung.
34. Wählen Sie einen Aufbewahrungszeitraum für verarbeitete Dateien. Dateien werden nach dem festgelegten Zeitraum gelöscht.
    
35. Klicken Sie auf Weiter.
36. Überprüfen Sie Ihre Einrichtung. Wenn Sie eine bestimmte Einstellung ändern müssen, klicken Sie auf die Schaltfläche Bearbeiten, um zu diesem Schritt in der Verbindungseinrichtung zu gelangen.
    
37. Wählen Sie Fertigstellen, um den Job zu sichern.

Standarddatenzuordnung

Dieser Abschnitt enthält Informationen zu den Standardfeldern für Dateieingangsjobs.

• feedback_type: Identifiziert Daten anhand ihres Typs. Dies ist hilfreich für das Reporting, wenn Ihr Projekt verschiedene Arten von Daten enthält (z.B. Umfragen und Social-Media-Feedback). Standardmäßig ist der Wert dieses Attributs auf „Anruf“ für Anrufprotokolle, „Chat“ für digitale Interaktionen oder „Feedback“ für individuelles Feedback gesetzt. Verwenden Sie benutzerdefinierte Transformationen, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• source_value: Identifiziert Daten, die aus einer bestimmten Quelle abgerufen wurden. Dies kann alles sein, das die Herkunft der Daten beschreibt, z.B. der Name einer Umfrage oder einer mobilen Marketingkampagne. Standardmäßig ist der Wert dieses Attributs auf „Dateien“ gesetzt. Verwenden Sie benutzerdefinierte Transformationen, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem anderen Feld zuzuordnen.
• document_date: Das primäre Datumsfeld, das mit einem Dokument verknüpft ist. Dieses Datum wird in XM-Discover-Berichten, Trends, Warnungen usw. verwendet. Sie können ein beliebiges Datumsfeld in Ihrem Datenbestand für das Belegdatum verwenden. Sie können auch ein bestimmtes Belegdatum festlegen.
• natural_id: Ein eindeutiger Identifikator eines Dokuments. Es wird dringend empfohlen, für jedes Dokument eine eindeutige ID zu haben, um Dubletten korrekt zu verarbeiten. Für Natürliche ID können Sie einen beliebigen Text oder ein beliebiges numerisches Feld aus Ihren Daten auswählen. Alternativ können Sie IDs automatisch generieren, indem Sie ein benutzerdefiniertes Feld hinzufügen.
• feedback_provider: Identifiziert Daten, die von einem bestimmten Provider abgerufen wurden. Für Datei-Uploads ist der Wert dieses Attributs auf „Dateien“ gesetzt und kann nicht geändert werden.
• job_name: Identifiziert Daten basierend auf dem Namen des Jobs, der zum Hochladen verwendet wird. Sie können den Wert dieses Attributs während der Einrichtung über das Feld Jobname ändern, das oben auf jeder Seite während der Einrichtung angezeigt wird.
• loadDate: Gibt an, wann ein Dokument in XM Discover hochgeladen wurde. Dieses Feld wird automatisch gesetzt und kann nicht geändert werden.

Beispielkonfiguration aktualisieren

Eingangskonnektoren für Dateien benötigen eine Beispieldatei, um Datenzuordnungen zu generieren. Wenn Sie die Datenzuordnungen nach dem Anlegen eines Jobs ändern möchten, gehen Sie wie folgt vor:

1. Heben Sie die Zuordnung der Felder auf, die in der neuen Beispieldatei nicht vorhanden sind.
2. Aktualisieren Sie die Beispielkonfiguration, indem Sie eine neue Beispieldatei mit einem neuen Satz von Feldern hochladen. Im Folgenden finden Sie die Schritte zum Aktualisieren der Beispielkonfiguration.
3. Aktualisieren Sie die Datenzuordnungen gemäß der neuen Beispieldatei.

Aktualisieren der Beispielkonfiguration

1. Wählen Sie im Menü „Joboptionen“ die Option Beispielkonfiguration aktualisieren für einen vorhandenen Dateijob aus.
   
2. Wählen Sie Klicken, um eine Datei für den Upload auszuwählen, und wählen Sie die auf Ihrem Computer gespeicherte Beispieldatei aus.
   
   Tipp: Wenn Ihre Datei Felder enthält, die nicht in Ihrer Datenzuordnung enthalten sind, erhalten Sie einen Fehler. Um dieses Problem zu beheben, bearbeiten Sie Ihre Datenzuordnung so, dass sie dieselben Felder wie Ihre Beispieldatei enthält.
3. Überprüfen Sie Ihre Dateieinstellungen. Weitere Informationen zu Beispieldateieinstellungen finden Sie auf der Seite Connector für eingehende Dateien.
4. Wählen Sie OK.

Pfad- und Dateimaske aktualisieren

Eingangskonnektoren für Dateien benötigen eine Pfad- und Dateimaske (regulärer Dateiname), um die richtigen Dateien für den Import zu finden. Sie können den Pfad und die Dateimaske für alle vorhandenen Dateijobs aktualisieren.

1. Wählen Sie im Joboptionsmenü die Option Aktualisierungspfad und Dateimaske für einen vorhandenen Dateiauftrag aus.
   
2. Klicken Sie auf Durchsuchen.
   
3. Wählen Sie den Ordner aus, in dem die Dateien gespeichert sind.
   
   Achtung: Nur die Dateien im ausgewählten Ordner werden verarbeitet; Unterordner müssen separat verarbeitet werden.
4. Wählen Sie OK.
5. Geben Sie im Feld Dateiname regulärer Ausdruck die Dateimaske (Dateiname regulärer Ausdruck) ein, die mit den Dateien übereinstimmt, die Sie importieren möchten.
   
6. Klicken Sie auf Speichern.

XM Discover

Für die Verbindung mit einem SFTP-Server ist eine Reihe von SSH-Handshakes erforderlich, um die zwischen dem Server und der Automatisierung verwendete Verschlüsselung zu koordinieren. Um eine Verbindung herzustellen, benötigt der SFTP-Server mindestens eine Verschlüsselung für jeden Chiffriertyp, der einer von Automatisierungen unterstützten Verschlüsselung entspricht. Nachfolgend finden Sie eine Liste der Verschlüsselungen, die von Automatisierungen unterstützt werden, die nach Verschlüsselungstyp gruppiert sind.

Nachfolgend finden Sie eine Liste der Schlüsselaustauschverschlüsselungen, die von XM Discover SFTP unterstützt werden:

• diffie-hellman-group14-sha256
• diffie-hellman-group18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• curve25519-sha256
• curve25519-sha256@libssh.org
• diffie-hellman-group16-sha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com