Este artigo contém a lista completa de expressões disponíveis para uso no Editor de Aplicativos do Trigger.
O uso de expressões permite que você utilize seus dados de diferentes maneiras ou os manipule em diferentes formatos.
Expressões no Editor de Aplicativos
Todos os exemplos são baseados em “Conclusões” de aplicativos. Portanto, ao usar uma função MAXIMUM() ou MINIMUM(), por exemplo, você está buscando o valor máximo ou mínimo de uma variável em todas as conclusões de um aplicativo.
**ADD_TIME()**Incrementa um valor de data e hora em uma quantidade e unidade de intervalo especificadas.
Ex.: ADD_TIME(variável_datetime, 2, 'anos')
**SUBTRACT_TIME()**Reduz um valor de data e hora em uma quantidade e unidade de intervalo especificadas.
Ex.: SUBTRACT_TIME(variável_datetime, 3, 'meses')
Expressões de conversão de tipo
**BADGE_ID_TO_USER()**Converte um ID de crachá em um objeto User
Ex. BADGE_ID_TO_USER(0000) = "John Doe" como um objeto usuário
DATETIMETOTEXT()
Converte um valor de data e hora em um valor de texto facilmente legível por uma pessoa
Ex.: DATETIMETOTEXT(variável_datetime, "MMMM DD, YYYY", 'America/New_York')
Isso converterá uma data e hora para o horário padrão do leste (EST) e a exibirá no formato tradicional de data, como “1º de janeiro de 2019”.
Observação: o último parâmetro, o fuso horário, deve corresponder a um dos nomes de bancos de dados tz listados aqui.
FILETOTEXT("url: Arquivo") => Texto: Converte o arquivo em uma sequência de texto da URL
Ex.: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")
HEX_TO_INT()
Retorna a representação numérica de uma determinada sequência hexadecimal.
Ex.: HEX_TO_INT('0xAB18') = '43800'
INT_TO_HEX()
Retorna a representação hexadecimal de um determinado número.
Ex.: INT_TO_HEX('43800') = '0xAB18'
INTERVAL_TO_SECONDS(intervalo: Interval) => Número Retorna a duração de um intervalo em segundos
Ex. INTERVAL_TO_SECONDS(seconds_to_interval(30,0))
LOWERCASE()
Converte uma string para letras minúsculas
MAP_TO_BOOLEAN_LIST(a: {} array, b: text) => arrayConverte uma matriz de objetos em uma matriz de valores booleanos para a chave fornecida
Ex.: MAP_TO_BOOLEAN_LIST([{chave: valor}], ‘chave’) = [valor]
MAP_TO_INTEGER_LIST(a: {} array, b: text) => arrayConverte um array de objetos em um array base para a chave fornecida
Ex. MAP_TO_INTEGER_LIST([{chave: valor}], ‘chave’) = [valor]
MAP_TO_NUMBER_LIST(a: {} array, b: text) => arrayConverte um array de objetos em um array básico para a chave especificada
Ex. MAP_TO_NUMBER_LIST([{chave: valor}], ‘chave’) = [valor]
MAP_TO_TEXT_LIST(a: {} array, b: text) => arrayConverte uma matriz de objetos em uma matriz básica para a chave especificada
Ex. MAP_TO_TEXT_LIST([{chave: valor}], ‘chave’) = [valor]
**SECONDS_TO_INTERVAL()**Converte segundos em um Interval.
SECONDS_TO_INTERVAL(segundos: Inteiro ou Número) => Intervalo
Ex.: SECONDS_TO_INTERVAL(20) => 0:00:20
**TEXTTOBOOLEAN()**Analisa texto e o converte em um valor booleano.
“y”, “yes”, “t”, “true” e “on”, bem como quaisquer variantes em maiúsculas, são reconhecidos como verdadeiros, enquanto “n”, “no”, “f”, “false” e “off” são reconhecidos como falsos.
Ex. TEXTTOBOOLEAN("yes")
TEXTTODATETIME()
Converte um valor de texto em um valor de data e hora com os parâmetros especificados. É comumente usado quando você tem um Connector Function que contém uma data e hora no formato de texto e precisa convertê-la.
TEXTTOIMAGEURL(url:Text) => URL da imagemConverte uma string em uma URL de imagem.
Ex.: TEXTTOIMAGEURL("https://example.com/photo.jpg")
**TEXTTOINTEGER()**Analisa texto ou intervalo e o converte em um inteiro.
Ex.: TEXTTOINTEGER("123")
**TEXTTONUMBER()**Analisa texto ou carimbo de data/hora e o converte em um número
Ex.: TEXTTONUMBER("2,4")
TOTEXT(): Converte qualquer valor em texto.
Ex.: TOTEXT(2)
UPPERCASE()
Converte uma string para letras maiúsculas
USER_ID_TO_USER(id: Texto) => User: Converte um ID de usuário em um objeto de usuário
Ex. User_id_to_user("abc") = User
Expressões truncadas
CEIL()
Arredonda para o inteiro mais próximo
FLOOR()
Arredonda para baixo para o inteiro mais próximo
ROUND()
Arredonda um número para o número especificado de casas decimais. Máximo de 3 casas decimais.
Ex. 1 - ROUND(123,123456; 1)
Isso retornará 123,1
Ex. 2 - ROUND(123,12)
Isso retornará 123
ROUNDDATETIME()
Trunca um valor de Datetime para uma determinada unidade, como mês ou dia.
Ex. ROUNDDATETIME(variável_datetime, "Mês", "America/New_York")
Isso converterá uma data e hora apenas para o mês no Horário Padrão do Leste.
Observação: o último parâmetro, o fuso horário, deve ser um dos nomes de banco de dados tz listados aqui.
Expressões de retorno de valor
ABS()
Retorna o valor absoluto de um número
CONTAINS()
Retorna se uma string contém uma determinada substring
Ex. CONTAINS("123ABC", "123")
Isso retornaria “verdadeiro”
COS()
Retorna o cosseno do valor fornecido
ENCODE_URI(componente: Texto) => Texto
Retorna uma versão da URI codificada como string para URL.
Ex.: ENCODE_URI("http://example.com/a=foo&b=a test") = "http://example.com/a=foo&b=a test"
ENCODE_URI_COMPONENT(componente: Texto) => Texto
Retorna uma versão em string codificada como URL de um componente de URI.
Ex.: ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"
**FIND()**Retorna a posição em que o primeiro argumento ocorre dentro do segundo argumento.
IF()
Com base no primeiro argumento, retorna o segundo argumento se o primeiro for verdadeiro, ou o terceiro argumento se o primeiro for falso.
Ex.: IF(true, 1, 2)
**ISNULL()**Retorna verdadeiro se o argumento for nulo; caso contrário, retorna falso.
**LEFT()**Retorna uma subcadeia de um valor de texto, começando na posição especificada pelo segundo argumento.
**LEN()**Retorna o comprimento de um valor de texto. Também retorna o número de itens em uma matriz.
LINK()
Retorna o primeiro dos argumentos que não for nulo.
Ex. LINK(peso, 70)
Isso retornará o valor de peso, caso peso tenha um valor
MAX()
Retorna o argumento com o maior valor
Ex. MAX(var1, var2)
Isso retornará o valor de var1 se ele for maior que o valor de var2
**MID()**Retorna uma subcadeia de um valor de texto, começando na posição especificada pelo segundo argumento. O terceiro argumento especifica o comprimento do resultado.
**MIN()**Retorna o argumento com o menor valor
Ex. MIN(var1, var2)
Isso retornará o valor de var1 se ele for menor que o valor de var2
POW()
Retorna o primeiro argumento elevado à potência do segundo argumento
Ex. POW(3,2)
Isso retornará 9
RAND()
Gera um número decimal aleatório entre 0 e 1
RANDBETWEEN()
Gera um número inteiro aleatório entre dois números especificados
Ex.: RANDBETWEEN(5,10)
RANDOMSTRING()
Retorna uma sequência aleatória de 17 caracteres. Destinada à criação de um ID para um novo registro na tabela.
**RANDOM_COLOR()**Gera uma cor aleatória
Ex.: RANDOM_COLOR() = ##c537a5
RGBA(r: inteiro, g: inteiro, b: inteiro, a: inteiro) => cor Retorna uma cor com os componentes especificados de vermelho, verde, azul e alfa
Ex.: RGBA(255, 255, 0, 0,5) = ##ffff00 (50% de opacidade)
RGB(r: inteiro, g: inteiro, b: inteiro) => Cor Retorna uma cor com os componentes de vermelho, verde e azul especificados
Ex. RGB(255, 255, 0) = ##ffff00
**RIGHT()**Retorna uma subcadeia de um valor de texto, terminando na posição especificada pelo segundo argumento.
SIN()
Retorna o seno do valor de entrada fornecido
**SPLIT()**Divide um valor de texto em uma matriz por meio de um delimitador especificado.
SQRT()
Retorna a raiz quadrada de um número
SUBSTITUTE()
Dentro de uma string fornecida no primeiro argumento, substitui todas as ocorrências do segundo argumento pelo terceiro argumento
Ex.: SUBSTITUTE("A734", "7", "3")
Isso retornará “A334”
TAN()
Retorna a tangente do valor fornecido
**TRIM()**Remove uma subcadeia (especificada pelo segundo argumento) do início e do final do primeiro argumento.
Expressões de matriz
ARRAY_AVG()
Retorna a média de todos os números em uma matriz
Ex. ARRAY_AVG([1,2,3])
Isso retornaria 2
ARRAY_CONCAT()
Retorna uma única matriz com todos os elementos das matrizes incluídas nos argumentos. Funciona apenas com matrizes do mesmo tipo, ou seja, todas as matrizes de texto.
Ex. ARRAY_CONCAT([1,2],[3,4],[5,6])
Isso retornaria [1,2,3,4,5,6]
ARRAYCONTAINS()
Determina se um valor está presente em um array
Ex. ARRAYCONTAINS([1,2,3], 1)
Isso retornará “true”
**ARRAY_INDEX_OF()**Retorna o índice da primeira ocorrência do valor fornecido na matriz especificada. Se não for encontrado, retorna “-1”.Ex. ARRAY_INDEX_OF([1,2,3], 2)Isso retornará 1
ARRAY_MAX()
Retorna o menor valor de uma matriz determinada
Ex. ARRAY_MAX([1,2,3])
Isso retornaria 3
ARRAY_MIN()
Retorna o menor valor de um determinado array
Ex. ARRAY_MIN([1,2,3])
Isso retornaria 1
ARRAY_STDEV_POPULATION()
Retorna o desvio padrão da população de uma determinada matriz numérica
Ex. ARRAY_STDEV_POPULATION([1,2,3])
Isso retornaria 0,816496580927726
ARRAY_STDEV_SAMPLE()
Retorna o desvio padrão da amostra de uma determinada matriz numérica
Ex. ARRAY_STDEV_SAMPLE([1,2,3])
Isso retornaria 1
**ARRAY_VALUE_AT_INDEX()**Retorna o valor no índice especificado na lista fornecida. Se o índice estiver fora dos limites, retorna null. Ex.: ARRAY_VALUE_AT_INDEX([1,2,3], 0) Isso retornaria 1
**REGEX_MATCH()**Retorna uma matriz de correspondências de expressões regulares de um valor de texto. As correspondências são baseadas na expressão regular e nos modificadores fornecidos. Esse método é baseado no método match do JavaScript e possui 2 “modos”.
Quando este método recebe dois argumentos, é equivalente à seguinte expressão em JavaScript:text.match(new RegExp(regex))Quando o parâmetro opcional modifiers é fornecido, este método é equivalente à seguinte expressão em JavaScript:`text.match(new RegExp(regex, modifiers))`. Os modificadores são sinalizadores que podem ser usados para alterar o comportamento da busca por expressão regular.
**REGEX_REPLACE()**Retorna uma matriz de correspondências de expressões regulares de um valor de texto. As correspondências são baseadas na expressão regular fornecida e nos modificadores. Esse método é baseado no método replace do JavaScript.
Quando a função recebe 3 argumentos, ela é equivalente à seguinte expressão em JavaScript:text.replace(new RegExp(regex), replacement)
Quando o parâmetro opcional modifiers é fornecido, este método é equivalente à seguinte expressão em JavaScript:text.replace(new RegExp(regex, modifiers), replacement)Modificadores são sinalizadores que podem ser usados para modificar o comportamento da busca por expressão regular.
Ao escrever uma expressão regular dentro de uma string, é necessário escapar as barras invertidas () porque o JavaScript trata cada barra invertida como um caractere de escape em literais de string.
regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')Essa expressão geraria “There Hello”.
{{snippet.Você encontrou o que estava procurando?}}