Utiliser des champs calculés pour exporter des tableaux en tant que chaînes use-calculated-fields-to-export-arrays-as-strings

Découvrez comment exporter des tableaux par le biais de champs calculés de Real-Time CDP vers les destinations de stockage dans le cloud en tant que chaînes. Lisez ce document pour comprendre les cas d’utilisation activés par cette fonctionnalité.

Obtenez des informations détaillées sur les champs calculés - ce qu’ils sont et pourquoi ils comptent. Lisez les pages liées ci-dessous pour une introduction aux champs calculés dans la préparation des données et pour plus d’informations sur toutes les fonctions disponibles :

Tableaux et autres types d’objets dans Platform arrays-strings-other-objects

Dans Experience Platform, vous pouvez utiliser les schémas XDM pour gérer différents types de champs. Avant d’ajouter la prise en charge des exportations de tableaux, vous pouviez exporter des champs de type paire clé-valeur simples tels que des chaînes en dehors de l’Experience Platform vers les destinations souhaitées. personalEmail.address:johndoe@acme.org est un exemple de champ qui a été pris en charge pour l’exportation précédemment.

Les autres types de champ dans Experience Platform incluent les champs de tableau. En savoir plus sur la gestion des champs de tableau dans l’interface utilisateur Experience Platform. Outre les types de champ précédemment pris en charge, vous pouvez désormais exporter des objets de tableau tels que l’exemple ci-dessous, concaténés dans une chaîne à l’aide de la fonction 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"
}]

Reportez-vous aux exemples complets qui illustrent l’utilisation de différentes fonctions pour accéder aux éléments de tableaux, transformer et filtrer des tableaux, joindre des éléments de tableau en chaîne, etc.

Limites connues known-limitations

Notez les limites connues suivantes qui s’appliquent actuellement à cette fonctionnalité :

Conditions préalables prerequisites

Connectez-vous à une destination de stockage dans le cloud souhaitée, passez par les étapes d’activation des destinations de stockage dans le cloud et accédez à l’étape mapping.

Comment exporter des champs calculés how-to-export-calculated-fields

Dans l’étape de mappage du workflow d’activation pour les destinations de stockage dans le cloud, sélectionnez Ajouter un champ calculé.

Cela ouvre une fenêtre modale dans laquelle vous pouvez sélectionner des fonctions et des champs pour exporter des attributs hors d’Experience Platform.

Par exemple, utilisez la fonction array_to_string sur le champ organizations comme illustré ci-dessous pour exporter le tableau des organisations sous la forme d’une chaîne dans un fichier CSV. Affichez plus d'informations à ce sujet et d'autres exemples plus loin sous.

Sélectionnez Enregistrer pour conserver le champ calculé et revenir à l’étape de mappage.

De retour à l’étape de mappage du workflow, renseignez le Champ cible avec la valeur de l’en-tête de colonne que vous souhaitez pour ce champ dans les fichiers exportés.

Une fois prêt, sélectionnez Suivant pour passer à l’étape suivante du processus d’activation.

Exemples de fonctions prises en charge pour exporter des tableaux supported-functions

Toutes les fonctions de préparation de donnéesdocumentées sont prises en charge lors de l’activation de données vers des destinations basées sur des fichiers.

Les fonctions ci-dessous, spécifiques à la gestion des exportations de tableaux, sont documentées avec des exemples.

Exemples de fonctions utilisées pour exporter des tableaux examples

Consultez des exemples et des informations supplémentaires dans les sections ci-dessous pour connaître certaines des fonctions répertoriées ci-dessus. Pour le reste des fonctions répertoriées, reportez-vous à la documentation générale sur les fonctions dans la section Préparation de données.

fonction array_to_string pour exporter des tableaux array-to-string-function-export-arrays

Utilisez la fonction array_to_string pour concaténer les éléments d’un tableau dans une chaîne à l’aide d’un séparateur souhaité, tel que _ ou |.

Par exemple, vous pouvez combiner les champs XDM suivants comme illustré dans la capture d’écran de mappage à l’aide d’une syntaxe array_to_string('_',organizations) :

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les éléments du tableau sont concaténés en une seule chaîne à l’aide du caractère _.

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

fonction filterArray pour exporter des tableaux filtrés

Utilisez la fonction filterArray pour filtrer les éléments d’un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En continuant avec l’objet de tableau organizations d’en haut, vous pouvez écrire une fonction du type array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), renvoyant aux organisations ayant une valeur pour founded dans l’année 2021 ou plus récente.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les deux éléments du tableau qui répondent au critère sont concaténés en une seule chaîne à l’aide du caractère _.

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

fonction transformArray pour exporter des tableaux transformés

Utilisez la fonction transformArray pour transformer les éléments d’un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

Si vous continuez avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))), renvoyant les noms des organisations converties en majuscules.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les trois éléments du tableau sont transformés et concaténés en une seule chaîne à l’aide du caractère _.

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

fonction iif pour exporter des tableaux iif-function-export-arrays

Utilisez la fonction iif pour exporter des éléments d’un tableau sous certaines conditions. Par exemple, si vous continuez avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction conditionnelle simple comme iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Dans ce cas, le premier élément du tableau est Marketing, la personne est donc membre du service marketing.

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

fonction add_to_array pour exporter des tableaux add-to-array-function-export-arrays

Utilisez la fonction add_to_array pour ajouter des éléments à un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En continuant avec l’objet de tableau organizations d’en haut, vous pouvez écrire une fonction du type source: array_to_string('_', add_to_array(organizations,"2023")), renvoyant les organisations dont une personne est membre au cours de l’année 2023.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les trois éléments du tableau sont concaténés en une seule chaîne à l’aide du caractère _ et 2023 est également annexé à la fin de la chaîne.

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

fonction flattenArray pour exporter des tableaux aplatis

Utilisez la fonction flattenArray pour aplatir un tableau multidimensionnel exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

Si vous continuez avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction comme array_to_string('_', flattenArray(organizations)). Notez que la fonction array_to_string aplatit le tableau d’entrée par défaut dans une chaîne.

Le résultat obtenu est le même que pour la fonction array_to_string décrite plus haut.

fonction coalesce pour exporter des tableaux coalesce-function-export-arrays

Utilisez la fonction coalesce pour accéder au premier élément non nul d’un tableau et l’exporter dans une chaîne.

Par exemple, vous pouvez combiner les champs XDM suivants comme indiqué dans la capture d’écran de mappage en utilisant une syntaxe coalesce(subscriptions.hasPromotion) pour renvoyer la première valeur true de false dans le tableau :

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment la première valeur true non nulle du tableau est exportée dans le fichier .

First_Name,Last_Name,hasPromotion
John,Doe,true

fonction size_of pour exporter des tableaux sizeof-function-export-arrays

Utilisez la fonction size_of pour indiquer le nombre d’éléments présents dans un tableau. Par exemple, si vous disposez d’un objet de tableau purchaseTime avec plusieurs horodatages, vous pouvez utiliser la fonction size_of pour indiquer le nombre d’achats distincts effectués par une personne.

Par exemple, vous pouvez combiner les champs XDM suivants comme indiqué dans la capture d’écran du mappage.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment la deuxième colonne indique le nombre d’éléments dans le tableau, correspondant au nombre d’achats distincts effectués par le client.

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

Accès aux tableaux basés sur des index index-based-array-access

Vous pouvez accéder à un index d’un tableau pour exporter un seul élément du tableau. Par exemple, comme dans l’exemple ci-dessus pour la fonction size_of, si vous cherchez à accéder et à exporter uniquement la première fois qu’un client a acheté un certain produit, vous pouvez utiliser purchaseTime[0] pour exporter le premier élément de l’horodatage, purchaseTime[1] pour exporter le deuxième élément de l’horodatage, purchaseTime[2] pour exporter le troisième élément de l’horodatage, etc.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit, en exportant la première fois que le client a effectué un achat :

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

Fonctions first et last pour exporter des tableaux first-and-last-functions-export-arrays

Utilisez les fonctions first et last pour exporter le premier ou le dernier élément d’un tableau. Par exemple, si vous continuez avec l’objet de tableau purchaseTime avec plusieurs horodatages des exemples précédents, vous pouvez les utiliser pour exporter la première ou la dernière heure d’achat effectuée par une personne.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit, en exportant la première et la dernière fois que le client a effectué un achat :

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