Conector de entrada de arquivos

Sobre o conector de entrada de arquivos

Você pode utilizar o conector de entrada de arquivos para carregar dados do cliente por meio de um upload de arquivo. Esses jobs podem ser escalonados para serem repetidos em uma programação que você define ou para serem configurados para serem um pull de dados único.

Os jobs de entrada de arquivo permitem que você carregue dados nos seguintes formatos:

• Arquivos de texto delimitados de forma plana (CSV, TSV etc.)
• XLS ou XLSX
• JSON
• WebVTT

Configuração de um job de entrada de arquivos

1. Na página Trabalhos, clique em Novo trabalho.
   
2. Selecione Arquivos.
   
3. Dê um nome ao seu job para poder identificá-lo.
   
4. Selecione o projeto para o qual os dados devem ser carregados.
5. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
6. Clique em Seguinte.
7. Escolha uma conta SFTP para usar ou selecione Adicionar novo para adicionar uma nova.
   
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 reconhecê-la mais tarde.
   • Nome de usuário do SFTP: insira o nome de usuário para conexão com o servidor SFTP.
   • Senha do SFTP: insira a senha para se conectar ao servidor SFTP.
   • Host SFTP: insira o URL do host do servidor SFTP.
   • Porta SFTP: insira sua porta SFTP. Normalmente é 22.
   • Enviar notificações de expiração: se desejar que suas credenciais SFTP expirem após um determinado período de tempo, selecione esta opção.
   • Dias antes da expiração: se as notificações de expiração forem ativadas, insira quantos dias você gostaria de ser notificado antes da expiração. Você pode inserir um valor entre 1 e 100 dias.
   • Data de vencimento: defina a data em que as credenciais expirarão. Clique na caixa para abrir um calendário e selecionar a data.
9. Clique em Seguinte.
10. Selecione o tipo de arquivo que você deseja carregar:
    
    • Arquivos “planos” separados por delimitadores
    • Arquivos do Excel (XLS, XLSX)
    • Arquivos JSON
    • Arquivos WebVTT
11. Dependendo do seu tipo de arquivo selecionado, existem configurações adicionais para você selecionar:
    • Arquivos planos separados por delimitadores: Para arquivos separados por delimitadores, escolha o seguinte:
      
      • Codificação do arquivo: Escolha o sistema de codificação do arquivo (UTF-8, ASCII, etc)
      • Caractere delimitador: insira o caractere utilizado para delimitar entradas de dados. Por padrão, esta é uma vírgula para arquivos CSV.
      • Caractere de embalagem: insira o caractere que inclui a entrada de dados. Deixe este campo em branco se Nenhuma embalagem estiver selecionado.
      • Sem inclusão: ative esta opção se o seu arquivo não contiver caracteres de embalagem.
    • JSON: insira o caminho JSON que contém os dados do documento que você deseja carregar no XM Discover. Deixe este campo em branco se seus documentos estiverem no nível raiz.
      
    • Pule para a próxima etapa para Excel e WebVTT.
12. Clique em Procurar e escolha o caminho da pasta no servidor SFTP que contém o arquivo que você deseja carregar.
    Qdica: Ao escolher um caminho de pasta, você pode clicar em um ícone de pasta para expandir essa pasta. Clique no nome da pasta para selecioná-la e clique em OK quando terminar.
13. Insira o nome do arquivo expressão regular que corresponda aos arquivos que você deseja carregar.
14. Se seus arquivos estiverem compactados, ative Descompactar arquivo(s) e insira a expressão regular Nome do arquivo compactado que corresponde aos arquivos que devem ser descompactados.
    
15. Se seus arquivos forem descriptografados, habilite Descriptografar arquivo(s) e insira o seguinte:
    • Expressão regular de nome de arquivo criptografado: insira o nome de arquivo expressão regular para arquivos que devem ser descriptografados.
    • Chave PGP/GPG: insira a chave PGP/GPG usada para criptografia.
    • Frase-chave: insira a frase-chave para descriptografia.
16. Se seus arquivos forem compactados e criptografados, você deve escolher o que deve acontecer primeiro:
    • Descompactar e depois descriptografar: os arquivos são descompactados e, em seguida, descriptografados.
    • Descriptografar e descompactar: os arquivos são descriptografados e, em seguida, descompactados.
17. Escolha o tipo de dados que você deseja importar:
    
    • Chat: Interações digitais com várias linhas de diálogo entre 2 ou mais participantes.
    • Chamada: Chamada de transcrições com múltiplas linhas de diálogo entre 2 ou mais participantes.
    • Feedback: documentos apresentados como objetos de uma única linha ou “planos”.
      Qdica: dependendo do seu tipo de arquivo, alguns tipos de dados não são compatíveis. Por exemplo, os arquivos WebVTT só podem ser utilizados para carregar transcrições de chamada.
18. Você deve fornecer um arquivo de amostra, que pode ser salvo em seu computador ou no servidor SFTP:
    • Selecione Baixar amostra do armazenamento de arquivos se o arquivo de amostra for salvo em seu servidor SFTP.
    • Selecione Carregar amostra do meu computador se a amostra estiver salva em seu computador.
19. Se necessário, você pode selecionar um arquivo de modelo para baixar. Clique no link aqui para baixar seu modelo selecionado. Use este arquivo para adicionar os dados que deseja importar para o XM Discover. Consulte a página de suporte Formatos de dados do XM Discover para obter informações específicas de formatação em cada arquivo e tipo de dados.
20. Clique no botão Selecionar arquivo de amostra e escolha o arquivo de amostra em seu computador ou em seu servidor SFTP.
21. Uma visualização do arquivo será exibida. Se você vir uma mensagem de erro ou conteúdo de arquivo bruto em vez da visualização, pode haver um problema com as opções de formato de dados que você selecionou. Consulte a página Erros do arquivo de amostra para obter ajuda na solução do seu arquivo.
22. Clique em Seguinte.
23. Se necessário, ajuste seus mapeamentos de dados. Consulte a página de suporte Mapeamento de dados para obter informações detalhadas sobre campos de mapeamento no XM Discover. A seção Mapeamento de dados padrão tem informações sobre os campos específicos deste conector e a seção Mapeamento de campos de conversação aborda como mapear dados para dados conversacionais.
    
24. Clique em Seguinte.
25. Se desejar, você pode adicionar regras de substituição e ocultação de dados para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente. Consulte a página de suporte Substituição e redação de dados para obter mais informações.
    
26. Clique em Seguinte.
27. Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
    
28. Você também pode limitar o número de registros importados em um único job inserindo um número na caixa Indicar limite de registros. Insira “Todos” se quiser importar todos os registros.
    Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
29. Clique em Seguinte.
30. Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
    
31. Clique em Seguinte.
32. Escolha como os documentos duplicados são tratados. Consulte Tratamento de duplicados para obter mais informações.
    
33. Selecione Programar execuções incrementais se você quiser que seu job seja executado periodicamente em uma programação ou Configurar pull único se quiser que o job seja executado somente uma vez. Consulte Escalonamento do job para mais informações.
34. Escolha um período de retenção para arquivos processados. Os arquivos são excluídos após o período definido.
    
35. Clique em Seguinte.
36. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
    
37. Clique em Concluir para salvar o trabalho.

Mapeamento de dados padrão

Esta seção contém informações sobre os campos padrão para jobs de entrada de arquivos.

• feedback_type: Identifica dados com base em seu tipo. Isso é útil para relatórios quando seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídias sociais). Por padrão, o valor deste atributo é definido como “chamar” para transcrições de chamada, “chat” para interações digitais ou “feedback” para feedback individual. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• source_value: identifica dados obtidos de uma fonte específica. Isso pode ser qualquer coisa que descreva a origem dos dados, como o nome de uma pesquisa ou uma campanha de marketing móvel. Por padrão, o valor desse atributo é definido como “Arquivos”. Use transformações personalizadas para definir um valor personalizado, definir uma expressão ou mapeá-la para outro campo.
• document_date: o campo de data principal associado a um documento. Esta data é usada em relatórios, tendências, alertas do XM Discover e assim por diante. Você pode usar qualquer campo de data em seu conjunto de dados para a data do documento. Você também pode definir uma data específica do documento.
• natural_id: Um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. Para ID natural, você pode selecionar qualquer campo de texto ou numérico a partir de seus dados. Como alternativa, você pode gerar IDs automaticamente adicionando um campo personalizado.
• feedback_provider: identifica dados obtidos de um provedor específico. Para uploads de arquivos, o valor desse atributo está definido como “Arquivos” e não pode ser alterado.
• job_name: identifica dados com base no nome do trabalho usado para carregá-lo. Você pode modificar o valor deste atributo durante a configuração por meio do campo Nome do job que é exibido na parte superior de cada página durante a configuração.
• loadDate: indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente e não pode ser modificado.

Atualizando configuração de amostra

Os conectores de entrada de arquivos necessitam de um arquivo de amostra para gerar mapeamentos de dados. Se você quiser modificar os mapeamentos de dados após criar um job, execute o seguinte:

1. Remova o mapeamento dos campos que não estão presentes no novo arquivo de amostra.
2. Atualize a configuração de amostra carregando um novo arquivo de amostra com um novo conjunto de campos. As etapas para atualizar a configuração de amostra estão abaixo.
3. Atualize os mapeamentos de dados de acordo com o novo arquivo de amostra.

Atualizando configuração de amostra

1. No menu de opções de trabalho, selecione Atualizar configuração de amostra para um trabalho de arquivos existente.
   
2. Selecione Clique em Para selecionar arquivo para upload e escolha seu arquivo de amostra salvo em seu computador.
   
   Qdica: Se seu arquivo contiver campos que não estão no mapeamento de dados, você receberá um erro. Para corrigir esse problema, edite seu mapeamento de dados para que ele tenha os mesmos campos que seu arquivo de amostra.
3. Verifique duas vezes suas configurações de arquivo. Consulte a página Conector de entrada de arquivos para obter mais informações sobre as configurações do arquivo de amostra.
4. Clique em OK.

Atualizando caminho e máscara de arquivo

Os conectores de entrada de arquivos necessitam de um caminho e uma máscara de arquivo (nome de arquivo expressão regular) para encontrar os arquivos corretos para importação. Você pode atualizar o caminho e a máscara de arquivo para qualquer job de arquivos existente.

1. No menu de opções de job, selecione Atualizar caminho e Máscara de arquivo para um job de arquivos existente.
   
2. Clique em Procurar.
   
3. Selecione a pasta onde os arquivos estão armazenados.
   
   Atenção: somente os arquivos na pasta selecionada são processados; as subpastas precisam ser processadas separadamente.
4. Clique em OK.
5. No campo Nome do arquivo expressão regular, insira a máscara do arquivo (nome do arquivo expressão regular) que corresponde aos arquivos que você deseja importar.
   
6. Clique em Salvar.

XM Discover Supported Key Exchange Ciphers

A conexão a um servidor SFTP requer uma série de handshakes SSH para coordenar a criptografia usada entre o servidor e a automação. Para estabelecer uma conexão, o servidor SFTP precisará ter pelo menos uma cifra para cada tipo de cifra que corresponda a uma cifra suportada por automações. Abaixo está a lista de codificações suportadas por automações agrupadas pelo tipo de cifra.

Here’s a list of key exchange ciphers supported by XM Discover SFTP servers:

• diffie-hellman-group14-sha256
• diffie-hellman-group18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• curve25519-sha256
• curve25519-sha256@libssh.org
• diffie-hellman-group16-sha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com