Usted está aquí: Guías de referencia > Guía de referencia de reglas > Tipos y propiedades de reglas
Tipos de reglas
Hay cuatro tipos de reglas básicos en Winshuttle Composer: Validación, Formato, Acción y JavaScript (consulte Guía de referencia de JavaScript para obtener más información sobre las reglas de JavaScript).
Ejecutar regla al cargar un formulario Indica si la regla se debe ejecutar automáticamente o no al cargar el formulario.
Detener la ejecución en el depurador antes de ejecutar esta regla
Esta opción es ideal para solucionar los problemas de las reglas. Al habilitar esta opción, se inserta un punto de interrupción en el código de JavaScript justo antes de ejecutar la regla. Si las herramientas de desarrollo del explorador están activas y se ejecuta esta regla, la sesión de depuración del explorador se detendrá antes de ejecutar la regla para interrogar el código.
Desactivar regla
Al habilitar esta opción, se detiene la ejecución de la regla cuando el formulario está en ejecución.
Tipo Especifica el tipo de regla que se creará. Se mostrarán opciones adicionales en función del tipo de regla seleccionado. Haga clic en un tipo de regla para obtener más información:
Una regla de validación se puede usar para mostrar un mensaje de error cuando los datos introducidos en un campo de formulario no son válidos. Puede especificar las condiciones en las que se muestra el mensaje de error.
Por ejemplo, podría crear una regla para mostrar un error si un número introducido en un campo es superior a un valor determinado, inferior a un valor determinado o se producen ambas situaciones.
Etiqueta: Etiqueta descriptiva de la regla.
Ejecutar regla al cargar un formulario: Marque esta opción para ejecutar la regla al cargar el formulario por primera vez.
Condición: Haga clic en esta opción para abrir el Creador de condiciones de reglas con el fin de definir las condiciones por las que la regla surtirá efecto. Las condiciones pueden ser comparaciones de valores básicas o pueden implicar fórmulas complejas.
Tipo: El tipo de la regla.
Mensaje de error: Texto del mensaje de error que desea que se muestre cuando se cumplan las condiciones que ha definido.
Utilizar elemento emergente: Muestra un cuadro de diálogo con el mensaje de validación en lugar de resaltar el error en el formulario. Nota: Esta opción se usa solo para mostrar un mensaje. La regla no se validará antes de enviar el formulario.
Título del elemento emergente: Título del cuadro emergente.
Las reglas de formato aplican un formato específico a un campo de formulario cuando se cumplen ciertas condiciones.
Por ejemplo, si el valor introducido en un campo de formulario es demasiado alto, puede crear una regla para cambiar el campo de formulario al color amarillo.
Etiqueta: Etiqueta descriptiva de la regla.
Ejecutar regla al cargar un formulario: Marque esta opción para ejecutar la regla al cargar el formulario por primera vez.
Condición: Haga clic en esta opción para abrir el Creador de condiciones de reglas con el fin de definir las condiciones por las que la regla surtirá efecto. Las condiciones pueden ser comparaciones de valores básicas o pueden implicar fórmulas complejas.
Tipo: El tipo de la regla.
Aplicar estilos a campos: Campo al que se aplicará el formato.
Opciones de formato: Opciones de fuente y color: Negrita, Cursiva, Subrayado, Tachado, Color de fondo y Color de texto.
Modificaciones del estilo de fuente
Modificaciones de componentes de formulario
Modificaciones del estilo de fuente (que se aplicarán al componente de formulario de este campo)
Negrita
Cursiva
Subrayado
Tachado
Color de fondo
Color de texto
Para ocultar, requerir o deshabilitar un campo, cree una regla de acción mediante Cambiar propiedades de campo. Consulte la entrada de Cambiar propiedades de campo en la Tabla de referencia rápida de reglas de acción para obtener más información.
Nota: Las soluciones creadas en versiones anteriores de Composer (11.0.2 y anteriores) también mostrarán las opciones siguientes.
Ocultar grupo de componentes: Oculte el grupo entero que contiene el campo si la condición es true.
Ocultar componente: Oculte el campo y sus etiquetas si la condición es true.
Deshabilitar este componente: Deshabilite el campo si la condición es true.
Requerir componente: Establezca el campo en Requerido (es decir, el formulario no se puede enviar si el campo está vacío) si la condición es true.
Las nuevas reglas creadas en Composer 11.0.3 y posteriores deberán usar la nueva regla de acción: Cambiar propiedades de campo, como se describe a continuación.
Las reglas de acción son las reglas más versátiles. Las reglas de acción pueden realizar una amplia gama de funciones, como establecer valores en campos específicos, comparar valores en campos, calcular valores basados en fórmulas, etc.
Etiqueta: Etiqueta descriptiva de la regla.
Ejecutar regla al cargar un formulario: Marque esta opción para ejecutar la regla al cargar el formulario por primera vez.
Condición: Haga clic en esta opción para abrir el Creador de condiciones de reglas con el fin de definir las condiciones por las que la regla surtirá efecto. Las condiciones pueden ser comparaciones de valores básicas o pueden implicar fórmulas complejas.
Tipo: El tipo de la regla.
Añadir: Haga clic para añadir la regla y abrir el cuadro de diálogo Añadir acción de regla (consulte a continuación).
Una vez que haya especificado la información básica y las condiciones de una regla de acción:
Acción: Seleccione la acción en el menú desplegable. Consulte Guía de referencia rápida de reglas para ver una descripción de las acciones de reglas.
Campo: Seleccione el campo al cual se aplicará la acción. También puede escribir el nombre de un campo para buscarlo automáticamente.
Valor: Escriba un valor o haga clic en f(x) (función) para insertar una fórmula que se ejecutará como parte de la acción.
En la tabla siguiente se proporciona un resumen de las reglas de acción disponibles, una descripción de las funciones de las reglas y los parámetros asociados con la acción.
Acción
Descripción
Añadir fila nueva
Añade una nueva fila a un grupo o una tabla de repetición.
Parámetros
Grupo: Grupo de repetición al cual se añadirá una nueva fila.
Modificar propiedades del campo
Cambie las propiedades de un campo para mostrar, ocultar, habilitar/deshabilitar o requerir/no requerir una entrada.
Muestra, oculta, amplía o contrae un grupo en función de un campo especificado del grupo.
Parámetros
Campo de grupo: Datos del campo que rigen el estado de visualización del grupo. (Mostrar | Ocultar | Ampliar | Contraer)
Eliminar Opciones de fila
Habilitar: Muestra el icono de la «papelera» (eliminar)
Deshabilitar: Oculta el icono de la «papelera» (eliminar)
Parámetros
Grupo: Grupo de repetición del cual se habilitarán o deshabilitarán las opciones Eliminar fila.
Vaciar tabla
Elimina todos los datos de una tabla o un grupo de repetición.
Parámetros
Grupo: Grupo de repetición del cual se eliminarán todos los datos.
Ejecutar consulta
Ejecuta un control de consulta en el formulario.
Parámetros
Control de consulta: Consulta que se ejecutará.
Ejecutar reglas para campo
Ejecuta la regla en otro campo. Puede ser útil si dos campos tienen reglas relacionadas entre sí.
Parámetros
Campo: Campo en el que se ejecutará la regla.
Ejecutar servicio web
Ejecuta un control de servicio web en el formulario.
Parámetros
Control de servicio web: Servicio web que se ejecutará.
Filtrar contenido repetitivo
Habilita el filtrado de grupos o tablas de repetición mientras que conserva el contenido. Puede configurar una «condición» para usar con este, por ejemplo, field1= «this» y field2 != «that». Solo se mostrarán las filas que cumplan las condiciones en la tabla o el grupo de repetición.
Parámetros
Grupo: Grupo que se filtrará según los criterios de filtro.
Filtro: Cree el filtro lógico para la lista desplegable. Por ejemplo, puede especificar «Es igual a» y escribir un valor específico, así como operadores and/or.
Opciones de fila nueva
Habilitar: Muestra el vínculo «Añadir nueva fila» en un grupo o una tabla de repetición.
Deshabilitar: Oculta el vínculo «Añadir nueva fila» en un grupo o una tabla de repetición.
Parámetros
Grupo: Grupo de repetición del cual se habilitarán o deshabilitarán las opciones Nueva fila.
Volver a cargar opciones de lista desplegable
Hace que se vuelvan a cargar las opciones de una lista desplegable o un cuadro combinado. Se puede usar para listas de opciones dinámicas.
Parámetros
Campo: Campo desplegable en el cual se volverán a cargar las opciones.
Mostrar mapa
Envía una nueva dirección a un control de mapa del formulario.
Parámetros
Elemento de mapa: Control de mapa que se actualizará con una nueva dirección.
Descripción: Descripción que se asignará a la ubicación del mapa.
Dirección: Dirección de la nueva ubicación del mapa.
Ciudad: Ciudad de la nueva ubicación del mapa.
Estado: Estado de la nueva ubicación del mapa.
Código postal: Código postal de la nueva ubicación del mapa.
País: País de la nueva ubicación del mapa.
Buscar contenido repetido
Proporciona un mecanismo para buscar todos los campos de un «patrón» (por ejemplo, si algún campo contiene «abcd»). En este caso, todas las filas en que al menos un campo contiene el patrón se mostrarán en la tabla o el grupo de repetición.
Parámetros
Grupo: Nombre del grupo
Contiene: Nombre del campo
Establecer un Valor de campo
Esta acción permite cambiar el valor de un campo del formulario.
Parámetros
Campo: Campo de destino del cual quiere establecer el valor.
Valor: Fórmula que se va a evaluar para obtener el nuevo valor del campo. Puede contener otros valores de campo, llamadas de funciones, referencias de datos externas o valores constantes.
Establezca una etiqueta
Esta acción de regla es similar a Establecer un valor de campo (más arriba), pero cambiará la etiqueta (o subetiqueta) de un elemento de formulario.
Parámetros
XPath: Campo (seleccionado de una lista desplegable) del cual se cambiará el valor de la etiqueta del elemento de formulario.
Valor: Fórmula que se va a evaluar para obtener el nuevo valor del campo. Puede contener otros valores de campo, llamadas de funciones, referencias de datos externas o valores constantes.
Subetiquetas: (True/False): Se establece en True para cambiar la subetiqueta del elemento especificado.
Organizar contenido repetido
Ordene los elementos de una tabla de repetición.
Parámetros
Campo de grupo: Campo del contenido de repetición por el que desee ordenar.
Orden de ordenación: Ascendente o descendente
Enviar formulario
Esta acción permite simular el botón Enviar del formulario.
Parámetros
Tipo de envío: Disposición o tipo de envío:
Completar: Complete la tarea actual.
Aprobar: Complete la tarea actual con la disposición Aprobado.
Rechazar: Complete la tarea actual con la disposición Rechazado.
Guardar: Guarde el formulario, pero no inicie ni avance el proceso.
Guardar y enrutar: Guarde el formulario e inicie el proceso.