Carica entità in blocco tramite caricamento entità
Questo articolo spiega come aggiungere e modificare in blocco entità al tuo account caricando un foglio di calcolo con il flusso di lavoro Caricamento di entità.
Nota: Caricamento di entità è solo uno dei modi per caricare fogli di calcolo dei dati delle entità nel Knowledge Graph. Puoi anche caricare i dati delle entità in formato .CSV, .XLSX o JSON utilizzando il framework Connettori, che è un processo separato da Caricamento di entità. Per sapere come creare un connettore per il caricamento di file per caricare dati, consulta l'articolo di assistenza Fonte di caricamento dei campi.
Prima di iniziare
Assicurati che il tuo foglio di calcolo sia formattato correttamente prima di iniziare il caricamento:
- Assicurati che il tuo file sia in formato .XLS, .XLSX o .CSV.
- Includi le colonne per l'ID entità e il Paese/l'area geografica, nonché tutti gli altri campi obbligatori per il tipo di entità che stai caricando.
- Per visualizzare tutti i campi richiesti per tipo di entità e scaricare i modelli di caricamento di esempio, consulta Campi richiesti e Template di seguito.
Carica entità
Per aggiungere e modificare entità caricando un foglio di calcolo:
- Accedi a Ricerca delle entità (Knowledge Graph > Entità) e fai clic su Aggiungi dati.
- Scegli Caricamento di entità dalla finestra modale Aggiungi dati.
- Si aprirà il passaggio Carica file del flusso Caricamento di entità. Imposta le seguenti opzioni:
- Fai clic su Scegli file per selezionare il tuo foglio di calcolo.
- Se stai utilizzando una configurazione di caricamento salvata per caricare dati in un formato specificato, scegli la configurazione di caricamento salvata dal menu a discesa.
- Se non stai utilizzando una configurazione di caricamento, lascia selezionata l'opzione No, si tratta di un nuovo foglio di calcolo.
- Se stai caricando dati in una lingua diversa da quella predefinita per il tuo account, seleziona la lingua dal menu a discesa.
- Fai clic su Continua.
- Nel passaggio Configura File, mappa le colonne del foglio di calcolo ai campi in Yext. Il sistema mapperà automaticamente le colonne quando possibile, ma potrebbe essere necessario selezionare la mappatura appropriata dei campi per alcune colonne.
- Per mappare una colonna a un campo, fai clic sul menu a discesa Mappa questa colonna, digita il nome del campo da mappare e selezionalo dal menu.
- Se non desideri caricare i valori dei campi per nessuna delle colonne non mappate nel tuo foglio di calcolo, fai clic su Ignora tutte le colonne non mappate per saltare la mappatura di queste colonne ai campi.
- Per modificare la mappatura dei campi per qualsiasi colonna mappata automaticamente, fai clic sul menu a discesa contenente il nome del campo mappato e seleziona un campo diverso.
- Per impostazione predefinita, ogni colonna mappata avrà le seguenti Regole per la pulizia dei dati impostate:
- Escludi spazi vuoti: escludi gli spazi iniziali o finali dal valore della colonna
-
Ignora i valori vuoti: Caricamento di entità ignorerà il caricamento di qualsiasi cella vuota (in modo che i valori dei campi esistenti in Yext non vengano rimossi).
- Per modificare una delle regole per la pulizia dei dati, fai clic su Modifica accanto alla colonna che desideri modificare.
- A seconda del tipo di campo che stai modificando, potrebbero essere disponibili diverse regole per la pulizia dei dati tra cui scegliere.
-
Una volta finito, fai clic su chiudi.
- Utilizza i campi aggiuntivi per impostare eventuali valori di campo aggiuntivi che non hai incluso nel foglio di calcolo. Per impostare un valore di campo aggiuntivo, fai clic su Aggiungi campo.
- Tieni presente che questa impostazione assegnerà lo stesso valore di campo per tutte le entità (ad esempio, l'impostazione di un valore di campo aggiuntivo per il campo "Accetta prenotazioni" imposterà tutte le entità su "Sì" o "No").
- Se desideri impostare valori di campo diversi per entità diverse nel tuo caricamento, dovresti caricare un nuovo file che includa quel campo. Per farlo, rivedi il tuo foglio di calcolo, quindi fai clic su Altre azioni nell'angolo in alto a destra. Seleziona Carica file aggiornato.
- Se stai aggiungendo un campo aggiuntivo, scegli il campo che desideri impostare dal menu a discesa Mappa questa colonna .
- Inserisci il valore del campo desiderato per tutte le entità nella casella di testo Valore del campo.
- Se lo desideri, applica eventuali regole per la pulizia dei dati.
- Scegli l'ambito delle entità a cui applicare il campo: qualsiasi nuova entità, qualsiasi entità già esistente nel Knowledge Graph, o tutte le entità nel file.
-
Una volta terminato, fai clic su Salva. Ripeti la stessa operazione per tutti gli altri campi che desideri aggiungere.
- Utilizza la sezione Azioni aggiuntive per aggiungere le entità nel tuo caricamento a una cartella, applicare etichette o applicare un modello di entità.
- Fai clic su Aggiungi azione accanto all'azione che desideri eseguire.
- Nel menu a discesa Seleziona il tipo di entità , scegli l'ambito della tua azione: qualsiasi nuova entità, qualsiasi entità mancante (entità già presenti nel tuo Knowledge Graph che non fanno parte di questo caricamento), tutte le entità nel tuo file o tutte le entità nel tuo account (incluso il caricamento attuale).
- A seconda dell'azione scelta, seleziona la cartella, l'etichetta o il modello che desideri applicare.
-
Per ulteriori informazioni su queste azioni, consulta Creare una cartella, Gestisci e applica etichette di entità, o Creare un template per un'entità.
- Dopo aver mappato tutte le colonne e impostato eventuali campi o azioni aggiuntivi, fai clic su Continua in basso a destra.
- Nel passaggio Analizza File , il sistema elaborerà il tuo caricamento.
- Se non si verificano problemi con il tuo caricamento, verrai indirizzato al passaggio Controlla modifiche.
- Se invece si verificassero problemi, verrai indirizzato al passaggio Risolvi errori.
Risolvi gli errori di caricamento
Se il sistema rileva errori nei tuoi dati, puoi risolverli prima di applicare modifiche:
- Nel passaggio Risolvi errori , esamina e risolvi eventuali problemi relativi ai dati nel tuo foglio di calcolo. La tabella mostrerà le colonne con errori e il numero di righe interessate da ciascun errore.
- Scegli uno dei seguenti modi per risolvere gli errori:
- Per scaricare un foglio di calcolo degli errori, correggerli nel file e ricaricarlo: fai clic su Errori di download.
- Per correggere tutti gli errori direttamente nel flusso di Caricamento di entità, fai clic su Correggi tutti gli errori.
- Per correggere un solo tipo di errore alla volta nel flusso di Caricamento di entità, fai clic su Correggi errori nella visualizzazione del foglio di calcolo accanto all'errore scelto.
- Per saltare il caricamento dei valori dei campi con errori, fai clic sulla freccia del menu a discesa sull'errore selezionato e seleziona Ignora questi valori.
- Se hai selezionato Correggi tutti gli errori o hai scelto di correggere un singolo errore nella visualizzazione del foglio di calcolo, vedrai le righe con gli errori e una spiegazione dell'errore. Inserisci il valore corretto del campo per ogni riga nella colonna Nuovo valore.
Controllare e applicare modifiche
- Nel passaggio Controlla modifiche, vedrai una suddivisione di tutte le entità nel tuo caricamento per categoria: nuove entità, entità aggiornate, entità non modificate (presenti nel tuo caricamento, ma nessun dato è stato aggiunto o modificato) ed entità mancanti (entità nel tuo account che non erano presenti nel tuo caricamento).
- Fai clic su ciascun numero Hero per ulteriori dettagli sulle singole entità in ciascuna categoria.
- Fai clic su Scarica il riepilogo completo per scaricare la ripartizione per tutte le categorie di entità
- Fai clic sui singoli pulsanti Download di ogni categoria per scaricarne il riepilogo.
- Fai clic su ogni categoria nel passaggio Controlla modifiche. Seleziona la casella di controllo in basso per confermare la modifica (ad esempio, "Confermo che sto aggiungendo [x] entità"), e fai clic su Avanti in basso a sinistra per procedere alla categoria successiva.
- Questa operazione deve essere eseguita per ciascuna categoria, anche nel caso in cui non siano presenti entità.
- Questa operazione deve essere eseguita per ciascuna categoria, anche nel caso in cui non siano presenti entità.
- Dopo aver confermato l'ultima categoria, fai clic su Invia modifiche per confermare tutte le modifiche.
- Nel passaggio Riepilogo , il sistema elaborerà e applicherà le modifiche al tuo caricamento. Puoi monitorare queste modifiche nella barra di avanzamento nella parte superiore dello schermo.
- Se desideri salvare questa configurazione di caricamento per caricare più dati utilizzando le stesse opzioni di formattazione in futuro, inserisci un nome per la configurazione accanto all'opzione Nome di configurazione e fai clic su Salva.
-
Altrimenti, fai clic su Fatto o Torna ai caricamenti per uscire dal flusso Caricamento di entità.
Nota: se carichi un file radicalmente diverso dai contenuti archiviati all'interno del tuo account, Yext potrà controllarlo manualmente e approvarlo per garantire che tutti gli aggiornamenti siano corretti e voluti.
Configurazioni di caricamento salvate
Le configurazioni di caricamento salvate sono come modelli per i caricamenti delle entità che prevedi di ripetere nel tempo. Puoi usare una configurazione di caricamento per salvare le impostazioni di uno specifico processo di caricamento di file (incluse le mappature dei campi, le regole di pulizia dei dati, campi/azioni aggiuntivi/e, ecc.) e applicare le stesse impostazioni ai caricamenti futuri di dati simili.
Puoi salvare una configurazione di caricamento durante il passaggio Riepilogo del flusso Caricamento di entità. Inserisci un nome per la tua configurazione e fai clic su Salva.
Applicazione di una configurazione di caricamento salvata
Per utilizzare una configurazione di caricamento salvata in un caricamento futuro, selezionala nel passaggio Carica file del flusso Caricamento di entità.
Visualizza i caricamenti passati
Campi obbligatori
- ID entità e Paese sono campi obbligatori per tutti i tipi di entità.
- Il campo Paese deve essere formattato come codice ISO a due lettere (denominato anche codice ISO alpha-2), che è uno standard di riferimento internazionale. Per un elenco completo dei codici ISO dei paesi, consulta la risorsa di navigazione ISO.
Nota: tutti gli URL presenti nel foglio di caricamento devono essere validi (ad esempio, se li copi e incolli dal foglio in un browser web, funzioneranno). Se i tuoi URL contengono caratteri speciali codificati che impediscono la corretta risoluzione dell'URL quando vengono inseriti in un browser web, devono essere decodificati prima del caricamento nel Knowledge Graph (ad eccezione degli spazi codificati come %20).
Campi obbligatori per tipo di entità
| Tipo di entità | Campi obbligatori |
| Location |
|
| Ristorante |
|
| Bancomat |
|
| Professionista della finanza |
|
|
Operatore sanitario Esiste un formato specifico di caricamento per strutture e operatori sanitari. Consulta Per iniziare: Yext per l'assistenza sanitaria per maggiori informazioni sulle best practice per le entità del settore sanitario. |
Nota: è possibile utilizzare il registro NPI NEPPES per trovare il numero NPI di un fornitore. |
|
Struttura sanitaria Esiste un formato specifico di caricamento per strutture e operatori sanitari. Consulta Per iniziare: Yext per l'assistenza sanitaria per maggiori informazioni sulle best practice per le entità del settore sanitario. |
|
| Evento |
|
| Hotel |
|
| FAQ |
|
| Lavoro |
|
Regole di pulizia dei dati per il caricamento dell'entità
| Regola | Descrizione | Tipi di campo applicabili |
|---|---|---|
| Escludi spazi vuoti | Rimuove spazi superflui all'inizio o alla fine di una stringa, in modo analogo alla funzione TRIM() di Excel. |
Stringhe |
| Ignora o cancella valori vuoti | Ignora i valori vuoti: se non vengono forniti dei dati, il sistema non apporterà alcuna modifica. Questa è l'impostazione predefinita. Cancella valori vuoti: se il valore di un campo viene lasciato vuoto, il sistema cancellerà i valori del campo. | Tutto |
| Maiuscole | Maiuscole: trasforma in maiuscolo la prima lettera di ogni parola separata da uno spazio. Maiuscole a ogni parola: la prima lettera di ogni parola (separata da uno spazio) viene scritta in maiuscolo. Le lettere rimanenti in una parola saranno formattate in minuscolo. | Stringhe |
| Delimitatore | Consente all'utente di specificare il delimitatore per i campi di tipo elenco. Opzioni: virgola, tabulazione. Il valore predefinito è la virgola. | Campi di tipo Lista |
| Aggiungi a esistenti | Aggiunge un elemento dell'elenco a qualsiasi elemento esistente nel campo. Se non viene selezionato ("Sostituisci esistente"), il caricamento sovrascriverà qualsiasi elemento esistente nell'elenco con il valore nel foglio di calcolo. Predefinito su Sostituisci esistente. | Campi di tipo Lista |
| Converti le lettere in numeri | Converte le lettere nei numeri di telefono con brand (ad esempio, 1-800-555-YEXT) nel numero appropriato. Attivato per impostazione predefinita. |
Campi del numero di telefono |
| Deduci codice paese | Il sistema dedurrà il codice Paese per un numero di telefono (basandosi sul campo Paese esistente dell'entità) se non viene fornito un codice Paese. Attivato per impostazione predefinita. | Campi del numero di telefono |
| Rilevamento del testo formattato | Permette all'utente di scegliere come il sistema deve interpretare il Rich Text. Scegli tra Interpreta come markdown o Interpreta come HTML. | Campi Rich Text |
Commenti
0 commenti
Questo articolo è chiuso ai commenti.