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. Criar um fluxo de trabalho ETL.
2. Selecione Fonte de dados (extrator ETL). Nesta etapa, você extrairá dados que pode carregar para outro destino. Consulte usando Criação de fluxos de trabalho ETL para obter mais informações. Sua tarefa deve importar os seguintes campos:
   
   • Identificador exclusivo
   • FirstName
   • LastName
   • 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.
3. Clique em Adicionar um destino de dados.
   
4. Selecione a tarefa Carregar usuários no diretório CX.
   
5. Selecione a tarefa de extração de dados que você configurou anteriormente.
   
6. 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ê!
7. 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.
8. 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.
9. 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.
   
10. 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.
11. 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.
12. 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.
• All fields must be added to the task in order for them to be updated. If a field is not added via Mapping Fields and Values, it will not be added or updated.

Perguntas frequentes