Fonctions générales

Variables

Vous pouvez utiliser ces variables générales pour identifier les détails d’une exécution :

  • executionID : identifiant de l’exécution de ce scénario
  • triggerTimestamp : heure de déclenchement de cette exécution
  • scenarioID : ID du scénario en cours d’exécution
  • scenarioName : nom du scénario en cours d’exécution
  • operationsConsumed : nombre d’opérations utilisées à ce stade du scénario.

get (object or array; path)

Renvoie le chemin d’accès à la valeur d’un objet ou d’un tableau. Pour accéder aux objets imbriqués, utilisez la notation par points. Le premier élément d’un tableau est l’index 1.

Exemples :

  • get( array ; 1 + 1 )
  • get( array ; 5.raw_name )
  • get( object ; raw_name )
  • get( object ; raw_name.sub_raw_name )

if (expression; value1; value2)

Renvoie la value1 si l’expression est considérée comme true ; sinon elle renvoie la value2.

Pour créer une instruction if qui renvoie une valeur uniquement si plusieurs expressions sont évaluées sur true, utilisez le mot-clé and.

Pour combiner des instructions if, utilisez les opérateurs and et or .

opérateur and

Exemples :

  • if( 1 = 1 ; A ; B )

    Renvoie A

  • if( 1 = 2 ; A ; B )

    Renvoie B

  • if( 1 = 2 and 1 = 2 ; A ; B )

    Renvoie B

ifempty (value1; value2)

Renvoie la value1 si cette valeur n’est pas vide ; sinon elle renvoie la value2.

Exemples :

  • ifempty( A ; B )

    Renvoie A

  • ifempty( unknown ; B )

    Renvoie B

  • ifempty( "" ; B )

    Renvoie B

switch (expression; value1; result1; [value2; result2; …]; [else])

Évalue une valeur (appelée expression) par rapport à une liste de valeurs ; renvoie le résultat correspondant à la première valeur correspondante. Pour inclure une valeur else, ajoutez-la après l’expression ou la valeur finale.

Exemples :

  • switch( B ; A ; 1 ; B ; 2 ; C ; 3 )

    Renvoie 2

  • switch( C ; A ; 1 ; B ; 2 ; C ; 3 )

    Renvoie 3

  • switch( X ; A ; 1 ; B ; 2 ; C ; 3 ; 4 )

    Renvoie 4

    Dans cette fonction, 4 est la valeur à renvoyer si aucune expression ne s’applique (la valeur else).

omit(object; key1; [key2; …])

Omet les clés données de l’objet et renvoie le reste.

Exemple :

omit( User ; password )

Renvoie une collection des informations de l’utilisateur ou de l’utilisatrice, à l’exclusion du mot de passe.

pick(object; key1; [key2; …])

Sélectionne uniquement les clés données de l’objet.

Exemple :

pick( User ; password ; email )

Renvoie une collection contenant uniquement le mot de passe et l’adresse e-mail de l’utilisateur ou de l’utilisatrice.

mergeCollections(collection1 ; collection2)

Fusionne deux collections en combinant leurs paires clé-valeur. Si les deux collections contiennent la même clé, la valeur de la deuxième collection remplace celle de la première collection.

isBlank(value)

Renvoie true si la valeur est null ou une chaîne vide, sinon renvoie false. Contrairement à ifEmpty, cette fonction ne traite pas les 0 numériques ou les chaînes contenant uniquement des espaces comme vides.

Exemple :

  • isBlank("")

    Renvoie vrai

  • isBlank(null)

    Renvoie vrai

  • isBlank("Hello")

    Renvoie false

  • isBlank(0)

    Renvoie false

  • isBlank(" ")

    Renvoie false

in(value; value1; value2; …)

Renvoie true si la valeur est égale à l’une des valeurs fournies (égalité stricte, aucune coercition de type).

Exemple :

  • in("B"; "A"; "B"; "C")

    Renvoie vrai

  • in("D"; "A"; "B"; "C")

    Renvoie false

  • in(2; 1; 2; 3)

    Renvoie vrai

  • in("2"; 1; 2; 3)

    Renvoie false

ifin(value; value1; value2; …; trueExpression; falseExpression)

Renvoie trueExpression si la valeur correspond à l’une des valeurs de correspondance fournies, sinon renvoie falseExpression. Requiert au moins 3 arguments (valeur, une valeur de correspondance et trueExpression + falseExpression).

Exemple :

  • ifin("B"; "A"; "B"; "yes"; "no")

    Renvoie oui

  • ifin("D"; "A"; "B"; "yes"; "no")

    Renvoie no

  • ifin("X"; "X"; "found"; "not found")

    Renvoie trouvée

case(indexNumber; value1; value2; …)

Renvoie la valeur à la position spécifiée par le numéro d’index (basé sur 1). Renvoie null si l’index est hors limites ou est égal à 0.

Exemple :

  • case(1; "Sun"; "Mon"; "Tue")

    Renvoie Sun

  • case(2; "Sun"; "Mon"; "Tue")

    Renvoie Lun

  • case(3; "Sun"; "Mon"; "Tue")

    Renvoie True

  • case(5; "a"; "b")

    Renvoie null

NOTE
Nous vous recommandons d’utiliser cette option pour obtenir le nom du jour à partir d’une date :
case(dayOfWeek(date); "Sun"; "Mon"; "Tue"; "Wed"; "Thu"; "Fri"; "Sat")
recommendation-more-help
workfront-fusion-help-workfront-fusion