Mapeamento de dados (Discover)

Sobre o mapeamento de dados no Discover

O objetivo do mapeamento de dados é definir a estrutura e o formato dos dados no seu projeto XM Discover. Ao carregar dados no XM Discover, você deve mapear campos de dados de uma fonte externa (como um serviço de terceiros ou um arquivo) para campos de dados em seu projeto XM Discover.

Ao mapear dados no XM Discover, você pode:

• Defina os valores dos campos de dados padrão no XM Discover.
• Selecione quais campos de dados devem ser carregados como novos atributos e quais devem ser conectados a atributos existentes.
• Defina o tipo de dados para novos campos.
• Ignore os campos que você não deseja carregar.

Acessando mapeamento de dados

Existem duas formas de acessar opções de mapeamento de dados para um job:

• Ao criar uma tarefa: você pode executar a configuração inicial de mapeamento de dados na página Mapear campos desejados para o XM Discover.
  
• Para tarefas existentes: você pode acessar a configuração de mapeamento de dados selecionando a opção Mapeamento de dados no menu de ações do job.
  

Mapeamento de Dados

Siga as etapas nesta seção ao mapear dados no XM Discover:

1. O Mapeamento de fonte padrão contém todos os campos obrigatórios padrão para o conector. Você não pode adicionar ou remover nenhum dos campos listados nesta seção.
   
2. Alguns campos podem ter vários campos de origem para seleção (por exemplo, determinar qual campo de data representa a data do documento). Se isso for possível, haverá um menu drop-down para você selecionar o campo desejado.
3. Alguns campos permitem que você aplique transformações personalizadas que modificam os valores de campo registrados. Clique no ícone de engrenagem para adicionar uma transformação personalizada.
4. Se necessário, você pode ajustar o tipo de dados para campos recém-adicionados. Alguns campos são obrigatórios e não podem ter o tipo de dados alterado ou ser definidos como “Não mapear”.
   Qdica: se você quiser cancelar o mapeamento de um campo existente, altere o tipo de dados para “Não mapear”.
5. A seção Mapeamento de origem permite que você mapeie campos adicionais do conector. Estes são campos opcionais que você deseja incluir juntamente com os campos obrigatórios padrão.
   
6. Os campos não padrão são codificados por cor da seguinte forma:
   • Branco: o campo é mapeado para um novo atributo, o que significa que o XM Discover não encontrou um atributo no projeto que corresponda a esse campo.
   • Verde: o campo é mapeado para um atributo existente e tem o nome idêntico.
   • Amarelo: o campo é mapeado para um atributo existente, mas o nome não corresponde exatamente.
     Exemplo: Se sua fonte tiver um campo chamado NAME e você tiver um atributo existente chamado NAMES, você provavelmente os verá mapeados em um fundo amarelo.
   • Vermelho: o campo contém um problema de mapeamento, como uma inconsistência de tipo de dados ou um nome incorreto.
     Exemplo: o tipo de dados de um campo está definido como “Atributo de texto”, mas já existe um campo com o mesmo nome no XM Discover como “Atributo de número”. Para corrigir isso, selecione o tipo de dados correto no menu suspenso Tipo de dados.
7. Ao adicionar novos campos, você pode adicionar mais nomes de campo fáceis de usar nas colunas Nome do atributo e Nome de exibição do atributo:
   • Nome do atributo: contém o nome do campo, pois ele será salvo no XM Discover. Este nome não pode conter espaços e não pode exceder 21 caracteres para um campo de dados estruturado ou 30 caracteres para um campo literal.
     Qdica: se você quiser mapear um novo campo para um campo existente, insira o nome do atributo existente nessa coluna.
   • Nome de exibição do atributo: contém o nome do campo tal como será apresentado aos usuários (por exemplo, em relatórios). Este nome pode conter espaços e não pode exceder 99 caracteres.
     Qdica: para campos literais, o Nome de exibição do atributo é definido automaticamente para corresponder ao Nome do atributo.
8. Ative ou desative a caixa de seleção na coluna Relacionável para ativar ou desativar novos campos para relatórios. Você não pode modificar esta configuração para campos já existentes.
9. Se desejar, você pode criar campos personalizados usando transformações personalizadas.
10. Use os sinais de mais ( + ) e menos ( – ) para adicionar e remover campos personalizados conforme necessário.
11. Clique em Aplicar e criar versão para salvar seu mapeamento de dados como uma nova versão, o que permite que você reverta seus mapeamentos, se necessário.
12. Clique em Aplicar para aplicar suas modificações a execuções de job futuras.

Mapeamentos de dados codificados

Se desejado, você pode adicionar mapeamentos de dados com programação incondicional, o que aplicará os valores com programação incondicional indicados para todos os registros carregados mediante o job:

1. Na janela de mapeamento de dados, clique em Mapeamento codificado.
2. Insira o Valor codificado, que será aplicado a todos os registros carregados por meio deste job.
3. Selecione o tipo de dados do campo.
4. No campo Nome do atributo, selecione um campo existente ou insira um nome para criar um novo campo. Ao adicionar um novo campo, você também pode definir o Nome de exibição do atributo.
5. Se estiver adicionando um novo campo, marque a caixa de seleção Reportável para ativar o campo para relatórios ou desmarque-o para desativar o campo para relatórios.
6. Use os sinais de mais ( + ) e menos ( – ) para adicionar outros valores com programação incondicional, conforme necessário.

Mapeamento de campos de conversação

Esta seção aborda como mapear campos de conversação para dados conversacionais, como interações de chamada e chat. Na seção Mapeamento de origem, você pode configurar os seguintes campos de dados conversacionais:

1. richVerbatim: Para dados conversacionais (como interações de chamada e chat), o XM Discover usa um formato conversacional na íntegra para o campo richVerbatim. Este formato suporta a ingestão de metadados específicos do diálogo necessários para desbloquear a visualização conversacional (turnos do falante, silêncio, eventos conversacionais, etc.) e enriquecimentos (hora de início, duração, etc.). Este campo literal inclui campos “filhos” para rastrear o lado do cliente e do representante da conversa:
   • clientVerbatim: Acompanha o lado do cliente da conversa.
   • agentVerbatim: rastreia o lado do representante da conversa.
   • desconhecido: rastreia outras partes da conversa em que não está claro quem é o palestrante, ou o palestrante não é nem o cliente nem o agente.
     Qdica: O mesmo texto não pode ser usado para diferentes tipos de dados conversacionais. Se você quiser que seu projeto hospede vários tipos de conversa, use pares separados de conversações textuais por tipo de conversa.
2. clientVerbatim: rastreia o lado do cliente da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
   • clientVerbatimChat para interações digitais.
   • clientVerbatimCall para interações de chamada.
3. agentVerbatim: rastreia o lado do representante (agente) da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
   • agentVerbatimChat para interações digitais.
   • agentVerbatimCall para interações de chamada.
4. desconhecido: rastreia o lado desconhecido da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
   • unknownVerbatimChat para interações digitais.
   • unknownVerbatimCall para interações de chamada.

Tipos de dados

Ao definir campos no XM Discover, você pode definir o tipo de dados do campo como 1 dos seguintes:

• Não mapear: não carregue este campo no XM Discover.
• Atributo de número: para campos de número. Você pode executar cálculos nesses atributos.
• Qdica: selecione somente Atributo de número se quiser realizar cálculos neste número. Um bom exemplo de um atributo numérico é a idade, pois pode ser interessante ver a idade média dos participantes da pesquisa. Um mau exemplo de um atributo numérico é o ano do modelo de um carro, que seria melhor escolhido como um Atributo de texto.
• Atributo de texto: para campos de texto com um conjunto discreto de valores.
• Atributo de data: para campos de data.
• Verbatim: Para campos textuais e comentários de texto. Use textualmente para campos com dados não estruturados que você deseja que sejam processados pelo mecanismo XM Discover NLP.

Ações de mapeamento de dados

O menu Ações permite que você execute as seguintes tarefas:

• Cancelar mapeamento de todos os campos: remove o mapeamento para todos os campos na seção “Mapeamento de origem” do mapeamento de dados, definindo todos os campos como “Não mapear”.
• Restaurar mapeamento padrão: remove qualquer mapeamento de campo personalizado e restaura o mapeamento de dados padrão para o conector.
• Importar mapeamento de dados: permite que você importe um arquivo contendo seu mapeamento de dados. Consulte Importação de & Exportação de mapeamento de dados para obter mais informações.
• Exportar mapeamento de dados: permite que você exporte um arquivo contendo seu mapeamento de dados. Consulte Importação de & Exportação de mapeamento de dados para obter mais informações.
• Atualizar mapeamento a partir do arquivo de amostra: esta opção está disponível apenas para os conectores Link do XM Discover e Arquivos. Permite que você atualize seu mapeamento carregando um dos arquivos de amostra de formato de dados do XM Discover.
• Fazer download de dados de amostra: ao mapear campos de dados de serviços de terceiros, você pode fazer o download de uma planilha do Excel com dados de amostra para entender melhor o tipo de dados esperado em seu projeto. Esta planilha contém duas folhas:
  • Dados padrão: campos de origem não mapeados com nomes e valores padrão (antes do mapeamento).
  • Dados mapeados: campos mapeados com nomes e valores transformados (após o mapeamento).

Importando & Exportando Mapeamento de Dados

Você pode exportar seu mapeamento de dados para uma planilha do Excel, o que permite alterar seu mapeamento fora do XM Discover. Em seguida, você pode importar esse arquivo para atualizar seu mapeamento. Essas opções também permitem que você reutilize rapidamente seus mapeamentos de dados em todos os jobs.

1. No menu Ações, selecione Exportar mapeamento de dados.
   
2. Edite seus mapeamentos conforme necessário. Siga estas diretrizes ao editar seu arquivo:
   
   • Os nomes das colunas correspondem às colunas exibidas na janela de mapeamento de dados em Descobrir.
   • Você pode criar novos campos personalizados adicionando novas linhas.
   • Não adicione novas colunas.
   • Salve seu arquivo como um arquivo XLS os XLSX.
3. No menu Ações, selecione Importar mapeamento de dados.
   
4. Clique em Carregar arquivo e escolha o arquivo salvo em seu computador.
   
5. Clique em OK.

Versões de mapeamento de dados

O mapeador de dados para um job rastreia até 30 das últimas versões salvas do mapeamento de dados do seu job. Você pode restaurar qualquer um desses mapeamentos de dados salvos, se necessário.

Alterne entre versões de mapeamento de dados seguindo as etapas abaixo:

1. Ao mapear seus dados, clique em Aplicar e criar versão. Isso salva o mapeamento de dados atual como uma nova versão caso você precise reverter suas modificações.
   
2. Use o menu suspenso Versão para escolher a versão para a qual você deseja alternar.
   
3. Um banner será exibido na parte superior da página, informando qual versão você está usando. Verifique novamente os mapeamentos antes de continuar.
   
4. Clique em Restaurar.
5. Clique em OK.
   
6. Esta etapa só será exibida se você não tiver salvo seus mapeamentos iniciais como uma nova versão. Se seu mapeamento de dados atual contiver modificações não salvas, escolha o que você deseja fazer com essa versão não salva:
   
   • Crie uma versão para o mapeamento atual e restaure essa versão: salve o mapeamento não salvo como uma versão separada e restaure a versão selecionada.
   • Restaurar esta versão sem criar uma versão para o mapeamento atual: perca o mapeamento não gravado e restaure a versão selecionada.
7. Clique em OK.

Relatório do mapeador de dados

O relatório de mapeador de dados permite a você verificar mapeamentos válidos para várias fontes usando um arquivo de mapeamento gerado automaticamente.

1. Na guia Jobs, filtre os jobs até que a tabela contenha os jobs que você deseja incluir no relatório.
   Qdica: você só pode baixar o mapeador de dados se todas as tarefas selecionadas estiverem no mesmo projeto.
2. No menu Ações em massa, selecione Baixar mapeador de dados.
3. Escolha seu formato de exportação, XLSX ou CSV.
   
4. Clique em OK.

Assim que seu arquivo for baixado, os seguintes campos estarão disponíveis no relatório:

• Nome do projeto: o nome do projeto XM Discover no qual os dados são carregados.
• Código do projeto: o código do projeto.
• Nome do job: o nome do job.
• ID do job: o ID do job.
• Fonte: a fonte de dados para a qual este job está configurado.
• Ativado: o status que indica se o job está ativado ou não.
• ID do tipo Atributo/contexto: a ID do atributo/integral.
• Nome do atributo/contexto: o nome do sistema do atributo/literal salvo pelo XM Discover.
• Nome de exibição do atributo: o nome de exibição do atributo salvo pelo XM Discover. Você pode deixar o mesmo que “Nome do atributo” ou fornecer uma versão mais fácil de usar.
• Tipo de dados: o tipo do atributo. Os valores possíveis incluem:
  • NUMBER: definido automaticamente para campos do tipo numérico.
  • TEXT: definido automaticamente para campos do tipo de texto.
  • DATE: definido automaticamente para campos do tipo de data.
  • VERBATIM: definido para campos textuais e comentários de texto.
• Tipo: o tipo do campo de dados mapeado. Os valores possíveis incluem:
  • Campo de origem: o tipo do campo de dados com mapeamentos de origem padrão para atributos comuns que são adicionados a todos os documentos carregados por meio deste job.
  • Hardcoded: o tipo do campo de dados com valores codificados para cada registro.
  • Transformações: o tipo do campo de dados com valores de campo de origem transformados e modificados.
• Valor: o valor do atributo.