Mensagens de importação, atualização e exportação de participantes (EX)
Qdica: Esta página descreve a funcionalidade disponível para projetos de Engajamento, Ciclo de vida e Pesquisa de funcionários ad hoc. Para mais detalhes sobre cada um, consulte Tipos de projetos do Employee Experience. Essa funcionalidade também está disponível no Pulse, embora com algumas diferenças detalhadas aqui.
Sobre importação, atualização, & de participante; Exportar mensagens
Às vezes, após importar, atualizar ou exportar um arquivo de participante, você pode querer ver informações mais detalhadas sobre os resultados do download do arquivo do participante. Você pode exibir informações detalhadas sobre quantos participantes foram criados e atualizados, bem como informações de erro relacionadas a participantes que não foram carregados a partir da seção Participantes da guia Participantes. Lá, você poderá ver um histórico de alterações nos seus participantes. Essa página abrange as diferentes mensagens que você pode ver após importar, atualizar ou exportar um arquivo de participante.
Exibindo mensagens do participante
Você pode encontrar mensagens de importação, atualização e erro em seu projeto EX.
- Selecione a guia Participantes.
- Navegar para o Participantes da guia Participantes, se você ainda não estiver lá.
- Clique em Ferramentas.
- Selecionar Gerenciar importações / atualizações / exportações.
- Na coluna Status, clique em Exibir resultados.
Qdica: Se o arquivo incluir erros, Exibir resultados será mostrado em vermelho, com um ponto de exclamação ( ” ! ” ). - Visualize seus resultados do arquivo de participantes. Aqui, você poderá visualizar mensagens de êxito, mensagens de erro e seu relatório de erros e baixar.
Advertência: os jobs executados nesta janela só são mantidos por 14 dias após serem iniciados pela primeira vez. Assim que este período tiver passado, esses jobs são eliminados.
Mensagens de êxito
Essas mensagens contêm informações sobre participantes que foram carregados com êxito.
- Atualização da hierarquia com êxito: a hierarquia organizacional foi atualizada com êxito. Esta mensagem conterá o nome da hierarquia que foi atualizada.
Qdica: Esta mensagem só será exibida se uma hierarquia já tiver sido criada.Qdica: Para atualizar uma hierarquia, você deve incluir todos os campos de metadados de hierarquia em seu upload.
- Pessoas analisadas sintaticamente: o número de registros que foram analisados sintaticamente corretamente durante a importação. Estar analisado corretamente significa que o sistema Qualtrics separou com sucesso o arquivo que você carregou em participantes distintos. Se esse número não corresponder ao que foi carregado, provavelmente haverá um problema com o arquivo que você carregou (ou seja, uma mensagem de erro adicional provavelmente apareceria. Consulte Mensagens de erro para mais informações).
- Pessoas já no diretório: o número de participantes em sua importação que já existia em seu diretório de projetos. Neste caso, o diretório refere-se à lista de participantes. Esta é a mesma notificação que as pessoas que já estão no projeto.
- Pessoas já no projeto: o número de participantes em sua importação que já existia em seu diretório de projetos. Esta é a mesma notificação que Pessoas que já estão no diretório.
- Pessoas criadas com êxito: o número de participantes recém-criados no diretório global. Isso indica que um novo participante foi criado no diretório global. Se você estiver usando o importador em um projeto, essa mensagem significa que o novo participante também foi adicionado com êxito ao projeto.
- Pessoas importadas com êxito: o número de participantes adicionados com êxito ao projeto.
- Total de pessoas: o número total de participantes em seu upload de arquivo.
Mensagens de erro
Você receberá uma mensagem de erro se o arquivo carregado não atualizar os participantes. Esta seção inclui as mensagens de erro, bem como algumas dicas de solução de problemas para ajudar você a resolver cada erro.
- Falha ao criar pessoa para o novo usuário: Exibido com uma lista dos identificadores exclusivos para participantes que o importador não conseguiu criar.
- Clique para obter mais informações sobre como resolver esse erro.
- Tente importar novamente. Se o problema persistir, entre em contato com a equipe de suporte com seu arquivo.
- Falha ao criar pessoa para o usuário existente; verifique se essa pessoa já existe com um identificador exclusivo diferente: os identificadores exclusivos que você tentou importar têm nomes de usuário que já existem em seu projeto e no diretório global; no entanto, os participantes existentes com esses nomes de usuário têm IDs exclusivos diferentes dos participantes em sua tentativa de importação. Esta mensagem é exibida com uma lista dos IDs únicos que o importador não conseguiu criar.
- Clique para obter mais informações sobre como resolver esse erro.
- O motivo mais comum pelo qual esse erro ocorre é porque existe uma inconsistência nas colunas UniqueIdentifier e UserName entre sua importação e o que existe atualmente no diretório global.
Exemplo: João Silva é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar João Silva para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seus dados para que o ID exclusivo de John no projeto e no diretório global seja X2, ou ajuste sua importação de arquivo de modo que o código exclusivo do João seja X1.
- Falha ao criar usuário, nome de usuário já em uso: os identificadores exclusivos que você tentou importar têm nomes de usuário que já existem em seu diretório global, mas não existem em seu projeto. No entanto, os participantes do projeto existentes têm códigos exclusivos diferentes dos participantes em sua tentativa de importação. Esta mensagem é exibida com uma lista dos IDs únicos cuja criação falhou.
- Clique para obter mais informações sobre como resolver esse erro.
- O motivo mais comum pelo qual esse erro ocorre é porque existe uma inconsistência nas colunas UniqueIdentifier e UserName entre sua importação e o que existe atualmente no diretório global.
Exemplo: João Silva é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar João Silva para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seus dados para que o ID exclusivo de John no projeto e no diretório global seja X2, ou ajuste sua importação de arquivo de modo que o código exclusivo do João seja X1.
- Falha ao atualizar usuário para a nova pessoa, o nome de usuário já está em uso: identificadores exclusivos não foram atualizados porque as novas IDs exclusivas do seu arquivo têm nomes de usuário existentes. Isso significa que os nomes de usuário já existem em seu diretório e projeto globais, mas cada um deles está anexado a um ID exclusivo diferente, de modo que o participante que você tentou carregar já está associado a metadados diferentes.
- Clique para obter mais informações sobre como resolver esse erro.
- O motivo mais comum pelo qual esse erro ocorre é porque existe uma inconsistência nas colunas UniqueIdentifier e UserName entre sua importação e o que existe atualmente no diretório global.
Exemplo: John Doe é um usuário existente no diretório global e em seu projeto com UniqueIdentifier = X1 e UserName = Y1. Sara é outro participante existente em seu diretório e projeto globais com UniqueIdentifier = X3 e UserName = Y3. No entanto, ao importar o João Silva para o projeto, seu arquivo mostra seu UniqueIdentifier = X2 e UserName =Y3. Você precisa ajustar duas coisas em sua importação:
- Ajuste seu participante de modo que o ID exclusivo de John no diretório global seja X1 ou ajuste sua importação de arquivo de modo que o ID exclusivo dele na lista de participantes seja X2.
- Ajuste o nome de usuário do John de modo que ele corresponda ao que já existe para ele no projeto e diretório global (Y1) – ou altere o Nome de usuário da Sara para algo novo, de modo que o de João possa ser Y3.
- Falha ao atualizar usuário para pessoa existente, nome de usuário já em uso: identificadores exclusivos não foram atualizados porque já existem no projeto e no diretório global, mas têm nomes de usuário diferentes. Os códigos exclusivos são anexados a um participante diferente que já está em seu projeto.
- Clique para obter mais informações sobre como resolver esse erro.
- O motivo mais comum desse erro é porque existe uma inconsistência nas colunas UniqueIdentifier e UserName entre sua importação e o que existe atualmente no diretório global.
Exemplo: João Silva é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar João Silva para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seu participante de modo que o ID exclusivo de João no diretório global seja X2 ou ajustar sua lista de participantes para que o ID exclusivo dele na lista de participantes seja X1. Sua importação deve corresponder ao que está no diretório global.
- Falha ao criar usuário, nome, sobrenome, e-mail ou nome de usuário inválido: os novos identificadores exclusivos de participantes ainda não incluídos em seu projeto incluem uma entrada inválida no campo Nome, Sobrenome, E-mail ou Nome de usuário.
- Clique para obter mais informações sobre como resolver esse erro.
- Motivos comuns para esta mensagem:
- O e-mail ou nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, existe um espaço dentro do e-mail ou nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm um símbolo “at” ( “ @ ” ).
- Um E comercial (” & ” ) foi incluído acidentalmente em um destes campos.
- Seu arquivo tem um campo E-mail ou Nome que é demasiado longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos de metadados têm um máximo de 1000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes).
- Falha ao atualizar usuário para pessoa existente: o nome, sobrenome, e-mail ou nome de usuário é inválido: exibido com uma lista de identificadores exclusivos existentes em seu projeto que têm uma entrada inválida no campo Nome, Sobrenome, E-mail ou Nome de usuário.
- Clique para obter mais informações sobre como resolver esse erro.
- Motivos comuns para esta mensagem:
- O e-mail ou nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, existe um espaço dentro do e-mail ou nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm um símbolo “at” ( ” @ ” ).
- Um E comercial (” & ” ) foi incluído acidentalmente em um destes campos.
- Seu arquivo tem um campo E-mail ou Nome que é demasiado longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos de metadados têm um máximo de 1000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes).
- Falha ao atualizar usuário para a nova pessoa: nome, sobrenome, e-mail ou nome de usuário inválido: o arquivo inclui uma entrada inválida em Nome, Sobrenome ou E-mail. Os identificadores exclusivos têm nomes de usuário existentes, mas ainda não estão em seu projeto.
- Clique para obter mais informações sobre como resolver esse erro.
- Motivos comuns para esta mensagem:
- O e-mail ou nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, existe um espaço dentro do e-mail ou nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm um símbolo “at” ( ” @ ” ).
- Um E comercial (” & ” ) foi incluído acidentalmente em um destes campos.
- Seu arquivo tem um campo E-mail ou Nome que é demasiado longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos de metadados têm um máximo de 1000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes).
- Falha ao inserir no diretório: Esta mensagem é exibida quando um grande número de participantes não foi adicionado ao diretório do projeto e/ou à lista de participantes.
- Clique para obter mais informações sobre como resolver esse erro.
- Procure no seu documento os seguintes problemas:
- O e-mail ou nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, existe um espaço dentro do e-mail ou nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm um símbolo “at” ( ” @ ” ).
- Um E comercial (” & ” ) foi incluído acidentalmente em um destes campos.
- Seu arquivo tem um campo E-mail ou Nome que é demasiado longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos de metadados têm um máximo de 1000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes).Se seu arquivo não incluir nenhum desses problemas e você continuar vendo esta mensagem de erro, entre em contato com o Suporte da Qualtrics e tenha seu arquivo pronto para a equipe solucionar o problema.
- Falha ao inserir no projeto: não foi possível adicionar um grande número de participantes ao projeto.
- Clique para obter mais informações sobre como resolver esse erro.
- Procure no seu documento os seguintes problemas:
- O e-mail ou nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, existe um espaço dentro do e-mail ou nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm um símbolo “at” ( ” @ ” ).
- Um E comercial (” & ” ) foi incluído acidentalmente em um destes campos.
- Seu arquivo tem um campo E-mail ou Nome que é demasiado longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos de metadados têm um máximo de 1000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes).Se seu arquivo não incluir nenhum desses problemas e você continuar vendo esta mensagem de erro, entre em contato com o Suporte da Qualtrics e tenha seu arquivo pronto para a equipe solucionar o problema.
- Falha ao atualizar o conjunto de campos: isso exibe a lista de IDs de conjunto de campos que falharam na atualização durante a importação.
- Clique para obter mais informações sobre como resolver esse erro.
- Se você vir este erro, entre em contato com o Suporte da Qualtrics e tenha seu arquivo pronto para a equipe solucionar o problema.
- Falha ao atualizar respondente / externo: isso exibe os identificadores exclusivos para novos usuários que não puderam ser atualizados durante a importação. Essa mensagem só será exibida se os campos “Externo” e “Entrevistado” forem incluídos em sua importação e se um grande número dos valores que você inseriu para esses campos falhar.
- Clique para obter mais informações sobre como resolver esse erro.
- Tente importar novamente. Se o problema persistir, entre em contato com o Suporte da Qualtrics e disponibilize seu arquivo para a equipe solucionar o problema.
- Falha ao atualizar a hierarquia organizacional: exibe uma lista de IDs de hierarquia organizacional que não puderam ser atualizados durante o trabalho de importação.
- Clique para obter mais informações sobre como resolver esse erro.
- O motivo mais comum para essa falha é um erro com os metadados da hierarquia organizacional que você está carregando. Por exemplo, se você adicionar metadados que criam uma dependência circular em seu arquivo (ou seja, você tem participantes relatando a alguém que está listado abaixo deles na hierarquia), a atualização será rejeitada.
- Falha ao atualizar pessoa: ocorreu um erro ao tentar atualizar o e-mail ou o nome de um participante existente.
- Clique para obter mais informações sobre como resolver esse erro.
- A causa mais comum para essa mensagem de erro é que o arquivo carregado tem um campo de e-mail ou nome que é demasiado longo.
Qdica: atualmente, os campos de e-mail e nome têm um máximo de 50 bytes, enquanto os campos de metadados normais têm um máximo de 1000 bytes (em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes). Se os campos de e-mail e nome estiverem abaixo deste limite, tente importar novamente ou entre em contato com o Suporte da Qualtrics.
- Total de registros sem Identificador exclusivo, Nome ou Sobrenome: isso exibe o número total de registros que não têm dados preenchidos para esses três campos.
- Clique para obter mais informações sobre como resolver esse erro.
- Revise seu arquivo de importação e procure uma linha que esteja em branco em qualquer um desses três campos. Assim que você encontrar o campo em branco, preencha-o e tente importar novamente.
- Pessoas sem nome ou sobrenome: o número de registros sem esses campos.
- Clique para obter mais informações sobre como resolver esse erro.
- Revise seu arquivo de importação para garantir que esses campos estão preenchidos e tente importar novamente.
- Total de registros sem identificador exclusivo: isso exibe o número de registros que não têm um identificador exclusivo.
- Clique para obter mais informações sobre como resolver esse erro.
- Revise seu arquivo de importação e certifique-se de que os identificadores exclusivos sejam preenchidos para todos os registros.
Qdica: isso só é relevante para organizações que migraram para identificadores exclusivos.
- Total de registros com comprimento de cabeçalho não correspondente: o número de registros que tiveram um comprimento de cabeçalho não correspondente durante a importação.
- Clique para obter mais informações sobre como resolver esse erro.
- Esse erro geralmente é causado por um arquivo CSV formatado incorretamente. Por exemplo, isso pode acontecer se você tinha um arquivo CSV com 10 cabeçalhos, mas uma das linhas só tinha 9 colunas. Normalmente, copiar seus dados para uma nova folha e gravar como um arquivo CSV irá resolver esse problema.
- Pessoas sem usuário associado: o participante existe no diretório, mas não existe na guia Usuários. Por esse motivo, o participante não pode ser adicionado ao projeto.
- Clique para obter mais informações sobre como resolver esse erro.
- Verifique se o indivíduo existe no diretório global e tente importar novamente.
- Pessoas com tipo de usuário inválido: o número de participantes em sua importação que têm um tipo de usuário inválido.
- Clique para obter mais informações sobre como resolver esse erro.
- Essa mensagem aparece mais comumente porque uma lista de participantes foi atualizada com a coluna de tipo de usuário e o tipo de usuário “UT_BRANDADMIN” foi adicionado. Remova “UT_BRANDADMIN” de qualquer participante que tenha esse valor incluído e recarregue seu arquivo.
- Total de registros contendo caracteres inválidos: isso exibe o número de registros que contêm um caractere inválido.
- Clique para obter mais informações sobre como resolver esse erro.
- Procure seu arquivo, substitua caracteres inválidos e tente carregar novamente.
Qdica: o caractere inválido mais comum é o uso de chaves ( “{ }” ).
- Falha ao atualizar metadados da pessoa: este erro exibe uma lista de IDs exclusivos para participantes com metadados que não foram atualizados durante uma tarefa de importação.
- Clique para obter mais informações sobre como resolver esse erro.
- Um motivo comum para essa mensagem de erro acontece quando você carrega um participante que tem valores de metadados com mais de 1000 caracteres.
Another common reason is that the user trying to upload participants doesn’t have the data access role required to make edits to that metadata.
If neither of these solutions work, then reach out to Qualtrics Support.
- Failure_FailedToUpdatePerson_CannotUpdateHigherThanEXAdmin: este erro exibe uma lista de identificadores exclusivos para administradores de marca que o importador não atualizou.
- Clique para obter mais informações sobre como resolver esse erro.
- Essa mensagem de erro geralmente é exibida para administradores EX e outros administradores do projeto. Se você não for um Administrador da marca por conta própria, não poderá atualizar os dados pessoais (nome, e-mail, tipo de usuário etc.) de outros Administradores da marca por meio de uma importação. Verifique se os dados pessoais dos Administradores da marca em seu arquivo correspondem ao que é exibido para eles na guia Participantes e tente importar novamente.
Relatório de erros e download
Por vezes, podem existir erros no arquivo que você tenta importar. Estes são problemas presentes no próprio arquivo e eles não se conectam ao diretório global. Se você tiver alguma dúvida sobre esses tipos de erros, visite Importando participantes do engajamento e do ciclo de vida.