Transformação de dados (conectores)

Sobre a transformação de dados no Discover

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

Para acessar as transformações de dados:

1. Ao configurar o trabalho de importação, clique no ícone de engrenagem na coluna Transformações avançar do campo de dados que você deseja transformar.
   
   Qdica: se você quiser atualizar as transformações de dados de um trabalho existente, selecione Data Mapping (Mapeamento de dados ) no menu de opções de trabalhos.
   Atenção: Se o ícone de engrenagem tiver um número avançar a ele, 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.
   
   • No Transformation (Sem transformação): Não transformar o campo importado.
   • Pesquisa dinâmica: Essa 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: Definir pares de valores de origem e valores de substituição.
   • Substituir valor por RegEx: Definir expressões regulares (regex) para correspondência de padrões e valores de substituição.
   • Transformação personalizada: Crie sua própria transformação usando diferentes funções e expressões.

Pesquisa dinâmica

Essa opção só está disponível para campos de dados que fazem referência a uma tabela de pesquisa 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 ao seu projeto XM Discover. Uma tabela de pesquisa permite que você defina os valores de origem a serem substituídos quando salvos no XM Discover.

1. Certifique-se de que Replace Value from Lookup Table esteja selecionado como sua transformação.
   
2. Clique em Export Lookup para exportar um arquivo de pesquisa no formato .XLSX.
   Qdica: recomendamos adicionar pesquisas por meio de um arquivo de pesquisa. Se quiser adicionar pesquisas manualmente, pule 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 de seu conector de dados.
   
5. Na coluna recodificada , 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 Source Value (Valor de origem) contém o valor do seu conector de dados, enquanto a coluna Transformed Value (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 pares clicando no sinal de menos ( – ) avançar do par.
10. Clique em Salvar.

Substituir valor por RegEx

Você pode substituir os valores de dados de entrada usando expressões regulares, ou regex, o que permite limpar os dados antes de carregá-los no seu projeto XM Discover.

1. Certifique-se de que Replace Value with RegEx esteja selecionado como sua transformação.
   
2. Especifique o padrão de pesquisa regex no campo Enter regular expression for pattern matching (Inserir expressão regular para correspondência de padrões ).
3. Especifique a string de substituição regex no campo Enter regular expression for replacement value (Inserir expressão regular para valor de substituição ).
4. Para testar a transformação, insira um exemplo de seu conjunto de dados no campo Amostra Source Value (Valor da fonte de amostra ) e clique em Test (Testar). O resultado da transformação é exibido na caixa Amostra Transformed Value (Exemplo de valor transformado ).
5. Clique em Salvar.

Transformação personalizada

Você pode transformar os 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 união de campos, a remoção de zeros à esquerda e muito mais.

1. Certifique-se de que a 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á de acordo com os dados recebidos e o resultado desejado. Consulte a página de suporte Building Expressions para obter mais informações sobre como criar sua expressão.
3. Se estiver criando um novo campo, você poderá alterar o Data Type do campo. Se estiver transformando um campo existente, você não poderá alterar o tipo de dados.
4. Para testar sua transformação, insira um valor de dados de teste no campo Valor de teste e clique em Testar. O resultado aparecerá avançar do botão “Test”.
5. Quando terminar de criar e testar sua expressão, clique em Save (Salvar).

Geração automática de IDs naturais

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

1. Ao mapear dados, clique no sinal de mais ( + ) na seção Source Mapping (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 do campo.
   • Tipo de dados: Selecione Text Atributo de texto) no menu suspenso.
   • Nome Atributo: Deixe-o igual ao “Nome do campo”
   • Nome de exibição Atributo: Se desejar, insira um nome de exibição mais fácil de usar para o campo.
   • Reportável: Ative essa caixa de seleção. Isso deve ser selecionado para que você possa usar a ID natural nos relatórios.
3. Na seção Default Source Mapping (Mapeamento de origem padrão ), selecione o atributo criado na etapa 2 para o mapeamento da 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 Functions para a caixa Expression.
7. Clique em Salvar.
   Qdica: certifique-se de clicar em Aplicar ) para salvar seus mapeamentos.

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

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

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

1. Ao mapear dados, clique no sinal de mais ( + ) na seção Source Mapping (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 do campo (por exemplo, custom_date).
   • Tipo de dados: Selecione Date Atributo de data) no menu suspenso.
   • Nome Atributo: Deixe-o igual ao “Nome do campo” (por exemplo, custom_date).
   • Nome de exibição Atributo: Se desejar, adicione um nome de exibição mais fácil de usar para o campo.
   • Reportável: Ative essa caixa de seleção. Isso deve ser selecionado para que a data do documento seja usada no relatório Discover.
3. Na seção Default Source Mapping (Mapeamento de origem padrão ), selecione o atributo criado 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 criador de expressões, você tem várias opções para definir uma data com base em suas necessidades:
   • Use o 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 a data e o formato da data entre parênteses.
     
     Qdica: em ambos os casos, a data resultante usará o formato YYYY-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 (“April Surveys”) ao atributo”Source”.

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

Altere “Last Name,First Name” (Sobrenome, Nome) para “First Name Last Name” (Nome, Sobrenome)

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

Como: Aplicar a seguinte transformação ao campo name:

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

Converter uma data de UTC para CST

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

Como: Aplicar 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 a hora da época do Unix em segundos para ISO 8601

Objetivo: Converter um carimbo de data/hora de época Unix em segundos para o formato de data ISO 8601.

Como: A transformação a seguir 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 algo estar em uma matriz

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

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

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

Extrair o 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))

Junte o nome e o sobrenome em um único campo

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

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

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

Unir dois verbatims e carregar somente o verbatim combinado

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

Como: Execute estas etapas:

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

Rollup multivariável

Objetivo: criar um rollup multivariável para respostas a uma única pergunta que esteja dividida em vários atributos. Suponha que o conjunto de dados contenha vários atributos “sim ou não” para indicar diferentes níveis de associação que um cliente pode ter:

• QID2_1 para Silver
• QID2_2 para ouro
• QID2_3 para Platinum

Você pode agrupar todas as respostas “sim” em um único atributo novo para indicar o nível 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 o caractere principal

Objetivo: remover o primeiro caractere de uma cadeia de caracteres.

Como: Aplicar a seguinte transformação:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Aparar zeros à esquerda

Objetivo: aparar os zeros à esquerda em um número.

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

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

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

TEXTTONUMBER(MY_NUMBER)