Show Menu
TEMAS×

Asignación de un archivo CSV a un esquema XDM

Para poder ingerir datos CSV en Adobe Experience Platform, los datos deben asignarse a un esquema Experience Data Model (XDM). Este tutorial explica cómo asignar un archivo CSV a un esquema XDM mediante la interfaz de usuario Platform .
Además, en el apéndice de este tutorial se proporciona más información sobre el uso de funciones de asignación.

Primeros pasos

Este tutorial requiere un conocimiento práctico de los siguientes componentes de Platform:
Este tutorial también requiere que ya haya creado un conjunto de datos para ingestar los datos de CSV. Para ver los pasos para crear un conjunto de datos en la interfaz de usuario, consulte el tutorial de ingesta de datos.

Elegir un destino

Inicie sesión en Adobe Experience Platform y, a continuación, seleccione Flujos de trabajo en la barra de navegación izquierda para acceder al espacio de trabajo de Flujos de trabajo .
En la pantalla Flujos de trabajo , seleccione Asignar CSV al esquema XDM en la sección de ingesta de datos y, a continuación, seleccione Iniciar .
Aparece el flujo de trabajo Asignar CSV al esquema XDM, comenzando en el paso Destino . Elija un conjunto de datos para los datos de entrada en los que se van a ingerir. Puede usar un conjunto de datos existente o crear uno nuevo.
Usar un conjunto de datos existente
Para ingerir los datos CSV en un conjunto de datos existente, seleccione Usar conjunto de datos existente. Puede recuperar un conjunto de datos existente mediante la función de búsqueda o desplazándose por la lista de conjuntos de datos existentes en el panel.
Para ingestar los datos CSV en un nuevo conjunto de datos, seleccione Crear nuevo conjunto de datos e introduzca un nombre y una descripción para el conjunto de datos en los campos proporcionados. Seleccione un esquema utilizando la función de búsqueda o desplazándose por la lista de esquemas proporcionada. Seleccione Siguiente para continuar.

Añadir datos

Aparece el paso Añadir datos . Arrastre y suelte el archivo CSV en el espacio proporcionado o seleccione Elegir archivos para introducir manualmente el archivo CSV.
La sección Datos de ejemplo aparece una vez cargado el archivo, mostrando las primeras diez filas de datos. Una vez que confirme que los datos se han cargado según lo esperado, seleccione Siguiente .

Asignar campos CSV a campos de esquema XDM

Aparece el paso Asignación . Las columnas del archivo CSV se muestran en Campo ** de origen, con sus correspondientes campos de esquema XDM en Campo de Destinatario. Los campos de destinatario no seleccionados están delineados en rojo. Puede utilizar la opción de campos de filtro para reducir la lista de los campos de origen disponibles.
Para asignar una columna CSV a un campo XDM, seleccione el icono de esquema junto al campo de destinatario correspondiente de la columna.
Aparece la ventana Seleccionar esquema . Aquí puede desplazarse por la estructura del esquema XDM y localizar el campo al que desea asignar la columna CSV. Haga clic en un campo XDM para seleccionarlo y, a continuación, haga clic en Seleccionar .
La pantalla Asignación vuelve a aparecer y el campo XDM seleccionado aparece ahora en Campo ** Destinatario.
Si no desea asignar una columna CSV concreta, puede eliminar la asignación haciendo clic en el icono ​Eliminar situado junto al campo destinatario. También puede eliminar todas las asignaciones seleccionando el botón ​Borrar todas las asignaciones.
Si desea agregar una nueva asignación, seleccione Añadir nueva asignación en la parte superior de la lista Campo de origen.
Al asignar campos, también puede incluir funciones para calcular valores en función de los campos de origen de entrada. Consulte la sección de funciones de asignación del apéndice para obtener más información.

Añadir campo calculado

Los campos calculados permiten crear valores en función de los atributos del esquema de entrada. Estos valores se pueden asignar a atributos en el esquema de destinatario y se les puede proporcionar un nombre y una descripción para facilitar la referencia.
Seleccione el botón Añadir campo calculado para continuar.
Aparece el panel Crear campo calculado. El cuadro de diálogo izquierdo contiene los campos, las funciones y los operadores admitidos en los campos calculados. Seleccione una de las fichas para agregar funciones, campos o operadores al editor de expresiones en inicio.
Tabulación
Descripción
Campos
La ficha Campos lista campos y atributos disponibles en el esquema de origen.
Funciones
La ficha Funciones lista las funciones disponibles para transformar los datos.
Operadores
La ficha Operadores lista los operadores disponibles para transformar los datos.
Puede agregar manualmente campos, funciones y operadores mediante el editor de expresiones del centro. Seleccione el editor para crear una expresión en inicio.
Seleccione Guardar para continuar.
La pantalla de asignación vuelve a aparecer con el campo de origen recién creado. Aplique el campo de destinatario correspondiente y seleccione Finalizar para completar la asignación.

Monitorear el flujo de datos

Una vez asignado y creado el archivo CSV, puede supervisar los datos que se están ingeriendo a través de él. Para obtener más información sobre la supervisión de flujos de datos, consulte el tutorial sobre la supervisión de flujos de datos de flujo continuo.

Pasos siguientes

Siguiendo este tutorial, ha asignado correctamente un archivo CSV plano a un esquema XDM y lo ha ingerido en Platform. Estos datos ahora pueden ser utilizados por servicios Platform de flujo descendente como Real-time Customer Profile. Consulte la información general Real-time Customer Profile para obtener más información.

Apéndice

La siguiente sección proporciona información adicional para asignar columnas CSV a campos XDM.

Funciones de asignación

Determinadas funciones de asignación se pueden utilizar para calcular y calcular valores en función de lo que se introduzca en los campos de origen. Para utilizar una función, escríbala en Campo ** de origen con la sintaxis y las entradas adecuadas.
Por ejemplo, para concatenar campos CSV de ciudad y país y asignarlos al campo XDM de ciudad , establezca el campo de origen como concat(city, ", ", county) .
La siguiente tabla lista todas las funciones de asignación admitidas, incluidas las expresiones de muestra y sus resultados.
Función
Descripción
expresión de muestra
Salida de muestra
concat
Concatena cadenas determinadas.
concat("Hi, ", "there", "!")
"Hi, there!"
explosionar
Divide la cadena según un regex y devuelve una matriz de partes.
explode("Hi, there!", " ")
["Hi,", "there"]
instr
Devuelve la ubicación/índice de una subcadena.
instr("adobe .com", "com")
6
sustitutor
Reemplaza la cadena de búsqueda si está presente en la cadena original.
replacestr("Esto es una cadena re test", "re", "replace")
"Ésta es una prueba de reemplazo de cadena"
substr
Devuelve una subcadena de una longitud determinada.
substr("Esta es una prueba de subcadena", 7, 8)
" a subst"
lower /
lcase
Convierte una cadena en minúsculas.
lower("HeLLo")
lcase("HeLLo")
"hello"
superior /
ucase
Convierte una cadena en mayúsculas.
top("HeLLo")
ucase("HeLLo")
"HOLA"
split
Divide una cadena de entrada en un separador.
split("Hello world", " ")
["Hello", "world"]
join
Une una lista de objetos mediante el separador.
join(" ", ["Hello", "world"] )
"Hola mundo"
fusionarse
Devuelve el primer objeto no nulo de una lista determinada.
coalesce(null, null, null, null, "first", null, "second")
"first"
decode
Dada una clave y una lista de pares de valor clave acoplados como una matriz, la función devuelve el valor si se encuentra la clave o devuelve un valor predeterminado si está presente en la matriz.
decode("k2", "k1", "v1", "k2", "v2", "default")
"Versión 2"
iif
Evalúa una determinada expresión booleana y devuelve el valor especificado en función del resultado.
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"
min
Devuelve el mínimo de los argumentos dados. Utiliza ordenación natural.
min(3, 1, 4)
1
max
Devuelve el máximo de los argumentos dados. Utiliza ordenación natural.
max(3, 1, 4)
4
first
Recupera el primer argumento dado.
first("1", "2", "3")
"1"
last
Recupera el último argumento dado.
last("1", "2", "3")
"3"
uuid /
guid
Genera un ID seudoaleatorio.
uuid()
guid()
now
Recupera la hora actual.
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
timestamp
Recupera la hora Unix actual.
timestamp()
1571850624571
format
Da formato a la fecha de entrada según un formato especificado.
format(, "aaaa-MM-dd HH:mm:ss")
"2019-10-23 11:24:35"
dformat
Convierte una marca de hora en una cadena de fecha según un formato especificado.
dformat(1571829875, "dd-MMM-yyyy hh:mm")
"23-Oct-2019 11:24"
date
Convierte una cadena de fecha en un objeto ZonianDateTime (formato ISO 8601).
date("23-Oct-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
Recupera las partes de la fecha. Se admiten los siguientes valores de componente:
"year"
"aaaaaa"
"yy"
"trimestre"
"qq"
"q"
"mes"
"mm"
"m"
"día del año"
"dy"y""día"d"d"semana"ww"w"w"día de la semana"día de la semana"dw"w"ea"hh"h"h"hh"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h"h" "hh24""hh12""minuto""mi""n""segundo""ss""s""milisegundo""ms""
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
Reemplaza un componente en una fecha determinada. Se aceptan los siguientes componentes:
"year"
"yyyy"
"yy"
"month"
"mm"
"m"
"day"
"dd"
"d"
"hour"
"hh"minuto""mi""s"ss"s"""
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
Crea una fecha a partir de partes.
make_date_time(2019, 10, 17, 11, 55, 12, 999, "América/Los Ángeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
Devuelve la marca de tiempo actual.
current_timestamp()
1571850624571
current_date
Devuelve la fecha actual sin un componente de tiempo.
current_date()
"18 de noviembre de 2019"