Importar dados organizacionais com a importação baseada em API (importação subsequente) (pré-visualização)

Neste artigo, vamos abordar dois tipos de importações: completas e incrementais. Estas importações atualizam os dados que forneceu quando configurou a ligação ao Viva Insights.

Acerca das importações subsequentes

Ao importar dados para Viva Insights, irá efetuar uma atualização completa ou incremental. Se quiser eliminar campos, pode utilizar uma atualização completa para o fazer.

A aplicação de exportação personalizada que criou em Importar dados organizacionais (primeira importação), juntamente com a DescriptiveDataUploadApp que criámos no GitHub, facilita as atualizações de que falamos abaixo. Como recapitulação rápida, quando DescriptiveDataUploadApp é executado, obtém dados da pasta zipada que transferiu do GitHub. Esta pasta zipada contém os seguintes ficheiros:

• data.csv, que contém os campos que pretende importar.
• metadata.json, que mapeia os campos de origem para Viva Insights campos. Também irá utilizar metadata.json para informar Viva Insights se a atualização está completa ou incremental, como explicamos na secção seguinte.

Como indicar uma atualização completa ou incremental

1. Em metadata.json, vá para a linha 3.
2. Atualize a “IsBootstrap”: propriedade para uma das seguintes opções:
   • Para uma atualização completa, utilize “IsBootstrap” : “true”.
   • Para uma atualização incremental, utilize “IsBootstrap” : “false”.

Quando DescriptiveDataUploadApp é executado, Viva Insights começará a processar os seus dados como uma atualização completa ou incremental, dependendo do que especificou aqui no metadata.json.

Tipos de atualização

Inteiro

Quando efetua uma atualização completa, está a substituir todos os dados da sua organização no Viva Insights, ou seja, substitui o que já importou. Quando efetuar uma atualização completa, certifique-se de que fornece dados para todos os funcionários licenciados e não licenciados (ou seja, para aqueles que têm uma subscrição Viva Insights e para aqueles que não têm). Descrevemos os campos a fornecer mais adiante neste artigo.

Pode utilizar uma atualização completa para eliminar campos, uma vez que os campos que deixar de fora não serão apresentados nos seus dados. Falamos sobre a eliminação de dados na próxima secção.

Eliminar campos com atualizações completas

Para eliminar campos com uma atualização completa, exporte os dados como uma .csv que contém todos os campos , exceto os campos que pretende eliminar. Uma vez que uma atualização completa substitui os dados existentes, acabará por todos os campos, exceto os que deixou de fora durante a importação.

Incremental

Efetue uma atualização incremental quando quiser apenas adicionar algumas informações novas aos dados organizacionais que já carregou para Viva Insights. Eis o que pode fazer com uma atualização incremental:

• Adicionar novos funcionários
• Adicionar novos atributos para funcionários existentes
• Adicionar novos atributos para novos funcionários
• Editar os atributos dos colaboradores existentes

Eis alguns exemplos de quando poderá efetuar uma atualização incremental:

Adicionar novas contratações

Digamos que pretende adicionar cinco novas contratações aos dados organizacionais. Durante a importação, incluiria:

• Cinco linhas que contêm novos dados de funcionários.
• Atributos necessários: PersonId, ManagerId, Organização e EffectiveDate.
• Todos os campos opcionais reservados (por exemplo, HireDate) que já importou para Viva Insights.

Após a conclusão da importação, a única alteração que notaria são cinco novas linhas e os respetivos valores.

Adicionar um novo atributo

Talvez queira adicionar um atributo reservado opcional que não estava nos seus dados antes( digamos , Localização) para todos os funcionários existentes. Quando vai importar os seus dados, só incluiria a Localização, PersonId e EffectiveDate, com valores atuais e históricos para cada funcionário, no seu ficheiro de .csv. Após a conclusão da importação, encontrará os mesmos dados que existiam anteriormente, à exceção de uma nova coluna para cada funcionário, Localização.

Campos a incluir no data.csv para atualizações completas e incrementais

Para os tipos de atualização listados abaixo, inclua os seguintes campos no ficheiro data.csv. Certifique-se de que:

• Formate estes campos de acordo com as nossas diretrizes em Preparar dados organizacionais.
• Remova quaisquer campos que não esteja a incluir do seu ficheiro de metadata.json.
• Mantenha os ficheiros data.csv e metadata.json na pasta zipada que transferiu do GitHub. Quando executar o DescriptiveDataUploadApp, irá fornecer o caminho da pasta zipada. Viva Insights, em seguida, irá solicitar os seus dados desta localização.