Fazer upload de dados organizacionais (primeiro upload)

Importante

Não há mais suporte para adicionar e editar carregamentos de dados organizacionais no aplicativo Web Viva Insights. Para carregar seus dados organizacionais (RH), use o Centro de administração do Microsoft 365. As exclusões de dados e Substituir Tudo ainda estão disponíveis no aplicativo Web do Viva Insights. Saiba mais.

Seus dados organizacionais podem aparecer no aplicativo Web do Viva Insights de duas maneiras: por meio do Microsoft Entra ID, que é a fonte padrão, ou por meio de um arquivo .csv que você, como administrador, carrega.

Este artigo fala sobre a segunda opção: carregar um arquivo .csv.

Importante

Use as etapas a seguir apenas se esta for a primeira vez que você está carregando dados organizacionais. Se esse não for seu primeiro upload, confira Carregar dados organizacionais (uploads subsequentes) para atualizar os dados carregados anteriormente.

Fluxo de trabalho

Depois de preparar os dados de origem, você seguirá estas etapas:

  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, você terminará a tarefa geral de carregamento de dados.

Upload de arquivos

Para carregar o arquivo .csv, siga estas etapas:

  1. Abra a experiência de administrador do aplicativo Web do Viva Insights .

  2. Na página Hub de dados, vá para a card de upload de.csv no lado direito da tela, abaixo de Fonte de dados. Captura de tela que mostra .csv bloco de upload e a opção Iniciar.

  3. Selecione Iniciar.

  4. Na Etapa 1 de 2: Preparar e carregar:

    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 aberto em um programa diferente quando você iniciar o processo de upload.

    • Não maior que 1 GB.

      Captura de tela que mostra a opção Preparar e carregar dados.

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 .

  1. Para carregar, selecione Avançar. Para cancelar o upload, selecione Cancelar.

Mapeamento de campo

Depois de carregar o arquivo, você verá a página Etapa 2 de 2: mapeamento . 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 Reservados opcionais. Esses campos representam atributos que o Viva Insights conhece e usa em cálculos específicos além de agrupamento e filtragem.

Importante

Todo campo obrigatório precisa ter um valor válido e não nulo em cada linha. Você precisa mapear todos os valores necessários do Viva Insights, mesmo que os cabeçalhos de coluna em seus arquivos de .csv não correspondam exatamente ao nome do valor do Viva Insights.

Campos opcionais são campos do sistema comumente encontrados que o aplicativo sugere usar. 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" abaixo do nome do campo, enquanto os atributos opcionais têm um rótulo "Opcional reservado".

Se você precisar de uma definição de campo, passe o mouse sobre o ícone de informações (i).

Captura de tela que mostra os atributos do Viva e uma definição de campo.

Personalizado

Os campos personalizados são atributos opcionais que você pode criar. A seção a seguir explica o mapeamento e a nomenclatura de um atributo personalizado.

Para mapear campos

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

Importante

Todos os .csv campos de cabeçalho, que aparecem em Nome da coluna de origem, precisam ser mapeados antes de você passar para a próxima parte do processo de upload.

  1. 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 1a.
  2. Repita as etapas 1a e 1b 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.

  3. Depois de concluir o mapeamento de seus atributos, selecione o botão Avançar na parte inferior esquerda da tela.

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, você terá terminado sua parte no processo de carregamento.

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. Dependendo do resultado, você receberá uma notificação de sucesso ou falha no canto superior direito da tela Conexões de dados .

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. Captura de tela que mostra os resultados da validação.
  • Selecione o ícone de mapeamento para ver as configurações de mapeamento do fluxo de trabalho. Captura de tela que mostra as configurações de mapeamento.

Observação

Cada locatário pode ter apenas um carregamento em andamento por vez. Você precisa concluir o fluxo de trabalho de um arquivo de dados, o que significa que você o orientará para uma validação e processamento bem-sucedidos ou o abandonará antes de iniciar o fluxo de trabalho do próximo arquivo de dados. O status ou o estágio do fluxo de trabalho de carregamento é mostrado na guia Conexões de dados.

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ê inicie o processo de upload novamente.

Observação

Falhas de processamento geralmente são devidas a erros de back-end. Se você estiver vendo falhas de processamento persistentes e tiver corrigido os dados no arquivo carregado, registre um tíquete de suporte conosco.

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 tiver um valor inválido para qualquer atributo, todo o upload falhará até que você corrija o arquivo de origem (ou 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.

Prepare os dados organizacionais