Regras de arquivo e erros de validação

Neste artigo, descrevemos como o arquivo de upload precisa ser formatado e fornecemos erros que você pode encontrar ao trazer dados para o aplicativo Web do Viva Insights.

Regras de arquivo e campo

Quando qualquer linha ou coluna de dados tem um valor inválido para qualquer atributo, todo o upload pode falhar ou produzir avisos, dependendo se a opção Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada está ativada ou desativada.

Se Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada estiver desativado, todo o upload falhará devido a erros de validação até que o arquivo de origem seja corrigido (ou o mapeamento altere o tipo de validação do atributo de uma maneira que torne o valor válido).

Se a opção Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada estiver ativada, ela carregará apenas as linhas que incluem valores válidos e mostrará avisos para as linhas que não foram ingeridas devido a erros. Essa configuração é desmarcada por padrão.

Regras para o arquivo

O arquivo de dados precisa estar no formato UTF-8 .csv e não pode estar vazio.

Regras para cabeçalhos de campo de origem e destino

Todos os nomes de cabeçalho ou coluna de campo de origem e destino precisam:

  1. Contenham apenas caracteres alfanuméricos ASCII (letras e números, por exemplo, Data1) ou sublinhado (_). Não há suporte para caracteres não alfanuméricos especiais, como @, #, %, & ou outros caracteres.
  2. Contêm um valor.
  3. Seja único.

Regras para cabeçalhos de campos de destino personalizados

Todos os cabeçalhos de campo de destino personalizado ou nomes de coluna precisam:

  1. Não ter espaços em branco à esquerda, no meio ou à direita.
  2. Não contêm campos do sistema, que são:
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • Domínio
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • WeekendDays
    • InferredTeamSize
    • ObjectId
    • IsActive
    • Começando com "Microsoft_"
    • DataDeMétrica
    • PrimaryCollaborator_PersonId
    • SecondaryCollaborator_PersonId

Os campos obrigatórios precisam ter um valor para cada linha.

Depois de carregar seu arquivo, você só pode mapear um cabeçalho de coluna para cada campo de dados do Viva Insights.

Regras para valores de campo

Os valores de campo precisam ser fornecidos no tipo de dados correto. Consulte a referência de atributo.

Regras para caracteres em valores de campo

  • O comprimento de caracteres dos valores de campo em linhas não pode exceder 128 KB, o que equivale a cerca de 1024 x 128 caracteres.
  • Caracteres de "nova linha" (\n) não são permitidos em valores de campo.

Observação

Você pode usar caracteres de byte duplo, como caracteres japoneses, nos valores de campo.

Regras para valores no campo ManagerId

Cada PersonId precisa ter um ManagerId exclusivo. Em outras palavras, não pode haver vários gerentes para uma pessoa.

Não pode haver loops em que:

  • Gerentes e funcionários se reportam uns aos outros.
  • Os gerentes se reportam aos funcionários.

Digamos que Dylan seja o empresário de Kris. Não foi possível mostrar os dados organizacionais:

  • Kris se reportando a Dylan e também Dylan se reportando a Kris.
  • Dylan reportando-se a Kris.

Ambas as hierarquias a seguir produziriam erros nas experiências do usuário final:

Captura de tela que mostra um loop de hierarquia de gerente entre três pessoas.

Exemplo .csv exportar arquivo

Aqui está um trecho de exemplo de um arquivo de exportação .csv válido:

PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest

Baixar log para funcionários com dados ausentes

A página Qualidade dos dados permite que você saiba se há usuários medidos ausentes no arquivo de dados organizacionais. Nesse caso, você verá a mensagem "{number} os usuários medidos têm dados organizacionais ausentes. Baixe quais usuários têm dados organizacionais ausentes e carregue seus dados para obter insights de maior qualidade."

O log de download mostra os usuários medidos que estão sem qualquer campo de dados, exceto os campos do sistema Domínio e Fuso horário.

Erros e avisos de validação

Aqui estão os erros de validação que você pode encontrar ao carregar dados no aplicativo Web do Viva Insights. Na maioria dos casos, você precisa corrigir os erros e carregar o arquivo novamente. Consulte nosso artigo Preparar dados organizacionais para saber como formatar e preparar seus dados para upload.

Categoria Regra relacionada Mensagem Aplicável a
Arquivo e extensões de arquivo O arquivo de dados precisa estar no formato UTF-8 .csv e não pode estar vazio. O arquivo está vazio. Selecione outro arquivo e carregue novamente. .csv carregar apenas
Este arquivo tem uma extensão inválida de '{0}'. Selecione um arquivo .csv e carregue novamente. .csv carregar apenas
O arquivo de dados para importação baseada em API e importação de blob Azure precisa estar em .zip formato de arquivo e incluir um arquivo .csv no formato UTF-8 e um arquivo de mapeamento .json. Os arquivos não podem estar vazios. Há um problema com os arquivos no arquivo .zip. Verifique se o arquivo .zip contém apenas um arquivo .json e um arquivo .csv e carregue-o novamente. Importação baseada em API e importação de blobs do Azure
O arquivo .csv no arquivo .zip está vazio. Adicione um arquivo .csv vazio e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
O arquivo .json no arquivo .zip está vazio. Adicione um arquivo .json não vazio e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
O arquivo .json é inválido. Use um arquivo .json válido e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
Cabeçalhos de coluna Todos os nomes de coluna ou cabeçalho de campo precisam ser exclusivos. Dois ou mais cabeçalhos de coluna no arquivo são iguais. Inclua cabeçalhos exclusivos para cada coluna. Todos
Todos os nomes de campo, cabeçalho ou coluna precisam conter um valor. O cabeçalho está ausente nas colunas {J}. Inclua o nome do cabeçalho no arquivo selecionado e carregue novamente. Todos
O arquivo .csv é mapeado para um campo nulo ou vazio no arquivo .json. Mapeie-o para um campo não vazio e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
Todos os nomes de coluna ou cabeçalho de campo precisam conter apenas caracteres alfanuméricos (letras e números, por exemplo, Data1) ou os seguintes símbolos: ~ ! @ # $ % ^ & * + > : <> [] ?. Não há suporte para outros caracteres {Header name} contém caracteres especiais incompatíveis. Remova os caracteres especiais e carregue novamente.
Todos os nomes de cabeçalho ou coluna de campo não precisam conter campos do sistema. {header name} é um campo do sistema. Renomeie {header name} para que ele não use um campo do sistema e carregue o arquivo novamente. Todos
Depois de carregar seu arquivo, você só pode mapear um cabeçalho de coluna para cada campo de dados do Viva Insights. O arquivo tem mais de uma coluna de origem mapeada para um campo de dados. Verifique se cada coluna de origem está mapeada para um campo exclusivo. Todos
Os nomes de cabeçalho no arquivo .csv não correspondem aos campos mapeados no arquivo .json. Verifique se o arquivo .json contém os mesmos campos que o arquivo .csv e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
O número de cabeçalhos no arquivo .csv não corresponde aos campos mapeados no arquivo .json. Verifique se o arquivo .json contém os mesmos campos que o arquivo .csv e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure
Todas as colunas de origem precisam ser mapeadas para um tipo de dados com suporte A coluna de origem não está mapeada para um tipo de dados com suporte. Mapeie para um tipo de dados compatível e carregue o arquivo novamente. Importação baseada em API e importação de blobs do Azure
O arquivo .json especifica um "DatasetType" que não é esperado. Especifique o valor correto e carregue o arquivo .zip novamente. Importação baseada em API e importação de blobs do Azure

Abaixo estão os erros de validação e os avisos relacionados aos valores de campo. Se a opção Carregar linhas válidas e Excluir linhas com dados inválidos em Configuração avançada estiver desativada, isso criará erros e falhará na validação. Se estiver ativado, ele carregará apenas as linhas que incluem valores válidos e mostrará avisos para as linhas que não foram ingeridas devido a erros. Essa configuração é desmarcada por padrão.

Categoria Regra relacionada Mensagem Erro ou aviso Aplicável a
Valores do campo O arquivo de dados precisa estar no formato UTF-8 .csv. Formato .csv inválido. O número de colunas na linha não corresponde ao número de colunas no cabeçalho. Marque se há vírgulas ausentes ou no local incorreto e carregue novamente. Erro Todos
Formato .csv inválido. O número de colunas na linha não corresponde ao número de colunas no cabeçalho. Linhas com valores inválidos não são carregadas. Marque se há vírgulas ausentes ou no local incorreto e carregue novamente.  Aviso Todos
Caractere não UTF-8 encontrado. Verifique se o arquivo .csv usa a codificação UTF-8 e carregue-o novamente. Erro Todos
Caractere não UTF-8 encontrado. Linhas com valores inválidos não são carregadas. Verifique se o arquivo .csv usa a codificação UTF-8 e carregue-o novamente.  Aviso Todos
Os valores de campo precisam ser fornecidos no tipo de dados correto. Consulte a referência de atributo. Valor {header name} inválido. {Header name} deve ser um endereço de email seguindo o formulário employee@contoso.com. Aviso Todos
{Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser um endereço de email seguindo o formulário employee@contoso.com. Aviso Todos
Valor {header name} inválido. {Header name} deve ser uma cadeia de caracteres. Erro Todos
{Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser uma cadeia de caracteres.  Aviso Todos
  • {Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser uma data seguinte ao formato MM/DD/AAAA, MM/DD/AAAA, MM/DD/AAAA seguida por mais texto (como hora), MM-DD-AAAA, MM-DD-AAA, AAAA-MM-DD, Quarta-feira, 14 de março de 2012, 14 de março de 2012, 14 de março de 2012, 14 de março de 2012 ou 14 de março de 12.
  • OU
  • {Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser uma data após o formato DD/MM/AAAA, DD/MM/AAAA seguida por mais texto (como hora), D/MM/AAAA, D/MM/AA, DD-MM-AAAA, DD-MM-AAA, DD-MM-DD-MM, Quarta-feira, 14 de março de 2012, 14 de março de 2012, 14 de março de 2012 ou 14 de março de 12.
    		•  Aviso Todos
    Valor {header name} inválido. {Header name} deve ser um duplo seguindo o formulário 23.75. Erro Todos
    {Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser um duplo seguindo o formulário 23.75.  Aviso Todos
    Valor {header name} inválido. {Header name} deve ser um número inteiro. Erro Todos
    {Header name} contém um valor inválido. Linhas com valores inválidos não são carregadas. {Header name} deve ser um número inteiro.  Aviso Todos
    Os campos obrigatórios precisam ter um valor para cada linha. Falta a coluna {header name} ou o valor {header name}. {Header name} é um campo obrigatório e precisa de um valor para cada linha. Adicione o valor {header name} e carregue o arquivo novamente. Erro Todos
    Valor ManagerId ausente para o novo campo PersonId. ManagerId é um campo obrigatório. Adicione o campo ManagerId correspondente e carregue novamente. Erro Todos
    Cada PersonId precisa ter um ManagerId exclusivo. Todos
    Não pode haver loops em que:
    • Gerentes e funcionários se reportam uns aos outros.
    • Os gerentes se reportam aos funcionários.
    		 Erro Todas
    • Last updated on