SMOP (Pequeñas Operaciones)
Concepto
Muchas veces, necesitamos modificar un parámetro antes de que sea referenciado en un flujo. Esto ocurre, por ejemplo, cuando buscamos una substring dentro de una cadena de texto o cuando necesitamos sumar un valor a un parámetro numérico. Para estos casos, existe la funcionalidad SMOPs (Small Operations), que permite crear pequeñas operaciones directamente en el campo donde los parámetros son referenciados. Esto significa que cada operación se ejecuta y su resultado es pasado como parámetro al módulo.
SMOP es una funcionalidad de transformación de datos que, utilizando JSONata, permite realizar operaciones de baja complejidad con parámetros dentro de un flujo en Skyone Studio.
Algunas operaciones que podemos realizar utilizando SMOP son:
Sumar dos números, como un offset y un rowCount, en la lectura de una base de datos;
Concatenar dos cadenas de texto o extraer un patrón de una de ellas;
Modificar el tipo de dato de un parámetro, por ejemplo, de string a number.
Con SMOP, siempre que se referencia un parámetro, es posible realizar pequeñas operaciones utilizando los datos obtenidos en el flujo.
Las operaciones ideales para esta funcionalidad son de baja complejidad, para que puedan realizarse usando solo una línea de código. La sintaxis utilizada es JSONata, la misma del módulo “Transformación de Datos”.
La funcionalidad SMOP está disponible para módulos con autenticación REST, Base de Datos y E-mail, y está presente en casi todos los módulos de herramientas.
Ejemplos de Operaciones
Los ejemplos a continuación describen pequeñas operaciones (expresiones) que pueden realizarse con JSONata en una sola línea y que devuelven solo un elemento de salida, incluso si ese elemento es un array:
1
$length(param1)
12
number
2
param1 + param2
15
number
3
param1 + param2
15
number
4
param1 > param2
VERDADERO
Boolean
5
$split(param1, " ")
Array
6
$number(param1)
123,45
Number
7
param1[param2]
1
number
Creación de SMOPs
El acceso a la configuración de las SMOPs se realiza durante la configuración de la operación de un módulo compatible, en la etapa de edición de un flujo.
Para crear una SMOP, sigue estos pasos:
Haz clic en “Editar” en el módulo deseado y compatible. Luego, haz clic en el signo “+” ubicado en el bloque de configuración de parámetros.
Se mostrará la ventana de creación de la SMOP, donde encontrarás los siguientes campos:
param1 (opcional): El parámetro original que deseas manipular debe arrastrarse a este campo. Es posible usar un parámetro del flujo o uno de pasos anteriores. También es posible crear SMOPs utilizando expresiones JSONata que no requieren parámetros.
valor (opcional): Si el parámetro informado es un parámetro del flujo, este campo se llenará automáticamente. También es posible ingresarlo manualmente o dejarlo vacío, según la necesidad. El tipo de dato debe ser compatible con el parámetro.
Agregar parámetro: Permite añadir más parámetros.
Expresión (obligatorio): Aquí debes ingresar la operación deseada. Todas las expresiones JSONata son válidas. Además de usar un parámetro, también puedes usar funciones como
$now(), que no requieren parámetros.Resultado (solo lectura): Aquí se mostrará automáticamente el resultado de la expresión creada.
Tipo (solo lectura): Aquí se mostrará automáticamente el tipo de dato del resultado (string, number, boolean, array o object). El tipo mostrado debe coincidir con el tipo esperado por el parámetro del módulo.
Para añadir un parámetro a la SMOP, simplemente arrástralo y suéltalo en el campo param1. Haz clic en “Agregar parámetro” si deseas añadir otro.
Puedes utilizar hasta 3 parámetros originales dentro de una SMOP.
Crea una expresión en JSONata para realizar la operación deseada, utilizando nuestra tabla de modelos. Por ejemplo:
param1 + param2Los campos Resultado y Tipo mostrarán la información correspondiente.
Haz clic en “Guardar” para finalizar. El campo de operación pasará a mostrar la expresión “SMOP”, indicando que se ha configurado una operación SMOP.
Edición de una SMOP
Para editar una SMOP:
Haz clic en la flecha hacia abajo junto al campo donde se encuentra la SMOP;
Realiza los cambios necesarios y haz clic en “Guardar”.
Eliminación de una SMOP
Existen dos formas de eliminar una SMOP:
Haciendo clic en el ícono “x” ubicado al lado derecho de la SMOP;
Abriendo el modal de edición y haciendo clic en “Eliminar”.
Last updated