El evento Assert es una herramienta de depuración, similar al evento Conditional, que comprueba la lógica de tu cadena y valida que funcione según lo previsto. En el nivel más básico, una rama en cadena continuará sin interrupción cuando una aserción pase y se detendrá cuando una aserción falle - pero hay una serie de condiciones que afectan a esta regla. Encontrará una Lista de casos de uso comunes al final de este artículo.
Etapa 1: Agregar el evento a la cadena
- En Chain Builder, desde la pestaña Chains , haga clic en Edit para la cadena.
- Haga clic en Eventos en cadena, y mueva Assert al lugar de la cadena donde debe producirse el evento.
- Arrastra un enlace al evento desde el nodo anterior de la cadena.
Nota: Para cambiar la posición de un nodo en la cadena, desvincúlelo de otros nodos y, a continuación, muévalo al lugar en el que debería aparecer. Para mover varios nodos a la vez, mantenga pulsado SHIFT mientras los selecciona.
- Seleccione el nodo del evento y haga clic en Editar .
- En Información básica, introduzca un nombre único y una descripción para ayudar a identificar el evento.
Nota: Habilite Stop Chain on Fail si toda la cadena debe detenerse cuando falle esta aserción. Si se deja sin marcar, otras ramas de la cadena se ejecutarán hasta su finalización, incluso si esta en particular falla.
Etapa 2: Configurar la lógica condicional
En Condiciones, construya la lógica condicional como reglas o grupos de reglas para probar salidas y variables de varios tipos de datos:
- Cadena, para uno o varios caracteres
- Entero, para cualquier valor numérico entero no decimal.
- Fecha, para una cadena de fechas o una variable
- Float, para cualquier valor numérico.
- JSON, para Javascript Object Notation
Nota: Para JSON, utilice una transformación de variables para analizar valores.
- Seleccione si desea agregar un Regla o Grupo de reglas.
- Si incluye varias reglas o grupos, únalos con un booleano AND o O :
- Si todas las reglas o grupos de deben ser verdaderos para que la condición pase, seleccione Y.
- Si cualquier regla o grupo de debe ser verdadera para que la condición pase, seleccione O.
- Para cada regla, seleccione el tipo de datos y la salida o variable a probar, y establezca sus criterios para pasar la condición:
- Para comprobar si el valor está en blanco, seleccione Está en blanco o No está en blanco.
- Para comprobar si el valor incluye caracteres específicos u otro valor de salida o variable, seleccione Contiene, e introduzca o seleccione el valor que debe coincidir.
- Para comprobar si el valor coincide con una expresión regular, seleccione Matches RegExp, e introduzca la expresión con la que desea que coincida.
- Para comprobar si el valor empieza o termina con caracteres específicos o con otro valor de salida o variable, seleccione Empieza con o Termina con, e introduzca o seleccione el valor que debe coincidir.
- Para comprobar si un valor numérico es igual a un importe, seleccione = o !=, e introduzca o seleccione el importe.
- Para comprobar si un valor numérico es mayor o menor que un importe, seleccione < o >, e introduzca o seleccione el importe.
- Para comprobar si un valor numérico es mayor o menor o igual que un importe, seleccione <= o >=, e introduzca o seleccione el importe.
- Después de configurar la lógica condicional, haga clic en Guardar como.
Nota: Para Quitar una regla de la lógica condicional, haga clic en Eliminar .
Condiciones y casos de uso habituales
El evento Assert puede agregarse a múltiples rutas o "ramas" de una cadena. Cada aserción funciona de forma independiente, lo que significa que una aserción fallida sólo detendrá la rama concreta en la que está colocada - todas las demás ramas continuarán ejecutándose hasta su finalización. Sin embargo, si falla una sola aserción, toda la cadena se marcará como "Fallida".
Lo que hay que saber:
- Habilite la opción Detener cadena en caso de fallo para detener inmediatamente toda la cadena cuando falle una aserción.
- Puede Invalidar un fallo de cadena añadiendo un evento Set Chain Result. Cuando un nodo Establecer resultado de cadena se establece en "Éxito", la cadena siempre pasará independientemente de cualquier aserción fallida.
Condición |
Resultado |
Explicación |
|---|---|---|
| La afirmación pasa | La carrera continúa; la cadena tiene éxito | La cadena continúa sin interrupción. |
|
La afirmación falla (afirmación única) |
Ejecutar falla; Cadena falla |
Cuando se coloca una única aserción en una ruta de cadena, la ejecución de la cadena se detiene cuando falla la aserción. Ejemplo: (Pulse para ampliar) Nota: Un evento assert se puede utilizar como una "guardia" que detiene una cadena antes de los puntos críticos si no se cumple una condición. Cuando un evento Assert es una dependencia de los nodos posteriores, toda la cadena se detendrá. |
|
La afirmación falla (con la opción "Detener cadena en caso de fallo" habilitada) |
Ejecutar falla; Cadena falla; Cadena se detiene inmediatamente |
Cuando la opción "Detener cadena en caso de fallo" está habilitada y esa aserción falla, todas las demás ramas se detienen inmediatamente. Ejemplo: (Pulse para ampliar) |
|
La afirmación falla (múltiples ramas/afirmaciones) |
La ejecución de la cadena se detiene en la rama fallida, pero continúa para todas las demás ramas hasta que se cumpla una condición Guard/Stop; La cadena falla |
El evento Assert puede colocarse en múltiples rutas o "ramas" dentro de la misma cadena. Una aserción fallida detendrá esa rama en particular, pero todas las demás ramas continuarán ejecutándose. Esto le permite probar múltiples condiciones dentro de la misma cadena. Ejemplo: (Pulse para ampliar) |
Evento Assert vs. Evento condicional
El evento Conditional, cuando se combina con el evento Set Chain Result, se puede utilizar para lograr resultados similares - pero se requieren múltiples nodos y rutas de ramificación vis-à-vis el evento Assert. El evento Assert pretende simplificar y Reemplazar este proceso más complejo.
Para demostrarlo, aquí hay un ejemplo de la lógica típica requerida para recrear una rama "Pasa" y "Falla" con un evento Condicional:
Y aquí está la misma lógica utilizando un único evento Assert:
Nota: Cuando se utiliza en la misma cadena, el evento Establecer Resultado de Cadena siempre Invalidará los resultados de un evento Assert. Por ejemplo, una cadena con un nodo Set Chain Result que esté configurado como "Succeed" siempre pasará independientemente del evento Assert.