Importare dati dell'organizzazione usando l'importazione basata su API (importazione successiva) (anteprima)

Importante

Questa funzionalità è destinata solo ai clienti di anteprima pubblica. Le funzionalità in anteprima potrebbero non essere complete e subire modifiche prima di diventare disponibili nella versione più ampia.

In questo articolo vengono illustrati due tipi di importazioni: completa e incrementale. Queste importazioni aggiornano i dati forniti quando si configura la connessione a Viva Insights.

Importante

Seguire questa procedura solo se questa non è la prima volta che si importano i dati dell'organizzazione. Se si tratta della prima importazione, fare riferimento a Importa dati dell'organizzazione (prima importazione) per configurare una connessione, compilare un'app di esportazione e importare dati in Viva Insights.

Informazioni sulle importazioni successive

Quando si importano dati in Viva Insights, si eseguirà un aggiornamento completo o incrementale. Per eliminare i campi, è possibile usare un aggiornamento completo.

L'app di esportazione personalizzata creata in Importa dati dell'organizzazione (prima importazione), insieme a DescriptiveDataUploadApp creata in GitHub, facilita gli aggiornamenti di cui si parla di seguito. Come riepilogo rapido, quando viene eseguito DescriptiveDataUploadApp, esegue il pull dei dati dalla cartella compressa scaricata da GitHub. Questa cartella compressa contiene i file seguenti:

• data.csv, che contiene i campi da importare.
• metadata.json, che esegue il mapping dei campi di origine ai campi Viva Insights. Si userà anche metadata.json per indicare Viva Insights se l'aggiornamento è completo o incrementale, come illustrato nella sezione successiva.

Come indicare un aggiornamento completo o incrementale

1. In metadata.json passare alla riga 3.
2. Aggiornare la “IsBootstrap”: proprietà a una delle operazioni seguenti:
   • Per un aggiornamento completo, usare “IsBootstrap” : “true”.
   • Per un aggiornamento incrementale, usare “IsBootstrap” : “false”.

Quando viene eseguito DescriptiveDataUploadApp, Viva Insights inizierà a elaborare i dati come aggiornamento completo o incrementale, a seconda di quanto specificato qui in metadata.json.

Importante

Assicurarsi di eliminare tutti i campi da metadata.json che non vengono inclusi nel file data.csv. Se nel file metadata.json sono presenti più campi che nel file data.csv o viceversa, l'elaborazione per l'importazione avrà esito negativo.

Per altre informazioni su metadata.json e su come usarli per eseguire il mapping dei campi, vedere Importare i dati dell'organizzazione (prima importazione ).

Tipi di aggiornamento

Full

Quando si esegue un aggiornamento completo, si sostituiscono tutti i dati dell'organizzazione in Viva Insights, ovvero si sovrascrive ciò che è già stato importato. Quando si esegue un aggiornamento completo, assicurarsi di fornire dati per tutti i dipendenti con licenza e senza licenza (ovvero quelli che hanno una sottoscrizione Viva Insights e quelli che non lo fanno). Vengono descritti i campi da fornire più avanti in questo articolo.

È possibile usare un aggiornamento completo per eliminare i campi, perché i campi che si escono non verranno visualizzati nei dati. Si parla di eliminazione dei dati nella sezione successiva.

Eliminazione di campi con aggiornamenti completi

Per eliminare i campi con un aggiornamento completo, esportare i dati come .csv che contiene tutti i campi tranne i campi che si desidera eliminare. Poiché un aggiornamento completo sostituisce i dati esistenti, si finirà con ogni campo tranne quelli lasciati durante l'importazione.

Incrementale

Eseguire un aggiornamento incrementale solo quando si vogliono aggiungere nuove informazioni ai dati dell'organizzazione già caricati in Viva Insights. Ecco cosa è possibile fare con un aggiornamento incrementale:

• Aggiungere nuovi dipendenti
• Aggiungere nuovi attributi per i dipendenti esistenti
• Aggiungere nuovi attributi per i nuovi dipendenti
• Modificare gli attributi dei dipendenti esistenti

Di seguito sono riportati alcuni esempi di quando è possibile eseguire un aggiornamento incrementale:

Aggiunta di nuovi assunti

Si supponga di voler aggiungere cinque nuovi assunti ai dati dell'organizzazione. Durante l'importazione, è possibile includere:

• Cinque righe che contengono i dati dei nuovi dipendenti.
• Attributi obbligatori: PersonId, ManagerId, Organization ed EffectiveDate.
• Tutti i campi facoltativi riservati(ad esempio HireDate) già importati in Viva Insights.

Al termine dell'importazione, l'unica modifica nota è costituita da cinque nuove righe e dai relativi valori.

Aggiunta di un nuovo attributo

È possibile aggiungere un attributo riservato facoltativo che non era già presente nei dati, ad esempio Location, per tutti i dipendenti esistenti. Quando si importano i dati, nel file di .csv verranno inclusi solo i valori Location, PersonId ed EffectiveDate, con valori correnti e cronologici per ogni dipendente. Al termine dell'importazione, verranno trovati gli stessi dati presenti in precedenza, ad eccezione di una nuova colonna per ogni dipendente, Location.

Campi da includere in data.csv per gli aggiornamenti completi e incrementali

Per i tipi di aggiornamento elencati di seguito, includere i campi seguenti nel file di data.csv. Assicurarsi di:

• Formattare questi campi in base alle linee guida in Preparare i dati dell'organizzazione.
• Rimuovere tutti i campi non inclusi dal file metadata.json.
• Mantenere i file data.csv e metadata.json nella cartella compressa scaricata da GitHub. Quando si esegue DescriptiveDataUploadApp, si fornirà il percorso della cartella compressa. Viva Insights estrarranno quindi i dati da questa posizione.

Per questo tipo di aggiornamento	Includere questi campi in data.csv	Con questi valori	Per questi dipendenti
Full	PersonId	Corrente Tutto cronologico (fare riferimento alla nota seguente)	Tutti
	ManagerId	Corrente Tutti i dati storici	Tutti
	Organizzazione	Corrente Tutti i dati storici	Tutti
	EffectiveDate	Corrente Tutti i dati storici	Tutti
	Tutti i campi facoltativi riservati (ad esempio HireDate) già importati in Viva Insights	Corrente Tutti i dati storici	Tutti
Completo (per l'eliminazione di campi facoltativi riservati)	PersonId	Corrente Tutti i dati storici	Tutti
	ManagerId	Corrente Tutti i dati storici	Tutti
	Organizzazione	Corrente Tutti i dati storici	Tutti
	EffectiveDate	Corrente Tutti i dati storici	Tutti
	Tutti i campi facoltativi riservati (ad esempio HireDate) già importati in Viva Insights, ad eccezione dei campi facoltativi riservati che si desidera eliminare	Corrente (ad eccezione dei campi da eliminare) Tutti i campi cronologici (ad eccezione dei campi da eliminare)	Tutti
Incrementale (per l'aggiunta di nuovi campi o la modifica di campi esistenti, ma non l'aggiunta di nuovi dipendenti)	PersonId	Corrente Tutto dopo l'ultimo caricamento (vedere la nota seguente)	Tutti
	EffectiveDate	Corrente Tutto dopo l'ultimo caricamento	Tutti
	Tutti i campi facoltativi riservati (ad esempio HireDate) che si desidera aggiungere	Corrente Tutto dopo l'ultimo caricamento	Tutti
Incrementale (per l'aggiunta di nuovi dipendenti)	PersonId	Corrente Tutto dopo l'ultimo caricamento (vedere la nota seguente)	Solo nuovi dipendenti
	ManagerId	Corrente Tutto dopo l'ultimo caricamento	Solo nuovi dipendenti
	Organizzazione	Corrente Tutto dopo l'ultimo caricamento	Solo nuovi dipendenti
	EffectiveDate	Corrente Tutto dopo l'ultimo caricamento	Solo nuovi dipendenti
	Tutti i campi facoltativi riservati (ad esempio HireDate) già importati in Viva Insights	Corrente Tutto dopo l'ultimo caricamento	Solo nuovi dipendenti

Nota

• "Tutti cronologici": valori per i periodi di tempo precedenti. Ad esempio, se si includono dati mensili, verranno inclusi i valori per ogni mese che precedono questo. Quando si inizia a usare per la prima volta Viva Insights, è consigliabile usare dati di 13 mesi. Successivamente, è consigliabile aggiornare regolarmente i dati in modo che si trasformi in dati di 27 mesi.
• "Tutti i valori dall'ultimo caricamento": valori per il periodo tra i caricamenti. Ad esempio, se l'ultimo caricamento è stato eseguito a marzo e ora è luglio, includere i valori per aprile, maggio e giugno.