Transformação de dados (Conectores)

Sobre a transformação de dados no Discover

Você pode transformar os dados recebidos antes de importá-los para o XM Discover. Isso é útil quando você precisa limpar seus dados ou modificar seu formato.

Para acessar as transformações de dados:

1. Ao configurar a tarefa de importação, clique no ícone de engrenagem na coluna Transformations (Transformações) ao lado do campo de dados que deseja transformar.
   
   Qdica: se quiser atualizar transformações de dados em uma tarefa existente, selecione Data Mapping (Mapeamento de dados) no menu de opções de tarefa.
   Atenção: se houver um número ao lado do ícone de engrenagem, isso significa que já existe uma transformação aplicada ao campo. Se você adicionar uma nova transformação, ela substituirá a anterior.
2. Escolha a transformação de dados desejada. Consulte as seções vinculadas para mais informações sobre cada transformação.
   
   • No Transformation (Sem transformação): não transformar o campo importado.
   • Dynamic Lookup (Consuta dinâmica): esta opção está disponível apenas para campos de consulta. Quando selecionado, esse campo aplicará os valores de pesquisa mais recentes para o campo a partir da tabela de consulta.
   • Replace Value from Lookup Table (Substituir valor da tabela de consulta): defina pares de valores de origem e valores de substituição.
   • Replace Value with RegEx (Substituir valor com RegEx): defina expressões regulares (regex) para correspondência de padrões e valores de substituição.
   • Custom Transformation (Transformação personalizada): permite criar sua própria transformação usando diferentes funções e expressões.

Dynamic Lookup (Consuta dinâmica)

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

Replace Value from Lookup Table (Substituir valor da tabela de consulta)

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

1. Certifique-se de que Replace Value from Lookup Table (Substituir valor da tabela de lookup) esteja selecionado como sua transformação.
   
2. Clique em Export Lookup (Exportar consulta) para exportar um arquivo de pesquisa em . formato XLSX.
   Qdica: recomendamos adicionar consultas por meio de um arquivo de consulta. Se você quiser adicionar consultas manualmente, avance para a etapa 8.
3. Abra o arquivo em um editor de planilhas e comece a adicionar os valores da sua consulta ao arquivo.
4. Na coluna match (corresponder), insira os valores recebidos do seu conector de dados.
   
5. Na coluna recoded (recodificado), insira os valores correspondentes que você deseja salvar no XM Discover.
6. Salve o arquivo como XLS ou XLSX.
7. No XM Discover, clique em Import Lookup (Importar consulta) e selecione o arquivo de consulta salvo no seu computador.
   
8. Se desejar, você pode editar as consultas. A coluna Source Value (Valor de origem) contém o valor proveniente do seu conector de dados, enquanto a coluna Transformed Value (Valor transformado) contém o valor que será salvo no XM Discover.
9. Você pode adicionar outros pares de consulta clicando no sinal de mais ( + ) ou remover pares clicando no sinal de menos ( – ) ao lado do par.
10. Clique em Salve (Salvar).

Replace Value with RegEx (Substituir valor com RegEx)

Você pode substituir valores recebidos usando expressões regulares (regex), permitindo limpar dados antes de carregá-los no seu projeto do XM Discover.

1. Certifique-se de que Replace Value with RegEx (Substituir valor com RegEx) esteja selecionado como sua transformação.
   
2. Especifique o padrão de busca regex no campo Enter regular expression for pattern matching (Inserir expressão regular para correspondência de padrão).
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 do seu conjunto de dados no campo Sample Source Value (Valor de origem de exemplo) e clique em Test (Testar). O resultado da transformação é exibido na caixa Sample Transformed Value (Valor transformado de exemplo).
5. Clique em Salve (Salvar).

Custom Transformation (Transformação personalizada)

É possível transformar dados recebidos usando suas próprias expressões personalizadas. As transformações personalizadas permitem muitos tipos de manipulação de dados, incluindo alterar formatos de data, unir campos, remover zeros à esquerda e muito mais.

1. Certifique-se de que Custom Transformation (Transformação personalizada) esteja selecionada como sua transformação de dados.
   
2. Crie sua expressão de transformação dos dados. A expressão varia conforme os dados recebidos e o resultado desejado. Consulte a página de suporte Building Expressions (Criação de expressões) para mais informações sobre como criar sua expressão.
3. Se você estiver criando um campo novo, poderá alterar o Data Type (Tipo de dados) do campo. Ao transformar um campo existente, não é possível alterar o tipo de dados.
4. Para testar sua transformação, insira um valor de dados de teste no campo Test Value (Valor de teste) e clique em Test (Testar). O resultado será exibido ao lado do botão “Test” (Testar).
5. Quando terminar de elaborar e testar sua expressão, clique em Save (Salvar).

Geração automática de IDs naturais

Quando você envia dados para o XM Discover, os documentos podem não conter um ID exclusivo para ser usado como ID natural, um campo importante porque ajuda a identificar documentos duplicados. Seus dados carregados devem ter um identificador exclusivo para ser usado como ID natural. Esta seção explica como definir um 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:
   • Field Name (Nome do campo): informe o nome do campo.
   • Data Type (Tipo de dados): selecione Text Attribute (Atributo de texto) no menu suspenso.
   • Attribute Name (Nome do atributo): deixe igual ao “Nome do campo”.
   • Attribute Display Name (Nome de exibição do atributo): se desejar, insira um nome de exibição para o campo mais fácil de usar.
   • Reportable (Reportável): ative esta caixa de seleção. Ela deve estar ativada para que o ID natural possa ser usado em relatórios.
3. Na seção Default Source Mapping (Mapeamento de origem 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 Transformations (Transformações).
5. Selecione Custom Transformation (Transformação personalizada).
   
6. Procure a função GENERATE_ID() e arraste-a da seção Functions (Funções) para a caixa Expression (Expressão).
7. Clique em Salve (Salvar).
   Qdica: clique em Apply (Aplicar) para salvar seus mapeamentos.

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

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

Quando você carrega 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 explica 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 Source Mapping (Mapeamento de origem) para adicionar um novo campo personalizado.
   
2. Forneça as seguintes informações para o campo personalizado:
   • Field Name (Nome do campo): informe o nome do campo (por exemplo, campo_personalizado).
   • Data Type (Tipo de dados): selecione Date Attribute (Atributo de data) no menu suspenso.
   • Attribute Name (Nome do atributo): deixe igual ao “Nome do campo” (por exemplo, campo_personalizado).
   • Attribute Display Name (Nome de exibição do atributo): se desejar, insira um nome de exibição para o campo mais fácil de usar.
   • Reportable (Reportável): ative esta caixa de seleção. Ela deve ser ativada para que a data do documento seja usada nos relatórios do Discover.
3. Na seção Default Source Mapping (Mapeamento de origem padrão), selecione o atributo que você criou na etapa 2 para o mapeamento de Document Date (Data do documento).
   
4. Clique no ícone de engrenagem na coluna Transformations (Transformações).
5. Selecione Custom Transformation (Transformação personalizada).
   
6. No criador de expressões, você tem várias opções para definir uma data com base nas suas necessidades:
   • Usar data de carregamento: para usar a data em que os documentos são carregados no XM Discover, arraste a função NOW() da seção Functions (Funções) para a caixa Expression (Expressão).
     
   • Usar valor fixo: para usar uma data específica, arraste a função TEXTTODATE() da seção Functions (Funções) para a caixa Expression (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 AAAA-MM-DDThh:mm:ssZ.
7. Clique em Test (Testar) para ver o resultado da transformação. Se necessário, ajuste sua expressão até que o teste retorne o resultado desejado.
8. Clique em Save (Salvar) quando terminar.

Exemplos de transformação personalizada

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

Atribuir um valor de origem personalizado

Objetivo: atribuir um valor de texto personalizado (“Pesquisas de abril”) ao atributo “Source” (Fonte).

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

Alterar “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 usar a primeira letra de cada palavra em maiúscula.

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

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

Converter uma data de UTC para CST

Objetivo: converter um campo de data de um fuso horário UTC para o 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: aplique a seguinte transformação:

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

Converter Unix Epoch Time em segundos para ISO 8601

Objetivo: converter um carimbo de data e hora do Unix em segundos para o formato de data ISO 8601.

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

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

Derivar um valor com base na presença de algo em um array.

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

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

SE(LOWER(STATE) em [“md”, “dc”, “va”], “Área DMV”, “Outros estados”)

Extrair o nome do artigo do título de uma 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))

Juntar nome e sobrenome em um único campo

Objetivo: combinar os campos FIRST_NAME (nome) e LAST_NAME (sobrenome) em um novo campo FULL_NAME (nome completo) e escrever a primeira letra de cada palavra em maiúscula.

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

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

Unir dois verbatins e carregar apenas o verbatim combinado

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

Como: execute as seguintes etapas:

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

Rollup multivariável

Objetivo: criar um rollup multivariável para respostas a uma única pergunta que são divididas 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 de um cliente:

• QID2_1 para Silver
• QID2_2 para Gold
• QID2_3 para Platinum

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

Como: aplique a seguinte transformação:

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

Remover o primeiro caractere

Objetivo: remover o primeiro caractere de uma string.

Como: aplique a seguinte transformação:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Remover zeros à esquerda

Objetivo: remover zeros à esquerda de 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)