Utilizzare i campi calcolati per esportare matrici come stringhe use-calculated-fields-to-export-arrays-as-strings

Scopri come esportare array tramite campi calcolati da Real-Time CDP a destinazioni di archiviazione cloud come stringhe. Leggi questo documento per comprendere i casi d’uso abilitati da questa funzionalità.

Ottieni informazioni complete sui campi calcolati: cosa sono e perché sono importanti. Leggi le pagine collegate di seguito per un’introduzione ai campi calcolati in Preparazione dati e ulteriori informazioni su tutte le funzioni disponibili:

Array e altri tipi di oggetti in Platform arrays-strings-other-objects

Ad Experience Platform, puoi utilizzare schemi XDM per gestire diversi tipi di campo. Prima di aggiungere il supporto per le esportazioni di array, era possibile esportare semplici campi di tipo coppia chiave-valore, come stringhe di Experience Platform, nelle destinazioni desiderate. Un esempio di questo campo precedentemente supportato per l'esportazione è personalEmail.address:johndoe@acme.org.

Altri tipi di campo in Experience Platform includono i campi array. Ulteriori informazioni sulla gestione dei campi array nell'interfaccia utente Experience Platform. Oltre ai tipi di campo supportati in precedenza, è ora possibile esportare oggetti array come l'esempio seguente, concatenati in una stringa utilizzando la funzione 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"
}]

Di seguito sono riportati estesi esempi di come utilizzare varie funzioni per accedere a elementi di array, trasformare e filtrare array, unire elementi di array in una stringa e altro ancora.

Limitazioni note known-limitations

Tieni presente le seguenti limitazioni note attualmente applicabili a questa funzionalità:

Prerequisiti prerequisites

Connetti a una destinazione di archiviazione cloud desiderata, segui i passaggi di attivazione per le destinazioni di archiviazione cloud e procedi al passaggio mappatura.

Come esportare i campi calcolati how-to-export-calculated-fields

Nel passaggio di mappatura del flusso di lavoro di attivazione per le destinazioni di archiviazione cloud, seleziona Aggiungi campo calcolato.

Viene visualizzata una finestra modale in cui è possibile selezionare funzioni e campi per esportare attributi da Experience Platform.

Ad esempio, utilizza la funzione array_to_string nel campo organizations come mostrato di seguito per esportare l'array organization come stringa in un file CSV. Visualizza ulteriori informazioni su questo e altri esempi più avanti.

Seleziona Salva per mantenere il campo calcolato e tornare al passaggio di mappatura.

Tornando al passaggio di mappatura del flusso di lavoro, compila il campo di destinazione con il valore dell'intestazione di colonna desiderata per questo campo nei file esportati.

Al termine, seleziona Avanti per procedere al passaggio successivo del flusso di lavoro di attivazione.

Funzioni supportate di esempio per esportare array supported-functions

Tutte le funzioni di preparazione dati documentate sono supportate quando si attivano i dati in destinazioni basate su file.

Le funzioni seguenti, specifiche per la gestione delle esportazioni di array, sono documentate insieme ad esempi.

Esempi di funzioni utilizzate per esportare array examples

Consulta gli esempi e ulteriori informazioni nelle sezioni seguenti per alcune delle funzioni elencate in precedenza. Per le altre funzioni elencate, consulta la documentazione sulle funzioni generali nella sezione Preparazione dati.

Funzione array_to_string per esportare array array-to-string-function-export-arrays

Utilizzare la funzione array_to_string per concatenare gli elementi di un array in una stringa utilizzando un separatore desiderato, ad esempio _ o |.

Ad esempio, puoi combinare i seguenti campi XDM come mostrato nella schermata di mappatura utilizzando una sintassi array_to_string('_',organizations):

In questo caso, il file di output si presenta come di seguito. Gli elementi dell'array vengono concatenati in una singola stringa utilizzando il carattere _.

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}"

Funzione filterArray per esportare array filtrati

Utilizzare la funzione filterArray per filtrare gli elementi di un array esportato. È possibile combinare questa funzione con la funzione array_to_string descritta in precedenza.

Continuando con l'oggetto array organizations dall'alto, è possibile scrivere una funzione come array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), restituendo alle organizzazioni un valore per founded nell'anno 2021 o più recente.

In questo caso, il file di output si presenta come di seguito. I due elementi dell'array che soddisfano il criterio vengono concatenati in una singola stringa utilizzando il carattere _.

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

Funzione transformArray per esportare array trasformati

Utilizzare la funzione transformArray per trasformare gli elementi di un array esportato. È possibile combinare questa funzione con la funzione array_to_string descritta in precedenza.

Continuando con l'oggetto array organizations dall'alto, è possibile scrivere una funzione come array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))), restituendo i nomi delle organizzazioni convertite in lettere maiuscole.

In questo caso, il file di output si presenta come di seguito. I tre elementi dell'array vengono trasformati e concatenati in una singola stringa utilizzando il carattere _.

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

Funzione iif per esportare array iif-function-export-arrays

Utilizzare la funzione iif per esportare gli elementi di un array in determinate condizioni. Ad esempio, continuando con l'oggetto array organizations dall'alto, è possibile scrivere una funzione condizionale semplice come iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

In questo caso, il file di output si presenta come di seguito. In questo caso, il primo elemento dell’array è Marketing, quindi la persona è membro del reparto marketing.

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

Funzione add_to_array per esportare array add-to-array-function-export-arrays

Utilizzare la funzione add_to_array per aggiungere elementi a un array esportato. È possibile combinare questa funzione con la funzione array_to_string descritta in precedenza.

Continuando con l'oggetto array organizations dall'alto, è possibile scrivere una funzione come source: array_to_string('_', add_to_array(organizations,"2023")), restituendo le organizzazioni di cui una persona è membro nel 2023.

In questo caso, il file di output si presenta come di seguito. Nota come i tre elementi dell’array sono concatenati in una singola stringa utilizzando il carattere _ e 2023 viene aggiunto alla fine della stringa.

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

Funzione flattenArray per esportare array appiattiti

Utilizzare la funzione flattenArray per appiattire una matrice multidimensionale esportata. È possibile combinare questa funzione con la funzione array_to_string descritta in precedenza.

Continuando con l'oggetto array organizations dall'alto, è possibile scrivere una funzione come array_to_string('_', flattenArray(organizations)). La funzione array_to_string appiattisce l'array di input per impostazione predefinita in una stringa.

L'output risultante è lo stesso della funzione array_to_string descritta più sopra.

Funzione coalesce per esportare array coalesce-function-export-arrays

Utilizzare la funzione coalesce per accedere ed esportare il primo elemento non Null di un array in una stringa.

Ad esempio, puoi combinare i seguenti campi XDM come mostrato nella schermata di mappatura utilizzando una sintassi coalesce(subscriptions.hasPromotion) per restituire il primo true del valore false nell'array:

In questo caso, il file di output si presenta come di seguito. Il primo valore true non nullo nell'array viene esportato nel file.

First_Name,Last_Name,hasPromotion
John,Doe,true

Funzione size_of per esportare array sizeof-function-export-arrays

Utilizzare la funzione size_of per indicare quanti elementi esistono in un array. Ad esempio, se si dispone di un oggetto array purchaseTime con più marche temporali, è possibile utilizzare la funzione size_of per indicare quanti acquisti separati sono stati effettuati da una persona.

Ad esempio, puoi combinare i seguenti campi XDM come mostrato nella schermata di mappatura.

In questo caso, il file di output si presenta come di seguito. Osserva come la seconda colonna indica il numero di elementi nell’array, corrispondente al numero di acquisti separati effettuati dal cliente.

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

Accesso all'array basato su indice index-based-array-access

È possibile accedere a un indice di un array per esportare un singolo elemento dall’array. Ad esempio, come nell'esempio precedente per la funzione size_of, se si desidera accedere ed esportare solo la prima volta che un cliente ha acquistato un determinato prodotto, è possibile utilizzare purchaseTime[0] per esportare il primo elemento del timestamp, purchaseTime[1] per esportare il secondo elemento del timestamp, purchaseTime[2] per esportare il terzo elemento del timestamp e così via.

In questo caso, il file di output si presenta come di seguito, esportando la prima volta che il cliente ha effettuato un acquisto:

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

first e last funzioni per esportare array first-and-last-functions-export-arrays

Utilizzare le funzioni first e last per esportare il primo o l'ultimo elemento di un array. Ad esempio, continuando con l'oggetto array purchaseTime con più marche temporali degli esempi precedenti, è possibile utilizzarle per le funzioni per esportare il primo o l'ultimo acquisto effettuato da una persona.

In questo caso, il file di output si presenta come di seguito, esportando la prima e l’ultima volta che il cliente ha effettuato un acquisto:

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