Quando si importano record o attività in HubSpot, è possibile che si verifichino degli errori. Di seguito, vi spieghiamo come risolvere gli errori rilevati durante un'importazione, scaricare un file di errore, visualizzare i dettagli dell'errore e correggere i problemi nel file di importazione o in Salesforce.
Prima di avviare un'importazione o di correggere un file con errori, è necessario conoscere i termini e i requisiti rilevanti per l'importazione in HubSpot.
Prima di completare l'importazione, HubSpot verifica la presenza di alcuni errori nelle prime 1000 righe del file. Se viene rilevato uno dei seguenti errori, questi vengono segnalati all'utente durante la mappatura delle proprietà nel processo di importazione:
Per risolvere questi errori dalla schermata Mappa le colonne del file nelle proprietà di HubSpot:
Nota: se il file contiene più di 1000 righe, è possibile che vi siano altri errori non risolti.
Una volta completata l'importazione, viene automaticamente visualizzato un riepilogo dell'importazione, con una panoramica degli eventuali errori. È anche possibile rivedere il riepilogo di un'importazione precedentemente completata.
Nota bene: i dati sensibili negli errori di importazione saranno sostituiti con la parola REDACTED nella schermata successiva all'importazione e nel file di errore scaricato. Per visualizzare il valore, consultare il file di importazione originale.
Una volta identificati gli errori di importazione, imparate a risolvere gli errori specifici.
Di seguito è riportato un elenco in ordine alfabetico di codici di errore con i dettagli dell'errore e i possibili passaggi per la risoluzione. In alcuni casi, i record o le attività con errori vengono importati e possono essere corretti in HubSpot o correggendo il file di importazione e reimportandolo. In altri casi, i record o le attività non verranno importati e il file di importazione dovrà essere corretto prima di essere reimportato.
Nota bene: i codici di errore in un file scaricato contengono lettere maiuscole e caratteri di sottolineatura, ma sono elencati in testo normale in questo articolo. Ad esempio, l'errore apparirà come AMBIGUOUS_ENUMERATION_OPTION nel file, ma sarà riportato come Ambiguous enumeration option nell'elenco seguente.
Lo stesso record corrisponde a più di una delle opzioni esistenti definite per una proprietà di enumerazione. Questo vale per le proprietà di tipo multi-selezione, selezione a discesa, selezione via radio e casella di controllo.
Questo errore può essere visualizzato anche se il valore nel file è l'etichetta dell'opzione della proprietà anziché il suo valore interno. Questo si applica alle opzioni di proprietà enumerative in cui l'etichetta è diversa dal valore interno.
I record interessati sono stati importati, ma la proprietà enumerativa non contiene un valore.
Identificare il valore errato confrontando il file di importazione con la proprietà in HubSpot. Aggiornare il valore nel file di importazione in modo che corrisponda a una sola opzione esistente o al valore interno dell'opzione se l'etichetta è diversa dal suo valore interno. Una volta aggiornato il valore, reimportare il file.
È anche possibile aggiornare manualmente il valore della proprietà nei record interessati. Se i record devono corrispondere a più opzioni, imparare a formattare il file per importare correttamente i dati nelle proprietà di più caselle di controllo.
Durante l'importazione, una colonna includeva etichette di associazione, ma l'etichetta non esiste in HubSpot. I dati sono stati importati, ma l'associazione risultante è priva di etichetta.
Identificare il valore errato confrontando il file di importazione con le etichette di associazione in HubSpot. Assicurarsi che il valore corrisponda a un'etichetta esistente o creare una nuova etichetta. Se si importano etichette abbinate, assicurarsi che sia stata utilizzata l'etichetta corretta per l'oggetto corrispondente (ad esempio, Datore di lavoro applicato all'azienda, Dipendente applicato al contatto). Al termine, reimportare il file o aggiornare manualmente l'etichetta nei record interessati.
Sono stati precedentemente impostati dei limiti di associazione per il numero di associazioni totali o etichettate consentite tra i record, ma l'importazione ha incluso un'associazione che ha superato un limite. I dati sono stati importati, ma i record risultanti non sono associati in HubSpot.
Se i record devono essere associati o hanno un'etichetta specifica per definire l'associazione, aggiornare i limiti di associazione, quindi importare nuovamente il file o aggiornare manualmente l'associazione in HubSpot.
Durante l'importazione, una colonna è stata mappata su una proprietà dell'identificatore univoco per associare i record (ad esempio, ID record, e-mail, nome del dominio aziendale o una proprietà di valore univoco personalizzata). Tuttavia, i valori univoci richiesti non sono stati inclusi nei file. Questo può accadere anche se si utilizza un identificatore univoco con valori contenenti interruzioni di riga o più di 100 caratteri. I dati sono stati importati, ma i record risultanti non sono associati in HubSpot.
Aggiornare il file di importazione per includere i valori corretti, quindi reimportare il file. Potrebbe essere necessario esportare i record esistenti per ottenere gli ID record corretti o utilizzare un identificatore univoco diverso per i record esistenti. Imparare a configurare correttamente i file per importare e associare più oggetti.
Il file di importazione contiene un proprietario di record che non corrisponde a un utente di HubSpot. I record interessati sono stati importati, ma il campo Proprietario non contiene un valore.
Verificate che la persona a cui volete assegnare il record sia un utente attivo nell'account, quindi aggiornate i dati nella colonna Proprietario del file di importazione per includere il nome e il cognome o l'e-mail dell'utente.
Il file di importazione contiene un valore di data che non corrisponde al formato selezionato durante il processo di importazione. I record interessati sono stati importati, ma la proprietà della data non contiene un valore.
Aggiornare il file di importazione con il valore corretto e reimportare, oppure aggiornare manualmente il valore della proprietà nei record interessati.
Il file di importazione contiene un valore per una proprietà number con caratteri non numerici. I record interessati sono stati importati, ma la proprietà number non contiene un valore.
Aggiornare il file di importazione con il valore numerico corretto e reimportare, oppure aggiornare manualmente il valore della proprietà nei record interessati.
Il file di importazione contiene una riga con dati che non possono essere elaborati. Se si tratta di una proprietà obbligatoria, i record non sono stati importati. Se non è una proprietà obbligatoria, i record sono stati importati, ma la proprietà non contiene un valore.
Verificare che il valore dei dati corrisponda al formato corretto della proprietà che si sta importando, correggere eventuali errori e reimportare il file. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
Il file di importazione contiene un valore per un periodo di tempo che non corrisponde a un formato di termine accettato. I record interessati sono stati comunque importati, ma la proprietà term non contiene un valore.
Aggiornare i valori dei termini nel file in modo che siano un numero intero di mesi o nel formato ISO8601 Duration (ad esempio, un periodo di tempo di tre anni, sei mesi e quattro giorni sarebbe P3Y6M4D), quindi importare nuovamente il file. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
È stato selezionato che l'importazione debba creare solo nuovi record, ma il file di importazione contiene valori di identificazione univoci che corrispondono a record esistenti in HubSpot. Ad esempio, è stato importato un valore Email che corrisponde già all'email di un contatto esistente (comprese le email aggiuntive), oppure è stato importato un valore Nome dominio azienda che corrisponde già al dominio di un'azienda esistente (compresi i domini aggiuntivi). Le righe interessate non sono state importate, quindi i record esistenti non sono stati aggiornati, ma le righe con le nuove informazioni hanno creato nuovi record.
Se l'obiettivo era quello di creare solo nuovi record ed evitare di aggiornare quelli esistenti, non è necessario intervenire. Se invece si desidera aggiornare i record esistenti, è necessario importare nuovamente il file e selezionare la creazione di nuovi record e l'aggiornamento di quelli esistenti durante il processo di importazione.
Lo stesso ID alternativo è stato utilizzato più volte nei file. I dati sono stati importati, ma potrebbero esserci dei duplicati dello stesso record in HubSpot. Se si sta cercando di associare i dati, i record non sono stati associati.
L'ID associazione scelto per associare i record non è univoco.
Scegliere un'intestazione di colonna diversa che funga da colonna comune tra i due file. Per ottenere risultati migliori, scegliere una proprietà da uno a molti, in cui un valore è unico per i molti record ad esso associati (ad esempio, il nome dell'azienda, che sarà associato a molti contatti che lavorano nella stessa azienda). Per ulteriori informazioni, consultare i file di importazione di esempio . Una volta selezionato un nuovo ID associazione, reimportare i file.
Lo stesso ID di record è stato utilizzato più volte nei vostri file. I record interessati non sono stati aggiornati o associati in HubSpot.
Aggiornare il file di importazione in modo che vi sia una sola riga con l' ID del record. Mantenere la riga con le informazioni più aggiornate che si desidera includere in HubSpot. Una volta eliminati i duplicati, reimportare i file.
HubSpot ha rilevato che il file di importazione contiene record duplicati. L'importazione non ha creato un nuovo record.
Eliminare i duplicati nel file di importazione e reimportare.
Una proprietà di identificazione univoca in HubSpot impone l'unicità del valore della proprietà in tutti i record. Alcuni dei valori di una colonna mappata su una proprietà di identificazione univoca non erano univoci rispetto ad altre righe del file o ad altri record del CRM. Se questa proprietà non è unica nel file, è stata importata solo una riga a cui fa riferimento questa proprietà. Se il valore di questa proprietà è in conflitto con un altro record del CRM, il record non è stato importato.
Scegliere un'intestazione di colonna diversa come valore univoco o rimuovere i valori duplicati, quindi importare nuovamente i file.
Se il file contiene più proprietà di identificazione univoca:
Nota: se si utilizza l'ID record come identificatore univoco, questo sostituirà qualsiasi altro identificatore univoco incluso nell'importazione. Anche la proprietà Email del contatto richiederà sempre valori univoci.
HubSpot non è in grado di associare i record nel loro formato attuale. I record sono stati importati ma non sono stati associati.
Verificare che siano stati rispettati i requisiti del file per l'associazione dei record. Se si importa in un unico file, potrebbe essere necessario aggiungere un identificatore unico per ogni oggetto. Se si importa in due file, potrebbe essere necessario selezionare una colonna comune diversa per effettuare l'associazione. Apportare le modifiche ai file e reimportare o associare manualmente i record.
Il file contiene valori vuoti per più colonne e HubSpot non è stato in grado di elaborare il record. I dati in quella riga non sono stati importati.
Compilare i valori delle proprietà mancanti nel file di importazione, quindi reimportare il file.
Il file selezionato non è stato trovato. I dati non sono stati importati.
Verificare che il file sia stato salvato sul computer e che sia del tipo corretto. Una volta fatto ciò, caricare nuovamente il file.
Il file di importazione contiene una o più e-mail che sono state bloccate dalla comunicazione a causa della privacy dei dati. Questi contatti non sono stati importati.
Il file di importazione importerà comunque gli altri contatti, ma non è possibile aggiungere i contatti bloccati tramite l'importazione. L'unico modo per aggiungere nuovamente al CRM i contatti eliminati in modo permanente è chiedere loro di inviare un modulo. Quando un contatto invia un modulo, viene creato come nuovo contatto nel CRM.
Il file di importazione contiene almeno una colonna senza intestazione. I dati delle colonne senza intestazione non sono stati importati.
Confermare se i dati nelle colonne devono essere importati o meno, aggiungere intestazioni appropriate o rimuovere le colonne, quindi importare nuovamente il file.
Quando si importano contatti con e-mail aggiuntive, il file contiene un indirizzo e-mail in un formato non valido o già utilizzato come e-mail in un altro contatto. I record interessati sono stati comunque importati, ma le e-mail aggiuntive non sono state aggiunte.
Se l'e-mail è stata formattata in modo errato, aggiornate il file con il formato e-mail corretto, quindi reimportate. Se l'e-mail è già utilizzata in un altro contatto, ma dovrebbe essere invece presente nel nuovo contatto, rimuovete l'e-mail dal record del contatto esistente, quindi reimportate il file. Se l'e-mail è già utilizzata in un altro contatto e questo contatto esistente dovrebbe mantenere l'e-mail, non è necessario alcun intervento.
Il file di importazione contiene un valore non valido importato come indirizzo e-mail, nome di dominio o ID record. L'importazione non ha creato o aggiornato il record.
Aggiornare il file di importazione con il valore corretto dell'e-mail, del nome di dominio o dell'ID record, quindi reimportare il file.
Il file di importazione non contiene un valore univoco corretto per associare i record. Questo può accadere se si è utilizzata una proprietà non univoca o se l'identificatore univoco ha valori contenenti interruzioni di riga o più di 100 caratteri. I dati sono stati importati, ma i record risultanti non sono stati associati in HubSpot.
Aggiornare il file di importazione per includere un identificatore di associazione valido (ad es. e-mail per i contatti, nome di dominio dell'azienda per le aziende o ID record), quindi importare nuovamente il file. Scoprite come impostare correttamente i file per importare e associare più oggetti.
Il file di importazione contiene un valore che non corrisponde a un'opzione esistente in una proprietà enumerativa. Questo vale per le proprietà di tipo multi-selezione, selezione a discesa, selezione radio e casella di controllo. I record interessati sono stati comunque importati, ma la proprietà enumerativa non contiene un valore.
Identificare il valore errato confrontando il file di importazione con la proprietà in HubSpot. Per le proprietà di enumerazione predefinite di HubSpot (ad esempio, Fase del ciclo di vita, Settore), assicurarsi che il valore corrisponda all'etichetta dell'opzione in inglese o al suo valore interno. Si può scegliere di aggiornare il valore nel file di importazione per farlo corrispondere a un'opzione esistente o di aggiungere il valore come opzione personalizzata alla proprietà. Al termine, reimportare il file o aggiornare manualmente il valore della proprietà nei record interessati.
Per le importazioni di eventi personalizzati o di eventi di marketing, il file di importazione contiene un evento non valido (ad esempio, un evento con un'ora di inizio successiva all'ora di fine). Le righe interessate non sono state importate.
Aggiornare il file per includere i valori validi delle proprietà dell'evento, quindi reimportare.
Per le importazioni di eventi personalizzati, il file di importazione contiene un timestamp vuoto o non valido per la proprietà Occurred at. Le righe interessate sono state importate, ma la proprietà non contiene un valore.
Aggiungere o aggiornare un valore all'interno dell'intervallo di timestamp accettato (tra 2000-01-01 e 3000-01-01), quindi reimportare.
Il file di importazione non è di tipo corretto per l'importazione in HubSpot. I dati non sono stati importati.
Convertire il file in un file .csv, .xls o .xlsx, quindi reimportare. Esaminare i requisiti dei file aggiuntivi per l'importazione in HubSpot.
Il file di importazione contiene un valore numerico troppo piccolo o troppo grande. Le righe interessate sono state importate, ma la proprietà number non contiene un valore.
Confermare i requisiti di formato della proprietà specifica o del tipo di proprietà, aggiornare il file in modo che corrisponda al formato corretto, quindi reimportare. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
Durante l'importazione, una delle colonne del file è stata mappata su ID record. Tuttavia, l'ID recordelencato nel file non corrispondeva agli ID esistenti in HubSpot. I record non sono stati importati.
Assicurarsi che gli ID dei record siano corretti. Potrebbe essere necessario esportare i record esistenti per ottenere gli ID dei record corretti, oppure utilizzare un identificatore univoco diverso per i record esistenti. Se non si aggiornano o associano oggetti esistenti in HubSpot, non selezionare la casella di controllo durante il processo di importazione.
Una proprietà obbligatoria nel file di importazione contiene un valore non valido. I dati di quella riga non sono stati importati.
Confermare i requisiti di formato della proprietà specifica o del tipo di proprietà, aggiornare il file in modo che corrisponda al formato corretto, quindi reimportare.
Il file di importazione contiene più di un foglio. I dati non sono stati importati.
Rimuovere tutti i fogli aggiuntivi dal file di importazione, quindi reimportare. Rivedere i requisiti dei file aggiuntivi per l'importazione in HubSpot.
Il file di importazione non è un foglio di calcolo valido. I dati non sono stati importati.
Convertire il file in un file .csv, .xls o .xlsx, quindi reimportare. Esaminare i requisiti dei file aggiuntivi per l'importazione in HubSpot.
HubSpot non è in grado di creare il record perché è stato raggiunto il limite del numero di record memorizzabili per quell'oggetto. Questo errore si applica agli oggetti CRM standard: contatti, aziende, offerte e biglietti. I dati non sono stati importati.
Eliminate i record che non vi servono più per quell'oggetto, quindi reimportate il file per creare i nuovi record. Per saperne di più sull'abbonamento a HubSpot e sulle sue limitazioni.
Il file di importazione contiene una riga con più di 10 errori. La descrizione dell'errore elenca tutti gli errori della riga e le colonne interessate. A seconda degli errori, è possibile che la riga non sia stata importata o che sia stata importata senza i valori delle colonne interessate.
Esaminare ogni errore, quindi aggiornare e reimportare il file o aggiornare manualmente il record/attività interessato in HubSpot.
Il file di importazione contiene un valore di nome di dominio Azienda che corrisponde a più aziende nell'account HubSpot. L'importazione non ha aggiornato il record dell'azienda.
Cercare il valore specifico del nome di dominio Company nella home delle aziende per trovare i domini duplicati. Unire i record aziendali o eliminare uno di essi, quindi importare nuovamente il file.
Il file di importazione contiene un valore di Proprietario che corrisponde a più di un utente dell'account. Questo accade solitamente per i nomi (ad esempio, ci sono due utenti John Doe nell'account HubSpot e il file di importazione contiene il nome "John Doe"). I record interessati sono stati importati, ma la proprietà Proprietario non contiene un valore.
Sostituire il nome del proprietario con il suo indirizzo e-mail nel file di importazione, quindi reimportare il file. È anche possibile aggiornare manualmente il valore della proprietàProprietario nei record interessati.
Il file di importazione contiene un valore per un periodo di tempo che non rientra nell'intervallo di termini accettato. I record interessati sono stati importati, ma la proprietà del termine non contiene un valore.
Aggiornare i valori dei termini nel file in modo che rientrino nell'intervallo di tempo accettato (un numero intero maggiore o uguale a 1 mese), quindi importare nuovamente il file. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
Il file di importazione contiene un valore per un periodo di tempo che non rientra nell'intervallo di tempo accettato. I record interessati sono stati importati, ma la proprietà dell'intervallo di tempo non contiene un valore.
Aggiornare i valori dell'intervallo di tempo nel file in modo che rientrino nell'intervallo di tempo accettato (meno di 1000 anni), quindi importare nuovamente il file. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
HubSpot non è in grado di creare il record perché è stato raggiunto il limite del numero di record memorizzabili per quell'oggetto personalizzato. I dati non sono stati importati.
Se ci sono record non più necessari, eliminare i record dell'oggetto personalizzato e reimportare il file. Se avete bisogno di ulteriore spazio di archiviazione per i record, potete acquistare un aumento del limite di record dell'oggetto personalizzato. Per saperne di più sull'abbonamento a HubSpot e sulle sue limitazioni.
Il file di importazione contiene un'intestazione di colonna che non corrisponde a una proprietà di HubSpot. I dati della colonna non sono stati importati.
Durante l'importazione, è necessario abbinare correttamente le colonne selezionando una proprietà esistente o creando una nuova proprietà nella pagina Mappa le colonne del file con le proprietà [dell'oggetto]. Si può anche scegliere di non importare le colonne non abbinate.
Il file di importazione contiene un valore che non soddisfa i requisiti delle regole di convalida di una proprietà (ad esempio, il valore contiene caratteri speciali, è troppo lungo, troppo corto, ecc.) I record interessati sono stati importati, ma la proprietà non contiene un valore.
Visualizzare o modificare le regole di convalida della proprietà nelle impostazioni. Aggiornare il file di importazione per includere un valore che segua le regole della proprietà, quindi reimportare il file. È anche possibile aggiornare manualmente il valore della proprietà nei record interessati.
Nel file di importazione manca un valore per una proprietà richiesta. I dati di quella riga non sono stati importati.
Aggiornare il file di importazione per includere il valore della proprietà richiesta, quindi importare nuovamente il file.
Il file include una cella o una riga che contiene più di 1 MB di dati, troppo grandi per essere elaborati dallo strumento di importazione. I dati di quella riga non sono stati importati.
Ridurre le dimensioni della cella o della riga interessata nel file, quindi importare nuovamente il file.
Il file di importazione contiene un ID record non valido che non corrisponde a nessun record esistente nell'account HubSpot. L'importazione non ha aggiornato il record, poiché i dati non corrispondono a nessun record esistente.
Verificare che l' ID del record sia corretto. Se si trova un ID errato, aggiornare il file di importazione con l'ID record corretto, quindi reimportare il file.
HubSpot non è in grado di elaborare il file a causa di un errore sconosciuto. I dati non sonostati importati.
Verificare che il file soddisfi tutti i requisiti. Provare a reimportare i dati dopo aver cancellato la cache del browser o aver utilizzato un altro browser. Se l'errore persiste, scrivete nella Community (tutti gli utenti) o contattate il team di supporto(solo pergli accountStarter, Professional ed Enterprise ).
È stato selezionato che l'importazione deve aggiornare solo i record esistenti, ma il file di importazione contiene valori di identificazione univoci che non corrispondono a record esistenti in HubSpot. Ad esempio, è stato importato un valore Email che non corrisponde all'email di un contatto esistente o un valore ID record che non corrisponde a un record esistente. Le righe interessate non sono state importate, quindi non sono stati creati nuovi record, ma sono stati aggiornati quelli esistenti.
Se i valori interessati avrebbero dovuto corrispondere a record esistenti, verificare che i valori siano scritti correttamente o che contengano i numeri ID record corretti. Correggere eventuali errori nel file e reimportare.
Se l'obiettivo era solo quello di aggiornare i record esistenti e non di crearne di nuovi, non è necessario intervenire. Se invece si desidera che le righe interessate creino nuovi record, reimportare il file e selezionare la creazione di nuovi record e l'aggiornamento di quelli esistenti nel processo di importazione.