Normas - Automate_Evolve - Automate_Studio_Manager

Esta página cubre las siguientes formas de trabajar con reglas:

Las reglas son herramientas potentes que controlan la lógica y ayudan a automatizar las funciones de un formulario, como actualizar un campo automáticamente cuando se cambian los datos de otro campo. Las reglas pueden aplicar fórmulas a datos, cambiar datos y cambiar el aspecto de los datos de un formulario.

Por ejemplo, usaría una regla para que un botón desencadenara una función específica, como buscar en una base de datos, activar un servicio web o configurar un valor de campo. También puede usar una regla para indicar una entrada de datos incorrectos cambiando el color de un campo a rojo para indicar un valor incorrecto.

Para reglas avanzadas

Si el creador de soluciones no proporciona la flexibilidad necesaria para crear una regla, los usuarios avanzados pueden crear reglas con JavaScript personalizado. Consulte la Guía de referencia de JavaScript para obtener información sobre los contenedores de JavaScript, la sintaxis, etc.

Acciones de reglas

Nota:

Cada regla puede constar de una o varias Acciones. En el ejemplo anterior, se podría usar una única regla para gestionar ambas funciones, cada una de las cuales sería una acción independiente. Por ejemplo, puede usar una regla para calcular automáticamente y actualizar el campo del precio total del formulario en función de los valores introducidos por el usuario en un campo de precio del elemento o en un campo de cantidad.

Al aplicar varias reglas a un campo o botón, las acciones siguientes solo se pueden usar una vez y debe ser la última regla de la secuencia:

Ejecutar consulta
Ejecutar servicio web
Formulario de envío

Esto se debe a que se realiza una solicitud al servidor, de manera que no se pueden ejecutar reglas adicionales una vez se haya realizado la solicitud.

Nota:

Los campos con reglas aplicadas aparecen con un icono de verificación junto a su nombre en el panel Solución en la pestaña Solución. Ejemplo:

Una regla consta de un tipo de regla (Acción, Formato o Validación), una o varias condiciones y una o varias acciones.

Añadir una regla nueva

En el panel Propiedades, haga clic en Propiedades.
En la pestaña Propiedades, junto a Reglas, haga clic en el botón Opciones [...].
El inspector de reglas se abre en el panel Propiedades.
Haga clic en Añadir regla.
Introduzca la información siguiente para la regla:
- Etiqueta: Escriba un nombre descriptivo para la regla.
- Ejecutar regla al cargar un formulario: Seleccione esta opción para ejecutar la regla tan pronto como se cargue el formulario.
- Tipo: Seleccione un tipo de regla: Validación, Formato o Acciones.
- Condición: Haga clic en esta opción para crear las condiciones para cuando se desencadene la regla, como cuando se cambia un campo de formulario específico. Consulte Trabajar con condiciones (a continuación) para obtener más información.
- Mensaje: Introduzca un mensaje que se mostrará al usuario cuando se ejecute la regla.
- Usar elemento emergente: Marque esta casilla para usar un elemento emergente para mostrar el mensaje al usuario.
- Título del elemento emergente: Si seleccionó Usar elemento emergente, escriba un nombre para la ventana emergente en este campo.
Haga clic en Aceptar para terminar.

Cambiar o eliminar reglas existentes

Haga clic en el campo o elemento que tenga la regla que desea cambiar.

En el panel Propiedades, haga clic en Propiedades.
En la pestaña Propiedades, junto a Reglas, haga clic en el botón Opciones [...].
En el editor de reglas:
- Haga clic en Añadir para añadir una acción de regla.
- Haga clic en el icono Editar para abrir la regla en el editor.
- Haga clic en el icono Eliminar (papelera) para eliminar la regla.
- Haga clic en la condición para cambiar la condición de la regla. Consulte Trabajar con condiciones (a continuación) para obtener más información.
- Haga clic en Eliminar condición (papelera) para eliminar una condición.
Haga clic en Aceptar para finalizar los cambios.

Utilizar el inspector de reglas

Use el inspector de reglas para obtener un «panel» de instantánea de todas las reglas de su solución.

En el inspector de reglas puede:

Busque reglas específicas en la barra de búsqueda para filtrar resultados.
Imprima los resultados.
Edite una regla haciendo clic en su nombre.
Visualice todas reglas aplicadas a un campo haciendo clic en el nombre del campo.

Trabajar con condiciones

El Creador de condiciones proporciona una interfaz gráfica para crear la lógica y las reglas para su condición.

Haga clic en Añadir condición para añadir una condición.
Haga clic en Añadir grupo añadir un subgrupo de condiciones.
Haga clic en Campos de formulario y operadores lógicos (como «es igual a» o «no igual que», por ejemplo) en los menús desplegables.
Haga clic en Eliminar para eliminar una condición o un grupo.

Abajo: Una condición de muestra del Creador de condiciones de reglas

Tipos de reglas

Hay cuatro tipos básicos de reglas: Validación, Formato, Acción y JavaScript (consulte la 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.

Consulte a continuación para obtener detalles de lo siguiente:

Propiedades de reglas generales
Reglas de validación
Reglas de formato
Reglas de acción
Tabla de referencia rápida de reglas de acción

Propiedades de reglas generales

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 Especifique el tipo de regla que se creará. Se mostrarán opciones adicionales en función del tipo de regla seleccionado. Para obtener más información, consulte a continuación:

Validación
Formateo
Acción

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

Nota:

Si utiliza una condición para compararla con una columna lista de datos de referencia Sí/No: El valor debe ser Verdadero o Falso (sin comillas, etc.) La primera letra debe estar en mayúsculas, es decir, Verdadero o Falso, no verdadero/falso

1. Reglas de validació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. 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.

2. Reglas de formato

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

Modificaciones de componentes de formulario

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.

Ocultar grupo de componentes: Oculta el grupo entero que contiene el campo si la condición es verdadera.
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 verdadera.

3. Reglas de acció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 Tabla 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

Consulte a continuación para obtener una descripción de lo que hace cada regla de acción y los parámetros asociados con la acción.

Acción	Descripción
Añade 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.
Copiar datos de tabla	Puede copiar datos entre tablas con la regla Copiar datos de tabla disponible en la interfaz de usuario del creador de soluciones. Si desea contar con esta función, póngase en contacto con su representante de ventas para obtener más información. Parámetros Campo/Tabla actual: Es el campo al que se le aplica la regla Copiar datos de tabla. (Obligatorio) Fuente primaria: Es la tabla desde la que se pueden copiar los valores. Pueden ser una o varias filas, dependiendo de las condiciones definidas. (Obligatorio) Todas las tablas de repetición, grupos de repetición o tablas seleccionables que aparezcan en los datos del formulario se rellenarán en la lista de Fuente primaria. Fuente adicional: Son los campos de origen no repetitivos definidos además de la fuente primaria. (Opcional) Tabla de destino: Es la tabla o grupo de repetición en los que se copian los datos. (Obligatorio) Campos accionables: Todos los campos anteriores, de forma colectiva, se llaman campos accionables. Condición: Define la condición por la que se seleccionan las filas que se van a copiar. Asignación: Define la relación entre los campos fuente y de destino. Tipo de actualización: Sobrescribir filas: Vacía la tabla y permite escribir datos desde la primera fila. Si no se cumple la condición de Copiar datos, no se van a copiar filas de la tabla fuente a la tabla de destino. Además, la tabla de destino se vacía. Anexar filas: Permite copiar datos desde la última fila disponible. Notas y limitaciones Los tipos de datos entre el/los campo/s de origen y el de destino deben ser iguales. El campo del tipo de datos de una tabla de repetición se llama Tipo de entrada y el de un grupo de repetición, Tipo de elemento. Por ejemplo, si la tabla de origen tiene un campo Fecha que debe copiarse mediante la regla Copiar datos de tabla, la tabla de destino también debe ser un campo Fecha. La tabla de origen y la de destino siempre deben encontrarse en la misma vista actual del formulario. Al copiar datos de un campo de origen a un grupo de repetición de destino (solo lectura), cuando elija la opción Sobrescribir filas, el icono Eliminar desaparece, incluso si no se cumple la condición de la regla Copiar datos de tabla. No se pueden copiar los siguientes elementos: Etiqueta Adjunto Tabla seleccionable con paginación No se admiten las tablas de repetición anidadas para la regla Copiar datos de tabla. No se admiten ni ejecutan la reglas en la tabla de destino.
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. También puede filtrar y ver el contenido repetido borrando el Filtro y usando el operador contiene en lugar de Es igual a.
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.
Formulario de envío	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.

Normas - Automate_Evolve - Automate_Studio_Manager - 20.3

Guía del usuario de Automate Evolve

Tipos de reglas