[Beta]{class="badge informative"}

(Beta) Utilice campos calculados para exportar matrices en archivos de esquema plano use-calculated-fields-to-export-arrays-in-flat-schema-files

Obtenga información sobre cómo exportar matrices a través de campos calculados desde Real-Time CDP en archivos de esquema plano a destinos de almacenamiento en la nube. Lea este documento para comprender los casos de uso habilitados por esta funcionalidad.

Obtenga información detallada sobre los campos calculados, qué son y por qué importan. Lea las páginas vinculadas a continuación para obtener una introducción a los campos calculados en la preparación de datos y más información sobre todas las funciones disponibles:

Matrices y otros tipos de objetos en Platform arrays-strings-other-objects

En Experience Platform, puede utilizar Esquemas XDM para administrar diferentes tipos de campo. Anteriormente, podía exportar campos de tipo de par clave-valor simples, como cadenas, fuera de Experience Platform a los destinos deseados. Un ejemplo de un campo de este tipo que era compatible con la exportación anteriormente es personalEmail.address:johndoe@acme.org.

Otros tipos de campo de Experience Platform incluyen campos de matriz. Más información sobre administración de campos de matriz en la IU de Experience Platform. Además de los tipos de campo admitidos anteriormente, ahora puede exportar objetos de matriz como: organizations:[marketing, sales, engineering]. Consulte más información a continuación ejemplos extensos Obtenga información sobre cómo utilizar varias funciones para acceder a elementos de matrices, unir elementos de matrices en una cadena, etc.

Limitaciones conocidas known-limitations

Tenga en cuenta las siguientes limitaciones conocidas para la versión beta de esta funcionalidad:

Requisitos previos prerequisites

Connect a un destino de almacenamiento en la nube deseado, avance en el pasos de activación para destinos de cloud storage y llegar al asignación paso.

Cómo exportar campos calculados how-to-export-calculated-fields

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

Se abrirá una ventana modal en la que se pueden seleccionar atributos que se pueden utilizar para exportar atributos fuera de Experience Platform.

Por ejemplo, utilice la variable join función en el loyaltyID como se muestra a continuación para exportar una matriz de ID de fidelidad como una cadena concatenada con un guion bajo en un archivo CSV. Ver más información sobre este y otros ejemplos más adelante.

Seleccionar Guardar para mantener el campo calculado y volver al paso de asignación.

Vuelva a la etapa de asignación del flujo de trabajo y rellene el Campo de destino con un 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 supported-functions

Todos los documentos Funciones de preparación de datos son compatibles al activar datos en destinos basados en archivos.

Sin embargo, tenga en cuenta que actualmente se proporcionan descripciones de casos de uso extensas e información de salida de muestra para las siguientes funciones solo en la versión beta de los campos calculados y la compatibilidad de matrices para destinos:

Ejemplos de funciones utilizadas para exportar matrices 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.

join función para exportar matrices join-function-export-arrays

Utilice el join para concatenar los elementos de una matriz en una cadena, utilizando un separador deseado, como _ o |.

Por ejemplo, puede combinar los siguientes campos XDM a continuación, como se muestra en la captura de pantalla de asignación, utilizando un join('_',loyalty.loyaltyID) sintaxis:

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 _ carácter.

`First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "Marketing_Sales_Finance"

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

Utilice el iif para exportar elementos de una matriz en ciertas condiciones. Por ejemplo, continuar con organizations objeto de matriz 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"

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

Utilice el add_to_array para añadir elementos a una matriz exportada. Puede combinar esta función con el join función descrita anteriormente.

Continuación con el organizations objeto de matriz desde arriba, puede escribir una función como source: join('_', 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 _ 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"

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

Utilice el 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 un coalesce(subscriptions.hasPromotion) sintaxis para devolver la primera true de false en la matriz:

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

First_Name,Last_Name,hasPromotion
John,Doe,true

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

Utilice el size_of para indicar cuántos elementos existen en una matriz. Por ejemplo, si tiene un purchaseTime objeto de matriz con varias marcas de tiempo, puede utilizar la variable size_of función 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 size_of función, si desea acceder 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"

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

Utilice el first y last funciones para exportar el primer o el último elemento de una matriz. Por ejemplo, continuar con purchaseTime Objeto de matriz con varias marcas de tiempo de los ejemplos anteriores, puede utilizarlas para 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

Además de las funciones 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 usar valores de cadena hash directamente, 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: