Elenco completo delle espressioni nell’editor dell’app

Questo articolo contiene l’elenco completo delle espressioni disponibili per l’uso nell’App Editor all’interno di Trigger.

L’uso delle espressioni consente di utilizzare i dati in modi diversi o di manipolarli in forme diverse.

Espressioni nell’App Editor

Tutti gli esempi si basano sui completamenti delle app. Pertanto, quando si utilizza una funzione MAXIMUM() o MINIMUM(), ad esempio, si sta cercando il valore massimo o minimo di una variabile in tutti i completamenti di un’app.

**ADD_TIME()**Incrementa un valore Datetime di un importo e di un'unità di intervallo specificati.

Es. ADD_TIME(variabile_datetime, 2, 'anni')

SUBTRACT_TIME(): decrementa un valore Datetime di un importo specificato e con un'unità di intervallo specificata.

Es. SUBTRACT_TIME(variabile_datetime, 3, 'months')

Espressioni di conversione di tipo

**BADGE_ID_TO_USER()**Converte un ID badge in un oggetto User

Es. BADGE_ID_TO_USER(0000) = "John Doe" come oggetto utente

DATETIMETOTEXT()
Converte un valore Datetime in un valore di testo facilmente leggibile dall’utente

Es. DATETIMETOTEXT(variabile_datetime, "MMMM GG, AAAA", 'America/New_York')

Questo convertirà una data e ora nell’ora standard dell’Est (EST) e la visualizzerà nel formato tradizionale, ad esempio "1 gennaio 2019".

Nota: l’ultimo parametro, il fuso orario, deve corrispondere a uno dei nomi del database tz elencati qui.

FILETOTEXT("url: File") => Testo: converte il file in una stringa di testo contenente l’URL

Es.: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

HEX_TO_INT()
Restituisce la rappresentazione numerica di una data stringa esadecimale.
Es. HEX_TO_INT('0xAB18') = '43800'

INT_TO_HEX()
Restituisce la rappresentazione esadecimale di un dato numero.
Es. INT_TO_HEX('43800') = '0xAB18'

INTERVAL_TO_SECONDS(intervallo: Intervallo) => Numero Restituisce la durata di un intervallo in secondi

Es. INTERVAL_TO_SECONDS(seconds_to_interval(30.0))

LOWERCASE()
Converte una stringa in minuscolo

MAP_TO_BOOLEAN_LIST(a: {} array, b: text) => array Converte un array di oggetti in un array di base per la chiave specificata

Es. MAP_TO_BOOLEAN_LIST([{key: value}], ‘key’) = [value]

MAP_TO_INTEGER_LIST(a: {} array, b: text) => array Converte un array di oggetti in un array di base per la chiave specificata

Es. MAP_TO_INTEGER_LIST([{key: value}], ‘key’) = [value]

MAP_TO_NUMBER_LIST(a: {} array, b: text) => array: converte un array di oggetti in un array di base per la chiave specificata

Es. MAP_TO_NUMBER_LIST([{key: value}], ‘key’) = [value]

MAP_TO_TEXT_LIST(a: {} array, b: text) => array Converte un array di oggetti in un array di base per la chiave specificata

Es. MAP_TO_TEXT_LIST([{key: value}], ‘key’) = [value]

**SECONDS_TO_INTERVAL()**Converte i secondi in un Interval.

SECONDS_TO_INTERVAL(seconds: Integer o Number) => Interval

Es. SECONDS_TO_INTERVAL(20) => 0:00:20

TEXTTOBOOLEAN(): analizza il testo e lo converte in un valore booleano.

"y", "yes", "t", "true" e "on", nonché qualsiasi variante in maiuscolo, vengono riconosciuti come veri, mentre "n", "no", "f", "false" e "off" vengono riconosciuti come falsi.

Es. TEXTTOBOOLEAN("yes")

TEXTTODATETIME()
Converte un valore di testo in un valore Datetime con i parametri specificati. È comunemente utilizzata se si dispone di un Connector Function che condivide un Datetime in formato testo e si ha bisogno di convertirlo.

TEXTTOIMAGEURL(url:Text) => URL dell’immagine: Converte una stringa in un URL di immagine.

Es. TEXTTOIMAGEURL("https://example.com/photo.jpg")

**TEXTTOINTEGER()**Analizza un testo o un intervallo e lo converte in un numero intero.

Es. TEXTTOINTEGER("123")

TEXTTONUMBER(): analizza un testo o un timestamp trasformandolo in un numero

Es. TEXTTONUMBER("2.4")

TOTEXT(): converte qualsiasi dato in testo.

Es. TOTEXT(2)

UPPERCASE()
Converte una stringa in maiuscolo

USER_ID_TO_USER(id: Testo) => Utente: converte un ID utente in un oggetto utente

Es. User_id_to_user("abc") = User

Espressioni troncate

CEIL()
Arrotonda per eccesso al numero intero più vicino

FLOOR()
Arrotonda per difetto al numero intero più vicino

ROUND()
Arrotonda un numero al numero specificato di cifre decimali. Massimo 3 cifre decimali.
Es. 1 - ROUND(123,123456; 1)
Il risultato sarà 123,1
Es. 2 - ROUND(123,12)
Restituirà 123

ROUNDDATETIME()
Arrotonda un valore Datetime a un'unità specificata, come mese o giorno.

Es. ROUNDDATETIME(variabile_datetime, "Mese", "America/New_York")
Questo convertirà una data e ora in un valore corrispondente al solo mese secondo l'ora standard dell'Est (EST).

Nota: l'ultimo parametro, il fuso orario, deve corrispondere a uno dei nomi di database tz elencati qui.

Espressioni di ritorno del valore

ABS()
Restituisce il valore assoluto di un numero

CONTAINS()
Indica se una stringa contiene una determinata sottostringa
Es. CONTAINS("123ABC", "123")
In questo caso verrebbe restituito "vero"

COS()
Restituisce il coseno del valore specificato

ENCODE_URI(componente: Testo) => Testo
Restituisce una versione stringa di un URI codificata secondo lo standard URL.
Es. ENCODE_URI("http://example.com/a=foo&b=a test") = "http://example.com/a=foo&b=a test"

ENCODE_URI_COMPONENT(componente: Testo) => Testo
Restituisce una versione stringa codificata in formato URL di un componente URI.

Es. ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"

**FIND()**Restituisce la posizione in cui il primo argomento compare all’interno del secondo argomento.

IF()
In base al primo argomento, restituisce il secondo argomento se il primo è vero, oppure il terzo argomento se il primo è falso.
Es. IF(vero, 1, 2)

**ISNULL()**Restituisce vero se l’argomento è nullo, altrimenti falso.

**LEFT()**Restituisce una sottostringa di un valore di testo, a partire dalla posizione specificata dal secondo argomento.

**LEN()**Restituisce la lunghezza di un valore di testo. Restituisce anche il numero di elementi in un array.

LINK()
Restituisce il primo degli argomenti che non è nullo.

Es. LINK(peso, 70)
In questo caso verrà restituito il valore di weight se weight ha un valore

MAX()
Restituisce l’argomento con il valore più alto
Es. MAX(var1, var2)
Restituirà il valore di var1 se è maggiore del valore di var2

**MID()**Restituisce una sottostringa di un valore di testo, a partire dalla posizione specificata dal secondo argomento. Il terzo argomento specifica la lunghezza della sottostringa restituita.

**MIN()**Restituisce l’argomento con il valore più basso
Es. MIN(var1, var2)
Restituirà il valore di var1 se è inferiore al valore di var2

POW()
Restituisce il primo argomento elevato alla potenza del secondo argomento
Es. POW(3,2)
Restituirà 9

RAND()
Genera un numero decimale casuale compreso tra 0 e 1

RANDBETWEEN()
Genera un numero intero casuale compreso tra due numeri specificati
Es. RANDBETWEEN(5,10)

RANDOMSTRING()
Restituisce una stringa casuale di 17 caratteri. Destinata alla creazione di un ID per un nuovo record della tabella.

**RANDOM_COLOR()**Genera un colore casuale

Es. RANDOM_COLOR() = ##c537a5

RGBA(r: Intero, g: Intero, b: Intero, a: Intero) => Colore Restituisce un colore con le componenti specificate di rosso, verde, blu e alfa

Es. RGBA(255, 255, 0, 0,5) = ##ffff00 (opacità al 50%)

RGB(r: numero intero, g: numero intero, b: numero intero) => Colore Restituisce un colore con le componenti specificate di rosso, verde e blu

Es. RGB(255, 255, 0) = ##ffff00

**RIGHT()**Restituisce una sottostringa di un valore di testo, che termina nella posizione specificata dal secondo argomento.

SIN()
Restituisce il seno del valore immesso

SPLIT(): Suddivide un valore di testo in un array in base a un delimitatore specificato.

SQRT()
Restituisce la radice quadrata di un numero

SUBSTITUTE()
All'interno di una stringa specificata nel primo argomento, sostituisce tutte le occorrenze del secondo argomento con il terzo argomento
Es. SUBSTITUTE("A734", "7", "3")
Il risultato sarà "A334"

TAN()
Restituisce la tangente del valore specificato

**TRIM()**Rimuove una sottostringa (specificata dal secondo argomento) dall’inizio e dalla fine del primo argomento.

Espressioni con array

ARRAY_AVG()
Restituisce la media di tutti i numeri presenti in un array
Es. ARRAY_AVG([1,2,3])
Il risultato sarebbe 2

ARRAY_CONCAT()
Restituisce un unico array contenente tutti gli elementi degli array inclusi negli argomenti. Funziona solo con array dello stesso tipo, ad esempio tutti array di testo.
Es. ARRAY_CONCAT([1,2],[3,4],[5,6])
Restituirebbe [1,2,3,4,5,6]

ARRAYCONTAINS()
Determina se un valore è presente in un array
Es. ARRAYCONTAINS([1,2,3], 1)
Restituirà "true"

**ARRAY_INDEX_OF()**Restituisce l’indice della prima occorrenza del valore specificato nell’array specificato. Se non viene trovato, restituisce “-1”. Es. ARRAY_INDEX_OF([1,2,3], 2) Restituirà 1

ARRAY_MAX()
Restituisce il valore minimo di un array specificato
Es. ARRAY_MAX([1,2,3])
Restituirà 3

ARRAY_MIN()
Restituisce il valore minimo di un dato array
Es. ARRAY_MIN([1,2,3])
Restituirebbe 1

ARRAY_STDEV_POPULATION()
Restituisce la deviazione standard della popolazione di un dato array numerico
Es. ARRAY_STDEV_POPULATION([1,2,3])
Restituirebbe 0,816496580927726

ARRAY_STDEV_SAMPLE()
Restituisce la deviazione standard del campione di un dato array numerico
Es. ARRAY_STDEV_SAMPLE([1,2,3])
Restituirebbe 1

**ARRAY_VALUE_AT_INDEX()**Restituisce il valore all'indice specificato nell'array specificato. Se l'indice è fuori dai limiti, restituisce null. Es. ARRAY_VALUE_AT_INDEX([1,2,3], 0) Restituirebbe 1

**REGEX_MATCH()**Restituisce un array di corrispondenze con espressioni regolari di un valore di testo. Le corrispondenze si basano sull’espressione regolare e sui modificatori specificati. Questo metodo si basa sul metodo match di JavaScript e dispone di 2 «modalità».

Quando a questo metodo vengono passati 2 argomenti, è equivalente alla seguente espressione JavaScript:text.match(new RegExp(regex))Quando viene fornito il parametro opzionale modifiers, questo metodo è equivalente alla seguente espressione in JavaScript:text.match(new RegExp(regex, modifiers))I modificatori sono flag che possono essere utilizzati per modificare il comportamento della ricerca con l’espressione regolare.

**REGEX_REPLACE()**Restituisce un array di corrispondenze con espressioni regolari di un valore di testo. Le corrispondenze si basano sull’espressione regolare specificata e sui modificatori. Questo metodo si basa sul metodo replace di JavaScript.

Quando alla funzione vengono passati 3 argomenti, è equivalente alla seguente espressione JavaScript:text.replace(new RegExp(regex), replacement)

Quando viene fornito il parametro opzionale modifiers, questo metodo è equivalente alla seguente espressione in JavaScript:`text.replace(new RegExp(regex, modifiers), replacement)`I modificatori sono flag che possono essere utilizzati per modificare il comportamento della ricerca con espressioni regolari.

Quando si scrive un'espressione regolare all’interno di una stringa, è necessario eseguire l’escape delle barre rovesciate () poiché JavaScript tratta ogni barra rovesciata come un carattere di escape nelle stringhe letterali.

regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')Questa espressione restituirebbe "There Hello".

{{snippet.Hai trovato quello che cercavi?}}