Liste complète des expressions dans l’éditeur d’application

Cet article contient la liste complète des expressions disponibles dans l’éditeur d’applications de Trigger.

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

Expressions dans l’éditeur d’applications

Tous les exemples sont basés sur les « Complétions » d’une application. Ainsi, lorsque vous utilisez une fonction MAXIMUM() ou MINIMUM(), par exemple, vous recherchez la valeur maximale ou minimale d’une variable parmi toutes les complétions d’une application.

ADD_TIME(): incrémente une valeur de date-heure d’une quantité et d’une unité d’intervalle spécifiées.

Ex. : ADD_TIME(variable_datetime, 2, 'années')

SUBTRACT_TIME(): diminue une valeur de date-heure d’une quantité et d’une unité d’intervalle spécifiées.

Ex. SUBTRACT_TIME(variable_date_heure, 3, 'mois')

Expressions de conversion de type

**BADGE_ID_TO_USER()**Convertit un identifiant de badge en un objet User

Ex. BADGE_ID_TO_USER(0000) = « John Doe » en tant qu'objet utilisateur

DATETIMETOTEXT()
Convertit une valeur de date-heure en une valeur textuelle facilement lisible par l'utilisateur

Ex. DATETIMETOTEXT(variable_datetime, "MMMM JJ, AAAA", 'America/New_York')

Cela convertira une date-heure en heure normale de l'Est (EST) et l'affichera au format de date traditionnel, par exemple « 1er janvier 2019 ».

Remarque : le dernier paramètre, le fuseau horaire, doit correspondre à l’un des noms de base de données tz répertoriés ici.

FILETOTEXT("url : Fichier") => Texte Convertit le fichier en une chaîne de texte correspondant à 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 durée d'un intervalle en secondes

Ex. INTERVAL_TO_SECONDS(seconds_to_interval(30,0))

LOWERCASE()
Convertit une chaîne de caractères en minuscules

MAP_TO_BOOLEAN_LIST(a : {} tableau, b: texte) => tableau Convertit un tableau d’objets en un tableau de base pour la clé donnée

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

MAP_TO_INTEGER_LIST(a : {} tableau, b: texte) => tableau 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 : {} tableau, b: texte) => tableau 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 : {} tableau, b: texte) => tableau 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 des secondes en un intervalle.

SECONDS_TO_INTERVAL(seconds : entier ou nombre) => intervalle

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

**TEXTTOBOOLEAN()**Analyse du texte pour obtenir une valeur booléenne.

« y », « yes », « t », « true » et « on », ainsi que toutes leurs variantes en majuscules, sont reconnus comme vrais, tandis que « n », « no », « f », « false » et « off » sont reconnus comme faux.

Ex. TEXTTOBOOLEAN("yes")

TEXTTODATETIME()
Convertit une valeur textuelle en une valeur Datetime selon les paramètres spécifiés. Couramment utilisée lorsque vous disposez d’une source de données ( Connector Function ) contenant une date-heure au format texte et que vous devez la convertir.

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

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

**TEXTTOINTEGER()**Analyse du texte ou d’un intervalle pour le convertir en nombre entier.

Ex. TEXTTOINTEGER("123")

**TEXTTONUMBER()**Analyse du texte ou d’un horodatage pour le convertir en nombre

Ex. TEXTTONUMBER("2,4")

TOTEXT(): convertit n'importe quelle valeur en texte.

Ex. : TOTEXT(2)

UPPERCASE()
Convertit une chaîne de caractères en majuscules

USER_ID_TO_USER(id : Texte) => Utilisateur Convertit un identifiant utilisateur en objet utilisateur

Ex. User_id_to_user("abc") = User

Expressions tronquées

CEIL()
Arrondit à l'entier supérieur 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)
Cela renverra 123,1
Ex. 2 - ROUND(123,12)
Cette fonction renvoie 123

ROUNDDATETIME()
Tronque une valeur Datetime à une unité donnée, telle que le mois ou le jour.

Ex. ROUNDDATETIME(variable_datetime, « Month », « America/New_York »)
Cela convertira une date-heure en un simple mois, selon l'heure normale de l'Est.

Remarque : le dernier paramètre, le fuseau horaire, doit correspondre à l’un des noms de base de données tz répertoriés ici.

Expressions de retour de valeur

ABS()
Renvoie la valeur absolue d’un nombre

CONTAINS()
Indique si une chaîne contient une sous-chaîne donnée
Ex. CONTAINS("123ABC", "123")
Cette fonction renverrait « true »

COS()
Renvoie le cosinus de la valeur fournie

ENCODE_URI(composant : Texte) => Texte
Renvoie une version sous forme de chaîne de caractères d'une URI, encodée selon le format URL.
Ex. ENCODE_URI("http://example.com/a=foo&b=a test") = "http://example.com/a=foo&b=a test"

ENCODE_URI_COMPONENT(composant : Texte) => Texte
Renvoie une version sous forme de chaîne de caractères, encodée en URL, d'un composant d'URI.

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

**FIND()**Renvoie la position à laquelle le premier argument apparaît 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 de texte, en commençant à la position spécifiée par le deuxième argument.

**LEN()**Renvoie la longueur d'une valeur de texte. Renvoie également le nombre d'éléments d'un tableau.

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

Ex. LINK(poids, 70)
Cette fonction renverra la valeur de « weight » si celui-ci 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 celle-ci est supérieure à celle de « var2 »

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

**MIN()**Renvoie l'argument ayant la valeur la plus faible
Ex. MIN(var1, var2)
Cela renverra la valeur de var1 si elle est inférieure à celle de var2

POW()
Renvoie le premier argument élevé à la puissance du deuxième argument
Ex. POW(3,2)
Cela renverra 9

RAND()
Génère un nombre décimal aléatoire compris entre 0 et 1

RANDBETWEEN()
Génère un nombre entier aléatoire compris entre deux nombres spécifiés
Ex. RANDBETWEEN(5,10)

RANDOMSTRING()
Renvoie une chaîne aléatoire de 17 caractères. Destinée à la création d'un identifiant pour un nouvel enregistrement de table.

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

Ex. RANDOM_COLOR() = ##c537a5

RGBA(r : entier, g : entier, b : entier, a : entier) => Couleur Renvoie une couleur dont les composantes rouge, verte, bleue et alpha sont spécifiées

Ex. RGBA(255, 255, 0, 0,5) = ##ffff00 (opacité de 50 %)

RGB(r : entier, g : entier, b : entier) => Couleur Renvoie une couleur dont les composantes rouge, verte et bleue sont 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 la valeur d'entrée fournie

**SPLIT()**Divise une valeur de texte en un tableau à l'aide d'un délimiteur spécifié.

SQRT()
Renvoie la racine carrée d'un nombre.

SUBSTITUTE()
Dans une chaîne de caractères fournie en premier argument, remplace toutes les occurrences du deuxième argument par le troisième argument
Ex. SUBSTITUTE("A734", "7", "3")
Cela renverra « A334 »

TAN()
Renvoie la tangente de la valeur fournie

**TRIM()**Supprime une sous-chaîne (spécifiée par le deuxième argument) au début et à la fin du premier argument.

Expressions de tableau

ARRAY_AVG()
Renvoie la moyenne de tous les nombres d'un tableau
Ex. ARRAY_AVG([1,2,3])
Cela renverrait 2

ARRAY_CONCAT()
Renvoie un seul tableau contenant tous les éléments des tableaux inclus dans les arguments. Ne fonctionne qu'avec des tableaux de même type, c'est-à-dire uniquement des tableaux de texte.
Ex. ARRAY_CONCAT([1,2],[3,4],[5,6])
Cela renverrait [1,2,3,4,5,6]

ARRAYCONTAINS()
Détermine si une valeur figure dans un tableau
Ex. ARRAYCONTAINS([1,2,3], 1)
Cela renverra « true »

**ARRAY_INDEX_OF()**Renvoie l'index de la première occurrence de la valeur donnée dans le tableau indiqué. Si la valeur n'est pas trouvée, renvoie « -1 ». Ex. ARRAY_INDEX_OF([1,2,3], 2) Cela renverra 1

ARRAY_MAX()
Renvoie la valeur minimale d'un tableau donné
Ex. ARRAY_MAX([1,2,3])
Cela renverra 3

ARRAY_MIN()
Renvoie la valeur minimale d'un tableau donné
Ex. ARRAY_MIN([1,2,3])
Cela 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])
Cela renverrait 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])
Cela renverrait 1

**ARRAY_VALUE_AT_INDEX()**Renvoie la valeur située à l'index donné dans la liste fournie. Si l'index est hors limites, renvoie null. Ex. ARRAY_VALUE_AT_INDEX([1,2,3], 0) Cela renverrait 1

**REGEX_MATCH()**Renvoie un tableau contenant les correspondances d'une expression régulière dans une valeur textuelle. Les correspondances sont déterminées en fonction de l'expression régulière et des modificateurs fournis. Cette méthode s'inspire de la méthode match de JavaScript et dispose de deux « modes ».

Lorsque cette méthode reçoit deux arguments, elle équivaut à l'expression JavaScript suivante :text.match(new RegExp(regex))Lorsque le paramètre facultatif modifiers est fourni, cette méthode équivaut à l’expression JavaScript suivante :text.match(new RegExp(regex, modifiers))Les modificateurs sont des indicateurs permettant de modifier le comportement de la recherche par expression régulière.

**REGEX_REPLACE()**Renvoie un tableau contenant les correspondances d’une valeur textuelle avec l’expression régulière. Les correspondances sont déterminées en fonction de l’expression régulière et des modificateurs fournis. Cette méthode s’inspire de la méthode replace de JavaScript.

Lorsque la fonction reçoit 3 arguments, elle équivaut à l'expression JavaScript suivante :text.replace(new RegExp(regex), replacement)

Lorsque le paramètre facultatif modifiers est fourni, cette méthode équivaut à l'expression JavaScript suivante :text.replace(new RegExp(regex, modifiers), replacement). Les modificateurs sont des indicateurs permettant de modifier le comportement de la recherche par expression régulière.

Lorsque vous écrivez une expression régulière à l'intérieur d'une chaîne, vous devez échapper les barres obliques inversées () car JavaScript traite chaque barre oblique inversée comme un caractère d'échappement dans les littéraux de chaîne.

regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')Cette expression renverrait « There Hello ».

{{snippet.Avez-vous trouvé ce que vous cherchiez ?}}