Introducción

Para acceder al Creador de reglas, debe ir al Administrador de formularios, hacer clic en el botón Acciones correspondiente al formulario que trabajará, luego Reglas condicionales.

Para este ejemplo, debe crear un formulario de contacto con cuatro campos:

• Nombre (campo de texto)
• Correo electrónico (campo de correo electrónico)
• Mensaje (área de texto)
• Botón (con texto Enviar)

Luego, vaya al Administrador de formularios, ubique su formulario, haga clic en el botón Acciones y luego haga clic en Reglas condicionales.

• Una vez en este Creador de reglas de formulario, lo primero que notará es un panel en blanco con el botón Agregar regla. Haga clic en este botón para crear su primera regla.
• Luego verás dos líneas, la primera se refiere a las condiciones y la segunda a las acciones.
• Haga clic en el botón Agregar condición y aparecerá el primer campo del formulario, seguido de una declaración. En nuestro ejemplo, el primer campo del formulario es un campo de texto con la etiqueta ‘Nombre’, por lo que el Generador de reglas mostrará la condición ‘Nombre’ ‘está presente’.
• Ahora haga clic en el botón Agregar acción y observe que aparecen varias listas de selección. La primera lista muestra la acción a realizar (Para este ejemplo, dejar en ‘Mostrar’); el segundo muestra el Tipo de resultado (Para este ejemplo, deje ‘Campo’) y el tercero, la etiqueta del primer campo: ‘Nombre’. Para este ejemplo, lo cambiará por ‘Enviar’ (El texto ‘Enviar’ se refiere al botón).
• Finalmente, en la parte superior derecha de esta regla, verá una pequeña advertencia naranja “Cambios no guardados” y al lado un botón verde con el ícono Verificar. Haga clic en este botón para guardar esta regla. La advertencia desaparecerá.

Has creado tu primera regla.

Debe tener en cuenta que algunas reglas se cumplen bidireccionalmente; es decir, si se ha cumplido la condición se ejecutará la acción. Pero, si la condición no se ha cumplido, se ejecutará la acción contraria (Mostrar <=> Ocultar, Habilitar <=> Deshabilitar, Matemática <=> Restablecer a O).

Puede agregar reglas adicionales haciendo clic en el botón “Agregar regla”, pero esto no se guardará hasta que presione el botón verde. Recuerde que cada regla se almacenará por separado.

Nota: Para eliminar una regla, haga clic en el botón rojo con el ícono Papelera. Además, si desea dejar de ejecutar una regla durante un tiempo determinado, puede deshabilitarla y luego habilitarla cuando lo necesite.

Nombre / Descripción

La primera parte nos permite describir la lógica condicional. Solo use algunas palabras para nombrar o describir lo que quiere lograr con esta regla. (Opcional. Longitud máxima: 255)

Condiciones

Es la segunda parte de una regla, está al principio y te permite especificar el campo o campos que necesitan ser evaluados, según el tipo de evaluación.

• Tipo de Condición: El tipo de condición indica cuantas condiciones se deben cumplir para ejecutar la acción. Puede ser: Todos, Cualquiera o Ninguno. El valor predeterminado es Todo.
• Condición: Es el enunciado referido a un campo del formulario y debe ser cumplido. Consta de 3 partes.
  • Nombre: El nombre del campo de formulario en el que se basa la condición.
  • Operador: El operador de comparación utilizado para evaluar la condición.
  • Valor: Es un valor arbitrario que el usuario debe ingresar al Formulario. La forma en que se definirán los valores variará según el tipo de campo y el tipo de operador.
• Varias condiciones: puede agregar varias condiciones a una regla. El tipo de condición indicará si se deben cumplir todas (Y), si alguna (O) o ninguna.
• Grupo de condiciones: Además de condiciones, una regla puede contener un grupo de condiciones. Un grupo de condiciones difiere de una condición que permite cambiar el tipo de condición. Entonces, una regla puede ser del tipo Todos (Y), pero el grupo puede ser del tipo Cualquiera (O).
• Proceso de evaluación: El proceso de evaluación de las condiciones es de arriba hacia abajo. Es decir, las condiciones del inicio se evaluarán antes que las del final, en orden descendente.

Nota: Las condiciones “Pertenece a” y “No pertenece a” pueden analizar múltiples valores separados por “|”, esto permite comparar el valor del campo con múltiples valores, si uno de ellos coincide se ejecutará la acción.

Comportamiento

La última parte de una regla indica la acción a realizar si se cumplen las condiciones. Como condiciones, las acciones tienen una forma declarativa fácil de entender.

Una acción consta básicamente de tres partes:

Tipo de acción:

• • Mostrar ocultar
  • Habilitar deshabilitar
  • Copiar: le permite copiar el valor de un campo u otro elemento y pegarlo en otro campo automáticamente. Un gran ejemplo de dónde esto es útil es en un formulario donde podría recopilar una dirección de envío y facturación. El usuario final podría ingresar su dirección de envío y marcar la opción Copiar para completar automáticamente los campos de dirección de facturación con los mismos datos.
  • Matemáticas: permite sumas/restas/multiplicaciones/divisiones/resto de campos y mostrar el resultado en otro campo o elemento HTML.
  • Evaluar: Permite la evaluación de expresiones matemáticas (fórmulas) y establecer el resultado en otro campo. También es compatible con los cálculos de fecha. Por ejemplo, si desea calcular la multiplicación de dos campos y dividir este valor por 10, utilice la siguiente fórmula: {{number_1}} * {{number_2}} / 100. Tenga en cuenta que la evaluación de las expresiones matemáticas no No funciona con acciones opuestas. Puede leer la lista completa de cálculos avanzados que admite Rule Builder gracias a las excelentes bibliotecas Math.js y date-fns.
  • Formato de número: le permite formatear un número de diferentes maneras y sin ningún tipo de codificación. Por ejemplo, para dar el formato de moneda a un número: 10130.25 use el siguiente formato ‘$0,00’ y el número ahora se mostrará como $10,130.25. Puede leer la lista completa de formatos que admite Rule Builder gracias a la excelente biblioteca Numeral.js.
  • Formato de texto: le permite seleccionar varios campos para crear una nueva cadena de texto con formato y establecer el resultado en otro campo o elemento HTML. P.ej. Para generar automáticamente una dirección de correo electrónico, seleccione un campo Nombre e ingrese el siguiente formato {{0}}@example.com, luego seleccione el campo Correo electrónico donde se mostrará la dirección de correo electrónico. Puede usar tokens numéricos para identificar la posición del campo en la lista de campos, o puede usar el Id. de campo o el Alias ​​de campo, en nuestro ejemplo: {0}@example.com o {{text_1234}}@example.com o {{ nombre}}@example.com debería funcionar.
  • Saltar: Le permite definir a qué página ir cuando pasamos a la página siguiente. Esta acción solo debe usarse en un formulario de varios pasos.
  • Formulario: Le permite establecer acciones relacionadas con el formulario:
    • ‘Enviar’: Para enviar el formulario.
    • ‘Restablecer’: Para restablecer el formulario.
    • ‘Página siguiente’: Para ir a la página siguiente.
    • ‘Página anterior’: Para ir a la página anterior.
  • Objetivo: Variará dependiendo del tipo de Acción. Puede ser de dos tipos
    •  Campo
    •  Elemento
  •  Nombre:
    • Si el objetivo es campo, será el nombre del campo.
    • Si el objetivo es un elemento, estará entre varios elementos HTML seleccionados por jQuery. Por ejemplo:
      • ‘#abc’: el objetivo es el elemento HTML con ‘abc’ como ID.
      • ‘.abc’: el objetivo son todos los elementos HTML con ‘abc’ como clase CSS.
  • Acciones opuestas: De forma predeterminada, las acciones opuestas se han habilitado porque ayudan a la creación de reglas condicionales comunes y las hacen más lógicas. Por ejemplo, si después de cumplir una condición quiero mostrar un campo, claramente al no cumplir la condición quiero mantener este campo oculto. Sin embargo, hay ocasiones en las que la desactivación de acciones opuestas puede resultar útil. Cuando esto ocurra, solo se ejecutará la acción descrita en la regla

Tenga en cuenta que el uso de elementos requiere un conocimiento básico de jQuery, pero ofrece grandes ventajas. Por ejemplo, podría crear una acción para ocultar todos los campos del formulario; ‘Ocultar’ ‘Elemento’ ‘.form-group’.

Validación condicional

Puede omitir una validación de campo obligatoria mediante el uso de reglas condicionales de dos maneras:

1. Cuando el campo está oculto.
2. Cuando el campo pertenece a una página que ha sido saltada.

Por ejemplo, si se crea un campo con el Creador de formularios y en las reglas condicionales se define que este campo solo debe mostrarse si otro campo cumple una condición y la condición no se cumple, entonces el primer campo ya no será obligatorio (será no ser validado por el servidor).

Nota: para usar la validación condicional, la validación del lado del cliente debe estar deshabilitada. (Ver Configuración de formulario -> No validar))