Afirmar un resultado de cadena

El evento Assert es una herramienta de depuración, similar al evento condicional, que prueba la lógica de su cadena y valida que funcione como está previsto. En el nivel más básico, una rama de cadena continuará ininterrumpidamente cuando se apruebe una afirmación y se detendrá cuando falle una afirmación, pero hay una serie de condiciones que afectan esta regla. Puede encontrar una lista de casos de uso comunes al final de este artículo.

Paso 1: Agregar el evento a la cadena

1. En Generador de cadenas, desde la pestaña Cadenas  device_hub , haga clic en Editar crear para la cadena.
2. Haga clic en Eventos de cadenaeventoy mueva Afirmar a donde debería ocurrir el evento en la cadena.
3. Arrastre un enlace al evento desde el nodo anterior en la cadena.

   Nota: Para cambiar la posición de un nodo en la cadena, desvincúlelo de otros nodos y luego muévalo a donde debería aparecer. Para mover varios nodos a la vez, mantenga presionada la tecla SHIFT mientras los selecciona.

4. Seleccione el nodo del evento y haga clic en Editar  crear.
5. En Información básica, ingrese un nombre y una descripción únicos para ayudar a identificar el evento.
   

   Nota: Habilite Detener cadena en caso de error si toda la cadena debe detenerse cuando falla esta afirmación. Si no se marca, las demás ramas de la cadena se ejecutarán hasta su finalización incluso si esta en particular falla.

Paso 2: Configurar la lógica condicional

En Condiciones, construya la lógica condicional como reglas o grupos de reglas para probar resultados y variables de varios tipos de datos:

• Cadena, para uno o más caracteres
• Entero, para cualquier valor numérico entero, no decimal
• Fecha, para una cadena o variable de fecha
• Flotante, para cualquier valor numérico
• JSON, para notación de objetos de Javascript

  Nota: Para JSON, utilice una transformación de variable para analizar valores.

1. Seleccione si desea agregar una Regla o un Grupo de reglas.
   
2. Si incluye varias reglas o grupos, únalos con un booleano AND o OR :
   • Si todas las reglas o grupos deben ser verdaderos para que se cumpla la condición, seleccione Y.
   • Si alguna regla o grupo debe ser verdadero para que se cumpla la condición, seleccione O.
3. 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 probar si el valor está en blanco, seleccione Está en blanco o No está en blanco.
   • Para probar si el valor incluye caracteres específicos u otro valor de salida o variable, seleccione Contienee ingrese o seleccione el valor que coincida. 
   • Para probar si el valor cumple con una expresión regular, seleccione Coincide con RegExpe ingrese la expresión que desea que coincida.
   • Para probar si el valor comienza o termina con caracteres específicos u otro valor de salida o variable, seleccione Comienza con o Termina cone ingrese o seleccione el valor que desea que coincida.
   • Para probar si un valor numérico equivale a una cantidad, seleccione = o !=e ingrese o seleccione la cantidad.
   • Para probar si un valor numérico es mayor o menor que una cantidad, seleccione < o >e ingrese o seleccione la cantidad.
   • Para probar si un valor numérico es mayor, menor o igual a una cantidad, seleccione <= o >=e ingrese o seleccione la cantidad.
4. Después de configurar la lógica condicional, haga clic en Guardar.

Nota: Para eliminar una regla de la lógica condicional, haga clic en Eliminar eliminar.

Condiciones y casos de uso comunes

El evento Assert se puede agregar a múltiples rutas o "ramas" de una cadena. Cada afirmación funciona independientemente, lo que significa que una afirmación fallida detendrá solo la rama particular donde está ubicada; todas las demás ramas continuarán ejecutándose hasta su finalización. Sin embargo, si falla alguna afirmación, toda la cadena se marcará como "Fallida".

Cosas que debes saber:

• Habilite la opción Detener cadena en caso de error para detener inmediatamente toda la cadena cuando falla una afirmación.
• Puede anular una falla de cadena agregando un evento Establecer resultado de cadena. Cuando un nodo de resultado de cadena establecida se establece en "Éxito", la cadena siempre pasará independientemente de cualquier afirmación fallida.
  
  

Condición	Resultado	Explicación
La afirmación pasa	La carrera continúa; la cadena tiene éxito	La cadena continúa su marcha sin interrupción.
La afirmación falla (afirmación única)	La ejecución falla; la cadena falla	Cuando se coloca una sola afirmación en una ruta de cadena, la ejecución de la cadena se detiene cuando la afirmación falla. Ejemplo: (Haga clic para ampliar) Nota: Un evento de afirmación se puede utilizar como una "protección" que detiene una cadena antes de puntos críticos si no se cumple una condición. Cuando un evento Assert es una dependencia de los nodos subsiguientes, toda la cadena se detendrá.
La afirmación falla (con "Detener cadena en caso de fallo" habilitado)	La ejecución falla; la cadena falla; la cadena se detiene inmediatamente	Cuando la opción "Detener cadena en caso de error" está habilitada y esa afirmación falla, todas las demás ramas se detienen inmediatamente. Ejemplo: (Haga clic 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 cumple una condición de protección/detención; la cadena falla	El evento Assert se puede colocar en múltiples rutas o "ramas" dentro de la misma cadena. Una afirmació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: (Haga clic para ampliar)

Afirmar evento vs. Evento condicional

El evento condicional , cuando se combina con el evento Establecer resultado de cadena, se puede utilizar para lograr resultados similares, pero se requieren múltiples nodos y rutas de ramificación con respecto al evento Assert. El evento Assert tiene como objetivo 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 "Pass" y "Fail" con un evento condicional:

Y aquí está la misma lógica usando un solo evento Assert:

Nota: Cuando se utiliza en la misma cadena, el evento Establecer resultado de cadena siempre anulará los resultados de un evento Assert. Por ejemplo, una cadena con un nodo Establecer resultado de cadena establecido en "Éxito" siempre pasará independientemente del evento Assert.