Help Center > Foundation Help

Se aplica a:

  • Winshuttle Foundation

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).

Cada tipo de regla lo rige un conjunto común de propiedades generales.

En esta página

Propiedades de reglas generales

Volver al principio

 

Pantalla Crear regla de Winshuttle Composer

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:

Condición
Si la condición especificada es verdadera, se ejecutará esta regla; de lo contrario, no se ejecutará.

Nota: Si una una condición para comparar con una columna de SharePoint Sí/No:

  • El valor debe ser Verdadero o Falso (sin comillas, etc.)
  • La primera letra debe ir en mayúscula, es decir, Verdadero o Falso, no verdader/falso

Reglas de validación

Volver al principio

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.

Reglas de formato

Volver al principio

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.

Cuadro Regla de formato: Composer 11.0.3

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.

Reglas de acción

Volver al principio

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.

Tabla de referencia rápida de reglas de acción

Volver al principio

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.

Parámetros

  • Opciones disponibles: Mostrar | Ocultar | Habilitar | Deshabilitar | Requerido\No requerido
  • Campo: Campo que se cambiará.

Modificar vista de grupo

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)
Copiar filas parecidas

Esta regla se puede usar para copiar filas de una tabla o grupo de repetición a una tabla o grupo de repetición de destino.

Esta regla hace coincidir el valor de la columna en el elemento de repetición de origen para determinar qué filas copiar dependiendo de la propiedad del campo selector.

La acción Copiar filas parecidas determina si las filas coincidentes deben sobreescribirse o añadirse al elemento de repetición de destino como filas nuevas.

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.

Mostrar mensaje

Muestra una ventana emergente con el texto del mensaje especificado en esta regla. Las propiedades de esta regla se derivan, por defecto, de los campos de un formulario.

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
  • Mantener: Déjelo como Verdadero para que los datos queden ordenados entre las diferentes vistas. Déjelo como Falso para que los datos no queden ordenados entre las diferentes vistas.

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.