Realizar transformaciones en los datos exportados a destinos de almacenamiento en la nube mediante campos calculados data-transformation-calculated-fields

Para realizar varias transformaciones en los datos exportados a destinos de almacenamiento en la nube, debe utilizar la funcionalidad de campos calculados en el paso de asignación del flujo de trabajo de exportación. Para obtener información detallada sobre los campos calculados, visite las páginas vinculadas a continuación. Estas páginas incluyen una introducción a los campos calculados en la preparación de datos y más información acerca de todas las funciones disponibles:

Requisitos previos prerequisites

Para utilizar campos calculados para transformaciones de datos:

Trabajar con campos calculados how-to-export-calculated-fields

En el paso de asignación del flujo de trabajo de activación para los destinos de almacenamiento en la nube, seleccione Agregar campo calculado.

Esto abre una ventana modal en la que se pueden seleccionar funciones y campos para exportar atributos desde Experience Platform.

Por ejemplo, utilice la función array_to_string en el campo organizations como se muestra a continuación para exportar la matriz de organizaciones como una cadena en un archivo CSV. Ver más información sobre este y otros ejemplos más abajo.

Seleccione Guardar para conservar el campo calculado y volver al paso de asignación.

Cuando vuelva al paso de asignación del flujo de trabajo, rellene el campo de destino con el valor del encabezado de columna que desee para este campo en los archivos exportados.

Cuando esté listo, seleccione Siguiente para continuar con el siguiente paso del flujo de trabajo de activación.

Funciones compatibles de ejemplo para realizar transformaciones de datos supported-functions

Todas las funciones de preparación de datos documentadas son compatibles al activar datos en destinos basados en archivos.

Las funciones siguientes, específicas para gestionar exportaciones de matrices o aplicar hash a campos, se documentan junto con ejemplos.

Ejemplos de funciones utilizadas para realizar transformaciones de datos examples

Consulte los ejemplos y la información adicional en las secciones siguientes para ver algunas de las funciones enumeradas anteriormente. Para el resto de las funciones enumeradas, consulte la documentación de funciones generales en la sección Preparación de datos.

Función array_to_string para exportar matrices array-to-string-function-export-arrays

Utilice la función array_to_string para concatenar los elementos de una matriz en una cadena, utilizando un separador deseado, como _ o |. Esta función es útil cuando desea exportar los elementos de una matriz de Experience Platform a un archivo CSV.

Por ejemplo, puede combinar los siguientes campos XDM a continuación, como se muestra en la captura de pantalla de asignación, utilizando una sintaxis array_to_string('_',organizations):

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo los elementos de la matriz se concatenan en una sola cadena utilizando el carácter _.

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

Función filterArray para exportar matrices filtradas filter-array

Utilice la función filterArray para filtrar los elementos de una matriz exportada. Puede combinar esta función con la función array_to_string descrita anteriormente.

Continuando con el objeto de matriz organizations desde arriba, puede escribir una función como array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), que devuelve las organizaciones con un valor para founded en el año 2021 o más reciente.

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo los dos elementos de la matriz que cumplen el criterio se concatenan en una sola cadena utilizando el carácter _.

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

Función transformArray para exportar matrices transformadas transform-array

Utilice la función transformArray para transformar los elementos de una matriz exportada. Puede combinar esta función con la función array_to_string descrita anteriormente.

Continuando con el objeto de matriz organizations desde arriba, puede escribir una función como array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))), devolviendo los nombres de las organizaciones convertidas a mayúsculas.

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo los tres elementos de la matriz se transforman y concatenan en una sola cadena utilizando el carácter _.

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

Función iif para exportar matrices iif-function-export-arrays

Utilice la función iif para exportar elementos de una matriz en ciertas condiciones. Por ejemplo, si continúa con el objeto de matriz organizations desde arriba, puede escribir una función condicional simple como iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

En este caso, el archivo de salida tiene el siguiente aspecto. En este caso, el primer elemento de la matriz es Marketing, por lo que la persona es miembro del departamento de marketing.

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

Función add_to_array para exportar matrices add-to-array-function-export-arrays

Utilice la función add_to_array para agregar elementos a una matriz exportada. Puede combinar esta función con la función array_to_string descrita anteriormente.

Continuando con el objeto de matriz organizations desde arriba, puede escribir una función como source: array_to_string('_', add_to_array(organizations,"2023")), que devuelve las organizaciones de las que es miembro una persona en el año 2023.

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo los tres elementos de la matriz se concatenan en una sola cadena utilizando el carácter _ y 2023 también se anexa al final de la cadena.

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

Función flattenArray para exportar matrices aplanadas flatten-array

Utilice la función flattenArray para acoplar una matriz multidimensional exportada. Puede combinar esta función con la función array_to_string descrita anteriormente.

Continuando con el objeto de matriz organizations desde arriba, puede escribir una función como array_to_string('_', flattenArray(organizations)). Tenga en cuenta que la función array_to_string aplana la matriz de entrada de forma predeterminada en una cadena.

El resultado es el mismo que para la función array_to_string descrita anteriormente.

Función coalesce para exportar matrices coalesce-function-export-arrays

Utilice la función coalesce para acceder al primer elemento no nulo de una matriz y exportarlo a una cadena.

Por ejemplo, puede combinar los siguientes campos XDM a continuación, como se muestra en la captura de pantalla de asignación, utilizando una sintaxis coalesce(subscriptions.hasPromotion) para devolver el primer valor true de false en la matriz:

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo se exporta en el archivo el primer valor true no nulo de la matriz.

First_Name,Last_Name,hasPromotion
John,Doe,true

Función size_of para exportar matrices sizeof-function-export-arrays

Utilice la función size_of para indicar cuántos elementos existen en una matriz. Por ejemplo, si tiene un objeto de matriz purchaseTime con varias marcas de tiempo, puede usar la función size_of para indicar cuántas compras independientes realizó una persona.

Por ejemplo, puede combinar los siguientes campos XDM a continuación, como se muestra en la captura de pantalla de asignación.

En este caso, el archivo de salida tiene el siguiente aspecto. Observe cómo la segunda columna indica el número de elementos de la matriz, correspondiente al número de compras independientes realizadas por el cliente.

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

Acceso a matrices basadas en índices index-based-array-access

Puede acceder al índice de una matriz para exportar un solo elemento de la matriz. Por ejemplo, similar al ejemplo anterior para la función size_of, si desea tener acceso y exportar solo la primera vez que un cliente ha comprado un determinado producto, puede utilizar purchaseTime[0] para exportar el primer elemento de la marca de tiempo, purchaseTime[1] para exportar el segundo elemento de la marca de tiempo, purchaseTime[2] para exportar el tercer elemento de la marca de tiempo, etc.

En este caso, el archivo de salida tiene el siguiente aspecto, al exportar la primera vez que el cliente ha realizado una compra:

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

Funciones first y last para exportar matrices first-and-last-functions-export-arrays

Utilice las funciones first y last para exportar el primer o último elemento de una matriz. Por ejemplo, si continúa con el objeto de matriz purchaseTime con varias marcas de tiempo de los ejemplos anteriores, puede utilizarlas en funciones para exportar la primera o la última hora de compra realizada por una persona.

En este caso, el archivo de salida tiene el siguiente aspecto, al exportar la primera y la última vez que el cliente ha realizado una compra:

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

Funciones hash hashing-functions

Otras funciones disponibles son específicas para exportar matrices o elementos de una matriz. Puede utilizar funciones hash para cifrar atributos en los archivos exportados. Por ejemplo, si tiene información de identificación personal en los atributos, puede hash en esos campos al exportarlos.

Puede hash directamente los valores de cadena, por ejemplo md5(personalEmail.address). Si lo desea, también puede hash elementos individuales de campos de matriz, suponiendo que los elementos de la matriz son cadenas, como se muestra a continuación: md5(purchaseTime[0])

Las funciones hash admitidas son: