Conector de saída de arquivos

Sobre o conector de saída de arquivos

Você pode usar o conector de saída de arquivos para exportar dados enriquecidos do XM Discover para o servidor SFTP da sua organização.

É possível exportar dados nos níveis de sentença e documento, limitá-los a registros novos e atualizados e escolher quais campos, enriquecimentos e classificações serão exportados. Os dados exportados estão disponíveis nos formatos CSV e JSON.

Configuração de um trabalho de saída de arquivos

1. Na página Jobs, clique em New Job (Novo trabalho).
   
2. Selecione Files 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 uma conta SFTP a ser usada ou selecione Add New (Adicionar nova ) para adicionar uma nova conta.
   
8. Se estiver adicionando uma nova conta, insira as seguintes informações para sua conta SFTP:
   • Nome da conexão: Dê um nome à conexão para que você possa reconhecê-la mais tarde.
   • Nome de usuário SFTP: digite o nome de usuário para se conectar ao servidor SFTP.
   • SFTP Password (Senha SFTP): Digite a senha para se conectar ao seu servidor SFTP.
   • Host SFTP: Digite o URL do host do servidor SFTP.
   • Porta SFTP: digite sua porta SFTP. Geralmente são 22.
   • Enviar notificações de expiração: Se você quiser que suas credenciais SFTP expirem após um determinado período de tempo, selecione essa opção.
   • Dias antes da expiração: Se estiver ativando as notificações de expiração, insira quantos dias você gostaria de ser notificado antes da expiração. Você pode inserir um valor entre 1 e 100 dias.
   • Data de expiração: Defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e escolher a data.
9. Clique em Seguinte.
10. Forneça seu endpoint API exportação XM Discover .
    
11. Clique em Seguinte.
12. 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.
13. Forneça uma consulta de 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 pesquisa selecionados usando a seguinte sintaxe: surveyid:sv_01
14. 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.
15. 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.
16. 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.
17. Escolha 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.
18. 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.
19. Clique em Seguinte.
20. Escolha o tipo de arquivo que deseja exportar:
    
    • “Plano” separado por delimitadores: O formato é um arquivo de texto delimitado, como CSV ou TSV.
    • Arquivos JSON: O formato é um arquivo JSON.
21. Se estiver exportando para um arquivo simples separado por delimitadores, escolha as configurações do arquivo:
    • Codificação do arquivo: Escolha a codificação do arquivo, como UTF-8 ou ASCII
    • Caractere delimitador: O caractere usado para separar entradas, como uma vírgula ou uma tabulação.
    • Caractere de fechamento: O caractere usado para delimitar os dados. Deixe esse campo em branco se você não quiser um compartimento.
    • No Enclosure: se você não quiser que seus dados sejam incluídos em um caractere extra, ative essa opção.
22. Clique em Browse e escolha sua pasta SFTP.
    
    Qdica: ao escolher um caminho de pasta, você pode clicar no ícone de uma pasta para expandi-la. Clique no nome da pasta para selecioná-la e, em seguida, clique em Ok quando terminar.
23. Se quiser que os arquivos exportados tenham um prefixo anexado a eles, ative a opção Fornecer um nome de arquivo para prefixo e digite o prefixo desejado na caixa.
    Qdica: o prefixo não pode conter [ ] \ / e não pode exceder 100 caracteres.
24. Se quiser que os arquivos exportados tenham um postfix anexado a eles, ative a opção Fornecer um nome de arquivo para postfix e digite o postfix desejado na caixa.
    Qdica: o postfix não pode conter [ ] \ / e não pode exceder 100 caracteres.
25. Se quiser criptografar seus dados, ative a opção Criptografar arquivos entregues pelo XM Discover e insira sua chave PGP/GPG na caixa.
    Qdica: os arquivos sempre serão criptografados em um arquivo GPG. Você pode inserir uma chave PGP/GPG, mas ela nunca será criptografada em um arquivo PGP.
26. Clique em Seguinte.
27. 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.
    
28. Selecione o tipo de dados como o qual o campo deve ser exportado:
    • 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.
29. Digite o Nome Atributo para esse campo. Esse será o nome do campo quando ele for exportado.
30. Use os sinais de mais ( + ) e menos ( – ) para adicionar e remover campos conforme necessário.
31. Clique em Seguinte.
32. Se desejar, você pode adicionar um filtro de conector para filtro os dados de entrada e limitar os dados importados.
    
33. 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.
34. Clique em Seguinte.
35. Escolha quando você gostaria de ser notificado. Consulte Notificações de trabalho para obter mais informações.
    
36. Clique em Seguinte.
37. 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.
    
38. Clique em Seguinte.
39. 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.
    
40. Clique em Finish (Concluir ) para salvar o trabalho.