Liste complète des expressions dans l'éditeur d'applications

Cet article contient la liste complète des expressions qui peuvent être utilisées dans l'éditeur d'applications au sein des fonctions de déclenchement.

L'utilisation d'expressions vous permet d'utiliser vos données de différentes manières ou de les manipuler sous différentes formes.

:::(Info) (NOTE) La liste des expressions dans l'éditeur d'application diffère des expressions disponibles dans l'éditeur d'analyse :: :

Expressions disponibles dans l'éditeur d'applications

Tous les exemples se basent sur les compléments d'application. Ainsi, lorsque vous utilisez une fonction MAXIMUM() ou MINIMUM(), par exemple, vous recherchez la valeur maximale ou minimale d'une variable sur l'ensemble des achèvements d'une application.

**ADD_TIME()**Augmente une valeur Datetime d'une quantité et d'une unité d'intervalle spécifiées.

Ex. ADD_TIME*(datetime_variable,* 2, 'years')

**SUBTRACT_TIME()**Diminue une valeur Datetime d'une quantité et d'une unité d'intervalle spécifiées.

Ex. SUBTRACT_TIME*(datetime_variable,* 3, 'mois')

Expressions de typecasting

DATETIMETOTEXT()

Convertit une valeur datetime en une valeur texte facilement lisible par un humain.

Ex. DATETIMETOTEXT*(datetime_variable*, "MMMM DD, YYYY", 'America/New_York')

Cette méthode convertit une date en heure normale de l'Est et l'affiche dans un formatage de date traditionnel tel que "1er janvier 2019".

Note : Le dernier paramètre, le fuseau horaire, doit provenir d'une des bases de données tz listées ici.

FILETOTEXT("url : File") => Texte Convertit le fichier en une chaîne de texte de l'URL.

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

HEX_TO_INT()

Renvoie la représentation numérique d'une chaîne hexadécimale donnée.

Ex. HEX_TO_INT('0xAB18') = '43800'

INT_TO_HEX()

Renvoie la représentation hexadécimale d'un nombre donné.

Ex. INT_TO_HEX('43800') = '0xAB18'

INTERVAL_TO_SECONDS(interval : Interval) => Nombre Renvoie la longueur d'un intervalle en secondes

EX. INTERVAL_TO_SECONDS(secondes_à_intervalle(30.0))

LOWERCASE()

Convertit une chaîne de caractères en minuscules

MAP_TO_BOOLEAN_LIST*(a :* {} array, b: text) => array Convertit un Object Array en un tableau de base pour la clé donnée

Ex. MAP_TO_BOOLEAN_LIST([{key : value}], 'key') = [value]

MAP_TO_INTEGER_LIST*(a :* {} array, b: text) => array Convertit un tableau d'objets en un tableau de base pour la clé donnée

Ex. MAP_TO_INTEGER_LIST([{key : value}], 'key') = [value]

MAP_TO_NUMBER_LIST*(a :* {} array, b: text) => array Convertit un tableau d'objets en un tableau de base pour la clé donnée

Ex. MAP_TO_NUMBER_LIST([{key : value}], 'key') = [value]

MAP_TO_TEXT_LIST*(a :* {} array, b: text) => array Convertit un tableau d'objets en un tableau de base pour la clé donnée

Ex. MAP_TO_TEXT_LIST([{key : value}], 'key') = [value]

**SECONDS_TO_INTERVAL()**Convertit les secondes en un intervalle.

SECONDS_TO_INTERVAL(seconds : Integer ou Number) => Intervalle

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

**TEXTTOBOOLEAN()**Analyse un texte en booléen.

"y", "yes", "t", "true" et "on" et leurs variantes en majuscules sont reconnus comme vrais, et "n", "no", "f" "false" et "off" sont reconnus comme faux.

Ex. TEXTTOBOOLEAN("oui")

TEXTTODATETIME()

Convertit une valeur texte en une valeur Datetime avec les paramètres spécifiés. Cette fonction est couramment utilisée lorsqu'une fonction de connexion partage une date au format texte et qu'il est nécessaire de la convertir.

TEXTTOIMAGEURL(url:Texte) => Image URL Convertit une chaîne de caractères en une image URL.

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

**TEXTTOINTEGER()**Convertit un texte ou un intervalle en un nombre entier.

Ex. TEXTTOINTEGER("123")

**TEXTTONUMBER()**Convertit le texte ou l'horodatage en un nombre.

Ex. TEXTTONUMBER("2.4")

**TOTEXT()**Convertit n'importe quoi en texte.

Ex. TOTEXT(2)

UPPERCASE()

Convertit une chaîne de caractères en majuscules.

USER_ID_TO_USER(id : Text) => User Convertit l'identifiant d'un utilisateur en un objet utilisateur.

Ex. User_id_to_user("abc") = Utilisateur

Expressions tronquées

CEIL()

Arrondit à l'entier le plus proche

FLOOR()

Arrondit à l'entier inférieur le plus proche

ROUND()

Arrondit un nombre au nombre de décimales spécifié. Maximum de 3 décimales.

Ex. 1 - ROUND(123.123456, 1)

Le résultat sera 123.1

Ex. 2 - ROUND(123.12)

Le résultat sera 123

ROUNDDATETIME()

Tronque une valeur Datetime à une unité donnée, comme le mois ou le jour.

Ex. ROUNDDATETIME*(datetime_variable*, "Month", "America/New_York")

Cette fonction convertit une date en un simple mois à l'heure normale de l'Est (Eastern Standard Time).

Remarque : Le dernier paramètre, le fuseau horaire, doit provenir d'une des bases de données tz répertoriées ici.

Expressions de retour de valeur

ABS()

Renvoie la valeur absolue d'un nombre

CONTAINS()

Indique si une chaîne de caractères contient une sous-chaîne donnée.

Ex. CONTAINS("123ABC", "123")

Cette fonction renverrait "true" (vrai)

COS()

Renvoie le cosinus de l'entrée donnée

ENCODE_URI(component : Text) => Text

Renvoie une version d'un URI sous forme de chaîne de caractères encodée dans l'URL.

Ex. ENCODE_URI("http://example.com/a=foo&b=a test") ="http://example.com/a=foo&b=a%20test"

ENCODE_URI_COMPONENT(component : Text) => Text

Renvoie une version de chaîne codée en URL d'un composant URI.

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

**FIND()**Renvoie la position de l'endroit où le premier argument se trouve dans le deuxième argument.

IF()

En fonction du premier argument, renvoie le deuxième argument si le premier argument est vrai, ou le troisième argument si le premier argument est faux.

Ex. IF(true, 1, 2)

**ISNULL()**Renvoie vrai si l'argument est nul, sinon faux.

**LEFT()**Renvoie une sous-chaîne d'une valeur textuelle, commençant à la position spécifiée par le deuxième argument.

**LEN()**Renvoie la longueur d'une valeur textuelle.

LINK()

Renvoie le premier des arguments qui n'est pas nul.

Ex. LINK(poids, 70)

Ceci retournera la valeur de poids si poids a une valeur

MAX()

Renvoie l'argument ayant la valeur la plus élevée

Ex. MAX(var1, var2)

Cette fonction renvoie la valeur de var1 si elle est supérieure à la valeur de var2

**MID()**Renvoie une sous-chaîne d'une valeur textuelle, à partir de la position spécifiée par le deuxième argument. Le troisième argument spécifie la longueur du retour.

**MIN()**Retourne l'argument ayant la valeur la plus basse

Ex. MIN(var1, var2)

Cette fonction renvoie la valeur de var1 si elle est inférieure à la valeur de var2.

POW()

Retourne le premier argument élevé au deuxième argument

Ex. POW(3,2)

Ceci retournera 9

RAND()

Génère un nombre décimal aléatoire entre 0 et 1

RANDBETWEEN()

Génère un nombre entier aléatoire entre deux nombres spécifiés

Ex. RANDBETWEEN(5,10)

RANDOMSTRING()

Renvoie une chaîne aléatoire de 17 caractères. Destiné à créer un identifiant pour un nouvel enregistrement de la table.

**RANDOM_COLOR()**Génère une couleur aléatoire

Ex. RANDOM_COLOR() = ##c537a5

RGA(r : Integer, g:Integer, b:Integer, a:Integer) => Couleur Renvoie une couleur avec les composantes rouge, verte, bleue et alpha spécifiées.

Ex. RGA(255, 255, 0, 0.5) = ##ffff00 (50% d'opacité)

RGB(r : Integer, g:Integer, b:Integer) => Couleur Renvoie une couleur des composantes rouge, verte et bleue spécifiées

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

**RIGHT()**Renvoie une sous-chaîne d'une valeur textuelle, se terminant à la position spécifiée par le deuxième argument.

SIN()

Renvoie le sinus de l'entrée donnée

**SPLIT()**Divise une valeur textuelle en un tableau en fonction d'un délimiteur spécifié.

SQRT()

Renvoie la racine carrée d'un nombre

SUBSTITUTE()

Dans une chaîne de caractères donnée en premier argument, remplace tous les exemples du deuxième argument par le troisième argument.

Ex. SUBSTITUTE("A734", "7", "3")

Le résultat sera "A334"

TAN()

Renvoie la tangente de l'entrée donnée

**TRIM()**Supprime une sous-chaîne (spécifiée par le deuxième argument) à l'avant et à l'arrière du premier argument.

Expressions de tableau

ARRAY_AVG()

Renvoie la moyenne de tous les nombres d'un tableau

Ex. ARRAY_AVG([1,2,3])

Le résultat sera 2

ARRAY_CONCAT()

Renvoie un tableau unique avec tous les éléments des tableaux inclus dans les arguments. Ne fonctionne qu'avec des tableaux de même type, c'est-à-dire tous les tableaux de texte.

Ex. ARRAY_CONCAT([1,2],[3,4],[5,6])

Cela renverrait [1,2,3,4,5,6]

ARRAYCONTAINS()

Déterminer si une valeur se trouve dans un tableau

Ex. ARRAYCONTAINS([1,2,3], 1)

Cette fonction renverra "true" (vrai)

ARRAY_MAX()

Renvoie le minimum d'un tableau donné

Ex. ARRAY_MAX([1,2,3])

Cette fonction renverra 3

ARRAY_MIN()

Renvoie le minimum d'un tableau donné

Ex. ARRAY_MIN([1,2,3])

Cette fonction renverrait 1

ARRAY_STDEV_POPULATION()

Renvoie l'écart-type de la population d'un tableau numérique donné

Ex. ARRAY_STDEV_POPULATION([1,2,3])

Cette fonction renvoie 0.816496580927726

ARRAY_STDEV_SAMPLE()

Renvoie l'écart-type de l'échantillon d'un tableau numérique donné

Ex. ARRAY_STDEV_SAMPLE([1,2,3])

Cette fonction renvoie 1

**REGEX_MATCH()**Renvoie un tableau de correspondances d'expressions régulières pour une valeur textuelle. Les correspondances sont basées sur l'expression régulière et les modificateurs donnés. Cette méthode est basée sur la méthode JavaScript match et possède 2 "modes".

Lorsque cette méthode reçoit 2 arguments, elle est équivalente à l'expression JavaScript suivante :text.match(new RegExp(regex))Lorsque le paramètre optionnel modifiers est fourni, cette méthode est équivalente à l'expression JavaScript suivante :text.match(new RegExp(regex, modifiers))Les modificateurs sont des drapeaux qui peuvent être utilisés pour modifier le comportement de la recherche par expression rationnelle.

**REGEX_REPLACE()**Renvoie un tableau de correspondances d'expressions régulières pour une valeur textuelle. Les correspondances sont basées sur l'expression régulière et les modificateurs donnés. Cette méthode est basée sur la méthode JavaScript replace.

Lorsque la fonction reçoit 3 arguments, elle est équivalente à l'expression JavaScript suivante :text.replace(new RegExp(regex), replacement). Lorsque le paramètre optionnel modifiers est fourni, cette méthode est équivalente à l'expression JavaScript suivante :text.replace(new RegExp(regex, modifiers), replacement)Les modificateurs sont des drapeaux qui peuvent être utilisés pour modifier le comportement de la recherche par expression régulière.

Avez-vous trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres personnes ont rencontré une question similaire !