Upload dados organizacionais (primeiro carregamento)

Os administradores devem primeiro carregar (importar) dados organizacionais para que você possa analisar informações sobre sua empresa no Workplace Analytics. Conclua as etapas a seguir após a preparação dos dados conforme descrito em Preparar dados organizacionais.

Importante

Use apenas as etapas a seguir se essa for a primeira vez que você estiver carregando dados organizacionais. Se esse não for seu primeiro carregamento, consulte Upload dados organizacionais (uploads subsequentes) para atualizar dados carregados anteriormente.

Importar tarefas

A tarefa de importar dados organizacionais tem três partes:

  1. Upload de arquivos
  2. Mapeamento de campos
  3. Validação de dados

Depois de preparar os dados de origem, você pode carregar o arquivo .csv e mapear campos. Depois de mapear campos, o Workplace Analytics valida os dados. Quando os dados são validados com êxito, a tarefa geral de importação de dados é concluída. Se a validação de dados não for bem-sucedida, você poderá escolher entre algumas opções descritas em Validação falhar.

Vídeo: Upload dados organizacionais

Upload de arquivos

Depois que o processamento inicial de dados de colaboração for concluído, na próxima vez que você abrir o Workplace Analytics, a página será atualizada automaticamente para que você saiba que é hora de carregar seus dados organizacionais como um arquivo .csv no Workplace Analytics. Use as etapas a seguir para fazer isso.

  1. Em Upload, selecione Nomear seu carregamento e insira um nome.

  2. Opcionalmente, selecione Adicionar uma descrição opcional e digite uma descrição.

  3. Clique em Selecionar um arquivo, selecione o arquivo .csv para carregar e selecione Abrir depois de revisar as seguintes considerações de carregamento importantes:

    • O .csv que você carrega deve ser codificado em UTF-8.
    • Confirme se .csv arquivo não está aberto em um programa diferente quando você inicia o processo de carregamento.
    • Após o início do processo de carregamento, o processo é irreversível.
  4. Para concluir um novo carregamento, selecione Próximo. Isso exibe a tabela Campos do sistema. Vá para Mapeamento de campo.

Mapeamento de Campos

Você precisa mapear os campos (colunas) para o arquivo de .csv de origem para os nomes de campo que o Workplace Analytics reconhece. Você mapeia esses campos durante a etapa Upload, conforme indicado na barra de progresso na página Instalação:

Opção Mapear campos de dados.

Esta página inclui tabelas para campos padrão do sistema e campos personalizados para mapear os dados do arquivo de carregamento. Esses tipos de campo são descritos nas seções a seguir.

Campos padrão do sistema

Os campos padrão do sistema representam atributos conhecidos pelo Workplace Analytics e são usados em cálculos específicos além de agrupar e filtrar. Um campo padrão do sistema pode ser obrigatório ou opcional.

  • Os campos necessários são identificados de duas maneiras. Suas linhas têm sombreamento escuro e mostram como "Obrigatório" no header da coluna Source. Essas linhas representam dados encontrados no arquivo carregado. Para que o carregamento seja bem-sucedido, você deve mapear os campos necessários com uma coluna em seu arquivo .csv que é o tipo de dados correto.

    Importante

    Cada campo necessário deve ter um valor válido, não nulo em cada linha. Isso significa que, mesmo que os nomes desses atributos não estão presentes no arquivo .csv carregado, outras colunas devem estar presentes no arquivo .csv que são mapeados para esses atributos.

  • Os campos opcionais aparecem abaixo dos campos necessários em linhas com sombreamento mais claro. Essas linhas são campos de sistema comumente encontrados que o Workplace Analytics sugere para uso. Você não precisa mapear esses campos se sua organização não tiver dados para eles.

Campos personalizados

  • Campos personalizados são exibidos nesta página abaixo dos campos opcionais. Campos personalizados são atributos opcionais que você pode criar. Selecione uma coluna no arquivo source.csv. Nomeia a coluna, selecione o tipo de dados e selecione a opção relatório.

Detalhes da coluna de campo

  • A coluna de origem corresponde a cada um dos campos no arquivo carregado.

  • Workplace Analytics name é o nome desse atributo nos dados do Workplace Analytics da sua organização.

  • Tipo de dados é o tipo de dados dos campos, como Email ou DateTime.

    Observação

    Se o tipo de dados for Boolean, o valor do campo Boolean deverá ser VERDADEIRO ou FALSO.

  • Incluir no relatório permite que você decida como tratar dados confidenciais no relatório que serão gerados sobre a operação de importação. Se oferecer as seguintes opções para cada uma das colunas em seus dados de origem:

    Mapear colunas de campo de dados para incluir.

    • Mostrar no relatório - Permite que o valor real dos dados seja exibido no relatório da mesma forma que foi importado no arquivo de dados organizacionais.
    • Excluir do relatório - Impede que o valor dos dados apareça no relatório. Por motivos de privacidade de dados, alguns atributos (como ManagerID) são atribuídos automaticamente ao valor "Excluir do relatório" e esse valor não pode ser alterado.
    • Hash no relatório - Desintente dados confidenciais. Essa opção inclui os dados no relatório que gera sobre a operação de importação, mas, em vez de exibir o valor real que foi tirado do arquivo de origem, ele mostra uma versão com hashed do valor – um formato que não pode ser lido.

Para mapear campos

Depois de concluir as etapas em Carregamento de arquivo,faça o seguinte para mapear os campos:

  1. Em Upload, mapeie os campos necessários.

    Tabela de campos do sistema.

    1. Determine qual das colunas em seu arquivo .csv corresponde à segunda coluna na tabela (nome do Workplace Analytics).
    2. Na coluna Fonte (a primeira coluna da tabela), selecione o nome que corresponde ao nome do atributo Workplace Analytics aplicável.
    3. Selecione ou insira os valores aplicáveis para as outras colunas, incluindo o tipo de dados e as opções Relatório.
    4. Repita estas etapas para todos os campos de sistema necessários.

    Observação

    Confira Detalhes da coluna de campo para obter mais informações.

  2. Mapeie os campos opcionais e personalizados, conforme aplicável. Você só precisa mapear as colunas no arquivo de dados de origem (.csv) que sua organização considera importante para análise. Por exemplo, se StartDate for importante e seus dados contiverem esse campo, mapeie-o.

    1. Na coluna Origem (a primeira coluna da tabela), selecione os nomes aplicáveis para os dados que você deseja carregar.
    2. Selecione ou insira os valores das outras colunas na tabela, como o tipo de dados e as opções de relatório.
    3. Repita estas etapas para todos os campos personalizados que são importantes para sua organização.
    Custom fields table
  3. Em Enviar para validação, selecione a caixa de seleção para eu confirmar se esses mapeamentos estão corretos e selecione Próximo. Em seguida, você verá um aviso sobre "seu arquivo está carregando".

Importante

Você deve permanecer conectado enquanto o arquivo estiver carregando ou o carregamento será cancelado. O carregamento exige que essa página seja aberta no navegador da Web durante o carregamento. Se você fechar o navegador (ou esta página do navegador), o carregamento falhará.

  1. A próxima etapa é Validação de dados.

Validação de dados

Depois de concluir as etapas no mapeamento de campo,a página Upload mostra a seguinte mensagem:

O arquivo está carregando.

Depois que o arquivo tiver sido carregado com êxito, a validação de arquivo será iniciada:

Validando agora.

Na maioria dos casos, a validação de arquivo deve ser concluída muito rapidamente. Se o arquivo de dados organizacional for muito grande, a validação pode levar até um ou dois minutos.

Durante esta etapa, se você decidir que os dados que você está carregando não são os dados corretos e que deseja carregar um arquivo de dados diferente, selecione Cancelar.

Após a conclusão dessa fase, o arquivo passou ou falhou na validação. Vá para a seção apropriada:

A validação é bem-sucedida

Falha na validação

A validação é bem-sucedida

Se a validação for bem-sucedida, na seção Resultados da Validação, a página exibirá a notificação bem-sucedida, que relata informações sobre os dados que foram carregados e validados com êxito:

Validação bem-sucedida.

Após a validação bem-sucedida, o Workplace Analytics processa seus novos dados.

Você pode selecionar Fontes de dados Dados > organizacionais para ver a página Upload histórico. Em seguida, você pode selecionar Sucessos para ver os fluxos de trabalho que foram validados com êxito (e carregados).

Nesta página, você tem as seguintes opções:

  • Selecione o ícone Exibir (olho) para ver um resumo dos resultados da validação.
  • Selecione o ícone Mapeamento para ver as configurações de mapeamento do fluxo de trabalho.
  • Selecione o ícone Validação (download) para ver uma lista de avisos de validação.

Observação

Cada locatário pode ter apenas um carregamento em andamento por vez. Portanto, você precisa concluir o fluxo de trabalho de um arquivo de dados, o que significa que você o guiará para uma validação bem-sucedida ou o abandonará antes de começar o fluxo de trabalho do próximo arquivo de dados. O status ou estágio do fluxo de trabalho de carregamento é mostrado na barra de progresso na parte superior da página Upload.

Falha na validação

Se a validação de dados falhar, a página de Instalação mostrará uma notificação "não pode ser validada" na área Upload detalhes. Esta página também apresenta opções de como continuar.

Falha na validação.

Antes de resolver o problema, você pode selecionar Baixar log de erro. Este arquivo de log descreve os problemas em seus dados que podem ter causado os erros de validação. Use essas informações para decidir o que fazer em seguida corrigir os dados — de origem ou alterar suas configurações de mapeamento. A seção a seguir descreve estas opções:

Opções após a validação com falha

Natureza dos erros Seleção recomendada Descrição
Erros menores, pequenos em número Selecionar Editar mapeamento Isso exibe a página Mapeamento de Campos, na qual você pode alterar como mapear campos de arquivo de origem para atributos do Workplace Analytics e, em seguida, tentar validação de novo. Você pode fazer isso sem alterar e carregar o arquivo de origem. Isso é melhor para erros secundários, como ter mapeado a coluna errada no arquivo de origem para um atributo específico.
Principais erros Selecione Upload arquivo Isso exibe a primeira página de carregamento de arquivo. Considere essa opção no caso de erros principais nos dados originalmente carregados. Primeiro, edite o arquivo de dados de origem para corrigir esses erros e, em seguida, tente o processo de carregamento e validação com o arquivo corrigido.

Observação

O Workplace Analytics não modifica nem preenche dados ausentes dos carregamentos de RH, mesmo para EffectiveDate ou TimeZone. O administrador é responsável por corrigir esses erros ou omissões.

Diretrizes para corrigir erros em dados

Esta seção contém ajuda para corrigir dados em um arquivo de origem carregado que está causando erros de validação.

Quando qualquer linha ou coluna de dados tiver um valor inválido para qualquer atributo, o carregamento inteiro falhará até que o arquivo de origem seja corrigido (ou o mapeamento altera o tipo de validação do atributo de uma forma que torna o valor válido).

Regras para headers de campo

Todos os nomes de coluna ou de header de campo devem:

  • Comece com uma letra (não um número)
  • Contém somente caracteres alfanuméricos (letras e números, por exemplo, Date1)
  • Ter pelo menos uma letra de caixa inferior (Hrbp); todas as maiúsculas não funcionarão (HRBP)
  • Corresponder exatamente como listado para atributos opcionais obrigatórios e reservados do Workplace Analytics, incluindo para sensibilidade de caso, como PersonId e HireDate
  • Não ter espaços em branco à frente ou à frente ou caracteres especiais (não alfanuméricos, como @, #, %, &); se espaços ou caracteres especiais estão incluídos, o Workplace Analytics os removerá do nome

Regras para valores de campo

Os valores de campo nas linhas de dados devem estar em conformidade com as seguintes regras de formatação:

  • Os valores de campo EffectiveDate e HireDate necessários devem estar no formato MM/DD/YYYY
  • Os valores de campo PersonId e ManagerId necessários devem ser um endereço de email válido (por exemplo, gc@contoso.com)
  • Os valores de campo TimeZone necessários devem estar em um formato Windows com suporte
  • Os valores de campo Camada necessários devem conter apenas números
  • Os valores de campo HourlyRate necessários devem conter apenas números, que o Workplace Analytics supõe que está em dólares dos EUA para cálculos e análise de dados

Observação

O Workplace Analytics atualmente não executa conversões de moeda para dados HourlyRate. Todos os cálculos e análise de dados no Workplace Analytics pressuem que os dados sejam em dólares dos EUA.

Regras para caracteres em valores de campo

As seguintes regras de campo se aplicam a caracteres em valores de campo:

  • Caracteres de byte duplo, como caracteres japoneses, são permitidos nos valores de campo

  • Limitar o comprimento do caractere dos valores de campo em linhas a um máximo de 128 KB, que é de cerca de 1024 x 128 caracteres

  • Os seguintes caracteres não são permitidos nos valores de campo:

    • tilde (~)
    • "nova linha" (\n)
    • Aspas duplas (" ")
    • Aspas simples (' ')