Carregar usuários na tarefa do diretório CX

Sobre a tarefa Carregar usuários no diretório CX

A tarefa Carregar usuários no diretório CX é usada para salvar dados de usuário CX no Qualtrics. Esta tarefa permite que você mantenha seus dados de usuário CX atualizados regularmente. Para usar esta tarefa, você deve primeiro carregar dados no Qualtrics usando uma tarefa do extrator de dados.

Configuração de uma tarefa de carregamento de usuários no diretório CX

1. Se esta for sua primeira vez usando essa tarefa, verifique se você tem acesso a identificadores exclusivos e ao administrador de usuários CX.
2. Clique no menu de navegação no canto superior esquerdo.
   
3. Vá para Workflows.
4. Clique em Criar um fluxo de trabalho.
5. Determine se o workflow deve ser Iniciado quando um evento é recebido (ou seja, baseado em eventos) ou Iniciado em um momento específico (ou seja, programado). Para uma comparação dessas opções, consulte Fluxos de trabalho programados vs. Workflow baseado em eventos. Na maioria das vezes, você usará um workflow programado.
6. Se desejar, renomeie seu fluxo de trabalho.
   
7. Se estiver utilizando um workflow programado, determine quando o workflow é executado. Se for utilizado um workflow baseado em eventos, determine o evento que inicia o workflow.
8. Clique no sinal de mais ( + ), selecione Tarefa e escolha a tarefa de extração de dados que importa dados para o Qualtrics. Você deve configurar primeiro uma tarefa de extração de dados antes de poder usar a tarefa Carregar usuários no diretório CX. Consulte o uso de tarefas de fluxos de trabalho para criar fluxos de trabalho de ETL para obter mais informações. Sua tarefa deve importar os seguintes campos: Identificador exclusivo, Nome, Sobrenome e E-mail.
   Qdica: recomendamos o uso da tarefa de extração de dados de arquivos SFTP. O arquivo de exemplo de dados do usuário está configurado para utilização com esta tarefa.
   Qdica: Há um tamanho máximo de arquivo de 100 MB.
   Qdica: se sua organização usa SSO, inclua uma coluna Nome de usuário a ser preenchida com os valores do Active Directory que você está transferindo para o atributo username. O #brandID será anexado ao nome de usuário automaticamente ao carregar o arquivo. Se sua organização não usa SSO, esta coluna geralmente deve corresponder à coluna de e-mail.
9. Após configurar sua tarefa de extração, clique no sinal de mais ( + ) e selecione Tarefa.
   
10. Selecione a tarefa Carregar usuários no diretório CX.
    
11. Selecione a tarefa de extração de dados que você configurou anteriormente.
    
12. Comece mapeando seus campos de dados importados para atributos de usuário CX usando os menus suspensos. Os campos marcados com um asterisco são obrigatórios. Você também pode mapear campos por meio de um upload de arquivo.
    Qdica: por padrão, todos os atributos de usuário CX existentes em sua licença serão incluídos no seu mapeamento. Você pode remover quaisquer campos desnecessários clicando em Excluir linha no menu Opções ao lado do campo.
    Qdica: Se os nomes de campo do seu campo de origem e do diretório CX corresponderem exatamente, eles serão mapeados automaticamente para você!
13. Se necessário, você pode mapear valores individuais para cada campo clicando em Mapear valores. Isso é útil se você deseja usar valores de dados diferentes no Qualtrics. Consulte Mapeamento de campos e valores para obter mais informações sobre o mapeamento de valores individuais.
    Exemplo: em nosso arquivo de dados importados, temos o valor “Europa”, mas queremos que ele seja salvo como “EMEA” na Qualtrics. Isso pode ser efetuado mapeando valores.
14. Você pode remover quaisquer campos desnecessários clicando em Excluir linha ao lado do campo.
    Qdica: Você deve remover todos os atributos de usuário CX não mapeados.
15. Se necessário, clique em Adicionar campo para adicionar campos adicionais ao seu mapeamento. Ao adicionar um novo campo, você pode mapear para um atributo de usuário CX existente ou criar um novo.
    Qdica: Ao criar um novo campo, você deve dar um nome ao campo. Tenha cuidado ao nomear seu campo, pois você não pode editá-lo ou excluí-lo sem entrar em contato com o administrador da marca.
    
16. Se sua licença tiver o SSO ativado, você poderá ativar Importar como usuários de SSO para importar esses usuários com o nome de usuário SSO. Isso permitirá que o usuário acesse a Qualtrics via SSO.
17. Quando terminar, clique em Salvar.
    Qdica: A tarefa não permitirá que você salve se o mapeamento estiver incompleto. Se o botão Salvar estiver acinzentado, verifique novamente seu mapeamento.
18. Ative seu workflow.
    

Quando o fluxo de trabalho é executado, seus usuários são importados para o Qualtrics e salvos no administrador de usuários CX.

Mapeamento de campos e valores

Ao configurar essa tarefa, você pode mapear seus campos de dados importados por meio de um upload de arquivo. Esta seção aborda como mapear campos e valores de campo individuais utilizando um arquivo.

Mapeamento de campos

1. Ao configurar a tarefa, clique em Fazer download de um mapeamento de amostra. Abra este arquivo em um editor de planilha eletrônica em seu computador.
2. Adicione seus mapeamentos de campos usando o arquivo descarregado como modelo. Ao criar seu arquivo de mapeamento, considere o seguinte:
   
   • Cada coluna no arquivo é 1 mapeamento de campos.
   • O valor na primeira célula da coluna é o nome do campo de origem.
   • O valor na segunda célula da coluna é o nome do campo Qualtrics.
   • Seu arquivo não pode exceder 100MB.
   • Salve seu arquivo como um arquivo CSV.
3. Na tarefa na Qualtrics, clique em Carregar arquivo e escolha o arquivo de mapeamentos em seu computador.
4. Em seguida, você pode ajustar manualmente seus mapeamentos e mapear valores de campo individuais.

Mapeando valores

1. Depois de mapear seus campos, clique no menu Opções ao lado de um campo e selecione Mapear valores.
2. Clique em Fazer download do modelo CSV.
   
3. Adicione seus mapeamentos de valores usando o arquivo baixado como modelo. Não exclua os cabeçalhos “de” e “até”. Ao criar seu arquivo de mapeamento, considere o seguinte:
   • Os valores de campo importados devem ir para a coluna “de”.
   • Os valores de campo que você deseja salvar na Qualtrics devem ir na coluna “para”.
   • Você pode incluir até 1000 mapeamentos em seu arquivo.
   • Salve seu arquivo como um arquivo CSV.
4. Na tarefa, clique em Carregar arquivo e escolha seu arquivo de mapeamentos.
5. Por padrão, os valores em branco não são importados. Se você quiser que os valores em branco sejam importados como algo, ative Mapear valores em branco para um valor padrão e, em seguida, especifique o valor na caixa Valor padrão.
   
   Exemplo: digamos que estou importando funcionários e temos um campo para “Localização do escritório”. Alguns empregados são remotos e, por isso, não têm um valor para este campo. Em vez de ignorar este campo para funcionários sem um valor, posso especificar um valor diferente, como “Remoto” a ser importado para esses funcionários.
6. Se necessário, você pode ajustar manualmente seus mapeamentos digitando nas caixas apropriadas.
7. Você pode adicionar valores adicionais manualmente clicando em Adicionar linha.
8. Para remover um mapeamento, clique no sinal negativo ( – ) à direita do mapeamento.
9. Ao terminar, clique em Concluído.

Dicas de Solução de Problemas

Esta seção aborda problemas comuns que podem aparecer ao configurar esta tarefa.

• Depois de selecionar a tarefa, você poderá ver o erro Diretório não encontrado. Tente recarregar a página. Este erro é exibido se sua licença não tiver acesso ao administrador de usuários CX. Para habilitar o administrador de usuários CX, entre em contato com seu gerenciador de sucesso do XM.
• Depois de selecionar a tarefa, você poderá ver que o erro ID único precisa ser ativado para usar essa extensão. Este erro é exibido quando a sua licença não tem identificadores exclusivos. Para habilitar identificadores exclusivos, entre em contato com seu gerente XM Success.
• Se o botão Salvar estiver acinzentado, isso significa que seu mapeamento não foi concluído. Certifique-se de que todos os campos incluídos na tarefa estão completamente mapeados.

Perguntas frequentes