Conector de saída da Qualtrics

Sobre o Conector de saída Qualtrics

O conector de saída do Qualtrics permite que você execute as seguintes ações em sua conta do Qualtrics:

• Acionador um evento fluxo de trabalho JSON e use os dados XM Discover nos fluxos de trabalho do Qualtrics.
• Exporte respostas com enriquecimentos do XM Discover do XM Discover e importe-as para um conjunto de dados pesquisa do Qualtrics.

Requisitos

Antes de configurar a conexão, você precisará das seguintes informações da sua conta Qualtrics:

• Seu ID do centro de dados Qualtrics.
• Seu token de API do Qualtrics .
• Seu ponto de extremidade API exportação XM Discover.

Trabalhos Evento JSON

Para acionador um evento JSON com o Qualtrics Outbound Connector, você precisará do endpoint do evento JSON. Você pode copiar o endpoint clicando em Copiar URL ao editar o evento JSON em seu fluxo de trabalho Qualtrics.

Trabalho de exportação de Respostas

Se estiver exportando respostas para um conjunto de dados pesquisa Qualtrics, é preciso garantir que os dados atendam aos seguintes requisitos:

• O conjunto de dados do seu pesquisa deve ter campos que correspondam aos enriquecimentos XM Discover que você deseja exportar. Se esses campos não existirem, você poderá adicioná-los como dados integrados ou criá-los usando campos personalizados.
• Os documentos que você exporta do XM Discover devem ter um campo que corresponda à ID do pesquisa para o qual você deseja importar respostas.

Criação de um trabalho de conector de saída Qualtrics

1. Na página Jobs, clique em New Job (Novo trabalho).
   
2. Selecione o conector Qualtrics Outbound.
   
3. Dê um nome ao seu trabalho para que você possa identificá-lo.
   
4. Escolha o projeto para carregar os dados.
5. Faça uma descrição do seu trabalho para que você saiba o propósito dele.
6. Clique em Seguinte.
7. Escolha o tipo de dados Qualtrics que você deseja exportar:
   
   • Pesquisa: Exportação de dados de resposta para importação em um conjunto de dados pesquisa.
   • Evento JSON : Exportar dados para acionador um evento fluxo de trabalho JSON.
8. Clique em Seguinte.
9. Use o menu suspenso para selecionar uma conexão Qualtrics existente ou selecione Add New para criar uma nova.
   
   Qdica: para editar ou remover uma conexão existente, acesse configurações da conta sua conta.
10. Ao adicionar uma nova conexão, forneça o seguinte:
    • Nome da conexão: Dê um nome à conexão para que você possa identificá-la posteriormente.
    • Qualtrics Datacenter ID: Digite o ID do seu centro de dados Qualtrics.
    • Token API Qualtrics: Digite o token de API de API de sua conta Qualtrics .
11. Se você quiser que a conexão expire após um período de tempo, ative a opção Send Expiration Notifications (Enviar notificações de expiração ). Use o campo Expiration Date (Data de expiração ) para escolher quando as credenciais expiram. Na caixa Dias antes da expiração, digite com que antecedência você gostaria de ser notificado sobre a expiração da conexão, até 100 dias.
12. Clique em Seguinte.
13. Forneça seu endpoint API exportação XM Discover .
    
14. Clique em Seguinte.
15. Escolha o nível de dados que você deseja exportar:
    
    • Sentenças: Use dados em nível de sentença.
    • Documentos: Use dados em nível de documento.
      Qdica: as etapas restantes na página Query Configuration (Configuração de consulta) são opcionais e o ajudarão a restringir os dados exportados.
16. Forneça umaconsultade pesquisa para filtro os dados de saída. Use a mesma sintaxe usada para procurar dados no Designer. Deixe esse campo vazio para incluir todos os dados.
    Exemplo: É possível especificar um ou mais IDs pesquisa para atualizar apenas os registros de pesquisa selecionados usando a seguinte sintaxe: surveyid:sv_01
17. Digite o nome do filtro do seu projeto que você gostaria que fosse aplicado aos dados de saída. Deixe esse campo em branco se não quiser filtro seus dados.
18. Escolha os registros que deseja importar:
    • Carregar novos registros: Registros que foram criados desde a última vez que o trabalho de saída foi executado.
    • Carregar registros novos e atualizados: Registros que foram criados ou atualizados desde a última vez que o trabalho de saída foi executado.
    • Carregar registros atualizados: Registros que foram atualizados desde a última vez que o trabalho de saída foi executado.
19. Use o menu suspenso para escolher quais modelos de classificação você deseja incluir em seus dados. Marque a caixa de seleção All Models (Todos os modelos ) para incluir os dados de classificação de todos os modelos disponíveis no projeto.
20. Selecione como você deseja que as classificações afetem a filtragem de dados:
    • Ignorar: Nenhuma filtragem é aplicada com base no(s) modelo(s) selecionado(s).
    • Atualmente classificado: Retorna os registros que foram classificados pelo(s) modelo(s) selecionado(s) durante a execução de classificação mais recente.
    • Sempre classificado: Retorna os registros que foram classificados pelo(s) modelo(s) selecionado(s) em qualquer momento.
21. Escolha as opções adicionais de exportação que você gostaria de usar:
    • Se deve retornar IDs de categoria (true) em vez de nomes de categoria (false): Exportar IDs de categoria em vez de nomes de categoria
    • Filtra resultados aplicando a consulta filtro com todos os caminhos dos nós folha: Adiciona vários modelos com o parâmetro “leaf_only flag” à chamada API Export.
    • Ignorar valores vazios: Ignore a atualização de um documento pesquisa se todos os seus valores de saída estiverem vazios.
22. Clique em Seguinte.
23. A avançar etapa depende se você está exportando dados pesquisa ou enviando dados para um ponto de extremidade JSON para acionador um fluxo de trabalho:
    • Pesquisa: Escolha a pesquisa para a qual deseja exportar os dados e clique em Avançar.
      
      Em seguida, selecione o atributo XM Discover que contém o ID Pesquisa Qualtrics.
      
      Qdica: somente os documentos com ID pesquisa que correspondam à pesquisa selecionada na etapa anterior serão atualizados.
    • Evento JSON : Insira o ponto de extremidade JSON do evento JSON.
      
24. Mapeie os campos do XM Discover para o Qualtrics. Clique na caixa vazia e escolha o atributo XM Discover que você gostaria de enviar para o Qualtrics.
    
25. Selecione o tipo de dados como o qual o campo deve ser exportado, que corresponde ao tipo de variável dados integrados do campo no Qualtrics:
    
    • Não mapear: Nenhum tipo de variável especificado.
    • Atributo de número: tipo de variável número.
    • Atributo de texto: tipo de variável de conjunto de texto.
    • Atributo Date : tipo de variável Date.
    • Verbatim: tipo de variável texto.
26. Digite o nome do campo incorporado do Qualtrics que deve ser preenchido com os valores do atributo XM Discover selecionado.
27. Use os sinais de mais ( + ) e menos ( – ) para adicionar e remover campos conforme necessário.
28. Clique em Seguinte.
29. Se desejar, você pode adicionar um filtro de conector para filtro os dados de entrada e limitar os dados importados.
    
30. Também é possível limitar o número de registros importados em um único trabalho inserindo um número na caixa Specify Record Limit (Especificar limite de registros ). Digite “All” se quiser importar todos os registros.
    Qdica: para dados de conversação, o limite é aplicado com base em conversações e não em linhas.
31. Clique em Seguinte.
32. Escolha quando você gostaria de ser notificado. Consulte Notificações de trabalho para obter mais informações.
    
33. Clique em Seguinte.
34. Escolha quando seu trabalho será executado. Você pode fazer uma extração única ou configurar uma extração de dados recorrente. Consulte Agendamento de trabalhos para obter mais informações.
    
35. Clique em Seguinte.
36. Revise sua configuração. Se você precisar alterar uma configuração específica, clique no botão Edit (Editar ) para ser levado a essa etapa na configuração do conector.
    
37. Clique em Finish (Concluir ) para salvar o trabalho.

Depois que o trabalho for salvo, os dados especificados serão exportados para o Qualtrics com base na programação que você definiu. Se você estiver acionando um evento JSON, certifique-se de criar o restante do seu fluxo de trabalho, o que inclui adicionar condições para limitar quando o fluxo de trabalho é executado e tarefas para determinar a saída do fluxo de trabalho.