Regole di file ed errori di convalida

  • Articolo

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 di origine e di destinazione

Tutti i nomi di intestazione o colonna del campo di origine e di destinazione devono:

  1. Contengono solo caratteri alfanumerici ASCII (lettere e numeri, ad esempio Date1) o caratteri di sottolineatura (_). Non sono supportati caratteri speciali non alfanumerici, ad esempio @, #, %, & o altri caratteri.
  2. Contiene un valore.
  3. 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:

  1. Non hanno spazi vuoti iniziali, intermedi o finali.
  2. 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 di 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:

Screenshot che mostra un ciclo della gerarchia di gestione tra tre persone.

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 di 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
  • {Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere una data successiva al formato MM/GG/AAAAA, MM/DD/AAAA, MM/GG/AAAA seguito da più testo (ad esempio ora), MM-DD-AAAA, MM-GG-AAA, AAAA-MM-GG, Mercoledì, 14 marzo 2012, 14 marzo 2012, 14-Mar-2012 o 14-Mar-12.
  • OPPURE
  • {Header name} contiene un valore non valido. Le righe con valori non validi non vengono caricate. {Nome intestazione} deve essere una data che segue il formato DD/MM/AAAA, DD/MM/AAAA seguita da più testo (ad esempio ora), D/MM/AAAAA, D/MM/AA, DD-MM-AAAAA, DD-MM-AA, AAAA-DD-MM, mercoledì 14 marzo 2012, 14 marzo 2012, 14 marzo 2012 o 14 marzo-12.
    		•  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