Transformando dados (conectores)

Sobre a transformação de dados no Discover

Você pode transformar seus dados de entrada antes que eles sejam importados para o XM Discover. Isso é útil se você precisar limpar seus dados ou modificar o formato deles.

Para acessar transformações de dados:

1. Ao configurar o job de importação, clique no ícone de engrenagem na coluna Transformações ao lado do campo de dados que você deseja transformar.
   
   Qdica: se você quiser atualizar transformações de dados para um job existente, selecione Mapeamento de dados no menu de opções de jobs.
   Atenção: Se o ícone de engrenagem tiver um número ao lado, isso significa que já existe uma transformação aplicada ao campo. Se você adicionar uma nova transformação, ela substituirá a antiga.
2. Escolha sua transformação de dados. Visite as seções vinculadas para obter mais informações sobre cada transformação.
   
   • Sem transformação: não transforme o campo importado.
   • Pesquisa dinâmica: esta opção só está disponível para campos de pesquisa. Quando selecionado, esse campo aplicará os valores de pesquisa mais recentes para o campo da tabela de pesquisa.
   • Substituir valor da tabela de pesquisa: defina pares de valores de origem e valores de reposição.
   • Substituir valor por expressão regular: defina expressões regulares (regex) para valores de correspondência de padrão e de substituição.
   • Transformação personalizada: crie sua própria transformação usando diferentes funções e expressões.

Pesquisa dinâmica

Esta opção só está disponível para campos de dados que referenciam uma tabela de pesquisa a partir da fonte de dados conectada. Você pode especificar uma expressão de pesquisa dinâmica para que os dados corretos sejam importados para o XM Discover.

Substituir valor da tabela de pesquisa

Você pode adicionar pesquisas a qualquer campo de origem para ter maior controle sobre os valores exatos que estão sendo enviados para seu projeto do XM Discover. Uma tabela de pesquisa permite que você defina valores de origem a serem substituídos quando salvos no XM Discover.

1. Certifique-se de que Substituir valor da tabela de pesquisa esteja selecionado como sua transformação.
   
2. Clique em Exportar pesquisa para exportar um arquivo de pesquisa no formato .XLSX.
   Qdica: recomendamos adicionar pesquisas por meio de um arquivo de pesquisa. Se você quiser adicionar pesquisas manualmente, vá para a etapa 8.
3. Abra seu arquivo em um editor de planilhas e comece a adicionar seus valores de pesquisa ao arquivo.
4. Na coluna de correspondência, adicione os valores de entrada do seu conector de dados.
   
5. Na coluna recodificado, adicione os valores correspondentes que você deseja salvar no XM Discover.
6. Salve seu arquivo como um arquivo XLS ou XLSX.
7. No XM Discover, clique em Importar pesquisa e selecione o arquivo de pesquisa salvo em seu computador.
   
8. Se desejar, você pode editar suas pesquisas. A coluna Valor de origem contém o valor do seu conector de dados, enquanto a coluna Valor transformado contém o valor que você deseja salvar no XM Discover.
9. Você pode adicionar pares de pesquisa adicionais clicando no sinal de mais ( + ), ou pode remover emparelhamentos clicando no sinal de menos ( – ) ao lado do emparelhamento.
10. Clique em Salvar.

Substituir valor por expressão regular

Você pode substituir valores de dados de entrada usando expressões regulares ou regex, permitindo que você limpe dados antes de carregá-los em seu projeto do XM Discover.

1. Certifique-se de que Substituir valor por expressão regular está selecionado como sua transformação.
   
2. Indique a expressão regular de modelo de pesquisa no campo Inserir expressão regular para correspondência de modelo.
3. Indique a expressão regular da cadeia de substituição no campo Inserir expressão regular para valor de substituição.
4. Para testar a transformação, insira um exemplo do seu conjunto de dados no campo Valor de origem de amostra e clique em Testar. O resultado da transformação é exibido na caixa Valor transformado de amostra.
5. Clique em Salvar.

Transformação personalizada

Você pode transformar dados de entrada usando suas próprias expressões personalizadas. As transformações personalizadas permitem muitos tipos de manipulação de dados, incluindo a alteração de formatos de data, a junção de campos, a remoção de zeros precedentes e muito mais.

1. Certifique-se de que Transformação personalizada esteja selecionada como sua transformação de dados.
   
2. Crie sua expressão de transformação de dados. Sua expressão variará dependendo de seus dados de entrada e da saída desejada. Consulte a página de suporte Criando expressões para obter mais informações sobre como criar sua expressão.
3. Se você estiver criando um novo campo, pode alterar o Tipo de dados do campo. Se você transformar um campo existente, não poderá modificar o tipo de dados.
4. Para testar sua transformação, insira um valor de dados de teste no campo Valor de teste e, em seguida, clique em Testar. O resultado será exibido ao lado do botão “Teste”.
5. Quando terminar de criar e testar sua expressão, clique em Salvar.

Geração automática de IDs naturais

Quando você carrega dados no XM Discover, os documentos podem não conter um ID exclusivo para você usar como ID natural, que é um campo importante porque ajuda você a identificar documentos duplicados. Seus dados carregados devem ter um identificador exclusivo para usar como o ID natural. Esta seção aborda como definir um ID natural ao mapear dados usando transformações personalizadas.

1. Ao mapear dados, clique no sinal de mais ( + ) na seção Mapeamento de origem para adicionar um novo campo personalizado.
   
2. Forneça as seguintes informações para o campo personalizado:
   • Nome do campo: forneça o nome para o campo.
   • Tipo de dados: selecione Atributo de texto a partir do menu drop-down.
   • Nome do atributo: deixe o mesmo que “Nome do campo”.
   • Nome de exibição do atributo: se desejado, insira um nome de exibição mais fácil de usar para o campo.
   • Reportável: ative esta caixa de seleção. Isso deve ser selecionado para que você possa usar o ID natural no relatório.
3. Na seção Mapeamento de fonte padrão, selecione o atributo que você criou na etapa 2 para o mapeamento de ID natural.
   
4. Clique no ícone de engrenagem na coluna Transformações.
5. Selecione Transformação personalizada.
   
6. Procure a função GENERATE_ID() e arraste-a da seção Funções para a caixa Expressão.
7. Clique em Salvar.
   Qdica: Clique em Aplicar para salvar seus mapeamentos.

Agora, seu documento terá um ID gerado aleatoriamente quando for carregado.

Definição de uma data do documento específica

Quando você carrega dados no XM Discover, os documentos podem conter vários campos de data ou nenhum. Seus dados carregados devem ter um campo de data para usar como data do documento. Esta seção aborda como definir uma data do documento ao mapear dados usando transformações personalizadas.

1. Ao mapear dados, clique no sinal de mais ( + ) na seção Mapeamento de origem para adicionar um novo campo personalizado.
   
2. Forneça as seguintes informações para o campo personalizado:
   • Nome do campo: forneça o nome para o campo (por exemplo, custom_date).
   • Tipo de dados: selecione Atributo de data a partir do menu drop-down.
   • Nome do atributo: deixe o mesmo que “Nome do campo” (por exemplo, custom_date).
   • Nome de exibição do atributo: se desejado, adicione um nome de exibição mais fácil de usar para o campo.
   • Reportável: ative esta caixa de seleção. Isso deve ser selecionado para que a data do documento seja usada no relatório do Discover.
3. Na seção Mapeamento de origem padrão, selecione o atributo que você criou na etapa 2 para o mapeamento da data do documento.
   
4. Clique no ícone de engrenagem na coluna Transformações.
5. Selecione Transformação personalizada.
   
6. No construtor de expressões, você tem várias opções para definir uma data com base em suas necessidades:
   • Usar tempo de carregamento: para usar a data em que os documentos são carregados no XM Discover, arraste a função NOW() da seção Funções para a caixa Expressão.
     
   • Usar valor codificado: Para usar uma data específica, arraste a função TEXTTODATE() da seção Funções para a caixa Expressão e forneça o formato de data e data dentro dos parênteses.
     
     Qdica: em ambos os casos, a data resultante usará o formato AAAA-MM-DDThh:mm:ssZ.
7. Clique em Testar para ver o resultado da transformação. Se necessário, ajuste sua expressão até que o teste forneça o resultado desejado.
8. Clique em Salvar quando terminar.

Exemplos de transformação personalizada

Esta seção aborda alguns exemplos de como você pode manipular seus dados usando transformações personalizadas.

Atribuir um valor de origem personalizado

Meta: atribuir um valor de texto personalizado (“Pesquisas de abril”) ao atributo “Origem”.

Como: Aplique a seguinte transformação ao campo “Fonte” (basta colocar o valor do texto entre aspas):

Alterar “Sobrenome, Nome” para “Sobrenome do primeiro nome”

Objetivo: alterar o formato do nome de “sobrenome, primeiro nome” para “sobrenome do primeiro nome” e colocar em maiúscula a primeira letra de cada palavra.

Como: Aplique a seguinte transformação ao campo de nome:

PROPERCASE(REPLACEBYREGEXP(NAME, “(.*),(.*)”, “$2 $1”))

Converter uma data de UTC em CST

Objetivo: converter um campo de data de um fuso horário UTC para CST.

Como: Aplique a seguinte transformação ao campo END_DATE:

CONVERT_TO_TIMEZONE(END_DATE, “Etc/UTC”, “America/Chicago”)

Converter hh:mm:ss em minutos

Objetivo: converter o tempo do formato hh:mm:ss para o número de minutos.

Como: Aplicar a seguinte transformação:

GETMINUTESBETWEEN(TEXTTODATE(“1970-01-01”, “YYYY-MM-DD”), CONCAT(“1970-01-01T”, MY_TIME))

Converter tempo de época Unix em segundos para ISO 8601

Objetivo: Converter um timestamp do Unix Epoch em segundos para o formato de data ISO 8601.

Como: A seguinte transformação faz duas coisas: transforma segundos em milissegundos e, em seguida, transforma os milissegundos em uma data ISO 8601:

NUMBERTODATE(TEXTTONUMBER(CONCAT(MY_DATE, “000”))))

Derivar valor com base no fato de alguma coisa estar em uma matriz

Objetivo: Verificar o nome do estado e atribuir um valor “Área DMV” se corresponder a qualquer um dos estados listados. Caso contrário, defina como “Outros estados”.

Como: Adicione um campo de texto personalizado chamado AREA e aplique a seguinte transformação:

IF(LOWER(STATE) in [“md”, “dc”, “va”], “DMV Area”, “Other States”)

Extrair nome do artigo de um título de página

Objetivo: Extrair o nome do artigo após o último divisor “|” em um título de página.

Como: Aplicar a seguinte transformação ao campo de título da página:

TRIMRIGHT(MID(PAGE_TITLE,FINDLAST(PAGE_TITLE,”|”)+1,1000))

Unir nome e sobrenome em um único campo

Objetivo: combinar os campos FIRST_NAME e LAST_NAME em um novo campo FULL_NAME e colocar em maiúscula a primeira letra de cada palavra.

Como: adicione um campo de texto personalizado chamado FULL_NAME e aplique a seguinte transformação:

PROPERCASE(CONCAT(FIRST_NAME, ” “, LAST_NAME))

Junte-se a dois Verbatims e Carregue apenas o Combined Verbatim

Objetivo: Junte dois campos verbatim VERBATIM1 e VERBATIM2 em um novo campo VERBATIM3 e carregue apenas o verbatim combinado no XM Discover.

Como: Execute estes passos:

1. Crie um campo literal chamado VERBATIM3 e aplique a seguinte transformação a ele:CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Para os campos VERBATIM1 e VERBATIM2, defina Tipo de dados como Não mapear.

Rollup de múltiplas variáveis

Objetivo: criar um acúmulo multivariável para respostas a uma única pergunta que são divididas em vários atributos. Suponha que o conjunto de dados contém vários atributos “sim ou não” para indicar diferentes níveis de associação que um cliente pode ter:

• QID2_1 para Prata
• QID2_2 para Ouro
• QID2_3 para Platina

Você pode rolar todas as respostas “sim” em um único atributo novo para indicar o nível de associação do cliente.

Como: Aplicar a seguinte transformação:

TRIMRIGHT(CONCAT(IF(QID2_1==”Yes”, “Silver”, “”), IF(QID2_2==”Yes”, “Gold”, “”), IF(QID2_3==”Yes”, “Platinum”, “”))))

Remover caractere principal

Objetivo: remover o primeiro caractere de uma sequência de caracteres.

Como: Aplique a seguinte transformação:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Cortar zeros precedentes

Objetivo: Cortar zeros precedentes em um número.

Como: Para um valor de texto, aplique a seguinte transformação:

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

Para um valor numérico, aplique a seguinte transformação:

TEXTTONUMBER(MY_NUMBER)