Importar dados organizacionais usando a importação baseada em API (importação subsequente) (versão prévia)

Neste artigo, discutimos dois tipos de importações: completa e incremental. Essas importações atualizam os dados fornecidos ao configurar sua conexão com o Viva Insights.

Sobre as importações subsequentes

Ao importar dados para o Viva Insights, você executará uma atualização completa ou incremental. Se quiser excluir campos, você pode usar uma atualização completa para fazer isso.

O aplicativo de exportação personalizado que você criou em Importar dados organizacionais (primeira importação), juntamente com o DescriptiveDataUploadApp que criamos no GitHub, facilita as atualizações sobre as quais falamos abaixo. Como uma rápida recapitulação, quando o DescriptiveDataUploadApp é executado, ele extrai dados da pasta zipada que você baixou do GitHub. Essa pasta zipada contém os seguintes arquivos:

• data.csv, que contém os campos que você deseja importar.
• metadata.json, que mapeia seus campos de origem para campos do Viva Insights. Você também usará metadata.json para informar ao Viva Insights se a atualização é completa ou incremental, conforme explicaremos na próxima seção.

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, use “IsBootstrap” : “true”.
   • Para uma atualização incremental, use “IsBootstrap” : “false”.

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

Tipos de atualização

Inteiro

Ao executar uma atualização completa, você está substituindo todos os dados da sua organização no Viva Insights, ou seja, substitui o que já importou. Ao realizar uma atualização completa, certifique-se de fornecer dados de todos os funcionários licenciados e não licenciados (ou seja, aqueles que têm uma assinatura do Viva Insights e aqueles que não têm). Descrevemos quais campos fornecer mais adiante neste artigo.

Você pode usar uma atualização completa para excluir campos, pois os campos que você deixar de fora não serão exibidos em seus dados. Falaremos sobre a exclusão de dados na próxima seção.

Exclusão de campos com atualizações completas

Para excluir campos com uma atualização completa, exporte seus dados como uma .csv que contém todos os campos, exceto os campos que você deseja excluir. Como uma atualização completa substitui os dados existentes, você acabará com todos os campos, exceto aqueles que você deixou de fora durante a importação.

Incremental

Execute uma atualização incremental quando quiser apenas adicionar algumas novas informações aos dados organizacionais que você já carregou no Viva Insights. Veja o que você 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 funcionários existentes

Aqui estão alguns exemplos de quando você pode executar uma atualização incremental:

Adicionando novas contratações

Digamos que você queira adicionar cinco novas contratações aos seus dados organizacionais. Durante a importação, você incluirá:

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

Após a conclusão da importação, a única alteração que você notará são cinco novas linhas e seus valores.

Adicionando um novo atributo

Talvez você queira adicionar um atributo reservado opcional que não estava em seus dados antes - digamos, Localização - para todos os funcionários existentes. Ao importar seus dados, você deve incluir apenas Location, PersonId e EffectiveDate, com valores atuais e históricos para cada funcionário, em seu arquivo .csv. Após a conclusão da importação, você encontrará os mesmos dados que estavam lá antes, com exceção de uma nova coluna para cada funcionário, Local.

Campos a serem incluídos no data.csv para atualizações completas e incrementais

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

• Formate esses campos de acordo com nossas diretrizes em Preparar dados organizacionais.
• Remova todos os campos que você não está incluindo do seu arquivo metadata.json.
• Mantenha os arquivos data.csv e metadata.json na pasta zipada que você baixou do GitHub. Ao executar o DescriptiveDataUploadApp, você fornecerá o caminho da pasta zipada. O Viva Insights extrairá seus dados desse local.