Entitäten zu Yext hochladen – Yext Help

Dieser Artikel beschreibt, wie Sie Entitäten in Ihrem Konto in großen Mengen hinzufügen und bearbeiten können, indem Sie eine Tabelle mit dem Entitäten-Upload-Flow hochladen.

Wie man Entitäten einzeln hinzufügt erfahren Sie unter „Einzelne Entität hinzufügen“.

Hinweis: Der Entity Upload ist eine Möglichkeit, Tabellenkalkulationen mit Entitätsdaten in den Knowledge Graph hochzuladen. Sie können Entitätsdaten auch im CSV-, XLSX- oder JSON-Format hochladen, indem Sie das Connectors-Framework verwenden, was ein vom Entitäten-Upload getrennter Prozess ist. Wie Sie einen Datei-Upload-Konnektor zum Hochladen von Daten erstellen, erfahren Sie in der Anleitung Erstellen eines Datei-Upload-Konnektors auf Hitchhikers.

Vorbereitung …

Stellen Sie sicher, dass Ihre Tabelle korrekt formatiert ist, bevor Sie mit dem Hochladen beginnen:

Stellen Sie sicher, dass Ihre Datei im Format .XLS, .XLSX oder .CSV vorliegt.
Fügen Sie Spalten für Entitäts-ID und Land/Region sowie alle anderen erforderlichen Felder für den Entitätstyp hinzu, den Sie hochladen.
Um alle erforderlichen Felder nach Entitätstyp anzuzeigen und Beispielvorlagen für den Upload herunterzuladen, besuchen Sie den Abschnitt „Vorlagen für den Upload von Entitäten und erforderliche Felder“.

Entitäten hochladen

So können sie Entitäten durch Hochladen einer Tabelle hinzufügen bzw. bearbeiten:

Navigieren Sie zur Entitätssuche (Knowledge Graph > Entitäten) und klicken Sie auf Daten hinzufügen.
Wählen Sie im Fenster „Daten hinzufügen“ die Option „Entitäten-Upload“.
Dies öffnet den Schritt „Datei hochladen“ des Entitäten-Upload-Flows. Legen Sie die folgenden Optionen fest:
- Klicken Sie auf „Datei auswählen“, um Ihre Tabelle auszuwählen.
- Falls Sie eine gespeicherte Upload-Konfiguration verwenden, um Daten in einem bestimmten Format hochzuladen, wählen Sie Ihre gespeicherte Upload-Konfiguration aus dem Dropdown-Menü.
- Falls Sie keine Upload-Konfiguration verwenden, lassen Sie die Option „Nein, das ist eine neue Tabelle“ ausgewählt.
- Wenn Sie Daten in einer anderen Sprache als der Standardsprache Ihres Kontos hochladen, wählen Sie die Sprache im Dropdown-Menü aus.
- Klicken Sie auf „Weiter“.
Im Schritt Datei konfigurieren ordnen Sie die Spalten in Ihrer Kalkulationstabelle den Feldern in Yext zu. Das System ordnet die Spalten automatisch zu, wann immer dies möglich ist. Für einige Spalten müssen Sie jedoch möglicherweise die entsprechende Feldzuordnung auswählen.
- Um eine Spalte einem Feld zuzuordnen, klicken Sie auf das Dropdown-Menü „Diese Spalte zuordnen“, geben Sie den Namen des Feldes ein, für das die Zuordnung gelten soll, und wählen Sie es aus dem Menü aus.
- Wenn Sie für keine der nicht zugeordneten Spalten in Ihrer Kalkulationstabelle Feldwerte hochladen möchten, klicken Sie auf „Alle nicht zugeordneten Spalten ignorieren“, um das Zuordnen dieser Spalten zu Feldern zu überspringen.
- Um die Feldzuordnung für automatisch zugeordnete Spalten zu ändern, klicken Sie auf das Dropdown-Menü mit dem zugeordneten Feldnamen und wählen Sie ein anderes Feld aus.
Standardmäßig sind für jede zugeordnete Spalte die folgenden Datenbereinigungsregeln festgelegt:
- Leerzeichen kürzen: Entfernt nachstehende oder vorstehende Leerzeichen am Anfang oder Ende des Spaltenwerts
- Leere Werte ignorieren: Beim Hochladen von Entitäten werden leere Zellen übersprungen, damit vorhandene Feldwerte in Yext nicht entfernt werden.
Um eine der Datenbereinigungsregeln zu ändern, klicken Sie auf „Bearbeiten“ neben der Spalte, die Sie bearbeiten möchten.
- Je nach Art des bearbeiteten Feldes können unterschiedliche Datenbereinigungsregeln zur Auswahl stehen.
- Wenn Sie fertig sind, klicken Sie auf „Schließen“.
Verwenden Sie die Zusätzlichen Felder, um alle zusätzlichen Feldwerte festzulegen, die Sie nicht in Ihre Tabelle aufgenommen haben. Um einen zusätzlichen Feldwert festzulegen, klicken Sie auf „Feld hinzufügen“.
- Beachten Sie, dass diese Einstellung den gleichen Feldwert für alle Entitäten setzt (z. B. setzt die Einstellung eines zusätzlichen Feldwertes für das Feld „Akzeptiert Reservierungen“ alle Entitäten entweder auf „Ja“ oder „Nein“).
- Wenn Sie in Ihrem Upload unterschiedliche Feldwerte für verschiedene Entitäten festlegen möchten, sollten Sie eine neue Datei hochladen, die das jeweilige Feld enthält. Überarbeiten Sie dazu Ihre Kalkulationstabelle und klicken Sie dann oben rechts auf „Weitere Aktionen“. Wählen Sie „Überarbeitete Datei hochladen“.
Wenn Sie ein zusätzliches Feld hinzufügen, wählen Sie das gewünschte Feld aus dem Dropdown-Menü „Diese Spalte zuordnen“.
- Geben Sie den gewünschten Feldwert für alle Entitäten in das Textfeld Feldwert ein.
- Wenden Sie bei Bedarf beliebige Datenbereinigungsregeln an.
- Wählen Sie den Geltungsbereich der Entitäten, auf die das Feld angewendet werden soll: alle neuen Entitäten, alle Entitäten, die bereits im Knowledge Graph existieren, oder alle Entitäten in der Datei.
- Klicken Sie auf „Speichern“, wenn Sie fertig sind. Wiederholen Sie den Vorgang für alle weiteren Felder, die Sie hinzufügen möchten.
Verwenden Sie den Abschnitt „Weitere Aktionen“, um die Entitäten in Ihrem Upload einem Ordner hinzuzufügen, Labels anzuwenden oder eine Entitätsvorlage anzuwenden.
- Klicken Sie neben der Aktion, die Sie ausführen möchten, auf „Aktion hinzufügen”.
- Wählen Sie in der Dropdown-Liste „Entitätstyp auswählen“ den Umfang Ihrer Aktion aus: neue Entitäten, fehlende Entitäten (Entitäten, die bereits in Ihrem Knowledge Graph enthalten und nicht Teil dieses Uploads sind), alle Entitäten in Ihrer Datei oder alle Entitäten in Ihrem Konto (einschließlich dieses aktuellen Uploads).
- Wählen Sie je nach gewählter Aktion den Ordner, das Label oder die Vorlage aus, die Sie anwenden möchten.
- Weitere Informationen zu diesen Aktionen finden Sie unter Ordner erstellen, Entitätslabels verwalten und anwenden oder Entitätsvorlage erstellen.
Nachdem Sie alle Spalten zugeordnet und zusätzliche Felder oder Aktionen festgelegt haben, klicken Sie unten rechts auf Weiter.
Im Schritt Datei analysieren wird das System Ihren Upload verarbeiten.
- Falls es bei Ihrem Upload keine Probleme gab, werden Sie zum Schritt Änderungen prüfen weitergeleitet.
- Sollten Probleme bei Ihrem Upload aufgetreten sein, werden Sie zum Schritt Fehler beheben weitergeleitet.
Überprüfen Sie im Schritt Fehler beheben alle Probleme mit den Daten in Ihrer Tabelle und beheben Sie diese. Die Tabelle zeigt die Spalten mit Fehlern und die Anzahl der von jedem Fehler betroffenen Zeilen an.
Wählen Sie eine der folgenden Möglichkeiten, um Fehler zu beheben:
- Um eine Tabelle mit Fehlern herunterzuladen, diese in Ihrer Datei zu korrigieren und die Datei erneut hochzuladen: Klicken Sie auf Fehler herunterladen.
- Um alle Fehler direkt im Entitäten-Upload-Flow zu bearbeiten, klicken Sie auf Alle Fehler beheben.
- Um jeweils nur einen Fehlertyp im Entitäten-Upload-Flow zu beheben, klicken Sie neben dem ausgewählten Fehler auf Fehler in der Tabellenansicht beheben.
- Um das Hochladen von Feldwerten mit Fehlern zu überspringen, klicken Sie auf den Dropdown-Pfeil beim ausgewählten Fehler und wählen Sie Diese Werte ignorieren.
Wenn Sie in der Tabellenansicht die Option Alle Fehler beheben gewählt haben oder einen einzelnen Fehler beheben, sehen Sie die fehlerhaften Zeilen und eine Erklärung des Fehlers. Geben Sie den korrigierten Feldwert für jede Zeile in der Spalte Neuer Wert ein.
Im Schritt Änderungen prüfen sehen Sie eine Aufschlüsselung aller Entitäten in Ihrem Upload nach Kategorien: neue Entitäten, aktualisierte Entitäten, unveränderte Entitäten (in Ihrem Upload vorhanden, jedoch wurden keine Daten hinzugefügt oder geändert) und fehlende Entitäten (Entitäten in Ihrem Konto, die in Ihrem Upload nicht vorhanden waren).
- Klicken Sie auf jede Hero-Zahl, um weitere Details zu den einzelnen Entitäten in jeder Kategorie zu erhalten.
- Klicken Sie auf Gesamte Zusammenfassung herunterladen, um die Aufschlüsselung für alle Entitäts-Kategorien herunterzuladen.
- Klicken Sie auf die einzelnen Download-Schaltflächen in jeder Kategorie, um die Zusammenfassung für jede Kategorie herunterzuladen.
Klicken Sie im Schritt Überprüfen der Änderungen auf jede Kategorie. Wählen Sie das Kontrollkästchen unten aus, um die Änderung zu bestätigen (z. B. „Ich erkläre, dass ich [x] Entitäten hinzufüge“). Klicken Sie dann unten links auf Weiter, um zur nächsten Kategorie zu gelangen.
- Dies muss für jede Kategorie durchgeführt werden, selbst wenn es 0 Entitäten in der Kategorie gibt.
Nachdem Sie die letzte Kategorie bestätigt haben, klicken Sie auf Änderungen übermitteln, um alle Änderungen zu bestätigen.
Im Schritt Zusammenfassung wird das System die Änderungen in Ihrem Upload verarbeiten und anwenden. Sie können diese Änderungen in der Fortschrittsleiste am oberen Rand des Bildschirms überwachen.
- Wenn Sie diese Upload-Konfiguration speichern möchten, um in Zukunft weitere Daten mit denselben Formatierungsoptionen hochzuladen, geben Sie neben der Option Konfigurationsbezeichnung einen Namen für die Konfiguration ein und klicken Sie auf Speichern.
- Andernfalls klicken Sie auf Fertig oder Zurück zu Uploads, um den Entitäten-Upload-Flow zu beenden.

Hinweis: Wenn Sie eine Datei hochladen, die sich wesentlich von den in Ihrem Konto gespeicherten Inhalten unterscheidet, wird die Datei unter Umständen manuell von Yext geprüft und freigegeben. So wird sichergestellt, dass alle Aktualisierungen richtig sind und bewusst erfolgen.

Nach dem Hochladen

Um vergangene Entity-Uploads und Ihre gespeicherten Upload-Konfigurationen anzuzeigen, navigieren Sie zu Knowledge Graph > Konfiguration. Klicken Sie auf die Kachel Upload-Konfigurationen oder Daten-Datei-Uploads.