Extrair dados da tarefa de arquivos SFTP

Sobre a tarefa Extrair dados de arquivos SFTP

A tarefa Extrair dados dos arquivos SFTP permite que você importe dados do seu servidor SFTP para usar no Qualtrics. Você pode utilizar esta tarefa para processar somente um ou vários arquivos de cada vez. Você pode combinar essa tarefa com outras tarefas, como a tarefa Carregar dados no XM Directory, para importar dados para outros locais da Qualtrics.

Para obter mais informações sobre configuração e solução de problemas de SFTP, consulte Solução de problemas de SFTP .

Conexão de uma conta SFTP

Antes de usar a tarefa Extrair dados de arquivos SFTP, você precisa conectar uma conta SFTP da Qualtrics para extrair os dados de. As contas podem ser adicionadas pelos Administradores da marca para outros usuários na marca utilizarem ou por usuários individuais para seu uso pessoal.

Existem 3 opções de autenticação diferentes:

• Senha: autenticar com um nome de usuário e senha.
• Chave SSH: autentique usando uma chave Secure Shell (SSH) que você fornece ou uma chave fornecida pela Qualtrics.
• Chave SSH criptografada: autenticar usando uma chave SSH criptografada.

Adição de uma conta como administrador da marca

Se você for Administrador da Marca, siga as etapas nesta seção para adicionar uma conta SFTP para alguns ou todos os usuários em sua licença de uso.

1. Usando o menu de navegação na parte superior esquerda, vá para Admin.
   
2. Vá para Extensões.
3. Clique em Extrair dados da extensão de arquivos SFTP.
4. Clique em Adicionar conta.
   
5. Dê um nome à conta. Este nome é utilizado para fins organizacionais e para identificar a conta.
   
6. Insira o nome do host do servidor SFTP associado.
   Exemplo: geralmente, eles estão no formato sftp.exemplo.com
7. Insira o número da Porta. Normalmente, isso é 22.
8. Escolha seu método de autenticação. Suas opções incluem:
   • Senha: forneça um nome de usuário e senha para autenticação.
   • Chave SSH: forneça um nome de usuário e uma chave SSH para autenticação ou use uma chave SSH gerada pela Qualtrics.
   • Chave SSH criptografada: forneça sua própria chave SSH criptografada com uma frase-chave para autenticação.
9. Se você escolher a senha, insira o nome de usuário e a senha da conta SFTP.
   
10. Se estiver autenticando com uma chave SSH, execute uma das seguintes ações:
    • Se estiver usando uma chave SSH gerada pela Qualtrics, insira um Nome de usuário e clique em Gerar par de chaves SSH.
      Você pode clicar em Baixar chave SSH pública para baixar a chave pública como um arquivo .pem para o seu computador. A chave privada associada será armazenada pela Qualtrics. Clique em Copiar para o clipboard para copiar a impressão digital da chave para seu clipboard. Salve ambos em um local seguro para que você possa referenciá-los, se necessário.
    • Se estiver usando sua própria chave SSH, clique em Fornecer uma chave privada.
      Em seguida, insira seu nome de usuário e a chave SSH.
      Qdica: Você deve inserir uma chave privada não protegida por senha nesta caixa. Além disso, a chave pública deve ser autorizada em seu servidor SFTP.
      Exemplo:
      É assim que uma chave SSH normalmente se parece (incluindo as linhas de chave RSA iniciais e finais):
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
11. Se estiver autenticando com a chave SSH criptografada, insira o Nome de usuário, a Chave SSH criptografada e a Frase-chave associada à sua chave.
12. Quando terminar, clique em Conectar conta.

Adição de uma conta como usuário individual

Siga as etapas nesta seção para adicionar uma conta SFTP para seu uso pessoal. Somente você poderá usar a conta que se conectar.

1. Siga as etapas na seção Configuração de uma tarefa de extração de dados de arquivos SFTP até chegar à etapa de seleção de uma conta.
2. Clique em Adicionar conta de usuário.
   
3. Siga as instruções na subseção “Adicionando uma conta como Administrador da marca” acima para obter mais informações sobre como conectar sua conta. As mesmas opções e configurações de autenticação estão disponíveis para você ao adicionar uma conta como um usuário individual.

Testando a conexão

Depois de adicionar uma conta, você pode testar a conexão na tarefa Extrair dados de arquivos SFTP. Na parte inferior da tarefa, clique em Testar conexão . Isso fará upload de um pequeno arquivo de teste para seu servidor, lerá seu conteúdo e, em seguida, excluirá o arquivo. 

Baixando chaves SSH públicas

Se estiver usando uma chave SSH gerada pela Qualtrics, você pode baixar a chave pública para a conexão. Ao visualizar a lista de contas SFTP a serem usadas, clique no menu de três pontos à direita de uma conta e, em seguida, selecione Baixar chave SSH pública. Isso irá baixar a chave para o seu computador como um arquivo .pem.

Atualizando chaves SSH geradas pela Qualtrics

Se estiver usando uma chave SSH gerada pela Qualtrics, você poderá gerar a chave novamente, se necessário. Isso é útil se você acredita que a chave foi comprometida ou se sua empresa exigir que você gire as chaves após um determinado período de tempo.

1. Ao visualizar a lista de contas SFTP a serem usadas, clique no menu de três pontos à direita da conta e clique em Editar conta.
2. Clique no hyperlink para gerar um novo par de chaves.
   

Configuração de uma tarefa Extrair dados de arquivos SFTP

1. Criar um fluxo de trabalho ETL.
2. Selecione Fonte de dados (extrator ETL).
   
3. Selecione a tarefa Extrair dados de arquivos SFTP.
   
4. Escolha a conta do SFTP da qual extrair os arquivos. Quaisquer contas adicionadas pelos Administradores da marca, bem como as contas que você mesmo adicionou, serão listadas aqui.
   
5. Se você deseja adicionar novas credenciais de conta SFTP, clique em Adicionar uma conta de usuário e siga os passos no conectando uma seção de conta SFTP .
6. Clique em Seguinte.
7. Insira o Modelo de nome do arquivo, que é usado para identificar quais arquivos devem ser processados observando o prefixo do arquivo. Todos os arquivos com seu prefixo especificado serão processados. Insira o prefixo desejado na caixa.
   
   Exemplo: digamos que tenho um arquivo chamado Qualtrics-DataImport.csv. Posso inserir “Q” ou “Qualtrics” como prefixo, dependendo de existirem outros arquivos no servidor que eu queira processar.
   Qdica: Clique no Use expressão regular caixa de seleção se você quiser usar regex para seu padrão de nome de arquivo.
8. Insira o diretório Pickup ou o caminho do diretório para encontrar o arquivo no servidor. Você pode inserir um caminho relativo ou um caminho absoluto.
   Qdica: Este caminho do diretório diferencia maiúsculas de minúsculas e deve apontar para uma pasta existente ou o fluxo de trabalho falhará. A Qualtrics não poderá acessar arquivos se eles estiverem em um diretório de nível superior ao especificado no diretório de retirada.

   Exemplo: dependendo do caminho que você inserir, os diretórios de retirada potenciais podem ser:

   • /home/username/myFolder (caminho absoluto)
   • myFolder (caminho relativo)
9. Se o seu arquivo estiver compactado, habilite o Você está extraindo de um arquivo zip opção. Em seguida, insira o Prefixo para arquivo dentro do zip que será usado para encontrar o arquivo correto para importar do arquivo zip.
   Qdica: Somente compressões .zip são suportadas. Os arquivos no arquivo .zip podem ser criptografados, mas o arquivo .zip em si não pode ser (por exemplo, filename.csv.pgp.zip é suportado, mas filename.csv.zip.pgp não é).
10. Selecione um tipo de arquivo.
    
    Suas opções incluem:
    • CSV
    • TSV
    • JSON

      Qdica: os arquivos JSON devem ter seu conteúdo entre colchetes, []. Por exemplo:

      [
         {
             "fruit": "Apple",
             "size": "Large",
             "color": "Red"
         ficha informativa
       ]

    • Excel (.xslx ou .xls)
11. Se estiver processando um CSV, escolha o Delimitador para o arquivo. Suas opções incluem vírgula, ponto-e-vírgula, tabulador e tubo.
12. Se desejar, selecione Decriptar arquivos antes de importar usando PGP. Para saber mais sobre este meio adicional de criptografia e proteção de dados, consulte Criptografia PGP.
    Qdica: Certifique-se de que os arquivos que você deseja importar estejam criptografados com a chave pública da Qualtrics antes de carregá-los no servidor SFTP. Para isso, talvez seja necessário conversar com sua equipe de TI.
13. Se você quiser ignorar arquivos que não podem ser processados, selecione Ignorar arquivos inválidos. Se esta opção não estiver selecionada, todo o fluxo de trabalho falhará quando tentar processar o arquivo incorreto.
    Qdica: há vários motivos pelos quais um arquivo não pode ser processado. O mais comum é que ele é muito grande ou seus dados estão corrompidos de alguma forma.
14. Escolha o que você gostaria que acontecesse após o processamento do arquivo. Suas opções incluem:
    • Excluir o arquivo processado: após processar o arquivo, o Qualtrics o exclui do seu servidor SFTP. Essa opção é ativada por padrão.
    • Manter o arquivo processado: depois de processar o arquivo, a Qualtrics deixa o arquivo no seu servidor SFTP.
15. Decida se você gostaria de Use validação estrita , que rejeitará automaticamente os arquivos extraídos se eles tiverem certos problemas de formatação. Leia a mensagem na tarefa para obter mais informações sobre quais arquivos serão rejeitados.
    
    Qdica: Habilitar Pular linhas malformadas para carregar seu arquivo e excluir quaisquer linhas com problemas de formatação.
16. Clique em Escolher arquivo e carregue um arquivo de amostra, que informará à Qualtrics os campos que você deseja importar e determinará as tarefas subsequentes que você pode usar com esta tarefa. O arquivo que você carrega deve conter os campos que deseja importar como parte desta tarefa.
    Qdica: baixe os arquivos de amostra na tarefa ou baixe os arquivos na seção de arquivos de exemplo para modelos sobre como estruturar seus dados com base em seu caso de uso. O único formato de codificação de arquivo suportado é UTF-8. Alguns softwares de planilha salvam como Unicode UTF-8, que é diferente do UTF-8, se você estiver recebendo erros inesperados. Certifique-se de que você está exportando no formato UTF-8 e não no Unicode UTF-8.
    
17. Verifique se seu arquivo está importando os dados corretamente. Se você precisar alterar suas configurações, clique em Voltar na parte superior da tarefa.
    

    Qdica: Se todos os seus dados estiverem sendo importados como uma coluna, você estará usando o delimitador incorreto. A captura de tela abaixo demonstra como isso se parece na janela de tarefas.

    

18. Se os dados estiverem corretos, clique em Salvar.
19. Conclua a criação do seu fluxo de trabalho ETL. Quando você escolhe uma tarefa de carregador, está decidindo o destino dos dados que extraiu. Consulte as tarefas de carregador disponíveis para obter uma lista de opções.
    

Arquivos de exemplo

Abaixo estão arquivos de exemplo sobre como estruturar seus dados para importação, dependendo do tipo de dados que você deseja importar. Clique em um nome de arquivo para baixar o arquivo de exemplo.

• Dados do usuário
• Dados de resposta da pesquisa
• Dados de contato do Salesforce
• Dados da conta Salesforce
• Dados do membro da equipe da conta Salesforce
• Dados do empregado

Perguntas frequentes