Entitäten in großen Mengen über den Entity-Upload hochladen
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.
Hinweis: Der Entity-Upload ist eine Möglichkeit, Tabellen mit Entitätsdaten in den Knowledge Graph hochzuladen. Sie können Entitätsdaten auch im CSV-, XLSX- oder JSON-Format mithilfe des Connectors-Frameworks hochladen, was ein vom Entity-Upload getrennter Prozess ist. Wie Sie einen Datei-Upload-Connector zum Hochladen von Daten erstellen, erfahren Sie im Hilfeartikel Field Upload Source.
Bevor Sie beginnen
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, siehe Erforderliche Felder und Vorlagen unten.
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 Entity-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.
Fehler beim Hochladen beheben
Falls das System Fehler in Ihren Daten erkennt, können Sie diese beheben, bevor Sie die Änderungen anwenden:
- Ü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.
Änderungen prüfen und übernehmen
- 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 die einzelnen Hero-Zahlen, um weitere Details zu den einzelnen Entitäten in jeder Kategorie zu erfahren.
- 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.
- 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.
Gespeicherte Upload-Konfigurationen
Gespeicherte Upload-Konfigurationen sind wie Vorlagen für Entity-Uploads, die Sie regelmäßig verwenden möchten. Sie können eine Upload-Konfiguration verwenden, um Ihre Einstellungen für einen bestimmten Datei-Upload-Prozess zu speichern (einschließlich Ihrer Feldzuordnungen, Datenbereinigungsregeln, zusätzlicher Felder/Aktionen usw.) und diese Einstellungen auf zukünftige Uploads ähnlicher Daten anzuwenden.
Sie können eine Upload-Konfiguration während der Zusammenfassung des Entity-Uploads speichern. Geben Sie einen Namen für Ihre Konfiguration ein und klicken Sie auf Speichern.
Anwendung einer gespeicherten Upload-Konfiguration
Um eine gespeicherte Upload-Konfiguration bei einem zukünftigen Upload zu verwenden, wählen Sie diese im Schritt Datei hochladen des Entity-Uploads aus.
Bisherige Uploads anzeigen
Pflichtfelder
- Entitäts-ID und Land sind Pflichtfelder für alle Entitätstypen.
- Das Feld Land sollte im Format des zweistelligen ISO-Ländercodes (auch ISO-Alpha-2-Code genannt) angegeben werden, der als internationaler Referenzstandard gilt. Eine vollständige Liste der ISO-Ländercodes finden Sie in der ISO-Browsing-Ressource.
Hinweis: Alle URLs in Ihrem Upload-Formular müssen gültig sein (d. h., wenn Sie sie aus Ihrem Formular kopieren und in einen Webbrowser einfügen, würden sie funktionieren). Wenn Ihre URLs kodierte Sonderzeichen enthalten, die verhindern, dass die URL bei der Eingabe in einen Webbrowser korrekt aufgelöst wird, sollten sie vor dem Hochladen in den Knowledge Graph dekodiert werden (mit Ausnahme von Leerzeichen, die als %20 kodiert sind).
Erforderliche Felder nach Entitätstyp
| Entitätstyp | Pflichtfelder |
| Standort |
|
| Restaurant |
|
| Bankomat |
|
| Finanzberater |
|
|
Heilberufler Für Gesundheitseinrichtungen und medizinische Fachkräfte gibt es ein spezielles Upload-Format. Unter Erste Schritte: Yext for Healthcare erfahren Sie mehr über Best Practices für Einrichtungen des Gesundheitswesens. |
Hinweis: Sie können das NEPPES NPI-Register verwenden, um die NPI-Nummer eines Anbieters zu finden. |
|
Gesundheitseinrichtung Für Gesundheitseinrichtungen und medizinische Fachkräfte gibt es ein spezielles Upload-Format. Unter Erste Schritte: Yext for Healthcare erfahren Sie mehr über Best Practices für Einrichtungen des Gesundheitswesens. |
|
| Veranstaltung |
|
| Hotel |
|
| Häufig gestellte Fragen |
|
| Job |
|
Regeln zur Datenbereinigung beim Hochladen von Entitäten
| Regel | Beschreibung | Anwendbare Feldtypen |
|---|---|---|
| Leerzeichen kürzen | Entfernt überflüssige Leerzeichen am Anfang oder Ende einer Zeichenkette, ähnlich der TRIM() Funktion in Excel. |
Zeichenfolgen |
| Leere Werte ignorieren oder löschen | Leere Werte ignorieren: Wenn keine Daten bereitgestellt werden, nimmt das System keine Änderung vor. Dies ist die Standardeinstellung. Leere Werte löschen: Wenn ein Feldwert leer gelassen wird, löscht das System die Feldwerte. | Alle |
| Großschreibung | Großschreiben: Schreibt den ersten Buchstaben jedes Worts groß, das durch ein Leerzeichen getrennt ist. Vollständig Großschreiben: Schreibt den ersten Buchstaben jedes Wortes groß (getrennt durch ein Leerzeichen). Die verbleibenden Buchstaben in einem Wort werden in Kleinbuchstaben formatiert. | Zeichenfolgen |
| Trennzeichen | Ermöglicht es Nutzer*innen, das Trennzeichen für listenartige Felder anzugeben. Optionen: Komma, Tabulator. Standardmäßig wird ein Komma verwendet. | Listenfelder |
| Zu Vorhandenem hinzufügen | Fügt ein Listenelement zu vorhandenen Elementen im Feld hinzu. Wenn die Option „Vorhandene ersetzen“ nicht ausgewählt ist, werden beim Hochladen alle vorhandenen Listeneinträge mit dem Wert aus der Tabelle überschrieben. Standardmäßig werden vorhandene Einträge ersetzt. | Listenfelder |
| Buchstaben in Zahlen umwandeln | Konvertiert Buchstaben in markenspezifischen Telefonnummern (z. B. 1-800-555-YEXT) in die entsprechenden Zahlen. Standardmäßig aktiviert. |
Telefonnummernfelder |
| Ländercode automatisch erkennen | Das System ermittelt die Ländervorwahl für eine Telefonnummer (basierend auf dem vorhandenen Feld „Land“ der Entität), falls keine Ländervorwahl angegeben ist. Standardmäßig aktiviert. | Telefonnummernfelder |
| Rich-Text-Erkennung | Ermöglicht Nutzer*innen die Auswahl, wie das System Rich Text verarbeiten soll. Wählen Sie zwischen Interpret as Markdown oder Interpret as HTML. | Rich-Text-Felder |
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.