Usar campos calculados para exportar matrizes como strings use-calculated-fields-to-export-arrays-as-strings

Saiba como exportar matrizes por meio de campos calculados do Real-Time CDP para destinos de armazenamento na nuvem como cadeias de caracteres. Leia este documento para entender os casos de uso ativados por essa funcionalidade.

Obtenha informações abrangentes sobre campos calculados - o que são e por que são importantes. Leia as páginas vinculadas abaixo para obter uma introdução aos campos calculados no Preparo de dados e mais informações sobre todas as funções disponíveis:

Matrizes e outros tipos de objetos na Platform arrays-strings-other-objects

No Experience Platform, você pode usar esquemas XDM para gerenciar diferentes tipos de campos. Antes de adicionar suporte para exportações de matriz, você podia exportar campos de tipo de par de valor-chave simples, como strings de Experience Platform para os destinos desejados. Um exemplo de um campo com suporte para exportação anterior é personalEmail.address:johndoe@acme.org.

Outros tipos de campo no Experience Platform incluem campos de matriz. Leia mais sobre gerenciamento de campos de matriz na interface do usuário do Experience Platform. Além dos tipos de campo suportados anteriormente, agora é possível exportar objetos de matriz, como o exemplo abaixo, concatenados em uma cadeia de caracteres usando a função array_to_string.

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

Veja mais abaixo exemplos abrangentes de como você pode usar várias funções para acessar elementos de matrizes, transformar e filtrar matrizes, unir elementos de matriz em uma cadeia de caracteres e muito mais.

Limitações conhecidas known-limitations

Observe as seguintes limitações conhecidas que se aplicam atualmente a essa funcionalidade:

Pré-requisitos prerequisites

Conecte a um destino de armazenamento na nuvem desejado. Prossiga pelas etapas de ativação para destinos de armazenamento na nuvem e vá para a etapa mapeamento.

Como exportar 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.

Exemplos de funções suportadas para exportar matrizes 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 arrays, estão documentadas junto com exemplos.

Exemplos de funções usadas para exportar matrizes 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 |.

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

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)), retornando 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

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

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"