Partilhar via

Regras de ficheiro e erros de validação

  • Artigo

Neste artigo, descrevemos como o ficheiro de carregamento tem de ser formatado e apresentamos erros que poderá encontrar ao introduzir dados na aplicação de informações avançadas.

Regras de ficheiros e campos

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

Regras para o ficheiro

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

Regras para cabeçalhos de campo de origem e de destino

Todos os nomes de colunas ou cabeçalhos de campo de origem e de destino têm de:

  1. Contenham apenas carateres alfanuméricos ASCII (letras e números, por exemplo, Data1) ou caráter de sublinhado (_). Não são suportados carateres especiais não alfanuméricos, como @, #, %, & ou outros carateres.
  2. Contenham um valor.
  3. Seja exclusivo.

Regras para cabeçalhos de campo de destino personalizados

Todos os cabeçalhos de campo de destino personalizados ou nomes de colunas têm de:

  1. Não tenha espaços em branco à esquerda, ao meio ou à direita.
  2. Não contém campos de sistema, que são:
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • Domínio
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • WeekendDays
    • InferredTeamSize
    • ObjectId
    • IsActive
    • A começar com "Microsoft_"
    • DataDmétrica
    • PrimaryCollaborator_PersonId
    • SecondaryCollaborator_PersonId

Os campos necessários têm de ter um valor para cada linha.

Depois de carregar o ficheiro, só pode mapear um cabeçalho de coluna para cada campo de dados do Viva Insights.

Regras para valores de campo

Os valores dos campos têm de ser fornecidos no tipo de dados correto. Veja Referência de atributos.

Regras para carateres em valores de campo

  • O comprimento do caráter dos valores de campo nas linhas não pode exceder os 128 KB, que é cerca de 1024 x 128 carateres.
  • Os carateres "Nova linha" (\n) não são permitidos em valores de campo.

Observação

Pode utilizar carateres de byte duplo, como carateres japoneses, nos valores de campo.

Regras para valores no campo ManagerId

Cada PersonId tem de ter um ManagerId exclusivo. Por outras palavras, não pode haver múltiplos gestores para uma pessoa.

Não podem existir ciclos em que:

  • Os gestores e funcionários reportam-se uns aos outros.
  • Os gestores reportam aos funcionários.

Digamos que Dylan é o gerente da Kris. Os dados organizacionais não puderam mostrar:

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

Ambas as hierarquias seguintes produziriam erros em experiências de utilizador final:

Captura de ecrã que mostra um ciclo de hierarquia de gestor entre três pessoas.

Exemplo .csv ficheiro de exportação

Eis um fragmento de exemplo de um ficheiro de exportação de .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

Erros de validação

Seguem-se erros de validação que poderá encontrar ao carregar dados para a aplicação de informações avançadas. Na maioria dos casos, terá de corrigir os erros e carregar o ficheiro novamente. Veja o nosso artigo Preparar dados organizacionais para saber como formatar e preparar os seus dados para carregamento.

Categoria Regra relacionada Mensagem Aplicável a
Extensões de ficheiros e ficheiros O ficheiro de dados tem de estar no formato .csv UTF-8 e não pode estar vazio. O ficheiro está vazio. Selecione outro ficheiro e carregue novamente. apenas carregamento de .csv
Este ficheiro tem uma extensão inválida de "{0}". Selecione um ficheiro .csv e carregue novamente. apenas carregamento de .csv
Formato de .csv inválido. O número de colunas na linha não corresponde ao número de colunas no cabeçalho. Verifique se existem vírgulas em falta ou no local incorrido e carregue novamente. Todos
Foi encontrado um caráter não UTF-8. Certifique-se de que o ficheiro .csv utiliza a codificação UTF-8 e carregue-o novamente. Todos
Cabeçalhos de coluna Todos os nomes de cabeçalhos ou colunas de campo têm de ser exclusivos. Dois ou mais cabeçalhos de coluna no seu ficheiro são os mesmos. Inclua cabeçalhos exclusivos para cada coluna. Todos
Todos os nomes de cabeçalhos ou colunas de campo têm de conter um valor. O cabeçalho está em falta nas colunas {J}. Inclua o nome do cabeçalho no ficheiro selecionado e carregue novamente. Todos
Todos os nomes de cabeçalhos ou colunas de campo têm de conter apenas carateres alfanuméricos (letras e números, por exemplo, Data1) ou os seguintes símbolos: ~ ! @ # $ % ^ & * + > : <> [] ?. Não são suportados outros carateres {Header name} contém carateres especiais não suportados. Remova os carateres especiais e carregue novamente.
Todos os nomes de cabeçalhos de campos ou colunas não têm de conter campos de sistema. {header name} é um campo de sistema. Mude o nome de {header name} para que não utilize um campo de sistema e carregue o ficheiro novamente. Todos
Depois de carregar o ficheiro, só pode mapear um cabeçalho de coluna para cada campo de dados do Viva Insights. O ficheiro tem mais do que uma coluna de origem mapeada para um campo de dados. Certifique-se de que cada coluna de origem está mapeada para um campo exclusivo. Todos
Valores de campo Os valores dos campos têm de ser fornecidos no tipo de dados correto. Veja Referência de atributos. Valor {header name} inválido. {Header name} deve ser um endereço de e-mail a seguir ao formulário employee@contoso.com. Todos
Valor {header name} inválido. {Header name} deve ser uma cadeia. Todos
  • {Header name} contém um valor inválido. As linhas com valores inválidos não são carregadas. {Header name} deve ser uma data a seguir ao formulário MM/DD/AAAA, MM/DD/AAAA, MM/DD/AAAA seguido de mais texto (como tempo), MM-DD-AAAA, MM-DD-YYY, AAAA, AAAA-MM-DD, quarta-feira, 14 de março de 2012, 14 de março de 2012, 14-mar-2012 ou 14-mar-12.
  • OU
  • {Header name} contém um valor inválido. As linhas com valores inválidos não são carregadas. {Header name} deve ser uma data a seguir ao formulário DD/MM/AAAA, DD/MM/AAAA seguido de mais texto (por exemplo, hora), D/MM/AAAA, D/MM/AAAA, DD-MM-AAAA, DD-MM-YY, AAAA-DD-MM, Quarta-feira, 14 de março de 2012, 14 de março de 2012, 14-mar-2012 ou 14-mar-12.
    		•  Todos
    Valor {header name} inválido. {Header name} deve ser um duplo a seguir ao formulário 23,75. Todos
    Valor {header name} inválido. {Header name} deve ser um número inteiro. Todos
    Os campos necessários têm de ter um valor para cada linha. Coluna {header name} ou {header name} em falta. {Header name} é um campo obrigatório e precisa de um valor para cada linha. Adicione o valor {header name} e carregue o ficheiro novamente. Todos
    Valor ManagerId em falta para o novo campo PersonId. ManagerId é um campo obrigatório. Adicione o campo ManagerId correspondente e carregue novamente. Todos
    Cada PersonId tem de ter um ManagerId exclusivo. Todos
    Não podem existir ciclos em que:
    • Os gestores e funcionários reportam-se uns aos outros.
    • Os gestores reportam aos funcionários.
    		 Todas