Regole di file ed errori di convalida

In questo articolo viene descritto il modo in cui deve essere formattato il file di caricamento e vengono forniti gli errori che potrebbero verificarsi durante l'inserimento dei dati nell'app Advanced Insights.

Regole di file e campi

Quando una riga o una colonna di dati ha un valore non valido per qualsiasi attributo, l'intero caricamento avrà esito negativo fino a quando il file di origine non viene corretto o il mapping modifica il tipo di convalida dell'attributo in modo da rendere valido il valore.

Regole per il file

Il file di dati deve essere nel formato .csv UTF-8 e non può essere vuoto.

Regole per le intestazioni di campo

Tutti i nomi di intestazione di campo o colonna devono:

• Contengono solo caratteri alfanumerici ASCII (lettere e numeri, ad esempio Date1) o caratteri di sottolineatura (_). Gli altri caratteri non sono supportati.
• Contiene un valore.
• Non sono presenti spazi vuoti iniziali, intermedi o finali o caratteri speciali non alfanumerici, ad esempio @, #, %o &.
• Sii univoco.
• Non contengono campi di sistema, ovvero:
  • PeopleHistoricalId
  • StartDate
  • EndDate
  • Dominio
  • PopulationType
  • Fuso orario
  • StandardTimeZone
  • WorkdayStart
  • WorkDayEnd
  • WeekendDays
  • InferredTeamSize
  • ObjectId
  • Microsoft_

I campi obbligatori devono avere un valore per ogni riga.

Dopo aver caricato il file, è possibile eseguire il mapping di una sola intestazione di colonna a ogni campo dati Viva Insights.

Regole per i valori dei campi

I valori dei campi devono essere specificati nel tipo di dati corretto. Fare riferimento a Riferimento all'attributo.

Regole per i caratteri nei valori dei campi

• La lunghezza dei caratteri dei campi nelle righe non può superare i 128 KB, ovvero circa 1024 x 128 caratteri.
• I caratteri "Nuova riga" (\n) non sono consentiti nei valori dei campi.

Nota

È possibile usare caratteri a byte doppio, ad esempio caratteri giapponesi, nei valori dei campi.

Regole per i valori nel campo ManagerId

Ogni PersonId deve avere un ManagerId univoco. In altre parole, non possono esserci più manager per una persona.

Non possono essere presenti cicli in cui:

• Manager e dipendenti si riferiscono l'uno all'altro.
• I manager segnalano ai dipendenti.

Diciamo che Dylan è il manager di Kris. I dati dell'organizzazione non possono essere visualizzati:

• Kris ha fatto rapporto a Dylan e anche a Dylan riportando a Kris.
• Dylan ha fatto rapporto a Kris.

Entrambe le gerarchie seguenti generano errori nelle esperienze degli utenti finali:

Esempio .csv file di esportazione

Ecco un frammento di codice di esempio di un file di esportazione .csv valido:

PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest

Errori di convalida

Di seguito sono riportati gli errori di convalida che potrebbero verificarsi durante il caricamento dei dati nell'app Advanced Insights. Nella maggior parte dei casi, è necessario correggere gli errori e caricare di nuovo il file. Vedere l'articolo Preparare i dati dell'organizzazione per informazioni su come formattare e preparare i dati per il caricamento.

Categoria	Regola correlata	Messaggio	Si applica a
Estensioni di file e file	Il file di dati deve essere nel formato .csv UTF-8 e non può essere vuoto.	Il file è vuoto. Selezionare un altro file e caricarlo di nuovo.	.csv solo caricamento
		Questo file ha un'estensione non valida di '{0}'. Selezionare un file .csv e caricarlo di nuovo.	.csv solo caricamento
		Formato .csv non valido. Il numero di colonne nella riga non corrisponde al numero di colonne nell'intestazione. Verificare la presenza di virgole mancanti o smarrite e caricare di nuovo.	Tutti
		Trovato carattere non UTF-8. Assicurarsi che il file .csv usi la codifica UTF-8 e caricarlo di nuovo.	Tutti
Intestazioni di colonna	Tutti i nomi di intestazione di campo o colonna devono essere univoci.	Due o più intestazioni di colonna nel file sono uguali. Includere intestazioni univoche per ogni colonna.	Tutti
	Tutti i nomi di intestazione di campo o colonna devono contenere un valore.	Intestazione mancante nelle colonne {J}. Includere il nome dell'intestazione nel file selezionato e caricarlo di nuovo.	Tutti
	Tutti i nomi di intestazione di campo o colonna devono contenere solo caratteri alfanumerici (lettere e numeri, ad esempio Date1) o i simboli seguenti: ~ ! @ # $ % ^ & * + > : <> [] ?. Altri caratteri non sono supportati	{Nome intestazione} contiene caratteri speciali non supportati. Rimuovere i caratteri speciali e caricarli di nuovo.
	Tutti i nomi di intestazione di campo o colonna non devono contenere campi di sistema.	{header name} è un campo di sistema. Rinominare {header name} in modo che non usi un campo di sistema e carichi nuovamente il file.	Tutti
	Dopo aver caricato il file, è possibile eseguire il mapping di una sola intestazione di colonna a ogni campo dati Viva Insights.	Nel file è stato eseguito il mapping di più colonne di origine a un campo dati. Assicurarsi che ogni colonna di origine sia mappata a un campo univoco.	Tutti
Valori dei campi	I valori dei campi devono essere specificati nel tipo di dati corretto. Fare riferimento a Riferimento all'attributo.	Valore {header name} non valido. {Nome intestazione} deve essere un indirizzo di posta elettronica nel formato employee@contoso.com.	Tutti
		Valore {header name} non valido. {Nome intestazione} deve essere una stringa.	Tutti
		Valore {header name} non valido. {Nome intestazione} deve essere una data successiva al formato MM/GG/AAAA.	Tutti
		Valore {header name} non valido. {Nome intestazione} deve essere un doppio dopo il formato 23.75.	Tutti
		Valore {header name} non valido. {Nome intestazione} deve essere un numero intero.	Tutti
	I campi obbligatori devono avere un valore per ogni riga.	Valore {header name} o {header name} mancante. {Header name} è un campo obbligatorio e richiede un valore per ogni riga. Aggiungere il valore {header name} e caricare di nuovo il file.	Tutti
		Valore ManagerId mancante per il nuovo campo PersonId. ManagerId è un campo obbligatorio. Aggiungere il campo ManagerId corrispondente e caricarlo di nuovo.	Tutti
	Ogni PersonId deve avere un ManagerId univoco.		Tutti
	Non possono essere presenti cicli in cui: Manager e dipendenti si riferiscono l'uno all'altro. I manager segnalano ai dipendenti.		Tutti