Regras de ficheiro e erros de validação
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 tem um valor inválido para qualquer atributo, todo o carregamento pode falhar ou produzir avisos consoante Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada está ativado ou desativado.
Se a opção Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada estiver desativada, o carregamento completo falhará devido a erros de validação até o ficheiro de origem ser corrigido (ou o mapeamento altera o tipo de validação do atributo de uma forma que torna 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, apenas carregará linhas que incluam 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 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:
- Contenham apenas carateres alfanuméricos ASCII (letras e números, por exemplo, Data1) ou caráter de sublinhado (_). Os carateres não fantasmagóricos especiais, como @, #, %, & ou outros carateres não são suportados.
- Contenham um valor.
- 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:
- Não tenha espaços em branco à esquerda, ao meio ou à direita.
- 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 Viva Insights campo de dados.
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:
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
Transferir o registo para funcionários com dados em falta
A página Qualidade dos dados permite-lhe saber se faltam utilizadores medidos no seu ficheiro de dados organizacional. Se for o caso, verá a mensagem "{number} utilizadores medidos têm dados organizacionais em falta. Transfira os utilizadores que têm dados organizacionais em falta e carregue os respetivos dados para obter informações de maior qualidade."
O registo de transferência mostra os utilizadores medidos que não têm qualquer campo de dados , exceto os campos do sistema Domínio e Fuso Horário.
Erros e avisos 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, tem 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 | ||
| O ficheiro de dados para importação baseada em API e importação de blobs do Azure tem de estar no formato de ficheiro .zip e incluir um ficheiro .csv no formato UTF-8 e um .json ficheiro de mapeamento. Os ficheiros não podem estar vazios. | Existe um problema com os ficheiros no ficheiro .zip. Certifique-se de que o ficheiro .zip contém apenas um ficheiro de .json e um ficheiro de .csv e carregue-o novamente. | Importação baseada em API e importação de blobs do Azure | |
| O ficheiro .csv no ficheiro .zip está vazio. Adicione um ficheiro de .csv não vazio e carregue novamente o ficheiro de .zip. | Importação baseada em API e importação de blobs do Azure | ||
| O ficheiro .json no ficheiro .zip está vazio. Adicione um ficheiro de .json não vazio e carregue novamente o ficheiro de .zip. | Importação baseada em API e importação de blobs do Azure | ||
| O ficheiro .json é inválido. Utilize um ficheiro de .json válido e carregue novamente o ficheiro .zip. | Importação baseada em API e importação de blobs do Azure | ||
| 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 | |
| O ficheiro de .csv está mapeado para um campo nulo ou vazio no seu ficheiro de .json. Mapeie-o para um campo não vazio e carregue novamente o ficheiro .zip. | Importação baseada em API e importação de blobs do Azure | ||
| 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 Viva Insights campo de dados. | 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 | |
| Os nomes de cabeçalho no ficheiro .csv não correspondem aos campos que mapeou no ficheiro .json. Certifique-se de que o ficheiro .json contém os mesmos campos que o ficheiro de .csv e carregue novamente o ficheiro de .zip. | Importação baseada em API e importação de blobs do Azure | ||
| O número de cabeçalhos no ficheiro .csv não corresponde aos campos que mapeou no ficheiro .json. Certifique-se de que o ficheiro .json contém os mesmos campos que o ficheiro de .csv e carregue novamente o ficheiro de .zip. | Importação baseada em API e importação de blobs do Azure | ||
| Todas as colunas de origem têm de ser mapeadas para um tipo de dados suportado | A coluna de origem não está mapeada para um tipo de dados suportado. Mapeie para um tipo de dados suportado e carregue o ficheiro novamente. | Importação baseada em API e importação de blobs do Azure | |
| O ficheiro .json especifica um "DatasetType" que não é esperado. Especifique o valor correto e carregue novamente o ficheiro .zip. | Importação baseada em API e importação de blobs do Azure |
Seguem-se os erros de validação e avisos relacionados com valores de campo. Se Carregar linhas válidas e excluir linhas com dados inválidos em Configuração avançada estiver desativada, cria erros e falha na validação. Se estiver ativada, apenas carregará linhas que incluam 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 de campo | O ficheiro de dados tem de estar no formato .csv UTF-8. | Formato de .csv inválido. O número de colunas na linha não corresponde ao número de colunas no cabeçalho. Por favor, marcar para vírgulas em falta ou no local incorrido e carregue novamente. | Erro | Todos |
| Formato de .csv inválido. O número de colunas na linha não corresponde ao número de colunas no cabeçalho. As linhas com valores inválidos não são carregadas. Por favor, marcar para vírgulas em falta ou no local incorrido e carregue novamente. | Aviso | 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. | Erro | Todos | ||
| Foi encontrado um caráter não UTF-8. As linhas com valores inválidos não são carregadas. Certifique-se de que o ficheiro .csv utiliza a codificação UTF-8 e carregue-o novamente. | Aviso | Todos | ||
| 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. |
Aviso | Todos | |
{Header name} contém um valor inválido. As linhas com valores inválidos não são carregadas. {Header name} deve ser um endereço de e-mail a seguir ao formulário employee@contoso.com. |
Aviso | Todos | ||
| Valor {header name} inválido. {Header name} deve ser uma cadeia. | Erro | 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 cadeia. | Aviso | Todos | ||
| Aviso | Todos | |||
| Valor {header name} inválido. {Header name} deve ser um duplo a seguir ao formulário 23,75. | Erro | Todos | ||
| {Header name} contém um valor inválido. As linhas com valores inválidos não são carregadas. {Header name} deve ser um duplo a seguir ao 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. As linhas com valores inválidos não são carregadas. {Header name} deve ser um número inteiro. | Aviso | 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. | Erro | Todos | |
| Valor ManagerId em falta para o novo campo PersonId. ManagerId é um campo obrigatório. Adicione o campo ManagerId correspondente e carregue novamente. | Erro | Todos | ||
| Cada PersonId tem de ter um ManagerId exclusivo. | Todos | |||
Não podem existir ciclos em que:
|
Erro | Todas |