Importação, atualização e exportação de mensagens Participante (EX)
Qdica: Esta página descreve a funcionalidade disponível para projetos de pesquisa de envolvimento, ciclo de vida e Colaborador ad hoc. Para obter mais detalhes sobre cada um deles, consulte Tipos de Projetos experiência dos colaboradores, Employee Experience. Essa funcionalidade também está disponível no Pulse, embora com algumas diferenças detalhadas aqui.
Sobre o Participante Importar, Atualizar e Exportar Mensagens
Às vezes, depois de importar, atualizar ou exportar um arquivo de participante, você pode querer ver informações mais detalhadas sobre os resultados do download do arquivo de participante. É possível visualizar informações detalhadas sobre quantos participantes foram criados e atualizados, bem como informações de erro relacionadas a participantes que não conseguiram fazer upload na seção Participants (Participantes ) da guia Participants (Participantes ). Lá, você poderá ver um histórico de alterações em seus participantes. Esta página aborda as diferentes mensagens que você pode ver após importar, atualizar ou exportar um arquivo de participante.
Visualização das mensagens Participante
Você pode encontrar mensagens de importação, atualização e erro em seu projeto EX.
- Selecione a guia Participantes.
- Navegue para a guia Participantes na seção Participantes da guia Participantes, se ainda não estiver lá.
- Clique Ferramentas.
- Selecionar Gerenciar importações / atualizações / exportações.
- Na coluna Status , clique em View Resultados.
Qdica: se o seu arquivo contiver erros, View Resultados será exibido em vermelho, com um ponto de exclamação ( ” ! ” ). - Visualizar seu arquivo de participante Resultados. Aqui, você poderá ver as mensagens de sucesso, as mensagens de erro, o relatório de erros e o download.
Aviso: Os trabalhos executados nessa janela são retidos apenas por 14 dias após serem iniciados pela primeira vez. Após esse período, esses trabalhos são excluídos.
Mensagens de sucesso
Essas mensagens contêm informações sobre os participantes que foram carregados com sucesso.
- A atualização Hierarquia foi bem-sucedida: A hierarquia organizacional foi atualizada com sucesso. Essa mensagem conterá o nome da hierarquia que foi atualizada.
Qdica: essa mensagem só será exibida se uma hierarquia já tiver sido criada.Qdica: para atualizar uma hierarquia, você deve incluir todos os campos metadados hierarquia em seu upload.
- Pessoas analisadas: O número de registros que foram analisados corretamente durante a importação. Ser analisado corretamente significa que o sistema Qualtrics separou com sucesso o arquivo que você enviou em participantes distintos. Se esse número não corresponder ao que foi carregado, provavelmente há um problema com o arquivo que você carregou (ou seja, uma mensagem de erro adicional provavelmente será exibida). Consulte Mensagens de erro para obter mais informações).
- Persons already in diretório Pessoas já no diretório ): O número de participantes da sua importação que já existiam no diretório do seu projeto. Nesse caso, diretório se refere à lista participante. Essa é a mesma notificação que as pessoas que já estão no projeto.
- Pessoas que já estão no projeto: O número de participantes em sua importação que já existiam no diretório do projeto. Essa é a mesma notificação que as pessoas que já estão no diretório.
- Pessoas criadas com sucesso: O número de participantes que foram criados recentemente 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 sucesso: O número de participantes que foram adicionados com sucesso 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 conseguir atualizar os participantes. Esta seção inclui as mensagens de erro, bem como algumas dicas de solução de problemas para ajudá-lo a resolver cada erro.
- Falha ao criar uma pessoa para o novo usuário: Exibido com uma lista dos identificadores exclusivos dos participantes que o importador não conseguiu criar.
- Clique para obter mais informações sobre como solucionar esse erro.
- Tente novamente a importação. Se o problema persistir, entre em contato com a equipe de suporte com o seu arquivo.
- Falha ao criar uma pessoa para um 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 no 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 na sua tentativa de importação. Essa mensagem é exibida com uma lista das IDs exclusivas que o importador não conseguiu criar.
- Clique para obter mais informações sobre como solucionar esse erro.
- O motivo mais comum para a ocorrência desse erro é que há uma incompatibilidade nas colunas UniqueIdentifier e UserName entre a sua importação e o que existe atualmente no diretório global.
Exemplo: John Doe é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar John Doe para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seus dados para que o ID exclusivo do John no projeto e no diretório global seja X2ou ajuste a importação do arquivo para que a ID exclusiva do John seja X1.
- Falha ao criar usuário, o nome de usuário já está em uso: Os identificadores exclusivos que você tentou importar têm nomes de usuário que já existem no seu diretório global, mas não existem no seu projeto. No entanto, os participantes do projeto existente têm IDs exclusivos diferentes dos participantes em sua tentativa de importação. Essa mensagem é exibida com uma lista das IDs exclusivas que não foram criadas.
- Clique para obter mais informações sobre como solucionar esse erro.
- O motivo mais comum para a ocorrência desse erro é que há uma incompatibilidade nas colunas UniqueIdentifier e UserName entre a sua importação e o que existe atualmente no diretório global.
Exemplo: John Doe é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar John Doe para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seus dados para que o ID exclusivo do John no projeto e no diretório global seja X2ou ajuste a importação do arquivo para que a ID exclusiva do John seja X1.
- Falha ao atualizar o usuário para uma nova pessoa, o nome de usuário já está em uso: Os identificadores exclusivos não foram atualizados porque os novos IDs exclusivos do seu arquivo têm nomes de usuário existentes. Isso significa que os nomes de usuário já existem no seu projeto e diret ório diretório global, mas cada um deles está associado a um ID exclusivo diferente, portanto, o participante que você tentou carregar já está associado a metadados diferentes.
- Clique para obter mais informações sobre como solucionar esse erro.
- O motivo mais comum para a ocorrência desse erro é que há uma incompatibilidade nas colunas UniqueIdentifier e UserName entre a sua importação e o que existe atualmente no diretório global.
Exemplo: John Doe é um usuário existente no diretório global e no seu projeto com UniqueIdentifier = X1 e UserName = Y1. Sara é outro participante existente em seu projeto e diretório global com UniqueIdentifier = X3 e UserName = Y3. No entanto, ao importar John Doe para o projeto, o arquivo mostra o UniqueIdentifier = X2 e o UserName =Y3. Você precisa ajustar dois aspectos em sua importação:
- Ajuste seu participante para que o ID exclusivo de John no diretório global seja X1 ou ajuste a importação do arquivo para que o ID exclusivo dele na lista participante seja X2.
- Ajuste o nome de usuário de John para que corresponda ao que já existe para ele no projeto e no diretório global (Y1) – ou altere o nome de usuário de Sara para algo novo, para que o de John possa ser Y3.
- Falha ao atualizar o usuário de uma pessoa existente, pois o nome de usuário já está em uso: Os identificadores exclusivos não foram atualizados porque eles já existem no projeto e no diretório global, mas têm nomes de usuário diferentes. Os IDs exclusivos são anexados a um participante diferente que já está em seu projeto.
- Clique para obter mais informações sobre como solucionar esse erro.
- O motivo mais comum para a ocorrência desse erro é que há uma incompatibilidade nas colunas UniqueIdentifier e UserName entre a sua importação e o que existe atualmente no diretório global.
Exemplo: John Doe é um usuário existente no diretório global com UniqueIdentifier = X1 e UserName = Y1. No entanto, ao importar John Doe para o projeto, seu arquivo mostra que seu UniqueIdentifier = X2 e UserName = Y1. Você precisa ajustar seu participante para que o ID exclusivo de John no diretório global seja X2 ou ajustar sua lista participante para que o ID exclusivo dele na lista participante seja X1. Sua importação deve corresponder ao que está no diretório global.
- Falha ao criar o usuário, o nome, o sobrenome, o e-mail ou o nome de usuário é inválido: Os novos identificadores exclusivos de participantes que ainda não estão 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 solucionar esse erro.
- Motivos comuns para essa mensagem:
- O e-mail ou o nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, há um espaço no e-mail ou no nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm o símbolo “at” ( ” @ ” ).
- Um e comercial ( ” & ” ) foi acidentalmente incluído em um desses campos.
- Seu arquivo tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos metadados têm um máximo de 1.000 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 o usuário de uma pessoa existente: o nome, o sobrenome, o e-mail ou o nome de usuário são inválidos: 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 solucionar esse erro.
- Motivos comuns para essa mensagem:
- O e-mail ou o nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, há um espaço no e-mail ou no nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm o símbolo “at” ( ” @ ” ).
- Um e comercial ( ” & ” ) foi acidentalmente incluído em um desses campos.
- Seu arquivo tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos metadados têm um máximo de 1.000 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 o usuário para uma nova pessoa: o nome, o sobrenome, o e-mail ou o nome de usuário são inválidos: O arquivo inclui uma entrada inválida no nome, sobrenome ou e-mail. Os identificadores exclusivos têm nomes de usuário existentes, mas ainda não estão no seu projeto.
- Clique para obter mais informações sobre como solucionar esse erro.
- Motivos comuns para essa mensagem:
- O e-mail ou o nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, há um espaço no e-mail ou no nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm o símbolo “at” ( ” @ ” ).
- Um e comercial ( ” & ” ) foi acidentalmente incluído em um desses campos.
- Seu arquivo tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos metadados têm um máximo de 1.000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes.)
- Failed to insert into diretório Falha ao inserir no diretório ): Essa mensagem é exibida se um grande número de participantes não tiver sido adicionado ao diretório do projeto e/ou à lista participante.
- Clique para obter mais informações sobre como solucionar esse erro.
- Pesquise em seu documento os seguintes problemas:
- O e-mail ou o nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, há um espaço no e-mail ou no nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm o símbolo “at” ( ” @ ” ).
- Um e comercial ( ” & ” ) foi acidentalmente incluído em um desses campos.
- Seu arquivo tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos metadados têm um máximo de 1.000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes.)Se o seu arquivo não incluir nenhum desses problemas e você continuar a ver essa mensagem de erro, entre contato suporte da Qualtrics e tenha seu arquivo pronto para que a equipe possa solucionar o problema.
- Falha ao inserir no projeto: Um grande número de participantes não conseguiu ser adicionado ao projeto.
- Clique para obter mais informações sobre como solucionar esse erro.
- Pesquise em seu documento os seguintes problemas:
- O e-mail ou o nome de usuário associado ao usuário está formatado incorretamente. Muitas vezes, há um espaço no e-mail ou no nome de usuário (por exemplo, “jane doe@test.com”), ou eles não têm o símbolo “at” ( ” @ ” ).
- Um e comercial ( ” & ” ) foi acidentalmente incluído em um desses campos.
- Seu arquivo tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos E-mail e Nome têm um máximo de 50 bytes, enquanto outros campos metadados têm um máximo de 1.000 bytes. (Em geral, um byte é igual a um caractere. No entanto, alguns caracteres chineses, coreanos e japoneses podem ter até três bytes.)Se o seu arquivo não incluir nenhum desses problemas e você continuar a ver essa mensagem de erro, entre contato suporte da Qualtrics e tenha seu arquivo pronto para que a equipe possa solucionar o problema.
- Falha ao atualizar fieldset: exibe a lista de IDs fieldset que não foram atualizados durante a importação.
- Clique para obter mais informações sobre como solucionar esse erro.
- Se esse erro ocorrer, entre contato suporte da Qualtrics e tenha seu arquivo pronto para que a equipe possa solucionar o problema.
- Falha ao atualizar externo/respondente: Exibe osidentificadores exclusivos de novos usuários que não foram atualizados durante a importação. Essa mensagem só aparecerá se os campos “External” (Externo) e “Respondent” (Respondente) estiverem incluídos na importação e se um grande número de valores inseridos para esses campos falhar.
- Clique para obter mais informações sobre como solucionar esse erro.
- Tente novamente a importação. Se o problema persistir, entre contato suporte da Qualtrics e tenha seu arquivo pronto para que a equipe possa solucionar o problema.
- Failed to update Org Hierarquia (Falha na atualização da hierarquia hierarquia organizacional ): Exibe uma lista de IDs de hierarquia da organização que não foram atualizados durante o trabalho de importação.
- Clique para obter mais informações sobre como solucionar esse erro.
- O motivo mais comum para essa falha é um erro com os metadados da Hierarquia da organização que você está carregando. Por exemplo, se você adicionar metadados que criem uma dependência circular em seu arquivo (ou seja, você tem participantes que se reportam a alguém que está listado abaixo deles na hierarquia), a atualização será rejeitada.
- Falha ao atualizar a 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 solucionar esse erro.
- A causa mais comum para essa mensagem de erro é que o arquivo carregado tem um campo de e-mail ou nome muito longo.
Qdica: atualmente, os campos de e-mail e nome têm um máximo de 50 bytes, enquanto os campos metadados normais têm um máximo de 1.000 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 desse limite, tente novamente a importação ou contato suporte da Qualtrics.
- Total de registros sem identificador exclusivo, nome ou sobrenome: 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 solucionar esse erro.
- Revise seu arquivo de importação e procure uma linha que esteja em branco em qualquer um desses três campos. Quando você encontrar o campo em branco, preencha-o e tente novamente a importação.
- Pessoas sem Nome ou Sobrenome: O número de registros sem esses campos.
- Clique para obter mais informações sobre como solucionar esse erro.
- Revise seu arquivo de importação para garantir que esses campos estejam preenchidos e, em seguida, tente novamente a importação.
- Total de registros sem identificador exclusivo: Exibe o número de registros que não possuem um identificador exclusivo.
- Clique para obter mais informações sobre como solucionar esse erro.
- Revise o arquivo de importação e certifique-se de que os identificadores exclusivos estejam 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 incompatível: O número de registros que tiveram um comprimento de cabeçalho incompatível durante a importação.
- Clique para obter mais informações sobre como solucionar esse erro.
- Esse erro geralmente é causado por um arquivo CSV mal formatado. Por exemplo, isso poderia acontecer se você tivesse um arquivo CSV com 10 cabeçalhos, mas uma das linhas tivesse apenas 9 colunas. Normalmente, copiar os dados em uma nova planilha e salvá-los como um arquivo CSV 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 solucionar 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 na sua importação que têm um tipo de usuário inválido.
- Clique para obter mais informações sobre como solucionar esse erro.
- Essa mensagem geralmente aparece porque uma lista participante foi atualizada com a coluna de tipo de usuário e o tipo de usuário “UT_BRANDADMIN” foi adicionado. Remova “UT_BRANDADMIN” de todos os participantes que tenham esse valor incluído e faça o upload do arquivo novamente.
- Total de registros contendo caracteres inválidos: Exibe o número de registros que contêm um caractere inválido.
- Clique para obter mais informações sobre como solucionar esse erro.
- Pesquise seu arquivo, substitua os caracteres inválidos e tente fazer o upload novamente.
Qdica: o caractere inválido mais comum é o uso de colchetes (“{ }“).
- Falha ao atualizar metadados da pessoa: Esse erro exibe uma lista de IDs exclusivos para participantes com metadados que não foram atualizados durante um trabalho de importação.
- Clique para obter mais informações sobre como solucionar esse erro.
- Um motivo comum para essa mensagem de erro ocorre quando você faz upload de um participante que tem valores metadados com mais de 1.000 caracteres.
Outro motivo comum é que o usuário que está tentando fazer upload de participantes não tem a função de acesso a dados necessária para fazer edições nesses metadados.
Se nenhuma dessas soluções funcionar, entre em contato com o suporte da Qualtrics.
- Failure_FailedToUpdatePerson_CannotUpdateHigherThanEXAdmin: Esse erro exibe uma lista de identificadores exclusivos para administradores Marca que o importador não conseguiu atualizar.
- Clique para obter mais informações sobre como solucionar esse erro.
- Essa mensagem de erro aparece com frequência para administradores EX e outros administradores de projeto. Se você não for um Marca Admin, não poderá atualizar os dados pessoais (nome, e-mail, tipo de usuário etc.) de outros Marca Admins por meio de uma importação. Verifique se os dados pessoais dos Marca Administrators em seu arquivo correspondem ao que é exibido para eles na guia Participants (Participantes ) e, em seguida, tente novamente a importação.
Relatório de erros e download
Às vezes, pode haver erros no arquivo que você tenta importar. Esses são problemas presentes no próprio arquivo e não se conectam ao diretório global. Se você tiver alguma dúvida sobre esses tipos de erros, visite Importing Engagement & Lifecycle Participants (Importando participantes do engajamento e do ciclo de vida).