Carregar dados organizacionais (upload subsequente)

Se os dados organizacionais já tiverem sido carregados no aplicativo Web do Viva Insights, você, como administrador, poderá usar as informações deste artigo para:

• Editar dados existentes
• Substituir dados existentes
• Excluir atributos organizacionais e funcionários de dados existentes

Conclua essas etapas após preparar os dados, conforme descrito em Preparar dados organizacionais.

Fluxo de trabalho

Depois de preparar os dados de origem, o processo de upload segue estas etapas, que são descritas nas seções a seguir:

1. Carregue o arquivo .csv.

2. Você mapeia campos.

3. O aplicativo valida seus dados. (Se a validação não for bem-sucedida, você poderá escolher entre algumas opções descritas em Falha na validação.)

4. O aplicativo processa seus dados. (Se o processamento não for bem-sucedido, você poderá escolher entre algumas opções descritas em Falha no processamento.)

   Depois que os dados forem validados e processados com êxito, a tarefa geral de carregamento de dados será concluída.

Para atualizar, substituir ou excluir dados

Todas as três ações compartilham as mesmas duas primeiras etapas:

1. Selecione o botão Iniciar na guia Hub de dados ou o botão Gerenciar fontes de dados na guia Conexões de dados .

   

2. A página resultante lista quatro opções:

   • Adicionar ou editar dados
   • Excluir campos opcionais
   • Excluir dados de funcionários
   • Substituir todos os dados

   

   Faça sua seleção com base no que você deseja fazer e navegue até a seção correspondente abaixo para a etapa 3.

   Ação	Seção	Comments
   Adicionar novos funcionários (linhas)	Atualizar dados organizacionais existentes	Seu arquivo precisa incluir todos os campos obrigatórios (PersonId, ManagerId e Organização) e outros campos opcionais.
   Adicionar novos campos (colunas)	Atualizar dados organizacionais existentes	O arquivo precisa incluir PersonId e outros campos opcionais.
   Editar campos (colunas)	Atualizar dados organizacionais existentes	O arquivo precisa incluir PersonId e outros campos opcionais.
   Excluir atributos	Excluir campos opcionais de dados organizacionais existentes	Você só pode excluir atributos opcionais. Se você excluir campos usados em consultas de atualização automática, essas consultas serão desabilitadas.
   Substituir todos os dados organizacionais existentes	Substituir dados existentes	Essa opção exclui permanentemente todos os dados organizacionais que você carregou no passado. Se o arquivo não tiver algum campo, as consultas de atualização automática que usam esses campos serão desabilitadas.
   Remover funcionários de dados organizacionais	Excluir funcionários específicos de dados organizacionais existentes	Essa opção permite excluir funcionários específicos de seus dados organizacionais usando um arquivo .csv.

Atualizar e substituir dados existentes

Atualizar dados existentes

Upload de arquivos

• Em Carregar arquivo, selecione o arquivo que deseja carregar e selecione Avançar.

  Agora você está pronto para mapear os campos. Para suas próximas etapas, vá para Mapeamento de campo.

Exemplo: adicionando uma nova coluna de dados

Digamos que você queira carregar um novo valor de pontuação de engajamento para cada funcionário. Você já carregou os 13 meses ou mais recomendados de dados de snapshot, que incluíam as colunas necessárias para todos os funcionários; agora você deseja aplicar o valor da pontuação de engajamento a todos esses dados históricos. Você escolheria a opção Atualizar dados organizacionais existentes . Para carregar sua nova coluna de dados do EngagementScore , você precisa carregar o arquivo que a contém.

Etapas importantes para editar atributos da organização

Se você quiser editar atributos anteriores, seu arquivo .csv deverá incluir valores atualizados com as EffectiveDates corretas, para garantir que os valores atualizados se apliquem durante o período de tempo correto.

Por exemplo, considere este estado inicial dos dados da organização no Viva Insights:

Nesse cenário, se você quiser editar o valor ManagerId a partir de 06/09/2023 e quiser que o novo valor seja aplicado indefinidamente no futuro, será necessário atualizar o ManagerId para cada EffectiveDate a partir de 06/09/2023 de todos os uploads incrementais anteriores, mesmo que o campo ManagerId não faça parte desses uploads incrementais.

Seu novo upload, portanto, teria esta aparência:

Com esse upload, os dados da sua organização ficariam assim. Para 06/09/2023 e 08/09/2023, o ManagerId foi atualizado para "D".

Ou, vamos imaginar um cenário diferente. Se você quiser alterar o ManagerId apenas para as datas entre 06/09/2023 e 08/09/2023, este seria o seu upload:

Após esse upload, os dados da sua organização ficariam assim. Após 08/09/2023, o ManagerId ainda é "R", pois nenhuma alteração foi feita para a entrada anterior em 08/09/2023.

Por fim, se você não se lembrar dos valores anteriores do campo DataEfetiva, exclua as colunas que precisam ser editadas e carregue as colunas novamente com os valores atualizados. Ou, se houver várias colunas que precisam ser editadas, você também poderá substituir todos os dados anteriores por um novo upload com os valores atualizados.

Substituir dados existentes

Upload de arquivos

1. Insira um Nome de upload.

2. Em Carregar arquivo, selecione o arquivo .csv que deseja carregar.

   Verifique se o arquivo .csv está:

   • Codificado em UTF-8

   • Não abre em outro programa quando você inicia o processo de upload

   • Não maior que 1 GB Captura de

     Observação

     Para ver a estrutura e as diretrizes dos arquivos .csv e evitar problemas comuns durante o upload, você pode baixar um modelo por meio do link Baixar .csv modelo.

3. Carregue seu arquivo selecionando Avançar. Se você precisar cancelar o upload, selecione Cancelar.

Agora você está pronto para mapear os campos. Para suas próximas etapas, vá para Mapeamento de campo.

Excluir campos opcionais de dados organizacionais existentes

1. Nomeia a ação de exclusão para que você possa consultá-la mais tarde.
2. Identifique o atributo que deseja excluir e marque a caixa correspondente.
3. A tela resultante lista quais atributos foram excluídos. Selecione Voltar para retornar ao Hub de dados.

O processo de exclusão foi concluído.

Excluir funcionários e dados de dados organizacionais existentes

Selecione esta opção para remover dados organizacionais que você não precisa mais ou remover dados históricos de um funcionário para que você possa editar seus dados em uma lousa limpa. Depois de remover os funcionários, você pode carregar um novo arquivo para adicionar novos dados para os funcionários excluídos.

Como carregar o arquivo

1. Crie um arquivo .csv com os nomes dos funcionários que você deseja excluir. O arquivo deve incluir uma coluna chamada "PersonId", com o endereço de email de cada pessoa que você deseja excluir em cada linha dessa coluna. Para obter orientação, use este arquivo de modelo. Verifique se o arquivo .csv está:

   • Codificado em UTF-8
   • Não abre em outro programa quando você inicia o processo de upload
   • Não maior que 1 GB

2. Insira um nome para a ação Excluir.

3. Em Carregar um arquivo com os funcionários que você deseja excluir, selecione o arquivo .csv.

4. Para carregar seu arquivo, selecione Enviar. Para cancelar o upload, selecione Cancelar.

5. A tabela Histórico de importação mostra o status da exclusão.

   • Selecione o ícone de download para baixar uma lista de funcionários excluídos pela operação. Você pode acessar o link de download por até 30 dias.

Mapeamento de campo

Depois de carregar o arquivo, você verá a página de mapeamento de campo. Para visualizar os insights de seus dados, você precisa mapear campos (colunas) do arquivo de .csv para nomes de campo que o aplicativo reconheça.

Existem dois tipos de campos: Padrão do sistema e Personalizado.

Padrão do sistema (obrigatório ou opcional)

Os campos padrão do sistema podem ser obrigatórios , que são PersonId, ManagerId e *Organization , ou opcionais. Esses campos obrigatórios e opcionais representam atributos que o Viva Insights conhece e usa em cálculos específicos além de agrupamento e filtragem.

Campos opcionais são campos do sistema comumente encontrados que o aplicativo sugere para uso. Você não precisará mapear campos opcionais se sua organização não tiver dados para eles.

Para descobrir se um campo é obrigatório ou opcional, consulte a seção Atributos do Viva à direita da lista de mapeamento. Os atributos obrigatórios têm um rótulo "Obrigatório" e os atributos opcionais têm um rótulo "Opcional".

Personalizado

Os campos personalizados são atributos opcionais que você pode criar. A seção a seguir, etapa 5a, explica como mapear e nomear um atributo personalizado.

Para mapear campos

Siga as etapas abaixo para mapear seus dados .csv para atributos do Viva Insights.

4. Para cada campo obrigatório do Viva Insights:

   1. Localize o cabeçalho da coluna correspondente em Nome da coluna de origem. Para evitar um erro de validação posteriormente, verifique se essa coluna é do tipo de dados correto.

   2. Na coluna de campo Mapear para o Viva Insights , abra a lista suspensa e selecione o atributo do Viva Insights que corresponde ao cabeçalho da coluna identificado na etapa a.

      

   Dica

   Passe o mouse sobre o nome de um atributo para ler sua descrição.

   Se estiver atualizando dados, você pode optar por ver apenas as novas colunas que adicionou ou os cabeçalhos de coluna que alterou. Para fazer isso, selecione a opção Mostrar somente campos inválidos .

5. Repita as etapas 4a e 4b para campos personalizados e opcionais.

   • Para adicionar um campo personalizado, basta incluí-lo como uma coluna no seu arquivo de dados. O aplicativo atribuirá automaticamente um nome e o mapeará. Para esta versão do Viva Insights, todos os atributos personalizados recebem um nome padrão e só podem ser classificados como tipos de dados String .

     Importante

     Não carregue TimeZone como uma coluna. Você receberá um erro.

Após mapear os campos, o aplicativo valida e processa seus dados conforme descrito nas seções a seguir. Se a validação e o processamento forem bem-sucedidos, sua entrada no processo de upload estará concluída.

Se as colunas esperadas estiverem ausentes ou excluídas

Para que uma consulta seja executada com êxito, atributos específicos (colunas) precisam estar presentes nos dados organizacionais. Esse requisito também é verdadeiro para consultas com a opção de atualização automática ativada. Se os atributos (colunas) usados por uma consulta estiverem ausentes de um upload de dados, o aplicativo o alertará. Você verá uma tabela que lista os campos de atributo e as consultas em que esses campos são usados, juntamente com uma mensagem de aviso: "Continuar desabilitará essas consultas. Se uma consulta de atualização automática que contém esses campos for criada enquanto a função estiver em andamento, ela também será desabilitada."

Depois de revisar atributos ausentes:

• Se você decidir não continuar com o upload ou a substituição de dados, selecione Cancelar. Esse botão retornará à página de mapeamento de campo.
• Se você decidir continuar com o carregamento de dados mesmo que haja atributos ausentes, selecione Avançar. Essa opção desativa a atualização automática para as consultas listadas acima. Você ainda pode acessar os resultados das últimas execuções dessas consultas.

Validação

Depois de mapear os atributos, o aplicativo começa a validar seus dados.

Na maioria dos casos, a validação do arquivo deve ser concluída rapidamente. Se o seu arquivo de dados organizacionais for grande, a validação poderá levar de um a dois minutos.

Após a conclusão dessa fase, a validação foi bem-sucedida ou falhou.

Para obter informações sobre o que acontece a seguir, vá para a seção apropriada:

Validação bem-sucedida

Falha na validação

Validação bem-sucedida

Após a validação, o Viva Insights começará a processar seus novos dados. O processamento pode levar entre algumas horas e um dia ou mais. Durante o processamento, você verá um status "Em processamento" na tabela Carregar ou excluir em andamento de conexões > de dados.

Após a conclusão do processamento, ele foi bem-sucedido ou falhou. Dependendo do resultado, você receberá uma notificação de sucesso ou falha no canto superior direito da tela Conexões de dados .

O processamento foi bem-sucedido

Quando o processamento for bem-sucedido, você verá um status de "Êxito" na tabela Histórico de carregamento ou exclusão. Neste ponto, o processo de upload está concluído.

Aqui está a quantidade típica de tempo necessária para que os dados organizacionais sejam refletidos depois de carregados nas seguintes experiências:

• Status de êxito mostrado em Conexões > de dados Histórico de importação: algumas horas

• Guia Qualidade de dados, consultas flexíveis e modelos do Power BI: um a dois dias

• Relatório do líder/gerente no aplicativo Teams: Próxima atualização semanal

Depois de receber o status "Êxito", você poderá:

• Selecione o ícone de exibição (olho) para ver um resumo dos resultados da validação.

  

• Selecione o ícone de mapeamento para ver as configurações de mapeamento do fluxo de trabalho.

Falha no processamento

Se o processamento falhar, você verá um status de falha na tabela Carregamento ou exclusão em andamento. Selecionar o link no status leva você a uma explicação da falha.

Selecione Editar ou iniciar novo upload. Esse botão permite que você faça o seguinte para o arquivo de dados carregado anteriormente:

• Edite para adicionar novas linhas ou colunas.
• Exclua atributos.
• Substitua o arquivo existente por um novo arquivo.

Falha na validação

Se a validação de dados falhar, você verá uma nova tela com um erro "Falha na validação" e algumas informações sobre a falha. Você pode selecionar o botão Cancelar upload se não quiser prosseguir com o processo de upload.

Antes de fazer alterações no arquivo de origem e tentar carregar novamente, você pode selecionar Problemas de download. Este arquivo de log descreve os problemas nos seus dados que podem ter causado os erros de validação. Use essas informações para decidir o que fazer a seguir: corrija os dados de origem ou altere as configurações de mapeamento.

Diretrizes para corrigir erros nos dados

Quando qualquer linha ou coluna de dados tem um valor inválido para qualquer atributo, todo o upload falha até que você corrija o arquivo de origem (ou você corrija o mapeamento de atributo).

Para saber mais sobre como formatar seu arquivo para evitar erros, consulte Regras de arquivo e erros de validação.

Tópico relacionado

Prepare os dados organizacionais