Effectuer des transformations sur les données exportées vers des destinations d’espace de stockage à l’aide de champs calculés data-transformation-calculated-fields

Pour effectuer diverses transformations sur les données exportées vers des destinations d’espace de stockage, vous devez utiliser la fonctionnalité de champs calculés dans l’étape de mappage du workflow d’exportation. Pour plus d’informations sur les champs calculés, consultez les pages liées ci-dessous. Ces pages présentent les champs calculés dans la préparation des données et contiennent des informations supplémentaires sur toutes les fonctions disponibles :

Prérequis prerequisites

Pour utiliser des champs calculés pour les transformations de données :

Utiliser des champs calculés how-to-export-calculated-fields

À l’étape de mappage du workflow d’activation pour les destinations d’espace de stockage, sélectionnez Ajouter un champ calculé.

Une fenêtre modale s’ouvre, dans laquelle vous pouvez sélectionner les fonctions et les champs à exporter en dehors d’Experience Platform.

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

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

De retour à l’étape de mappage du workflow, remplissez le champ cible avec une 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 workflow d’activation.

Exemples de fonctions prises en charge pour effectuer des transformations de données supported-functions

Toutes les fonctions de préparation de données documenté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 ou à l’application d’un hachage aux champs, sont documentées avec des exemples.

Exemples de fonctions utilisées pour effectuer des transformations de données examples

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

array_to_string fonction 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 en chaîne, à l’aide du séparateur souhaité, tel que _ ou |. Cette fonction est utile lorsque vous souhaitez exporter les éléments d’un tableau d’Experience Platform dans un fichier CSV.

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

filterArray fonction pour exporter des tableaux filtrés filter-array

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 poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), qui renvoie les organisations avec une valeur pour founded en 2021 ou plus récent.

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

transformArray fonction pour exporter des tableaux transformés transform-array

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.

En poursuivant 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 convertis 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

iif fonction 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, en poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction conditionnelle simple telle que 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. Par conséquent, la personne est membre du service marketing.

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

add_to_array fonction 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 poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que source: array_to_string('_', add_to_array(organizations,"2023")), renvoyant les organisations dont une personne est membre en 2023.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Remarquez 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 ajouté à la fin de la chaîne.

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

flattenArray fonction pour exporter des tableaux aplatis flatten-array

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.

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

La sortie résultante est la même que pour la fonction array_to_string décrite plus haut.

coalesce fonction 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 ci-dessous comme illustré dans la capture d’écran de mappage en utilisant une syntaxe coalesce(subscriptions.hasPromotion) pour renvoyer la première true de false valeur dans le tableau :

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

First_Name,Last_Name,hasPromotion
John,Doe,true

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

Utilisez la fonction size_of pour indiquer le nombre d’éléments qui existent 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 ci-dessous comme illustré dans la capture d’écran du mappage.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez que 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é sur les 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 souhaitez 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 le premier achat du client :

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

first et fonctions de 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, en poursuivant avec l’objet de tableau purchaseTime avec plusieurs horodatages des exemples précédents, vous pouvez utiliser ces fonctions 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 le premier et le dernier achat du client :

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

Fonctions de hachage hashing-functions

D’autres fonctions disponibles sont spécifiques à l’exportation de tableaux ou d’éléments à partir d’un tableau. Vous pouvez utiliser des fonctions de hachage pour hacher les attributs dans les fichiers exportés. Par exemple, si vous disposez d’informations d’identification personnelle dans les attributs, vous pouvez hacher ces champs lors de leur exportation.

Vous pouvez hacher directement des valeurs de chaîne, par exemple md5(personalEmail.address). Si vous le souhaitez, vous pouvez également hacher des éléments individuels des champs de tableau, en supposant que les éléments du tableau soient des chaînes, comme suit : md5(purchaseTime[0])

Les fonctions de hachage prises en charge sont les suivantes :