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 potrebbe non riuscire o generare avvisi a seconda che l'opzione Carica righe valide ed escludi righe con dati non validi in Configurazione avanzata sia attivata o disattivata.
Se Carica righe valide ed escludi righe con dati non validi in Configurazione avanzata è disattivato, l'intero caricamento ha esito negativo a causa di errori di convalida 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).
Se l'opzione Carica righe valide ed escludi righe con dati non validi in Configurazione avanzata è attivata, verranno caricate solo le righe che includono valori validi e verranno visualizzati avvisi per le righe che non sono state ingerite a causa di errori. Questa opzione è disattivata per impostazione predefinita.
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 di origine e di destinazione
Tutti i nomi di intestazione o colonna del campo di origine e di destinazione devono:
- Contengono solo caratteri alfanumerici ASCII (lettere e numeri, ad esempio Date1) o caratteri di sottolineatura (_). I caratteri speciali non alfanumerici, ad esempio @, #, %, & o altri caratteri, non sono supportati.
- Contiene un valore.
- Sii univoco.
Regole per le intestazioni di campo di destinazione personalizzate
Tutte le intestazioni o i nomi di colonna dei campi di destinazione personalizzati devono:
- Non hanno spazi vuoti iniziali, intermedi o finali.
- Non contengono campi di sistema, ovvero:
- PeopleHistoricalId
- StartDate
- EndDate
- Dominio
- PopulationType
- Fuso orario
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- WeekendDays
- InferredTeamSize
- ObjectId
- IsActive
- A partire da "Microsoft_"
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId
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
Scaricare il log per i dipendenti con dati mancanti
La pagina Data quality (Qualità dei dati ) consente di sapere se sono presenti utenti misurati mancanti nel file di dati dell'organizzazione. In tal caso, verrà visualizzato il messaggio "{number} measured users have missing organizational data({numero} utenti misurati con dati aziendali mancanti). Scaricare quali utenti hanno dati aziendali mancanti e caricare i dati per ottenere informazioni di qualità superiore."
Il log di download mostra gli utenti misurati a cui manca un campo dati , ad eccezione dei campi di sistema Domain e TimeZone.
Errori e avvisi 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 | ||
| Il file di dati per l'importazione basata su API e l'importazione BLOB di Azure deve essere in .zip formato di file e includere un file .csv in formato UTF-8 e un file di mapping .json. I file non possono essere vuoti. | Si è verificato un problema con i file nel file .zip. Assicurarsi che il file .zip contenga solo un file .json e un file .csv e caricarlo di nuovo. | Importazione basata su API e importazione BLOB di Azure | |
| Il file .csv nel file .zip è vuoto. Aggiungere un file di .csv non vuoto e caricare di nuovo il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| Il file .json nel file .zip è vuoto. Aggiungere un file di .json non vuoto e caricare di nuovo il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| Il file .json non è valido. Usare un file di .json valido e caricare di nuovo il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| 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 | |
| Il file .csv viene mappato a un campo null o vuoto nel file .json. Eseguire il mapping a un campo non vuoto e caricare di nuovo il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| 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 | |
| I nomi di intestazione nel file .csv non corrispondono ai campi mappati nel file .json. Assicurarsi che il file .json contenga gli stessi campi del file .csv e caricare nuovamente il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| Il numero di intestazioni nel file .csv non corrisponde ai campi mappati nel file .json. Assicurarsi che il file .json contenga gli stessi campi del file .csv e caricare nuovamente il file .zip. | Importazione basata su API e importazione BLOB di Azure | ||
| È necessario eseguire il mapping di tutte le colonne di origine a un tipo di dati supportato | La colonna di origine non è mappata a un tipo di dati supportato. Eseguire il mapping a un tipo di dati supportato e caricare di nuovo il file. | Importazione basata su API e importazione BLOB di Azure | |
| Il file .json specifica un "DatasetType" non previsto. Specificare il valore corretto e caricare di nuovo il file .zip. | Importazione basata su API e importazione BLOB di Azure |
Di seguito sono riportati gli errori di convalida e gli avvisi correlati ai valori dei campi. Se Carica righe valide ed escludi righe con dati non validi in Configurazione avanzata è disattivato, vengono generati errori e la convalida non riesce. Se è attivata, caricherà solo le righe che includono valori validi e mostrerà avvisi per le righe che non sono state ingerite a causa di errori. Questa opzione è disattivata per impostazione predefinita.
| Categoria | Regola correlata | Messaggio | Errore o avviso | Si applica a |
|---|---|---|---|---|
| Valori dei campi | Il file di dati deve essere nel formato .csv UTF-8. | 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. | Error | Tutti |
| Formato .csv non valido. Il numero di colonne nella riga non corrisponde al numero di colonne nell'intestazione. Le righe con valori non validi non vengono caricate. Verificare la presenza di virgole mancanti o smarrite e caricare di nuovo. | Avviso | Tutti | ||
| Trovato carattere non UTF-8. Assicurarsi che il file .csv usi la codifica UTF-8 e caricarlo di nuovo. | Error | Tutti | ||
| Trovato carattere non UTF-8. Le righe con valori non validi non vengono caricate. Assicurarsi che il file .csv usi la codifica UTF-8 e caricarlo di nuovo. | Avviso | Tutti | ||
| 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. |
Avviso | Tutti | |
{Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere un indirizzo di posta elettronica nel formato employee@contoso.com. |
Avviso | Tutti | ||
| Valore {header name} non valido. {Nome intestazione} deve essere una stringa. | Error | Tutti | ||
| {Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere una stringa. | Avviso | Tutti | ||
| Avviso | Tutti | |||
| Valore {header name} non valido. {Nome intestazione} deve essere un doppio dopo il formato 23.75. | Error | Tutti | ||
| {Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere un doppio dopo il formato 23.75. | Avviso | Tutti | ||
| Valore {header name} non valido. {Nome intestazione} deve essere un numero intero. | Error | Tutti | ||
| {Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere un numero intero. | Avviso | 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. | Error | Tutti | |
| Valore ManagerId mancante per il nuovo campo PersonId. ManagerId è un campo obbligatorio. Aggiungere il campo ManagerId corrispondente e caricarlo di nuovo. | Error | Tutti | ||
| Ogni PersonId deve avere un ManagerId univoco. | Tutti | |||
Non possono essere presenti cicli in cui:
|
Error | Tutti |