Caricare i dati dell'organizzazione (primo caricamento)

I dati dell'organizzazione possono essere visualizzati nell'app Advanced Insights del Microsoft Viva Insights in uno dei due modi seguenti: tramite Microsoft Entra ID, ovvero l'origine predefinita, o tramite un file di .csv caricato dall'amministratore.

Questo articolo illustra la seconda opzione: caricare un file .csv.

Importante

Usare i passaggi seguenti solo se questa è la prima volta che si caricano i dati dell'organizzazione. Se non si tratta del primo caricamento, vedere Caricare i dati dell'organizzazione (caricamenti successivi) per aggiornare i dati caricati in precedenza.

Per i clienti che provengono dall'app legacy:

Se si esegue la migrazione dall'app advanced insights legacy e si caricano i dati dell'organizzazione in Viva Insights per la prima volta in assoluto, è consigliabile usare solo la nuova app per il caricamento dei dati. L'uso della nuova app impedisce l'incoerenza dei dati.

Flusso di lavoro

Dopo aver preparato i dati di origine, seguire questa procedura:

1. Caricare il file .csv.
2. È possibile eseguire il mapping dei campi.
3. L'app convalida i dati. Se la convalida non riesce, è possibile scegliere tra alcune opzioni descritte in Convalida non riuscita.
4. L'app elabora i dati. Se l'elaborazione non riesce, è possibile scegliere tra alcune opzioni descritte in Elaborazione non riuscita.

Dopo che i dati vengono convalidati e elaborati correttamente, l'attività di caricamento dei dati complessiva viene completata.

File upload

Per caricare il file .csv, seguire questa procedura:

1. Aprire l'esperienza di amministratore dell'app Advanced Insights .

2. Nella pagina Hub dati passare alla scheda di caricamento.csv sul lato destro della schermata, sotto Origine dati.

3. Selezionare Start.

4. In Passaggio 1 di 2: Preparare e caricare:

   1. Immettere un nome di caricamento.
   2. In Carica file selezionare il file .csv da caricare.

   Assicurarsi che il file .csv sia:

   • Codifica UTF-8.

   • Non aprire in un programma diverso quando si inizia il processo di caricamento.

   • Non più grande di 1 GB.

     

Nota

Per visualizzare la struttura e le linee guida per i file .csv ed evitare problemi comuni durante il caricamento, è possibile scaricare un modello tramite il collegamento Scarica .csv modello .

4. Per caricare, selezionare Avanti. Per annullare il caricamento, selezionare Annulla.

Mapping dei campi

Dopo aver caricato il file, verrà visualizzata la pagina Passaggio 2 di 2: Mapping . Per visualizzare informazioni dettagliate dai dati, è necessario eseguire il mapping dei campi (colonne) dal file .csv ai nomi dei campi riconosciuti dall'app.

Esistono due tipi di campi: Impostazione predefinita del sistema e Personalizzato.

Impostazione predefinita del sistema (obbligatoria o facoltativa)

I campi predefiniti del sistema possono essere obbligatori, ovvero PersonId, ManagerId e Organization, oppure Riservati facoltativi. Questi campi rappresentano attributi che Viva Insights conoscono e usano in calcoli specifici oltre al raggruppamento e al filtro.

Importante

Ogni campo obbligatorio deve avere un valore valido non Null in ogni riga. È necessario eseguire il mapping di tutti i valori Viva Insights necessari, anche se le intestazioni di colonna nei file .csv non corrispondono esattamente al nome del valore Viva Insights.

I campi facoltativi vengono comunemente rilevati nei campi di sistema che l'app suggerisce di usare. Non è necessario eseguire il mapping dei campi facoltativi se l'organizzazione non dispone di dati.

Per scoprire se un campo è obbligatorio o facoltativo, fare riferimento alla sezione Attributi viva a destra dell'elenco di mapping. Gli attributi obbligatori hanno un'etichetta "Required" sotto il nome del campo, mentre gli attributi facoltativi hanno un'etichetta "Riservato facoltativo".

Se è necessaria la definizione di un campo, passare il puntatore del mouse sull'icona delle informazioni (i).

Personalizzato

I campi personalizzati sono attributi facoltativi che è possibile creare. Nella sezione seguente viene illustrato il mapping e la denominazione di un attributo personalizzato.

Per eseguire il mapping dei campi

Seguire la procedura seguente per eseguire il mapping dei dati .csv agli attributi Viva Insights.

Importante

Per poter passare alla parte successiva del processo di caricamento, è necessario eseguire il mapping di tutti i campi di intestazione .csv, visualizzati in Nome colonna di origine.

1. Per ogni campo Viva Insights obbligatorio:

   1. Trovare l'intestazione di colonna corrispondente in Nome colonna di origine. Per evitare un errore di convalida in un secondo momento, verificare che questa colonna sia il tipo di dati corretto.
   2. Nella colonna Mappa a Viva Insights campo aprire l'elenco a discesa e selezionare l'attributo Viva Insights corrispondente all'intestazione di colonna identificata nel passaggio 1a.

2. Ripetere i passaggi 1a e 1b per i campi personalizzati e facoltativi.

   Per aggiungere un campo personalizzato, è sufficiente includerlo come colonna nel file di dati. L'app assegnerà automaticamente un nome e lo eseguirà il mapping. Per questa versione di Viva Insights, a tutti gli attributi personalizzati viene assegnato un nome predefinito e possono essere classificati solo come tipi di dati String.

   Importante

   Non caricare TimeZone come colonna. Verrà visualizzato un errore.

3. Dopo aver completato il mapping degli attributi, selezionare il pulsante Avanti nella parte inferiore sinistra della schermata.

Dopo aver eseguito il mapping dei campi, l'app convalida ed elabora i dati come descritto nelle sezioni seguenti. Se la convalida e l'elaborazione hanno esito positivo, la parte del processo di caricamento è completata.

Convalida

Dopo aver eseguito il mapping degli attributi, l'app inizia a convalidare i dati.

Nella maggior parte dei casi, la convalida dei file deve essere completata rapidamente. Se il file di dati dell'organizzazione è di grandi dimensioni, la convalida potrebbe richiedere fino a uno o due minuti.

Al termine di questa fase, la convalida ha avuto esito positivo o negativo. A seconda del risultato, si riceverà una notifica di esito positivo o una notifica di errore nell'angolo in alto a destra della schermata Connessioni dati .

Per informazioni su ciò che accade dopo, passare alla sezione appropriata:

La convalida ha esito positivo

La convalida non riesce

La convalida ha esito positivo

Dopo aver completato la convalida, Viva Insights avvia l'elaborazione dei nuovi dati. L'elaborazione può richiedere tra alcune ore e un giorno o così via. Durante l'elaborazione, verrà visualizzato lo stato "Elaborazione" nella tabella Caricamento o eliminazione delle connessioni > dati in corso .

Al termine dell'elaborazione, l'operazione ha avuto esito positivo o negativo. A seconda del risultato, si riceverà una notifica di esito positivo o una notifica di errore nell'angolo in alto a destra della schermata Connessioni dati .

L'elaborazione ha esito positivo

Quando l'elaborazione ha esito positivo, nella tabella Cronologia caricamento o eliminazione verrà visualizzato lo stato "Operazione riuscita". A questo punto, il processo di caricamento è completato.

Dopo aver ricevuto lo stato "Operazione riuscita", è possibile:

• Selezionare l'icona di visualizzazione (occhio) per visualizzare un riepilogo dei risultati della convalida.
• Selezionare l'icona di mapping per visualizzare le impostazioni di mapping per il flusso di lavoro.

Nota

Ogni tenant può avere un solo caricamento in corso alla volta. È necessario completare il flusso di lavoro di un file di dati, ovvero guidarlo a una convalida ed elaborazione corretta o abbandonarlo, prima di iniziare il flusso di lavoro del file di dati successivo. Lo stato o la fase del flusso di lavoro di caricamento viene visualizzato nella scheda Connessioni dati .

L'elaborazione non riesce

Se l'elaborazione non riesce, verrà visualizzato uno stato non riuscito nella tabella Caricamento o eliminazione in corso . Se si seleziona il collegamento nello stato, viene visualizzata una spiegazione dell'errore.

Selezionare Modifica o avvia nuovo caricamento. Questo pulsante consente di avviare di nuovo il processo di caricamento.

Nota

Gli errori di elaborazione sono in genere dovuti a errori back-end. Se vengono visualizzati errori di elaborazione persistenti e i dati sono stati corretti nel file caricato, registrare un ticket di supporto con Microsoft.

La convalida non riesce

Se la convalida dei dati non riesce, verrà visualizzata una nuova schermata con un errore "Convalida non riuscita" e alcune informazioni sull'errore. È possibile selezionare il pulsante Annulla caricamento se non si vuole procedere con il processo di caricamento.

Prima di apportare modifiche al file di origine e riprovare, è possibile selezionare Scarica problemi. Questo file di log descrive i problemi nei dati che potrebbero aver causato gli errori di convalida. Usare queste informazioni per decidere cosa fare successivamente, correggere i dati di origine o modificare le impostazioni di mapping.

Linee guida per la correzione degli errori nei dati

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 non si correggerà il file di origine (o si correggerà il mapping degli attributi).

Per informazioni sulla formattazione del file per evitare errori, vedere Regole file ed errori di convalida.

Argomento correlato

Preparare i dati organizzativi