Funciones generales
Variables
Puede utilizar estas variables generales para identificar los detalles de una ejecución:
executionID: el ID de esta ejecución de escenariotriggerTimestamp: hora a la que se activó esta ejecuciónscenarioID: ID del escenario abierto actualmentescenarioName: nombre del escenario que se está ejecutandooperationsConsumed: número de operaciones que se utilizan en ese momento en el escenario.
get (objeto o matriz; ruta de acceso)
Devuelve la ruta de valor de un objeto o matriz. Para acceder a objetos anidados, utilice la notación de puntos. El primer elemento de una matriz es el índice 1.
Ejemplos:
get( array ; 1 + 1 )get( array ; 5.raw_name )get( object ; raw_name )get( object ; raw_name.sub_raw_name )
if (expresión; valor1; valor2)
Devuelve value1 si la expresión se evalúa como verdadera; en caso contrario, devuelve value2.
Para crear una instrucción if que devuelva un valor sólo si dos o más expresiones se evalúan como true, utilice la palabra clave and.
Para combinar instrucciones if, use los operadores and y or.
Ejemplos:
-
if( 1 = 1 ; A ; B )Devuelve un
-
if( 1 = 2 ; A ; B )Devuelve B
-
if( 1 = 2 and 1 = 2 ; A ; B )Devuelve B
ifempty (value1; value2)
Devuelve value1 si este valor no está vacío; en caso contrario, devuelve value2.
Ejemplos:
-
ifempty(A;B)Devuelve un
-
ifempty(unknown;B)Devuelve B
-
ifempty("";B)Devuelve B
modificador (expresión; valor1; resultado1; [valor2; resultado2; …]; [Else])
Evalúa un valor (denominado expresión) frente a una lista de valores; devuelve el resultado correspondiente al primer valor coincidente. Para incluir un valor else, agréguelo después de la expresión o valor final.
Ejemplos:
-
switch( B ; A ; 1 ; B ; 2 ; C ; 3 )Devuelve 2
-
switch( C ; A ; 1 ; B ; 2 ; C ; 3 )Devuelve 3
-
switch( X ; A ; 1 ; B ; 2 ; C ; 3 ; 4 )Devuelve 4
En esta función, 4 es el valor que se devuelve si no se aplica ninguna expresión (el valor
else).
omitir(objeto; clave1; [clave2; …])
Omite las claves dadas del objeto y devuelve el resto.
Ejemplo:
omit( Usuario ; contraseña )
Devuelve una colección de información del usuario, excluida la contraseña.
pick(object; key1; [key2; …])
Selecciona solo las claves dadas del objeto.
Ejemplo:
pick( Usuario ; contraseña ; correo electrónico )
Devuelve una colección que incluye únicamente la contraseña y la dirección de correo electrónico del usuario.
mergeCollections(colección1; colección2)
Combina dos colecciones combinando sus pares clave-valor. Si ambas colecciones contienen la misma clave, el valor de la segunda colección sobrescribe ese valor de la primera colección.
isBlank(valor)
Devuelve true si el valor es null o una cadena vacía; en caso contrario, devuelve false. A diferencia de ifEmpty, esta función no trata el número 0 o las cadenas de solo espacio en blanco como en blanco.
Ejemplo:
-
isBlank("")Devuelve verdadero
-
isBlank(null)Devuelve verdadero
-
isBlank("Hello")Devuelve falso
-
isBlank(0)Devuelve falso
-
isBlank(" ")Devuelve falso
in(valor; valor1; valor2; …)
Devuelve true si el valor equivale a uno de los valores proporcionados (igualdad estricta, sin coerción de tipos).
Ejemplo:
-
in("B"; "A"; "B"; "C")Devuelve verdadero
-
in("D"; "A"; "B"; "C")Devuelve falso
-
in(2; 1; 2; 3)Devuelve verdadero
-
in("2"; 1; 2; 3)Devuelve falso
ifin(valor; valor1; valor2; …; expresión_verdadero; expresión_falso)
Devuelve trueExpression si el valor coincide con cualquiera de los valores de coincidencia proporcionados; en caso contrario, devuelve falseExpression. Requiere al menos 3 argumentos (valor, un valor de coincidencia y trueExpression + falseExpression).
Ejemplo:
-
ifin("B"; "A"; "B"; "yes"; "no")Devuelve sí
-
ifin("D"; "A"; "B"; "yes"; "no")Devuelve el valor
-
ifin("X"; "X"; "found"; "not found")Devoluciones encontradas
case(indexNumber; value1; value2; …)
Devuelve el valor en la posición especificada por el número de índice (basado en 1). Devuelve null si el índice está fuera de los límites o es 0.
Ejemplo:
-
case(1; "Sun"; "Mon"; "Tue")Devuelve Sun
-
case(2; "Sun"; "Mon"; "Tue")Devuelve LUN
-
case(3; "Sun"; "Mon"; "Tue")Devuelve el mar
-
case(5; "a"; "b")Devuelve nulo
case(dayOfWeek(date); "Sun"; "Mon"; "Tue"; "Wed"; "Thu"; "Fri"; "Sat")