DocumentaciónExperience PlatformGuía de preparación de datos

Funciones de asignación de preparación de datos

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

Las funciones de preparación de datos se pueden utilizar para calcular y calcular valores basados en lo que se introduce en los campos de origen.

Campos

Un nombre de campo puede ser cualquier identificador válido: una secuencia de longitud ilimitada de letras y dígitos Unicode que comience por una letra, el signo de dólar ($) o el carácter de subrayado (_). Los nombres de variables también distinguen entre mayúsculas y minúsculas.

Si el nombre de campo no sigue esta convención, el nombre de campo debe incluirse entre ${}. Por lo tanto, si el nombre de campo es "First Name" o "First.Name", el nombre debe incluirse entre ${First Name} o ${First\.Name}, respectivamente.

TIP
Al interactuar con jerarquías, si un atributo secundario tiene un punto (.), debe utilizar una barra invertida (\) para omitir los caracteres especiales. Para obtener más información, lea la guía sobre caracteres especiales de escape.

Si el nombre de campo es any de las siguientes palabras clave reservadas, debe incluirse ${}{}:

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return, _errors, do, function, empty, size

Además, las palabras clave reservadas también incluyen cualquiera de las funciones de asignador enumeradas en esta página.

Se puede acceder a los datos de los subcampos utilizando la notación de puntos. Por ejemplo, si había un objeto name, para tener acceso al campo firstName, utilice name.firstName.

Lista de funciones

En las tablas siguientes se enumeran todas las funciones de asignación admitidas, incluidas las expresiones de muestra y sus resultados.

Funciones de cadena string

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
concatena
Concatena las cadenas dadas.
  • STRING: cadenas que se concatenarán.
concat(CADENA_1, CADENA_2)
concat("Hola, ", "hay", "!")
"Hi, there!"
explotar
Divide la cadena en función de una regex y devuelve una matriz de partes. Opcionalmente, puede incluir regex para dividir la cadena. De forma predeterminada, la división se resuelve en ",". Los siguientes delimitadores necesitan que se escapen con \: +, ?, ^, |, ., [, (, {, ), *, $, \ Si incluye varios caracteres como delimitador, el delimitador se tratará como un delimitador de varios caracteres.
  • CADENA: Requerida La cadena que debe dividirse.
  • REGEX: Opcional La expresión regular que se puede usar para dividir la cadena.
explode(STRING, REGEX)
explode("Hola, ¡ahí!", "")
["Hi,", "there"]
instr
Devuelve la ubicación o el índice de una subcadena.
  • ENTRADA: Requerida La cadena que se está buscando.
  • SUBCADENA: Requerida La subcadena que se está buscando dentro de la cadena.
  • START_POSITION: Opcional La ubicación de donde comenzar a buscar en la cadena.
  • OCURRENCIA: Opcional La enésima ocurrencia que se busca desde la posición inicial. De forma predeterminada, se establece en 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
reemplazantes
Reemplaza la cadena de búsqueda si está presente en la cadena original.
  • ENTRADA: Requerida La cadena de entrada.
  • TO_FIND: Requerido La cadena que buscar dentro de la entrada.
  • TO_REPLACE: Requerido La cadena que reemplazará el valor dentro de "TO_FIND".
replace(INPUT, TO_FIND, TO_REPLACE)
replace("Esto es una cadena re-test", "re", "replace")
"Esta es una prueba de reemplazo de cadena"
substr
Devuelve una subcadena de una longitud determinada.
  • ENTRADA: Requerida La cadena de entrada.
  • START_INDEX: Requerido Índice de la cadena de entrada donde comienza la subcadena.
  • LENGTH: Requerido Longitud de la subcadena.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
"un subconjunto"
lower /
lcase
Convierte una cadena a minúsculas.
  • ENTRADA: Requerida La cadena que se convertirá a minúsculas.
lower(INPUT)
lower("HeLo")
lcase("HeLo")
"hola"
upper /
ucase
Convierte una cadena a mayúsculas.
  • ENTRADA: Requerida La cadena que se convertirá a mayúsculas.
upper(ENTRADA)
upper("HeLo")
ucase("HeLo")
"HOLA"
split
Divide una cadena de entrada en un separador. El siguiente separador necesita que se escape con \: \. Si incluye varios delimitadores, la cadena se dividirá en cualquiera de los delimitadores presentes en la cadena. Nota: Esta función sólo devuelve índices no nulos de la cadena, independientemente de la presencia del separador. Si se requieren todos los índices, incluidos los valores nulos, en la matriz resultante, utilice la función "explode" en su lugar.
  • ENTRADA: Requerida La cadena de entrada que se va a dividir.
  • SEPARADOR: Requerido La cadena que se usa para dividir la entrada.
split(ENTRADA, SEPARADOR)
split("Hello world", " ")
["Hello", "world"]
unirse
Une una lista de objetos mediante el separador.
  • SEPARADOR: Requerido La cadena que se usará para unir los objetos.
  • OBJETOS: Requerido Una matriz de cadenas que se unirán.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hola mundo"
lpad
Rellena el lado izquierdo de una cadena con la otra cadena dada.
  • ENTRADA: Requerida La cadena que se va a rellenar. Esta cadena puede ser nula.
  • RECUENTO: Requerido El tamaño de la cadena que se va a rellenar.
  • RELLENO: Requerido La cadena con la que se va a rellenar la entrada. Si es nulo o está vacío, se tratará como un solo espacio.
lpad(ENTRADA, RECUENTO, RELLENO)
lpad("bat", 8, "yz")
"yzybat"
rpad
Rellena el lado derecho de una cadena con la otra cadena dada.
  • ENTRADA: Requerida La cadena que se va a rellenar. Esta cadena puede ser nula.
  • RECUENTO: Requerido El tamaño de la cadena que se va a rellenar.
  • RELLENO: Requerido La cadena con la que se va a rellenar la entrada. Si es nulo o está vacío, se tratará como un solo espacio.
rpad(ENTRADA, RECUENTO, RELLENO)
rpad("bat", 8, "yz")
"batyzyzy"
left
Obtiene los primeros caracteres "n" de la cadena dada.
  • CADENA: Requerida La cadena para la que está obteniendo los primeros caracteres "n".
  • RECUENTO: Requerido Los caracteres "n" que desea obtener de la cadena.
left(CADENA, RECUENTO)
left("abcde", 2)
"ab"
derecha
Obtiene los últimos "n" caracteres de la cadena dada.
  • CADENA: Requerida La cadena para la que se obtienen los últimos caracteres "n".
  • RECUENTO: Requerido Los caracteres "n" que desea obtener de la cadena.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Elimina el espacio en blanco del principio de la cadena.
  • CADENA: Requerida La cadena de la que desea quitar el espacio en blanco.
ltrim(CADENA)
ltrim(" hello")
"hola"
rtrim
Elimina el espacio en blanco del final de la cadena.
  • CADENA: Requerida La cadena de la que desea quitar el espacio en blanco.
rtrim(CADENA)
rtrim("hello ")
"hola"
trim
Elimina el espacio en blanco del principio y del final de la cadena.
  • CADENA: Requerida La cadena de la que desea quitar el espacio en blanco.
trim(CADENA)
trim(" hello ")
"hola"
igual a
Compara dos cadenas para confirmar si son iguales. Esta función distingue entre mayúsculas y minúsculas.
  • CADENA1: Requerida La primera cadena que desea comparar.
  • CADENA2: Requerida La segunda cadena que desea comparar.
CADENA1.​es igual a( CADENA2)
"cadena1".​igual a​("STRING1")
false
igual a IgnoreCase
Compara dos cadenas para confirmar si son iguales. Esta función no distingue entre mayúsculas y minúsculas.
  • CADENA1: Requerida La primera cadena que desea comparar.
  • CADENA2: Requerida La segunda cadena que desea comparar.
CADENA1.​igual a IgnoreCase​(STRING2)
"cadena1".​igual a IgnoreCase​("STRING1)
true

Funciones de expresión regular

Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
extract_regex
Extrae grupos de la cadena de entrada en función de una expresión regular.
  • CADENA: Requerida La cadena de la que está extrayendo los grupos.
  • REGEX: Requerido Expresión regular que desea que coincida el grupo.
extract_regex(STRING, REGEX)
extract_regex​("E259,E259B_009,1_1"​, "([,]+),[,]*,([^,]+)")
["E259,E259B_009,1_1", "E259", "1_1"]
matches_regex
Comprueba si la cadena coincide con la expresión regular introducida.
  • CADENA: Requerida La cadena que está comprobando coincide con la expresión regular.
  • REGEX: Requerido Expresión regular con la que está comparando.
matches_regex(STRING, REGEX)
matches_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")
true

Funciones hash hashing

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
sha1
Toma una entrada y produce un valor hash utilizando el algoritmo hash seguro 1 (SHA-1).
  • ENTRADA: Requerida El texto sin formato que se va a hash.
  • CHARSET: Opcional El nombre del conjunto de caracteres. Los valores posibles incluyen UTF-8, UTF-16, ISO-8859-1 y US-ASCII.
sha1(INPUT, CHARSET)
sha1("mi texto", "UTF-8")
c3599c11e47719df18a24 48690840c5dfcce3c80
sha256
Toma una entrada y produce un valor hash utilizando el algoritmo hash seguro 256 (SHA-256).
  • ENTRADA: Requerida El texto sin formato que se va a hash.
  • CHARSET: Opcional El nombre del conjunto de caracteres. Los valores posibles incluyen UTF-8, UTF-16, ISO-8859-1 y US-ASCII.
sha256(ENTRADA, CHARSET)
sha256("mi texto", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21 ee6a39af698154a83a586ee270a0d372104
sha512
Toma una entrada y produce un valor hash utilizando el algoritmo hash seguro 512 (SHA-512).
  • ENTRADA: Requerida El texto sin formato que se va a hash.
  • CHARSET: Opcional El nombre del conjunto de caracteres. Los valores posibles incluyen UTF-8, UTF-16, ISO-8859-1 y US-ASCII.
sha512(ENTRADA, CHARSET)
sha512("mi texto", "UTF-8")
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef 708bf11b4232bb21d2a8704ada2cdcd7b367dd078a89 a5c908cfe377aceb1072a7b 386b7d4fd2ff68a8fd24d16
md5
Toma una entrada y produce un valor hash con MD5.
  • ENTRADA: Requerida El texto sin formato que se va a hash.
  • CHARSET: Opcional El nombre del conjunto de caracteres. Los valores posibles incluyen UTF-8, UTF-16, ISO-8859-1 y US-ASCII.
md5(INPUT, CHARSET)
md5("mi texto", "UTF-8")
d3b96ce8c9fb4 e9bd0198d03ba6852c7
crc32
Toma una entrada utiliza un algoritmo de comprobación de redundancia cíclica (CRC) para producir un código cíclico de 32 bits.
  • ENTRADA: Requerida El texto sin formato que se va a hash.
  • CHARSET: Opcional El nombre del conjunto de caracteres. Los valores posibles incluyen UTF-8, UTF-16, ISO-8859-1 y US-ASCII.
crc32(INPUT, CHARSET)
crc32("mi texto", "UTF-8")
8df92e80

Funciones de URL url

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
get_url_protocol
Devuelve el protocolo de la dirección URL determinada. Si la entrada no es válida, devuelve nulo.
  • URL: Requerida Dirección URL de la cual se debe extraer el protocolo.
get_url_protocol​(URL)
get_url_protocol("https://platform .adobe.com/home")
https
get_url_host
Devuelve el host de la URL determinada. Si la entrada no es válida, devuelve nulo.
  • URL: Requerida Dirección URL de la cual se debe extraer el host.
get_url_host​(URL)
get_url_host​("https://platform .adobe.com/home")
platform.adobe.com
get_url_port
Devuelve el puerto de la dirección URL determinada. Si la entrada no es válida, devuelve nulo.
  • URL: Requerido Dirección URL de la cual se debe extraer el puerto.
get_url_port(URL)
get_url_port​("sftp://example.com//home/ joe/employee.csv")
22
get_url_path
Devuelve la ruta de la dirección URL determinada. De forma predeterminada, se devuelve la ruta de acceso completa.
  • URL: Requerida Dirección URL de la cual se debe extraer la ruta.
  • FULL_PATH: Opcional Un valor booleano que determina si se devuelve la ruta de acceso completa. Si se establece en false, solo se devuelve el final de la ruta.
get_url_path​(URL, FULL_PATH)
get_url_path​("sftp://example.com// home/joe/employee.csv")
"//home/joe/ employee.csv"
get_url_query_str
Devuelve la cadena de consulta de una dirección URL determinada como un mapa del nombre y el valor de la cadena de consulta.
  • URL: Requerida Dirección URL desde la que intenta obtener la cadena de consulta.
  • ANCLAJE: Requerido Determina qué se hará con el anclaje en la cadena de consulta. Puede ser uno de los tres valores siguientes: "keep", "remove" o "append".

    Si el valor es "conservar", el anclaje se adjuntará al valor devuelto.
    Si el valor es "remove", el anclaje se eliminará del valor devuelto.
    Si el valor es "anexar", el anclaje se devolverá como un valor independiente.
get_url_query_str​(URL, ANCLAJE)
get_url_query_str​("foo://example.com:8042​/over/there?name= ferret#nose", "keep")
get_url_query_str​("foo://example.com:8042​/over/there?name= ferret#nose", "remove")
get_url_query_str​("foo://example.com​:8042/over/there​?name=ferret#nose", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Esta función toma una URL como entrada y reemplaza o codifica los caracteres especiales con caracteres ASCII. Para obtener más información sobre caracteres especiales, lea la lista de caracteres especiales en el apéndice de este documento.
  • URL: Requerida La dirección URL de entrada con caracteres especiales que desea reemplazar o codificar con caracteres ASCII.
get_url_encoded(URL)
get_url_encoded("https://example.com/partneralliance_asia-pacífico_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacífico_2022
get_url_decoded
Esta función toma una URL como entrada y descodifica los caracteres ASCII en caracteres especiales. Para obtener más información sobre caracteres especiales, lea la lista de caracteres especiales en el apéndice de este documento.
  • URL: Requerida La URL de entrada con caracteres ASCII que desea descodificar en caracteres especiales.
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacífico_2022")
https://example.com/partneralliance_asia-pacífico_2022

Funciones de fecha y hora date-and-time

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla. Encontrará más información sobre la función date en la sección de fechas de la guía de administración de formato de datos.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
now
Recupera la hora actual.
now()
now()
2021-10-26T10:10:24Z
timestamp
Recupera la hora Unix actual.
timestamp()
timestamp()
1571850624571
formato
Aplica formato a la fecha de entrada según un formato especificado.
  • FECHA: Requerida La fecha de entrada, como objeto ZonedDateTime, a la que desea dar formato.
  • FORMATO: Requerido El formato al que desea cambiar la fecha.
format(DATE, FORMAT)
format(2019-10-23T11:24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
Convierte una marca de tiempo en una cadena de fecha según un formato especificado.
  • Marca de tiempo: Requerida La marca de tiempo a la que desea dar formato. Esto se escribe en milisegundos.
  • FORMATO: Requerido El formato en el que desea que se convierta la marca de tiempo.
dformat(TIMESTAMP, FORMAT)
dformat(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
fecha
Convierte una cadena de fecha en un objeto ZonedDateTime (formato ISO 8601).
  • FECHA: Requerido La cadena que representa la fecha.
  • FORMATO: Requerido La cadena que representa el formato de la fecha de origen.Nota: Esto hace que no represente el formato en el que desea convertir la cadena de fecha.
  • DEFAULT_DATE: Obligatorio Se devolvió la fecha predeterminada, si la fecha proporcionada es nula.
date(FECHA, FORMATO, FECHA_PREDETERMINADA)
date("2019-10-23 11:24", "aaaa-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
fecha
Convierte una cadena de fecha en un objeto ZonedDateTime (formato ISO 8601).
  • FECHA: Requerido La cadena que representa la fecha.
  • FORMATO: Requerido La cadena que representa el formato de la fecha de origen.Nota: Esto hace que no represente el formato en el que desea convertir la cadena de fecha.
date(FECHA, FORMATO)
date("2019-10-23 11:24", "aaaa-MM-dd HH:mm")
2019-10-23T11:24:00Z
fecha
Convierte una cadena de fecha en un objeto ZonedDateTime (formato ISO 8601).
  • FECHA: Requerido La cadena que representa la fecha.
date(FECHA)
date("2019-10-23 11:24")
"2019-10-23T11:24:00Z"
date_part
Recupera las partes de la fecha. Se admiten los siguientes valores de componente:

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
"d"

"week"
"ww"
"w" "día de la semana"
"dw"
"w"

"hora"
"hh"
"hh24"
"hh12"

"minuto"
"mi"
"n"

"segundo"
"ss"
"s"

"milisegundo"
"SSS"
  • COMPONENTE: Requerido Una cadena que representa la parte de la fecha.
  • FECHA: Requerida La fecha, en un formato estándar.
date_part​(COMPONENT, DATE)
date_part("MM", date("2019-10-17 11:55:12"))
10
set_date_part
Reemplaza un componente en una fecha determinada. Se aceptan los siguientes componentes:

"año"
"aaaa"
"aa"

"mes"
"mm"
"m"

"día"
"dd"
"d"

"hora"
"hh"

"minuto"
"mi"
"n"

"segundo"
"ss"
"s"
  • COMPONENTE: Requerido Una cadena que representa la parte de la fecha.
  • VALOR: Requerido Valor que se va a establecer para el componente en una fecha determinada.
  • FECHA: Requerida La fecha, en un formato estándar.
set_date_part​(COMPONENT, VALUE, DATE)
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44Z"
make_date_time
Crea una fecha a partir de artículos. Esta función también se puede inducir usando make_timestamp.
  • AÑO: Obligatorio El año, escrito con cuatro dígitos.
  • MES: Requerido mes. Los valores permitidos son del 1 al 12.
  • DÍA: Requerido El día. Los valores permitidos son del 1 al 31.
  • HORA: Requerido La hora. Los valores permitidos son de 0 a 23.
  • MINUTO: Requerido El minuto. Los valores permitidos son de 0 a 59.
  • NANOSECOND: Requerido Los valores de nanosegundos. Los valores permitidos son de 0 a 999999999.
  • ZONA HORARIA: Requerida La zona horaria de la fecha y hora.
make_date_time​(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, NANOSECOND, TIMEZONE)
make_date_time​(2019, 10, 17, 11, 55, 12, 999, "América/Los_Ángeles")
2019-10-17T11:55:12Z
zone_date_to_utc
Convierte una fecha de cualquier zona horaria en una fecha en UTC.
  • FECHA: Requerida La fecha que intenta convertir.
zone_date_to_utc​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Convierte una fecha de una zona horaria a otra.
  • FECHA: Requerida La fecha que intenta convertir.
  • ZONA: Requerida Zona horaria a la que intenta convertir la fecha.
zone_date_to_zone​(DATE, ZONE)
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Jerarquías: objetos objects

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
is_empty
Comprueba si un objeto está o no vacío.
  • ENTRADA: Requerida El objeto que intenta comprobar está vacío.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
array_to_object
Crea una lista de objetos.
  • ENTRADA: Requerida Una agrupación de pares de claves y matrices.
array_to_object(INPUT)
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
Crea un objeto basado en los pares de clave/valor plano dados.
  • ENTRADA: Requerida Una lista plana de pares clave/valor.
to_object(INPUT)
to_object​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Crea un objeto de la cadena de entrada.
  • STRING: Requerido La cadena que se está analizando para crear un objeto.
  • VALUE_DELIMITER: Opcional El delimitador que separa un campo del valor. El delimitador predeterminado es :.
  • FIELD_DELIMITER: Opcional El delimitador que separa los pares de valor de campo. El delimitador predeterminado es ,.
str_to_object​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Nota: Puede utilizar la función get() junto con str_to_object() para recuperar los valores de las claves de la cadena.
  • Ejemplo #1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Ejemplo #2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • Ejemplo #1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Ejemplo #2: "John"
contains_key
Comprueba si el objeto existe en los datos de origen. Nota: Esta función reemplaza la función obsoleta is_set().
  • ENTRADA: Requerida Ruta de acceso que se debe comprobar si existe dentro de los datos de origen.
contains_key(INPUT)
contains_key("evars.evar.field1")
true
anular
Establece el valor del atributo en null. Debe utilizarse cuando no desee copiar el campo en el esquema de destino.
nullify()
nullify()
null
get_keys
Analiza los pares clave/valor y devuelve todas las claves.
  • OBJETO: Requerido El objeto del cual se extraerán las claves.
get_keys(OBJECT)
get_keys({"book1": "Pride and Prejudice", "book2": "1984"})
["book1", "book2"]
get_values
Analiza los pares clave/valor y devuelve el valor de la cadena, en función de la clave dada.
  • CADENA: Requerida La cadena que desea analizar.
  • CLAVE: Requerida Clave para la que se debe extraer el valor.
  • VALUE_DELIMITER: Requerido El delimitador que separa el campo y el valor. Si se proporciona null o una cadena vacía, este valor es :.
  • FIELD_DELIMITER: Opcional El delimitador que separa los pares de campo y valor. Si se proporciona null o una cadena vacía, este valor es ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John , lastName - Cena , phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Toma un mapa y una entrada de clave. Si la entrada es una clave única, la función devuelve el valor asociado a esa clave. Si la entrada es una matriz de cadenas, la función devuelve todos los valores correspondientes a las claves proporcionadas. Si el mapa entrante tiene claves duplicadas, el valor devuelto debe anular la duplicación de las claves y devolver valores únicos.
  • MAPA: Requerido Los datos del mapa de entrada.
  • CLAVE: Requerida La clave puede ser una sola cadena o una matriz de cadenas. Si se proporciona cualquier otro tipo primitivo (datos/número), se trata como una cadena.
get_values(MAP, KEY)
Consulte el apéndice para ver un ejemplo de código.
map_has_keys
Si se proporcionan una o más claves de entrada, la función devuelve true. Si se proporciona una matriz de cadenas como entrada, la función devuelve true en la primera clave encontrada.
  • MAPA: Requerido Los datos de asignación de entrada
  • CLAVE: Requerida La clave puede ser una sola cadena o una matriz de cadenas. Si se proporciona cualquier otro tipo primitivo (datos/número), se trata como una cadena.
map_has_keys(MAP, KEY)
Consulte el apéndice para ver un ejemplo de código.
add_to_map
Acepta al menos dos entradas. Se puede proporcionar cualquier cantidad de mapas como entradas. La preparación de datos devuelve un solo mapa que tiene todos los pares clave-valor de todas las entradas. Si se repiten una o más claves (en el mismo mapa o entre mapas), la preparación de datos anula la duplicación de las claves para que el primer par clave-valor persista en el orden en que se pasaron en la entrada.
MAPA: Requerido Los datos del mapa de entrada.
add_to_map(MAPA 1, MAPA 2, MAPA 3, …)
Consulte el apéndice para ver un ejemplo de código.
object_to_map (Sintaxis 1)
Utilice esta función para crear tipos de datos de mapa.
  • CLAVE: Requerido Las claves deben ser una cadena. Si se proporciona cualquier otro valor primitivo, como números enteros o fechas, se convierten automáticamente en cadenas y se tratan como cadenas.
  • ANY_TYPE: Obligatorio Se refiere a cualquier tipo de datos XDM admitido, excepto Mapas.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, … )
Consulte el apéndice para ver un ejemplo de código.
object_to_map (Sintaxis 2)
Utilice esta función para crear tipos de datos de mapa.
  • OBJETO: Requerido Puede proporcionar un objeto entrante o matriz de objetos y señalar a un atributo dentro del objeto como clave.
object_to_map(OBJECT)
Consulte el apéndice para ver un ejemplo de código.
object_to_map (Sintaxis 3)
Utilice esta función para crear tipos de datos de mapa.
  • OBJETO: Requerido Puede proporcionar un objeto entrante o matriz de objetos y señalar a un atributo dentro del objeto como clave.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Consulte el apéndice para ver un ejemplo de código.

Para obtener información sobre la característica de copia de objetos, consulte la sección debajo de.

Jerarquías - Matrices arrays

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
fundirse
Devuelve el primer objeto no nulo de una matriz determinada.
  • ENTRADA: Requerida La matriz de la que desea encontrar el primer objeto no nulo.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"primero"
primero
Recupera el primer elemento de la matriz determinada.
  • ENTRADA: Requerida La matriz de la que desea encontrar el primer elemento.
first(INPUT)
first("1", "2", "3")
"1"
última(s)
Recupera el último elemento de la matriz determinada.
  • ENTRADA: Requerida La matriz de la que desea encontrar el último elemento.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Añade elementos al final de la matriz.
  • MATRIZ: Requerida Matriz a la que está agregando elementos.
  • VALUES: Los elementos que desea anexar a la matriz.
add_to_array​(MATRIZ, VALORES)
add_to_array​(['a', 'b'], 'c', 'd')
['a', 'b', 'c', 'd']
join_array
Combina las matrices entre sí.
  • MATRIZ: Requerida Matriz a la que está agregando elementos.
  • VALUES: Las matrices que desea anexar a la matriz principal.
join_array​(ARRAY, VALUES)
join_array​(['a', 'b'], ['c'], ['d', 'e'])
['a', 'b', 'c', 'd', 'e']
to_array
Toma una lista de entradas y la convierte en una matriz.
  • INCLUDE_NULLS: Requerido Valor booleano que indica si se deben incluir o no valores nulos en la matriz de respuesta.
  • VALORES: Requerido Los elementos que se van a convertir en una matriz.
to_array​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Devuelve el tamaño de la entrada.
  • ENTRADA: Requerida El objeto del que intenta encontrar el tamaño.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Esta función se utiliza para anexar todos los elementos de toda la matriz de entrada al final de la matriz en Profile. Esta función es solamente aplicable durante las actualizaciones. Si se utiliza en el contexto de las inserciones, esta función devuelve la entrada tal cual.
  • MATRIZ: Requerido La matriz para anexar la matriz en el perfil.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
Esta función se utiliza para reemplazar elementos en una matriz. Esta función es solamente aplicable durante las actualizaciones. Si se utiliza en el contexto de las inserciones, esta función devuelve la entrada tal cual.
  • MATRIZ: Requerido La matriz para reemplazar la matriz en el perfil.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
[Solo destinos]{class="badge informative"} array_to_string
Une las representaciones de cadena de los elementos de una matriz utilizando el separador especificado. Si la matriz es multidimensional, se acopla antes de unirse. Nota: esta función se usa en destinos. Lea la documentación para obtener más información.
  • SEPARADOR: Requerido El separador usado para unir los elementos de la matriz.
  • MATRIZ: Requerida Matriz que se unirá (después del acoplamiento).
array_to_string(SEPARATOR, ARRAY)
array_to_string(";", ["Hello", "world"])
"Hola;mundo"
[Solo destinos]{class="badge informative"} filterArray*
Filtra la matriz determinada en función de un predicado. Nota: esta función se usa en destinos. Lea la documentación para obtener más información.
  • MATRIZ: Requerido La matriz que se filtrará
  • PREDICADO: Requerido El predicado que se aplicará en cada elemento de la matriz dada.
filterArray(MATRIZ, PREDICADO)
filterArray([5, -6, 0, 7], x -> x > 0)
[5, 7]
[Solo destinos]{class="badge informative"} transformArray*
Transforma la matriz determinada en función de un predicado. Nota: esta función se usa en destinos. Lea la documentación para obtener más información.
  • MATRIZ: Requerido La matriz que se va a transformar.
  • PREDICADO: Requerido El predicado que se aplicará en cada elemento de la matriz dada.
transformArray(MATRIZ, PREDICADO)
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[Solo destinos]{class="badge informative"} flattenArray*
Acople la matriz determinada (multidimensional) a una matriz unidimensional. Nota: esta función se usa en destinos. Lea la documentación para obtener más información.
  • MATRIZ: Requerido La matriz que se va a acoplar.
flattenArray(MATRIZ)
flattenArray([['a', 'b'], ['c', 'd']], [['e'], ['f']])
['a', 'b', 'c', 'd', 'e', 'f']

Jerarquías: asignación map

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
array_to_map
Esta función toma una matriz de objetos y una clave como entrada y devuelve un mapa del campo de la clave con el valor como clave y el elemento de matriz como valor.
  • ENTRADA: Requerida La matriz de objetos de la que desea encontrar el primer objeto no nulo.
  • CLAVE: Requerida La clave debe ser un nombre de campo en la matriz de objetos y el objeto como valor.
array_to_map(OBJECT[] INPUTS, KEY)
Lea el apéndice para ver un ejemplo de código.
object_to_map
Esta función toma un objeto como argumento y devuelve un mapa de pares clave-valor.
  • ENTRADA: Requerida La matriz de objetos de la que desea encontrar el primer objeto no nulo.
object_to_map(OBJECT_INPUT)
"object_to_map(address) donde input es " + "address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}"
Devuelve un mapa con pares de nombre y valor de campo determinados o nulo si la entrada es nula. Por ejemplo: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Esta función toma una lista de pares clave-valor y devuelve un mapa de pares clave-valor.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Devuelve un mapa con pares de nombre y valor de campo determinados o nulo si la entrada es nula. Por ejemplo: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Operadores lógicos logical-operators

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
descifrar
Dadas 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.
  • CLAVE: Requerida La clave que se va a buscar coincide.
  • OPTIONS: Requerido Una matriz aplanada de pares clave/valor. De forma opcional, se puede colocar un valor predeterminado al final.
decode(KEY, OPTIONS)
decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A")
Si el stateCode proporcionado es "ca", "California".
Si el stateCode proporcionado es "pa", "Pennsylvania".
Si stateCode no coincide con lo siguiente, "N/A".
iif
Evalúa una expresión booleana determinada y devuelve el valor especificado en función del resultado.
  • EXPRESIÓN: Requerida La expresión booleana que se está evaluando.
  • TRUE_VALUE: Requerido El valor que se devuelve si la expresión se evalúa como true.
  • FALSE_VALUE: Requerido El valor que se devuelve si la expresión se evalúa como falsa.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"

Agregación aggregation

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
min
Devuelve el mínimo de los argumentos dados. Utiliza el orden natural.
  • OPTIONS: Requerido Uno o más objetos que se pueden comparar entre sí.
min(OPTIONS)
min(3, 1, 4)
1
max
Devuelve el máximo de los argumentos dados. Utiliza el orden natural.
  • OPTIONS: Requerido Uno o más objetos que se pueden comparar entre sí.
max(OPTIONS)
max(3, 1, 4)
4

Escribir conversiones type-conversions

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
to_bigint
Convierte una cadena en un BigInteger.
  • STRING: Requerido La cadena que se va a convertir en un BigInteger.
to_bigint(STRING)
to_bigint​("1000000.34")
1000000,34
to_decimal
Convierte una cadena en un valor Double.
  • CADENA: Requerida La cadena que se va a convertir en un valor de tipo Double.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Convierte una cadena en flotante.
  • CADENA: Requerida La cadena que se va a convertir en un valor Flotante.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Convierte una cadena en un número entero.
  • STRING: Requerido La cadena que se va a convertir en un número entero.
to_integer(CADENA)
to_integer("12")
12

Funciones JSON json

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
json_to_object
Deserialice el contenido JSON de la cadena determinada.
  • CADENA: Requerida La cadena JSON que se va a deserializar.
json_to_object​(STRING)
json_to_object​({"info":{"firstName":"John","lastName": "Doe"}})
Un objeto que representa el JSON.

Operaciones especiales special-operations

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
uuid /
guid
Genera un ID pseudoaleatorio.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Esta función toma una cadena FPID y la convierte en un ECID para su uso en aplicaciones de Adobe Experience Platform y Adobe Experience Cloud.
  • CADENA: Requerido La cadena FPID que se convertirá en ECID.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Funciones del agente de usuario user-agent

Cualquiera de las funciones de agente de usuario que se incluyen en la tabla siguiente puede devolver cualquiera de los siguientes valores:

  • Teléfono: dispositivo móvil con pantalla pequeña (normalmente < 7")
  • Móvil: dispositivo móvil que aún no se ha identificado. Este dispositivo móvil puede ser un eReader, una tableta, un teléfono, un reloj, etc.

Para obtener más información sobre los valores de los campos de dispositivos, lea la lista de valores de los campos de dispositivos en el apéndice de este documento.

NOTE
Desplácese hacia la izquierda/derecha para ver todo el contenido de la tabla.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
ua_os_name
Extrae el nombre del sistema operativo de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_os_name​(USER_AGENT)
ua_os_name​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Extrae la versión principal del sistema operativo de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_os_version_major​(USER_AGENT)
ua_os_version_major s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
IOS 5
ua_os_version
Extrae la versión del sistema operativo de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_os_version​(USER_AGENT)
ua_os_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1
ua_os_name_version
Extrae el nombre y la versión del sistema operativo de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_os_name_version​(USER_AGENT)
ua_os_name_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Extrae la versión del agente de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_agent_version​(USER_AGENT)
ua_agent_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5,1
ua_agent_version_major
Extrae el nombre del agente y la versión principal de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_agent_version_major​(USER_AGENT)
ua_agent_version_major​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Extrae el nombre del agente de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_agent_name​(USER_AGENT)
ua_agent_name​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
Extrae la clase de dispositivo de la cadena del agente de usuario.
  • USER_AGENT: Requerido La cadena del agente de usuario.
ua_device_class​(USER_AGENT)
ua_device_class​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 como Mac OS X) AppleWebKit/534.46 (KHTML, como Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Teléfono

Funciones de Analytics analytics

NOTE
Solo puede utilizar las siguientes funciones de análisis para flujos de WebSDK y Adobe Analytics.
Función
Descripción
Parámetros
Sintaxis
Expresión
Salida de ejemplo
aa_get_event_id
Extrae el ID de evento de una cadena de eventos de Analytics.
  • EVENT_STRING: Requerido La cadena de evento de Analytics separada por comas.
  • EVENT_NAME: Requerido El nombre del evento que se va a extraer e ID.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Extrae el valor del evento de una cadena de eventos de Analytics. Si no se especifica el valor del evento, se devuelve 1.
  • EVENT_STRING: Requerido La cadena de evento de Analytics separada por comas.
  • EVENT_NAME: Requerido El nombre del evento del que se extraerá un valor.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_categories
Extrae la categoría de producto de una cadena de productos de Analytics.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
aa_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories(";Ejemplo de producto 1;1;3.50,Ejemplo de categoría 2;Ejemplo de producto 2;1;5.99")
[null,"Ejemplo de categoría 2"]
aa_get_product_names
Extrae el nombre de un producto de una cadena de productos de Analytics.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names(";Ejemplo de producto 1;1;3.50,Ejemplo de categoría 2;Ejemplo de producto 2;1;5.99")
["Ejemplo de producto 1","Ejemplo de producto 2"]
aa_get_product_quantity
Extrae las cantidades de una cadena de productos de Analytics.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
aa_get_product_quantity(PRODUCTS_STRING)
aa_get_product_quantity(";Ejemplo de producto 1;1;3.50,Ejemplo de categoría 2;Ejemplo de producto 2")
["1", nulo]
aa_get_product_price
Extrae el precio de una cadena de productos de Analytics.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
aa_get_product_price(PRODUCTS_STRING)
aa_get_product_price(";Ejemplo de producto 1;1;3.50,Ejemplo de categoría 2;Ejemplo de producto 2")
["3.50", nulo]
aa_get_product_event_values
Extrae los valores del evento con nombre de la cadena de products como una matriz de cadenas.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
  • EVENT_NAME: Requerido El nombre del evento del que se extraerán los valores.
aa_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values(";Ejemplo product 1;1;4.20;event1=2.3|event2=5:1,;Ejemplo product 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_evars
Extrae los valores de eVar del evento con nombre de la cadena de products como una matriz de cadenas.
  • PRODUCTS_STRING: Requerido La cadena de productos de Analytics.
  • EVAR_NAME: Requerido El nombre del eVar que se va a extraer.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars(";Ejemplo de producto;1;6.69;;eVar 1=Valor de comercialización", "eVar 1")
["Valor de comercialización"]

Copia de objeto object-copy

TIP
La función de copia de objetos se aplica automáticamente cuando un objeto del origen se asigna a un objeto del XDM. No se necesitan acciones adicionales de los usuarios.

Puede utilizar la función de copia de objetos para copiar automáticamente los atributos de un objeto sin realizar cambios en la asignación. Por ejemplo, si los datos de origen tienen una estructura de:

address{
        line1: 4191 Ridgebrook Way,
        city: San Jose,
        state: California
        }

y una estructura XDM de:

addr{
    addrLine1: 4191 Ridgebrook Way,
    city: San Jose,
    state: California
    }

A continuación, la asignación pasa a ser:

address -> addr
address.line1 -> addr.addrLine1

En el ejemplo anterior, los atributos city y state también se incorporan automáticamente durante la ejecución porque el objeto address está asignado a addr. Si crea un atributo line2 en la estructura XDM y los datos de entrada también contienen un line2 en el objeto address, también se incorporará automáticamente sin necesidad de modificar manualmente la asignación.

Para garantizar que la asignación automática funcione, se deben cumplir los siguientes requisitos previos:

  • Los objetos de nivel principal deben asignarse;
  • Se deben haber creado nuevos atributos en el esquema XDM;
  • Los nuevos atributos deben tener nombres coincidentes en el esquema de origen y en el esquema XDM.

Si no se cumplen todos los requisitos previos, debe asignar manualmente el esquema de origen al esquema XDM mediante la preparación de datos.

Apéndice

A continuación se proporciona información adicional sobre el uso de funciones de asignación de preparación de datos

Caracteres especiales special-characters

La siguiente tabla describe una lista de caracteres reservados y sus caracteres codificados correspondientes.

Carácter reservado
Carácter codificado
espacio
%20
!
%21
”
%22
#
%23
$
%24
%
%25
&
%26
'
%27
(
%28
)
%29
*
%2A
+
%2B
,
%2C
/
%2F
:
%3A
;
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5D
^
%5E
`
%60
~
%7E

Valores de campo de dispositivo device-field-values

La tabla siguiente describe una lista de valores de campos de dispositivo y sus descripciones correspondientes.

Device
Descripción
Escritorio
Un tipo de dispositivo de escritorio o portátil.
Anonimizado
Un dispositivo anónimo. En algunos casos, estos son useragents que han sido alterados por un software de anonimización.
Desconocido
Un dispositivo desconocido. Generalmente son useragents y no contienen información sobre el dispositivo.
Dispositivo móvil
Dispositivo móvil que aún no se ha identificado. Este dispositivo móvil puede ser un eReader, una tableta, un teléfono, un reloj, etc.
Tableta
Un dispositivo móvil con una pantalla grande (normalmente > 7").
Teléfono
Un dispositivo móvil con una pantalla pequeña (normalmente < 7").
Ver
Un dispositivo móvil con una pantalla pequeña (normalmente < 2"). Estos dispositivos funcionan normalmente como una pantalla adicional para un dispositivo de tipo teléfono/tableta.
Realidad aumentada
Un dispositivo móvil con capacidades de AR.
Realidad virtual
Un dispositivo móvil con capacidades de RV.
eReader
Dispositivo similar a una tableta, pero normalmente con una pantalla de eInk.
Cuadro en la parte superior
Dispositivo conectado que permite la interacción a través de una pantalla de tamaño TV.
TV
Dispositivo similar al decodificador, pero integrado en el televisor.
Dispositivo doméstico
Un electrodoméstico (generalmente grande), como un refrigerador.
Consola de juego
Un sistema de juego fijo como Playstation o XBox.
Consola de juego portátil
Un sistema de juegos móvil como Nintendo Switch.
Voz
Un dispositivo controlado por voz como Amazon Alexa o Google Home.
Coche
Un explorador basado en vehículo.
Robot
Robots que visitan un sitio web.
Robot móvil
Robots que visitan un sitio web pero que indican que desean que se les considere visitantes móviles.
Robot Imitator
Robots que visitan un sitio web, fingiendo que son robots como Google, pero no lo son. Nota: En la mayoría de los casos, los imitadores de robots son robots.
Nube
Una aplicación basada en la nube. Estos no son ni robots ni hackers, sino aplicaciones que necesitan conectarse. Esto incluye Mastodon servidores.
Pirata Informático
Este valor de dispositivo se utiliza en caso de que se detecten scripts en la cadena useragent.

Muestras de código code-samples

map_get_values map-get-values

Seleccione para ver el ejemplo
code language-json 
 example = "map_get_values(book_details,\"author\") where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "{\"author\": \"George R. R. Martin\"}"

map_has_keys map_has_keys

Seleccione para ver el ejemplo
code language-json 
 example = "map_has_keys(book_details,\"author\")where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "true"

add_to_map add_to_map

Seleccione para ver el ejemplo
code language-json 
example = "add_to_map(book_details, book_details2) where input is {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}" +
        "{\n" +
        "    \"book_details2\":\n" +
        "    {\n" +
        "        \"author\": \"Neil Gaiman\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-0-380-97365-0\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      result = "{\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      returns = "A new map with all elements from map and addends"

object_to_map object_to_map

Sintaxis 1

Seleccione para ver el ejemplo
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Sintaxis 2

Seleccione para ver el ejemplo
code language-json 
example = "object_to_map(address) where input is " +
  "address: {line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}",
result = "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"

Sintaxis 3

Seleccione para ver el ejemplo
code language-json 
example = "object_to_map(addresses,type)" +
        "\n" +
        "[\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "]" ,
result = "{\n" +
        "    \"home\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    \"work\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    \"office\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "}"

array_to_map array_to_map

Seleccione para ver el ejemplo
code language-json 
example = "array_to_map(addresses, \"type\") where addresses is\n" +
  "\n" +
  "[\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "]" ,
result = "{\n" +
  "    \"home\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    \"work\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    \"office\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "}",
returns = "Returns a map with given field name and value pairs or null if input is null"
recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394