Executar transformações nos dados exportados para destinos de armazenamento na nuvem usando campos calculados data-transformation-calculated-fields

Para executar várias transformações nos dados exportados para destinos de armazenamento na nuvem, você deve usar a funcionalidade de campos calculados na etapa de mapeamento do fluxo de trabalho de exportação. Para obter informações detalhadas sobre campos calculados, visite as páginas vinculadas abaixo. Essas páginas incluem uma introdução aos campos calculados no Preparo de dados e mais informações sobre todas as funções disponíveis:

Pré-requisitos prerequisites

Para usar campos calculados para transformações de dados:

Como trabalhar com campos calculados how-to-export-calculated-fields

Na etapa de mapeamento do fluxo de trabalho de ativação para destinos de armazenamento na nuvem, selecione Adicionar campo calculado.

Isso abre uma janela modal onde você pode selecionar funções e campos para exportar atributos do Experience Platform.

Por exemplo, use a função array_to_string no campo organizations, como mostrado abaixo, para exportar a matriz de organizações como uma cadeia de caracteres em um arquivo CSV. Exibir mais informações sobre este e outros exemplos mais abaixo.

Selecione Salvar para manter o campo calculado e retornar à etapa de mapeamento.

De volta à etapa de mapeamento do fluxo de trabalho, preencha o campo de Destino com um valor do cabeçalho de coluna desejado para este campo nos arquivos exportados.

Quando estiver pronto, selecione Avançar para prosseguir para a próxima etapa do fluxo de trabalho de ativação.

Amostras de funções compatíveis para executar transformações de dados supported-functions

Todas as funções de Preparo de Dados documentadas têm suporte ao ativar dados para destinos baseados em arquivo.

As funções abaixo, específicas para lidar com exportações de matrizes ou aplicar hash a campos, estão documentadas junto com exemplos.

Exemplos de funções usadas para executar transformações de dados examples

Consulte exemplos e informações adicionais nas seções abaixo para algumas das funções listadas acima. Para o restante das funções listadas, consulte a documentação de funções gerais na seção Preparo de dados.

Função array_to_string para exportar matrizes array-to-string-function-export-arrays

Use a função array_to_string para concatenar os elementos de uma matriz em uma sequência, usando um separador desejado, como _ ou |. Essa função é útil quando você deseja exportar os elementos de uma matriz do Experience Platform para um arquivo CSV.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento, usando uma sintaxe array_to_string('_',organizations):

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os elementos da matriz são concatenados em uma única string usando o caractere _.

First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':456,'orgName':'Superstar Inc','founded':2004,'latestInteraction':1692921600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

Função filterArray para exportar matrizes filtradas filter-array

Use a função filterArray para filtrar os elementos de uma matriz exportada. É possível combinar essa função com a função array_to_string descrita mais acima.

Continuando com o objeto de matriz organizations acima, você pode gravar uma função como array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), que retorna as organizações com um valor para founded no ano de 2021 ou mais recente.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os dois elementos da matriz que atendem ao critério são concatenados em uma única string usando o caractere _.

John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

Função transformArray para exportar matrizes transformadas transform-array

Use a função transformArray para transformar os elementos de uma matriz exportada. É possível combinar essa função com a função array_to_string descrita mais acima.

Continuando com o objeto de matriz organizations acima, você pode gravar uma função como array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))), retornando os nomes das organizações convertidas em maiúsculas.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são transformados e concatenados em uma única string usando o caractere _.

John,Doe,johndoe@acme.org,ACME INC_SUPERSTAR INC_ENERGY CORP

Função iif para exportar matrizes iif-function-export-arrays

Use a função iif para exportar elementos de uma matriz sob determinadas condições. Por exemplo, ao continuar com o objeto de matriz organizations acima, você pode gravar uma função condicional simples como iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Nesse caso, o primeiro elemento do array é Marketing, então a pessoa é um membro do departamento de marketing.

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

Função add_to_array para exportar matrizes add-to-array-function-export-arrays

Use a função add_to_array para adicionar elementos a uma matriz exportada. É possível combinar essa função com a função array_to_string descrita mais acima.

Continuando com o objeto de matriz organizations acima, você pode gravar uma função como source: array_to_string('_', add_to_array(organizations,"2023")), retornando as organizações das quais uma pessoa é membro no ano de 2023.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são concatenados em uma única string usando o caractere _ e 2023 também é anexado ao final da string.

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

Função flattenArray para exportar matrizes niveladas flatten-array

Use a função flattenArray para nivelar uma matriz multidimensional exportada. É possível combinar essa função com a função array_to_string descrita mais acima.

Continuando com o objeto de matriz organizations acima, você pode gravar uma função como array_to_string('_', flattenArray(organizations)). Observe que a função array_to_string nivela a matriz de entrada por padrão em uma cadeia de caracteres.

A saída resultante é a mesma da função array_to_string descrita mais acima.

Função coalesce para exportar matrizes coalesce-function-export-arrays

Use a função coalesce para acessar e exportar o primeiro elemento não nulo de uma matriz em uma cadeia de caracteres.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, conforme mostrado na captura de tela de mapeamento, usando uma sintaxe coalesce(subscriptions.hasPromotion) para retornar o primeiro true de valor false na matriz:

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como o primeiro valor true não nulo na matriz é exportado no arquivo.

First_Name,Last_Name,hasPromotion
John,Doe,true

Função size_of para exportar matrizes sizeof-function-export-arrays

Use a função size_of para indicar quantos elementos existem em uma matriz. Por exemplo, se você tiver um objeto de matriz purchaseTime com vários carimbos de data e hora, poderá usar a função size_of para indicar quantas compras separadas foram feitas por uma pessoa.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como a segunda coluna indica o número de elementos na matriz, correspondente ao número de compras separadas feitas pelo cliente.

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

Acesso ao array baseado em índice index-based-array-access

Você pode acessar um índice de uma matriz para exportar um único item da matriz. Por exemplo, semelhante ao exemplo acima para a função size_of, se você quiser acessar e exportar apenas a primeira vez que um cliente tiver comprado um determinado produto, você poderá usar purchaseTime[0] para exportar o primeiro elemento do carimbo de data e hora, purchaseTime[1] para exportar o segundo elemento do carimbo de data e hora, purchaseTime[2] para exportar o terceiro elemento do carimbo de data e hora e assim por diante.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira vez que o cliente fez uma compra:

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

first e last funções para exportar matrizes first-and-last-functions-export-arrays

Use as funções first e last para exportar o primeiro ou o último elemento em uma matriz. Por exemplo, continuando com o objeto de matriz purchaseTime com vários carimbos de data e hora dos exemplos anteriores, você pode usá-los para funções a fim de exportar a primeira ou a última compra feita por uma pessoa.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira e a última vez que o cliente fez uma compra:

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"

Funções de hash hashing-functions

Outras funções disponíveis são específicas para exportar matrizes ou elementos de uma matriz. Você pode usar funções de hash para fazer hash de atributos nos arquivos exportados. Por exemplo, se você tiver informações de identificação pessoal nos atributos, é possível aplicar hash a esses campos ao exportá-los.

Você pode hash de valores de cadeias de caracteres diretamente, por exemplo md5(personalEmail.address). Se desejar, você também pode aplicar hash a elementos individuais de campos de matriz, supondo que os elementos na matriz sejam cadeias de caracteres, como esta: md5(purchaseTime[0])

As funções de hash compatíveis são: