DocumentaçãoExperience PlatformGuia de preparação de dados

Funções de mapeamento de Preparo de dados

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

Criado para:

  • Desenvolvedor

As funções de Preparo de dados podem ser usadas para calcular e calcular valores com base no que é inserido em campos de origem.

Campos

Um nome de campo pode ser qualquer identificador legal - uma sequência ilimitada de letras e dígitos Unicode, começando com uma letra, o cifrão ($) ou o caractere de sublinhado (_). Os nomes de variáveis também fazem distinção entre maiúsculas e minúsculas.

Se um nome de campo não segue essa convenção, o nome do campo deve ser colocado entre ${}. Portanto, por exemplo, se o nome do campo for "Nome" ou "Nome.Nome", o nome deverá ser encapsulado como ${First Name} ou ${First\.Name} respectivamente.

TIP
Ao interagir com hierarquias, se um atributo filho tiver um ponto (.), você deverá usar uma barra invertida (\) para usar escape em caracteres especiais. Para obter mais informações, leia o manual sobre como escapar caracteres especiais.

Se um nome de campo for qualquer das seguintes palavras-chave reservadas, ele deverá ser empacotado com ${}{}:

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

Além disso, as palavras-chave reservadas também incluem qualquer uma das funções do mapeador listadas nesta página.

Os dados em subcampos podem ser acessados usando a notação de pontos. Por exemplo, se havia um objeto name, para acessar o campo firstName, use name.firstName.

Lista de funções

As tabelas a seguir listam todas as funções de mapeamento compatíveis, incluindo expressões de amostra e suas saídas resultantes.

Funções de string string

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
concat
Concatena as sequências de caracteres fornecidas.
  • STRING: as cadeias de caracteres que serão concatenadas.
concat(STRING_1, STRING_2)
concat("Hi, ", "there", "!")
"Hi, there!"
explodir
Divide a sequência de caracteres com base em um regex e retorna uma matriz de partes. Opcionalmente, pode incluir regex para dividir a cadeia de caracteres. Por padrão, a divisão é resolvida como ",". Os seguintes delimitadores precisam de escape com \: +, ?, ^, |, ., [, (, {, ), *, $, \ Se você incluir vários caracteres como delimitador, ele será tratado como um delimitador de vários caracteres.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres que precisa ser dividida.
  • REGEX: Opcional A expressão regular que pode ser usada para dividir a cadeia de caracteres.
explode(STRING, REGEX)
explode("Olá!", " ")
["Hi,", "there"]
instr
Retorna o local/índice de uma substring.
  • ENTRADA: Obrigatório A cadeia de caracteres que está sendo pesquisada.
  • SUBSTRING: Obrigatório A subcadeia de caracteres que está sendo pesquisada na cadeia de caracteres.
  • START_POSITION: Opcional O local de onde começar a pesquisar na cadeia de caracteres.
  • OCORRÊNCIA: Opcional A enésima ocorrência a ser procurada a partir da posição inicial. Por padrão, é definido como 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
replacester
Substitui a cadeia de caracteres de pesquisa, se presente na cadeia de caracteres original.
  • ENTRADA: Obrigatório A cadeia de caracteres de entrada.
  • TO_FIND: Obrigatório A cadeia de caracteres a ser pesquisada na entrada.
  • TO_REPLACE: Obrigatório A cadeia de caracteres que substituirá o valor em "TO_FIND".
replacestr(INPUT, TO_FIND, TO_REPLACE)
replacestr("Isto é uma sequência de caracteres re test", "re", "replace")
"Este é um teste de substituição de cadeia de caracteres"
substr
Retorna uma substring de um determinado comprimento.
  • ENTRADA: Obrigatório A cadeia de caracteres de entrada.
  • START_INDEX: Obrigatório O índice da cadeia de caracteres de entrada em que a subsequência de caracteres é iniciada.
  • LENGTH: Required O comprimento da subcadeia de caracteres.
substr(INPUT, START_INDEX, LENGTH)
substr("Este é um teste de substring", 7, 8)
"um subconjunto"
lower /
lcase
Converte uma cadeia de caracteres em minúsculas.
  • ENTRADA: Obrigatório A cadeia de caracteres que será convertida em minúsculas.
lower(INPUT)
lower("HeLL")
lcase("HeLL")
"olá"
upper /
ucase
Converte uma cadeia de caracteres em maiúsculas.
  • ENTRADA: Obrigatório A cadeia de caracteres que será convertida em maiúsculas.
upper(ENTRADA)
upper("HeLL")
ucase("HeLL")
"OLÁ"
split
Divide uma cadeia de caracteres de entrada em um separador. O seguinte separador precisa de escape com \: \. Se você incluir vários delimitadores, a cadeia de caracteres será dividida em qualquer dos delimitadores presentes na cadeia de caracteres. Observação: esta função retorna apenas índices não nulos da cadeia de caracteres, independentemente da presença do separador. Se todos os índices, incluindo nulos, forem necessários na matriz resultante, use a função "explodir".
  • ENTRADA: Obrigatório A cadeia de caracteres de entrada que será dividida.
  • SEPARATOR: Obrigatório A cadeia de caracteres usada para dividir a entrada.
split(ENTRADA, SEPARADOR)
split("Olá mundo", " ")
["Hello", "world"]
ingressar
Une uma lista de objetos usando o separador.
  • SEPARATOR: Obrigatório A cadeia de caracteres que será usada para unir os objetos.
  • OBJETOS: Obrigatório Uma matriz de cadeias de caracteres que serão unidas.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Olá, mundo"
lpad
Preenche o lado esquerdo de uma cadeira de caracteres com a outra cadeira de caracteres especificada.
  • ENTRADA: Obrigatório A cadeia de caracteres a ser preenchida. Esta cadeia de caracteres pode ser nula.
  • COUNT: Obrigatório O tamanho da cadeia de caracteres a ser preenchida.
  • PREENCHIMENTO: Obrigatório A cadeia de caracteres com a qual preencher a entrada. Se for nulo ou estiver vazio, será tratado como um único espaço.
lpad(ENTRADA, CONTAGEM, PREENCHIMENTO)
lpad("bat", 8, "yz")
"yzyzybat"
rpad
Preenche o lado direito de uma cadeia de caracteres com a outra cadeia de caracteres fornecida.
  • ENTRADA: Obrigatório A cadeia de caracteres a ser preenchida. Esta cadeia de caracteres pode ser nula.
  • COUNT: Obrigatório O tamanho da cadeia de caracteres a ser preenchida.
  • PREENCHIMENTO: Obrigatório A cadeia de caracteres com a qual preencher a entrada. Se for nulo ou estiver vazio, será tratado como um único espaço.
rpad(ENTRADA, CONTAGEM, PREENCHIMENTO)
rpad("bat", 8, "yz")
"batyzyzy"
left
Obtém os primeiros caracteres "n" da cadeira de caracteres fornecida.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres para a qual você está obtendo os primeiros caracteres "n".
  • COUNT: Obrigatório Os caracteres "n" que você deseja obter da cadeia de caracteres.
left(STRING, COUNT)
left("abcde", 2)
"ab"
direita
Obtém os últimos caracteres "n" da cadeira de caracteres fornecida.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres para a qual você está obtendo os últimos caracteres "n".
  • COUNT: Obrigatório Os caracteres "n" que você deseja obter da cadeia de caracteres.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Remove o espaço em branco do início da cadeira de caracteres.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres da qual você deseja remover o espaço em branco.
ltrim(STRING)
ltrim(" Olá")
"olá"
rtrim
Remove o espaço em branco do final da cadeira de caracteres.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres da qual você deseja remover o espaço em branco.
rtrim(STRING)
rtrim("alô")
"olá"
trim
Remove o espaço em branco do início e do fim da sequência de caracteres.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres da qual você deseja remover o espaço em branco.
trim(STRING)
trim(" olá ")
"olá"
igual a
Compara duas strings para confirmar se são iguais. Esta função diferencia maiúsculas de minúsculas.
  • STRING1: Obrigatório A primeira cadeia de caracteres que você deseja comparar.
  • CADEIA DE CARACTERES2: Obrigatório A segunda cadeia de caracteres que você deseja comparar.
STRING1.​equals(​STRING2)
"string1".​equals​("STRING1")
false
equalsIgnoreCase
Compara duas strings para confirmar se são iguais. Esta função não diferencia maiúsculas de minúsculas.
  • STRING1: Obrigatório A primeira cadeia de caracteres que você deseja comparar.
  • CADEIA DE CARACTERES2: Obrigatório A segunda cadeia de caracteres que você deseja comparar.
STRING1.​equalsIgnoreCase​(STRING2)
"string1".​equalsIgnoreCase​("STRING1)
true

Funções de expressão regular

Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
extract_regex
Extrai grupos da string de entrada, com base em uma expressão regular.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres da qual você está extraindo os grupos.
  • REGEX: Obrigatório A expressão regular que você deseja que o grupo corresponda.
extract_regex(STRING, REGEX)
extract_regex​("E259,E259B_009,1_1"​, "([,]+),[,]*,([^,]+)")
["E259,E259B_009,1_1", "E259", "1_1"]
matches_regex
Verifica se a string corresponde à expressão regular inserida.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres que você está verificando corresponde à expressão regular.
  • REGEX: Obrigatório A expressão regular com a qual você está comparando.
matches_regex(STRING, REGEX)
matches_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")
true

Funções de hash hashing

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
sha1
Pega uma entrada e produz um valor de hash usando o Algoritmo de hash seguro 1 (SHA-1).
  • ENTRADA: Obrigatório O texto sem formatação a ser hash.
  • CHARSET: Opcional O nome do conjunto de caracteres. Os valores possíveis incluem UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha1(ENTRADA, CHARSET)
sha1("meu texto", "UTF-8")
c3599c11e47719df18a24​48690840c5dfcce3c80
sha256
Pega uma entrada e produz um valor de hash usando o Algoritmo de hash seguro 256 (SHA-256).
  • ENTRADA: Obrigatório O texto sem formatação a ser hash.
  • CHARSET: Opcional O nome do conjunto de caracteres. Os valores possíveis incluem UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha256(ENTRADA, CHARSET)
sha256("meu texto", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21​ee6a39af698154a83a586ee270a0d372104
sha512
Pega uma entrada e produz um valor de hash usando o Algoritmo de hash seguro 512 (SHA-512).
  • ENTRADA: Obrigatório O texto sem formatação a ser hash.
  • CHARSET: Opcional O nome do conjunto de caracteres. Os valores possíveis incluem UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
sha512(ENTRADA, CHARSET)
sha512("meu texto", "UTF-8")
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef​708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89​a5c908cfe377aceb107 2a7b386b7d4fd2ff68a8fd24d16
md5
Pega uma entrada e produz um valor de hash usando MD5.
  • ENTRADA: Obrigatório O texto sem formatação a ser hash.
  • CHARSET: Opcional O nome do conjunto de caracteres. Os valores possíveis incluem UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
md5(ENTRADA, CHARSET)
md5("meu texto", "UTF-8")
d3b96ce8c9fb4​e9bd0198d03ba6852c7
crc32
Pega uma entrada e usa um algoritmo de verificação de redundância cíclica (CRC) para produzir um código cíclico de 32 bits.
  • ENTRADA: Obrigatório O texto sem formatação a ser hash.
  • CHARSET: Opcional O nome do conjunto de caracteres. Os valores possíveis incluem UTF-8, UTF-16, ISO-8859-1 e US-ASCII.
crc32(INPUT, CHARSET)
crc32("meu texto", "UTF-8")
8df92e80

Funções de URL url

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
get_url_protocol
Retorna o protocolo do URL fornecido. Se a entrada for inválida, retornará null.
  • URL: Obrigatório A URL da qual o protocolo precisa ser extraído.
get_url_protocol​(URL)
get_url_protocol("https://platform​.adobe.com/home")
https
get_url_host
Retorna o host do URL fornecido. Se a entrada for inválida, retornará null.
  • URL: Obrigatório A URL da qual o host precisa ser extraído.
get_url_host​(URL)
get_url_host​("https://platform​.adobe.com/home")
platform.adobe.com
get_url_port
Retorna a porta do URL fornecido. Se a entrada for inválida, retornará null.
  • URL: Obrigatório A URL da qual a porta precisa ser extraída.
get_url_port(URL)
get_url_port​("sftp://example.com//home/​joe/employee.csv")
22
get_url_path
Retorna o caminho do URL fornecido. Por padrão, o caminho completo é retornado.
  • URL: Obrigatório A URL da qual o caminho precisa ser extraído.
  • FULL_PATH: Opcional Um valor booliano que determina se o caminho completo é retornado. Se definido como false, somente o final do caminho é retornado.
get_url_path​(URL, CAMINHO_COMPLETO)
get_url_path​("sftp://example.com//​home/joe/employee.csv")
"//home/joe/​employee.csv"
get_url_query_str
Retorna a cadeia de caracteres de consulta de um determinado URL como um mapa de nome de cadeia de caracteres de consulta e valor de cadeia de caracteres de consulta.
  • URL: Obrigatório A URL da qual você está tentando obter a cadeia de caracteres de consulta.
  • ÂNCORA: Obrigatório Determina o que será feito com a âncora na cadeia de caracteres de consulta. Pode ser um destes três valores: "keep", "remove" ou "append".

    Se o valor for "reter", a âncora será anexada ao valor retornado.
    Se o valor for "remover", a âncora será removida do valor retornado.
    Se o valor for "append", a âncora será retornada como um valor separado.
get_url_query_str​(URL, ÂNCORA)
get_url query_str​("foo://example.com:8042​/over/there?name=​ferret#reter", "0}get_url_query_str​ ​ ​ ​ ​ ​("foo://example.com:8042acima/there?name=ferret", "remover")
get_url_query_strr("foo://example.com04/over/therename?impossível=ferret#nariz", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Essa função pega uma URL como entrada e substitui ou codifica os caracteres especiais por caracteres ASCII. Para obter mais informações sobre caracteres especiais, leia a lista de caracteres especiais no apêndice deste documento.
  • URL: Obrigatório A URL de entrada com caracteres especiais que você deseja substituir ou codificar com caracteres ASCII.
get_url_encoded(URL)
get_url_encoded("https://example.com/partneralliance_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
Essa função pega uma URL como entrada e decodifica os caracteres ASCII em caracteres especiais. Para obter mais informações sobre caracteres especiais, leia a lista de caracteres especiais no apêndice deste documento.
  • URL: Obrigatório A URL de entrada com caracteres ASCII que você deseja decodificar em caracteres especiais.
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https://example.com/partneralliance_asia-pacific_2022

Funções de data e hora date-and-time

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela. Mais informações sobre a função date podem ser encontradas na seção de datas do guia de manipulação de formato de dados.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
now
Recupera a hora atual.
now()
now()
2021-10-26T10:10:24Z
carimbo de data e hora
Recupera o horário Unix atual.
timestamp()
timestamp()
1571850624571
formato
Formata a data de entrada de acordo com um formato especificado.
  • DATE: Obrigatório A data de entrada, como um objeto ZonedDateTime, que você deseja formatar.
  • FORMATO: Obrigatório O formato para o qual você deseja alterar a data.
format(DATA, FORMATO)
format(2019-10-23T11:24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
Converte um carimbo de data e hora em uma cadeia de caracteres de data de acordo com um formato especificado.
  • CARIMBO DE DATA/HORA: Obrigatório O carimbo de data/hora que você deseja formatar. Isso é gravado em milissegundos.
  • FORMATO: Obrigatório O formato em que você deseja que o carimbo de data/hora se torne.
dformat(CARIMBO DE DATA E HORA, FORMATO)
dformat(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
data
Converte uma string de data em um objeto ZonedDateTime (formato ISO 8601).
  • DATA: Obrigatório A cadeia de caracteres que representa a data.
  • FORMATO: Obrigatório A cadeia de caracteres que representa o formato da data de origem.Observação: não representa o formato em que você deseja converter a cadeia de caracteres de data.
  • DEFAULT_DATE: Obrigatório A data padrão retornada, se a data fornecida for nula.
date(DATE, FORMAT, DEFAULT_DATE)
date("2019-10-23 11:24", "aaaa-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
data
Converte uma string de data em um objeto ZonedDateTime (formato ISO 8601).
  • DATA: Obrigatório A cadeia de caracteres que representa a data.
  • FORMATO: Obrigatório A cadeia de caracteres que representa o formato da data de origem.Observação: não representa o formato em que você deseja converter a cadeia de caracteres de data.
date(DATA, FORMATO)
date("2019-10-23 11:24", "aaaa-MM-dd HH:mm")
2019-10-23T11:24:00Z
data
Converte uma string de data em um objeto ZonedDateTime (formato ISO 8601).
  • DATA: Obrigatório A cadeia de caracteres que representa a data.
date(DATE)
date("2019-10-23 11:24")
"2019-10-23T11:24:00Z"
date_part
Recupera as partes da data. Há suporte para os seguintes valores de componente:

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
"d"

"week"
"ww"
"w" "dia da semana"
"dw"
"w"

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

"minuto"
"mi"
"n"

"segundo"
"ss"
"s"

"milissegundo"
"SSS"
  • COMPONENTE: Obrigatório Uma cadeia de caracteres que representa a parte da data.
  • DATE: Obrigatório A data, em um formato padrão.
date_part​(COMPONENT, DATE)
date_part("MM", date("10-17-2019:55:12"))
10
set_date_part
Substitui um componente em uma determinada data. Os seguintes componentes foram aceitos:

"year"
"yyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • COMPONENTE: Obrigatório Uma cadeia de caracteres que representa a parte da data.
  • VALUE: Required O valor a ser definido para o componente em uma determinada data.
  • DATE: Obrigatório A data, em um formato padrão.
set_date_part​(COMPONENT, VALUE, DATE)
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"04/2016/09T11:44:44Z"
make_date_time
Cria uma data a partir de partes. Essa função também pode ser induzida usando make_timestamp.
  • ANO: Obrigatório O ano, gravado em quatro dígitos.
  • MÊS: Obrigatório O mês. Os valores permitidos são de 1 a 12.
  • DIA: Obrigatório O dia. Os valores permitidos são de 1 a 31.
  • HORA: Necessário A hora. Os valores permitidos são de 0 a 23.
  • MINUTO: Necessário O minuto. Os valores permitidos são de 0 a 59.
  • NANOSECOND: Obrigatório Os valores de nanossegundos. Os valores permitidos são de 0 a 99999999.
  • FUSO HORÁRIO: Obrigatório O fuso horário da data e 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_Angeles")
2019-10-17T11:55:12Z
zone_date_to_utc
Converte uma data em qualquer fuso horário em uma data em UTC.
  • DATA: Obrigatório A data que você está tentando converter.
zone_date_to_utc​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Converte uma data de um fuso horário em outro.
  • DATA: Obrigatório A data que você está tentando converter.
  • ZONA: Obrigatório O fuso horário para o qual você está tentando converter a data.
zone_date_to_zone​(DATA, ZONA)
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Hierarquias - Objetos objects

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
is_empty
Verifica se um objeto está ou não vazio.
  • ENTRADA: Obrigatório O objeto que você está tentando verificar está vazio.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
arrays_to_object
Cria uma lista de objetos.
  • ENTRADA: Obrigatório Um agrupamento de pares de chaves e matrizes.
arrays_to_object(ENTRADA)
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
Cria um objeto com base nos pares de chave/valor simples fornecidos.
  • ENTRADA: Obrigatório Uma lista simples de pares de chave/valor.
to_object(ENTRADA)
to_object​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Cria um objeto a partir da cadeia de caracteres de entrada.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres que está sendo analisada para criar um objeto.
  • VALUE_DELIMITER: Opcional O delimitador que separa um campo do valor. O delimitador padrão é :.
  • FIELD_DELIMITER: Opcional O delimitador que separa pares de valores de campo. O delimitador padrão é ,.
str_to_object​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Observação: é possível usar a função get() juntamente com str_to_object() para recuperar valores para as chaves na cadeia de caracteres.
  • Exemplo #1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Exemplo #2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • Exemplo #1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Exemplo #2: "John"
contains_key
Verifica se o objeto existe nos dados de origem. Observação: esta função substitui a função is_set() obsoleta.
  • ENTRADA: Obrigatório O caminho a ser verificado se ele existir nos dados de origem.
contains_key(ENTRADA)
contains_key("evars.evar.field1")
true
nullify
Define o valor do atributo para null. Isso deve ser usado quando você não deseja copiar o campo para o schema de destino.
nullify()
nullify()
null
get_keys
Analisa os pares chave/valor e retorna todas as chaves.
  • OBJETO: Obrigatório O objeto do qual as chaves serão extraídas.
get_keys(OBJECT)
get_keys({"book1": "Orgulho e Preconceito", "book2": "1984"})
["book1", "book2"]
get_values
Analisa os pares chave/valor e retorna o valor da string, com base na chave fornecida.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres que você deseja analisar.
  • KEY: Obrigatório A chave para a qual o valor deve ser extraído.
  • VALUE_DELIMITER: Obrigatório O delimitador que separa o campo e o valor. Se for fornecido um null ou uma cadeia de caracteres vazia, este valor será :.
  • FIELD_DELIMITER: Opcional O delimitador que separa pares de campo e valor. Se for fornecido um null ou uma cadeia de caracteres vazia, este valor será ,.
get_values(STRING, CHAVE, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John , lastName - Cena , phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Pega um mapa e uma entrada de chave. Se a entrada for uma única chave, a função retornará o valor associado a essa chave. Se a entrada for uma matriz de sequência, a função retornará todos os valores correspondentes às chaves fornecidas. Se o mapa de entrada tiver chaves duplicadas, o valor de retorno deverá desduplicar as chaves e retornar valores exclusivos.
  • MAPA: Obrigatório Os dados do mapa de entrada.
  • KEY: Obrigatório A chave pode ser uma única cadeia de caracteres ou uma matriz de cadeia de caracteres. Se qualquer outro tipo primitivo (dados / número) for fornecido, ele será tratado como uma string.
get_values(MAP, KEY)
Consulte o apêndice para obter uma amostra de código.
map_has_keys
Se uma ou mais chaves de entrada forem fornecidas, a função retornará true. Se uma matriz de string for fornecida como entrada, a função retornará true na primeira chave encontrada.
  • MAPA: Obrigatório Os dados do mapa de entrada
  • KEY: Obrigatório A chave pode ser uma única cadeia de caracteres ou uma matriz de cadeia de caracteres. Se qualquer outro tipo primitivo (dados / número) for fornecido, ele será tratado como uma string.
map_has_keys(MAP, KEY)
Consulte o apêndice para obter uma amostra de código.
add_to_map
Aceita pelo menos duas entradas. Qualquer número de mapas pode ser fornecido como entrada. O Preparo de dados retorna um único mapa que tem todos os pares de valores-chave de todas as entradas. Se uma ou mais chaves forem repetidas (no mesmo mapa ou entre mapas), o Preparo de dados desduplica as chaves para que o primeiro par de valores-chave persista na ordem em que foram passadas na entrada.
MAPA: Obrigatório Os dados do mapa de entrada.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Consulte o apêndice para obter uma amostra de código.
object_to_map (Sintaxe 1)
Use esta função para criar tipos de dados de Mapa.
  • KEY: Obrigatório As chaves devem ser uma cadeia de caracteres. Se quaisquer outros valores primitivos, como números inteiros ou datas, forem fornecidos, eles serão convertidos automaticamente em cadeias de caracteres e serão tratados como cadeias de caracteres.
  • ANY_TYPE: Obrigatório Refere-se a qualquer tipo de dados XDM com suporte, exceto Mapas.
object_to_map(CHAVE, ANY_TYPE, CHAVE, ANY_TYPE, … )
Consulte o apêndice para obter uma amostra de código.
object_to_map (Sintaxe 2)
Use esta função para criar tipos de dados de Mapa.
  • OBJETO: Obrigatório Você pode fornecer um objeto de entrada ou uma matriz de objetos e apontar para um atributo dentro do objeto como chave.
object_to_map(OBJECT)
Consulte o apêndice para obter uma amostra de código.
object_to_map (Sintaxe 3)
Use esta função para criar tipos de dados de Mapa.
  • OBJETO: Obrigatório Você pode fornecer um objeto de entrada ou uma matriz de objetos e apontar para um atributo dentro do objeto como chave.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Consulte o apêndice para obter uma amostra de código.

Para obter informações sobre o recurso de cópia de objeto, consulte a seção abaixo.

Hierarquias - Matrizes arrays

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
coalescência
Retorna o primeiro objeto não nulo em uma determinada matriz.
  • ENTRADA: Obrigatório A matriz da qual você deseja encontrar o primeiro objeto não nulo.
coalesce(INPUT)
coalesce(null, null, null, "primeiro", null, "segundo")
"first"
primeiro
Recupera o primeiro elemento da matriz especificada.
  • ENTRADA: Obrigatório A matriz da qual você deseja encontrar o primeiro elemento.
first(ENTRADA)
first("1", "2", "3")
"1"
últimos
Recupera o último elemento da matriz especificada.
  • ENTRADA: Obrigatório A matriz da qual você deseja encontrar o último elemento.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Adiciona elementos ao final da matriz.
  • ARRAY: Obrigatório A matriz à qual você está adicionando elementos.
  • VALORES: os elementos que você deseja anexar à matriz.
add_to_array​(MATRIZ, VALORES)
add_to_array​(['a', 'b'], 'c', 'd')
['a', 'b', 'c', 'd']
join_arrays
Combina os arrays entre si.
  • ARRAY: Obrigatório A matriz à qual você está adicionando elementos.
  • VALORES: a(s) matriz(es) que você deseja anexar à matriz principal.
join_arrays​(MATRIZ, VALORES)
join_arrays​(['a', 'b'], ['c'], ['d', 'e'])
['a', 'b', 'c', 'd', 'e']
to_array
Pega uma lista de entradas e a converte em uma matriz.
  • INCLUDE_NULLS: Obrigatório Um valor booliano para indicar se os nulos devem ou não ser incluídos na matriz de resposta.
  • VALORES: Obrigatório Os elementos a serem convertidos em uma matriz.
to_array​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Retorna o tamanho da entrada.
  • ENTRADA: Obrigatório O objeto do qual você está tentando encontrar o tamanho.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Esta função é usada para anexar todos os elementos na matriz de entrada inteira ao final da matriz no Perfil. Esta função é somente aplicável durante atualizações. Se usada no contexto de inserções, essa função retorna a entrada como está.
  • ARRAY: Obrigatório A matriz à qual anexar a matriz no Perfil.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123, 456]
upsert_array_replace
Esta função é usada para substituir elementos em uma matriz. Esta função é somente aplicável durante atualizações. Se usada no contexto de inserções, essa função retorna a entrada como está.
  • ARRAY: Obrigatório A matriz para substituir a matriz no Perfil.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
[Somente destinos]{class="badge informative"} array_to_string
Une as representações de cadeia de caracteres dos elementos em uma matriz usando o separador especificado. Se a matriz for multidimensional, ela será nivelada antes de ser unida. Observação: esta função é usada em destinos. Leia a documentação para obter mais informações.
  • SEPARATOR: Obrigatório O separador usado para unir os elementos na matriz.
  • ARRAY: Obrigatório A matriz que será unida (após nivelamento).
array_to_string(SEPARADOR, MATRIZ)
array_to_string(";", ["Hello", "world"])
"Olá;mundo"
[Somente destinos]{class="badge informative"} filterArray*
Filtra a matriz especificada com base em um predicado. Observação: esta função é usada em destinos. Leia a documentação para obter mais informações.
  • ARRAY: Obrigatório A matriz a ser filtrada
  • PREDICATE: Obrigatório O predicado a ser aplicado em cada elemento da matriz especificada.
filterArray(MATRIZ, PREDICADO)
filterArray([5, -6, 0, 7], x -> x > 0)
[5, 7]
[Somente destinos]{class="badge informative"} transformArray*
Transforma a matriz especificada com base em um predicado. Observação: esta função é usada em destinos. Leia a documentação para obter mais informações.
  • ARRAY: Obrigatório A matriz a ser transformada.
  • PREDICATE: Obrigatório O predicado a ser aplicado em cada elemento da matriz especificada.
transformArray(MATRIZ, PREDICADO)
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[Somente destinos]{class="badge informative"} flattenArray*
Nivela a matriz dada (multidimensional) para uma matriz unidimensional. Observação: esta função é usada em destinos. Leia a documentação para obter mais informações.
  • ARRAY: Obrigatório A matriz a ser nivelada.
flattenArray(MATRIZ)
flattenArray([['a', 'b'], ['c', 'd']], [['e'], ['f']])
['a', 'b', 'c', 'd', 'e', 'f']

Hierarquias - Mapa map

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
array_to_map
Esta função pega uma matriz de objetos e uma chave como entrada e retorna um mapa do campo da chave com o valor como chave e o elemento da matriz como valor.
  • ENTRADA: Obrigatório A matriz de objetos da qual você deseja encontrar o primeiro objeto não nulo.
  • KEY: Obrigatório A chave deve ser um nome de campo na matriz de objetos e o objeto como valor.
array_to_map(OBJECT[] INPUTS, KEY)
Leia o apêndice para obter uma amostra de código.
object_to_map
Essa função pega um objeto como argumento e retorna um mapa de pares de valores-chave.
  • ENTRADA: Obrigatório A matriz de objetos da qual você deseja encontrar o primeiro objeto não nulo.
object_to_map(OBJECT_INPUT)
"object_to_map(address) onde a entrada é " + "address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}"
Retorna um mapa com determinado nome de campo e pares de valores ou nulo se a entrada for nula. Por exemplo: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Esta função pega uma lista de pares de valor-chave e retorna um mapa de pares de valor-chave.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Retorna um mapa com determinado nome de campo e pares de valores ou nulo se a entrada for nula. Por exemplo: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Operadores lógicos logical-operators

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
decodificar
Dada uma chave e uma lista de pares de valores chave nivelados como uma matriz, a função retorna o valor se a chave for encontrada ou retorna um valor padrão se presente na matriz.
  • KEY: Obrigatório A chave a ser correspondida.
  • OPTIONS: Obrigatório Uma matriz nivelada de pares de chave/valor. Opcionalmente, um valor padrão pode ser colocado no final.
decode(CHAVE, OPTIONS)
decode(stateCode, "ca", "Califórnia", "pa", "Pennsylvania", "N/A")
Se o stateCode fornecido for "ca", "California".
Se o stateCode fornecido for "pa", "Pennsylvania".
Se stateCode não corresponder ao seguinte, "N/A".
iif
Avalia uma determinada expressão booleana e retorna o valor especificado com base no resultado.
  • EXPRESSION: Required A expressão booleana que está sendo avaliada.
  • TRUE_VALUE: Obrigatório O valor retornado se a expressão for avaliada como verdadeira.
  • FALSE_VALUE: Obrigatório O valor retornado se a expressão for avaliada como falsa.
iif(EXPRESSÃO, VALOR_VERDADEIRO, VALOR_FALSO)
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"

Agregação aggregation

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
min
Retorna o mínimo dos argumentos fornecidos. Usa a ordenação natural.
  • OPTIONS: Obrigatório Um ou mais objetos que podem ser comparados entre si.
min(OPTIONS)
min(3, 1, 4)
1
max
Retorna o máximo dos argumentos fornecidos. Usa a ordenação natural.
  • OPTIONS: Obrigatório Um ou mais objetos que podem ser comparados entre si.
max(OPTIONS)
max(3, 1, 4)
4

Conversões de tipo type-conversions

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
to_bigint
Converte uma cadeia de caracteres em um BigInteger.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres a ser convertida em um BigInteger.
to_bigint(STRING)
to_bigint​("1000000.34")
1000000,34
to_decimal
Converte uma cadeia de caracteres em um Duplo.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres a ser convertida em Double.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Converte uma cadeia de caracteres em um flutuante.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres a ser convertida em Float.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Converte uma string em um inteiro.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres a ser convertida em um inteiro.
to_integer(STRING)
to_integer("12")
12

Funções JSON json

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
json_to_object
Desserialize o conteúdo JSON da string fornecida.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres JSON a ser desserializada.
json_to_object​(STRING)
json_to_object​({"info":{"firstName":"John","lastName": "Doe"}})
Um objeto que representa o JSON.

Operações especiais special-operations

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
uuid /
guid
Gera uma ID pseudo-aleatória.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Essa função pega uma sequência de caracteres FPID e a converte em uma ECID para ser usada em aplicativos Adobe Experience Platform e Adobe Experience Cloud.
  • CADEIA DE CARACTERES: Obrigatório A cadeia de caracteres FPID a ser convertida em ECID.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Funções do agente do usuário user-agent

Qualquer uma das funções do agente do usuário contidas na tabela abaixo pode retornar um dos seguintes valores:

  • Telefone - um dispositivo móvel com tela pequena (geralmente < 7 pol)
  • Dispositivo móvel - Um dispositivo móvel que ainda não foi identificado. Esse dispositivo móvel pode ser um eReader, um tablet, um telefone, um relógio etc.

Para obter mais informações sobre valores de campo de dispositivo, leia a lista de valores de campo de dispositivo no apêndice deste documento.

NOTE
Role a tela para a esquerda/direita para visualizar o conteúdo completo da tabela.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
ua_os_name
Extrai o nome do sistema operacional da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_os_name​(USER_AGENT)
ua_os_name​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Extrai a versão principal do sistema operacional da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_os_version_major​(USER_AGENT)
ua_os_version_major​s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5
ua_os_version
Extrai a versão do sistema operacional da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_os_version​(USER_AGENT)
ua_os_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1
ua_os_name_version
Extrai o nome e a versão do sistema operacional da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_os_name_version​(USER_AGENT)
ua_os_name_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Extrai a versão do agente da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_agent_version​(USER_AGENT)
ua_agent_version​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5,1
ua_agent_version_major
Extrai o nome do agente e a versão principal da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_agent_version_major​(USER_AGENT)
ua_agent_version_major​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Extrai o nome do agente da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_agent_name​(USER_AGENT)
ua_agent_name​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
Extrai a classe de dispositivo da sequência de agente do usuário.
  • USER_AGENT: Necessário A sequência de agente do usuário.
ua_device_class​(USER_AGENT)
ua_device_class​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Telefone

Funções do Analytics analytics

NOTE
Você só pode usar as seguintes funções de análise para fluxos do WebSDK e do Adobe Analytics.
Função
Descrição
Parâmetros
Sintaxe
Expressão
Saída de exemplo
aa_get_event_id
Extrai a ID de evento de uma string de evento do Analytics.
  • EVENT_STRING: Obrigatório A cadeia de caracteres de evento do Analytics separada por vírgulas.
  • EVENT_NAME: Obrigatório O nome do evento do qual extrair e ID.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Extrai o valor de evento de uma string de evento do Analytics. Se o valor do evento não for especificado, 1 será retornado.
  • EVENT_STRING: Obrigatório A cadeia de caracteres de evento do Analytics separada por vírgulas.
  • EVENT_NAME: Obrigatório O nome do evento do qual extrair um valor.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_categories
Extrai a categoria de produto de uma string de produtos do Analytics.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
aa_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories(";Exemplo de produto 1;1;3.50,Exemplo de categoria 2;Exemplo de produto 2;1;5.99")
[null,"Exemplo de categoria 2"]
aa_get_product_names
Extrai o nome do produto de uma string de produtos do Analytics.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names(";Exemplo produto 1;1;3.50,Exemplo categoria 2;Exemplo produto 2;1;5.99")
["Exemplo de produto 1","Exemplo de produto 2"]
aa_get_product_quantity
Extrai as quantidades de uma string de produtos do Analytics.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
aa_get_product_quantity(PRODUCTS_STRING)
aa_get_product_quantity(";Exemplo produto 1;1;3.50,Exemplo categoria 2;Exemplo produto 2")
["1", nulo]
aa_get_product_price
Extrai o preço de uma string de produtos do Analytics.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
aa_get_product_price(PRODUCTS_STRING)
aa_get_product_price(";Exemplo produto 1;1;3.50,Exemplo categoria 2;Exemplo produto 2")
["3.50", nulo]
aa_get_product_event_values
Extrai valores para o evento nomeado da string de produtos como uma matriz de strings.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
  • EVENT_NAME: Obrigatório O nome do evento do qual extrair valores.
aa_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values(";Exemplo produto 1;1;4.20;event1=2.3|event2=5:1,;Exemplo produto 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_evars
Extrai os valores de evar do evento nomeado da string de produtos como uma matriz de strings.
  • PRODUCTS_STRING: Obrigatório A cadeia de caracteres de produtos do Analytics.
  • EVAR_NAME: Obrigatório O nome do eVar a ser extraído.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars(";Exemplo produto;1;6.69;;eVar 1=Valor de merchandising", "eVar 1")
["Valor de merchandising"]

Cópia do objeto object-copy

TIP
O recurso de cópia de objeto é aplicado automaticamente quando um objeto na origem é mapeado para um objeto no XDM. Nenhuma ação adicional necessária por parte dos usuários.

Você pode usar o recurso de cópia de objeto para copiar atributos automaticamente de um objeto sem fazer alterações no mapeamento. Por exemplo, se os dados de origem tiverem uma estrutura de:

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

e uma estrutura XDM de:

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

Em seguida, o mapeamento se torna:

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

No exemplo acima, os atributos city e state também são assimilados automaticamente em tempo de execução porque o objeto address está mapeado para addr. Se você tiver que criar um atributo line2 na estrutura XDM e seus dados de entrada também contiverem um line2 no objeto address, ele também será assimilado automaticamente, sem a necessidade de alterar manualmente o mapeamento.

Para garantir que o mapeamento automático funcione, os seguintes pré-requisitos devem ser atendidos:

  • Objetos de nível primário devem ser mapeados;
  • Novos atributos devem ter sido criados no esquema XDM;
  • Os novos atributos devem ter nomes correspondentes no esquema de origem e no esquema XDM.

Se qualquer um dos pré-requisitos não for atendido, você deverá mapear manualmente o esquema de origem para o esquema XDM usando o preparo de dados.

Apêndice

Veja a seguir informações adicionais sobre o uso das funções de mapeamento do Preparo de dados

Caracteres especiais special-characters

A tabela abaixo descreve uma lista de caracteres reservados e seus caracteres codificados correspondentes.

Caractere reservado
Caractere codificado
espaço
%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 do campo Dispositivo device-field-values

A tabela abaixo descreve uma lista de valores de campo de dispositivo e suas descrições correspondentes.

Dispositivo
Descrição
Desktop
Um tipo de dispositivo Desktop ou Laptop.
Anônimo
Um dispositivo anônimo. Em alguns casos, são useragents que foram alterados por um software de anonimização.
Desconhecido
Um dispositivo desconhecido. Normalmente, são useragents que não contêm informações sobre o dispositivo.
Dispositivo móvel
Um dispositivo móvel que ainda não foi identificado. Esse dispositivo móvel pode ser um eReader, um tablet, um telefone, um relógio etc.
Tablet
Um dispositivo móvel com tela grande (geralmente > 7 pol).
Telefone
Um dispositivo móvel com tela pequena (geralmente < 7 pol).
Observar
Um dispositivo móvel com uma tela pequena (geralmente < 2 pol). Esses dispositivos normalmente funcionam como uma tela adicional para um dispositivo do tipo telefone/tablet.
Realidade aumentada
Um dispositivo móvel com recursos de AR.
Realidade virtual
Um dispositivo móvel com recursos VR.
eReader
Um dispositivo semelhante a um tablet, mas geralmente com uma tela eInk.
Decodificador de sinais
Um dispositivo conectado que permite a interação através de uma tela dimensionada para TV.
TV
Um dispositivo semelhante ao decodificador de sinais, mas integrado à TV.
Equipamento doméstico
Um aparelho doméstico (geralmente grande), como uma geladeira.
Console de jogos
Um sistema de jogos fixo como o Playstation ou o XBox.
Console de jogos portátil
Um sistema móvel de jogos como o Nintendo Switch.
Voz
Um dispositivo orientado por voz, como um Amazon Alexa ou um Google Home.
Carro
Um navegador baseado em veículo.
Robô
Robôs que visitam um site.
Robot Mobile
Robôs que visitam um site, mas indicam que desejam ser vistos como um visitante móvel.
Robot Imitator
Robôs que visitam um site, fingindo que são robôs como Google, mas não são. Observação: na maioria dos casos, os Robot Imitators são realmente robôs.
Nuvem
Um aplicativo baseado em nuvem. Eles não são robôs nem hackers, mas são aplicativos que precisam se conectar. Isso inclui Mastodon servidores.
Hacker
Este valor de dispositivo é usado caso scripts sejam detectados na cadeia de caracteres useragent.

Amostras de código code-samples

map_get_values map-get-values

Selecione para exibir o exemplo
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

Selecione para exibir o exemplo
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

Selecione para exibir o exemplo
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

Sintaxe 1

Selecione para exibir o exemplo
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Sintaxe 2

Selecione para exibir o exemplo
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\"}"

Sintaxe 3

Selecione para exibir o exemplo
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

Selecione para exibir o exemplo
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