Tipos de operadores y eventos en el editor de reglas de un formulario adaptable basado en componentes principales
En AEM Forms as a Cloud, el editor de reglas incluye varios tipos de operadores y eventos que le permiten definir y ejecutar condiciones y acciones complejas con facilidad.
Los tipos de operadores disponibles en el editor de reglas de un formulario adaptable proporcionan un marco sólido para construir condiciones precisas. Permiten manipular datos, realizar cálculos y combinar varias condiciones de una manera lógica y coherente. Tanto si compara valores como si realiza operaciones aritméticas o manipula cadenas, estos operadores garantizan que las reglas sean flexibles y eficaces.
Los eventos del editor de reglas sirven como déclencheur que activan las reglas. Definen las acciones específicas que se producen cuando se cumplen determinadas condiciones. Al aprovechar diferentes tipos de eventos, puede automatizar las respuestas a una amplia gama de escenarios, por ejemplo, interacciones de usuarios, horas programadas, cambios en los datos y estados del sistema. Con la capacidad de especificar estos déclencheur, puede crear reglas dinámicas y adaptables que se adapten a sus necesidades específicas.
Al comprender y utilizar los tipos de operadores y eventos disponibles, puede desbloquear todo el potencial del editor de reglas, lo que le permite crear reglas eficientes y efectivas que satisfagan sus necesidades únicas y mejoren la funcionalidad general del sistema.
Tipos de operadores y eventos disponibles en el editor de reglas available-operator-types-and-events-in-rule-editor
El editor de reglas proporciona los siguientes operadores lógicos y eventos mediante los cuales puede crear reglas.
- Is Equal To
- Is Not Equal To
- Starts With
- Ends With
- Contains
- No contiene
- Is Empty
- Is Not Empty
- Has Selected: devuelve el valor True cuando el usuario selecciona una opción concreta para un botón de opción, un menú desplegable o una casilla de verificación.
- Is Initialized (event): devuelve el valor True cuando un objeto de formulario se procesa en el explorador.
- Is Changed (event): devuelve el valor True cuando el usuario cambia el valor indicado o la opción seleccionada para un objeto de formulario.
Tipos de reglas disponibles en el editor de reglas available-rule-types-in-rule-editor
El editor de reglas proporciona un conjunto de tipos de reglas predefinidas que puede utilizar para escribir reglas. Veamos en detalle cada tipo de regla. Para obtener más información sobre cómo escribir reglas en el editor de reglas, consulte Escribir reglas.
When whenruletype
El tipo de regla When sigue a la construcción de regla condición-acción-acción alternativa o, a veces, solo a la construcción condición-acción. En este tipo de regla, primero debe especificar una condición para la evaluación seguida de una acción que se activará si se cumple la condición (True
). Al usar el tipo de regla When, puede usar varios operadores AND y OR para crear expresiones anidadas.
Con el tipo de regla When, se puede evaluar una condición en un objeto de formulario y realizar acciones en uno o varios objetos.
En palabras simples, una regla When típica está estructurada de la siguiente manera:
When on Object A:
(Condition 1 AND Condition 2 OR Condition 3) is TRUE;
Then, do the following:
Action 2 on Object B;
AND
`Acción 3 sobre el objeto C;
Else, do the following:
Action 2 on Object C;
_
Cuando tiene un componente de varios valores, como botones de opción o lista, mientras crea una regla para ese componente, las opciones se recuperan automáticamente y se ponen a disposición del creador de reglas. No es necesario volver a escribir los valores de las opciones.
Por ejemplo, una lista tiene cuatro opciones: rojo, azul, verde y amarillo. Al crear la regla, las opciones (botones de opción) se recuperan automáticamente y se ponen a disposición del creador de reglas de la siguiente manera:
Al escribir una regla When, puede activar la acción Clear Value Of. La acción Clear Value Of borra el valor del objeto especificado. Contar con Clear Value Of como opción en la instrucción When permite crear condiciones complejas con varios campos. Puede agregar la instrucción Else para agregar más condiciones
Varios campos permitidos en When allowed-multiple-fields
En la condición When, tiene la opción de agregar otros campos aparte del campo al que se aplica la regla.
Por ejemplo, con el tipo de regla When, puede evaluar una condición en diferentes objetos de formulario y realizar la acción:
Cuándo:
(Objeto A, condición 1)
Y/O
(Objeto B Condición 2)
A continuación, haga lo siguiente:
Acción 1 en el objeto A
_
Consideraciones al usar campos múltiples permitidos en la función de condición When
- Asegúrese de que el componente principal está configurado en la versión 3.0.14 o posterior para usar esta característica en el editor de reglas.
- Si las reglas se aplican a diferentes campos dentro de la condición When, la regla entra en déclencheur aunque solo se cambie uno de esos campos.
Si los campos múltiples permitidos en la función de condición When encuentran algún problema, siga los pasos de solución de problemas como:
- Abra el formulario en modo de edición.
- Abra el Explorador de contenido y seleccione el componente Contenedor de guía de su formulario adaptable.
- Haga clic en el icono de propiedades del contenedor de guía . Se abre el cuadro de diálogo Contenedor de formulario adaptable.
- Haga clic en Listo y vuelva a guardar el cuadro de diálogo.
Hide. Oculta el objeto especificado.
Show. Muestra el objeto especificado.
Enable. Habilita el objeto especificado.
Disable. Deshabilita el objeto especificado.
Invoke service. Invoca un servicio configurado en un modelo de datos de formulario (FDM). Al elegir la operación Invocar un servicio, aparece un campo. Al pulsar el campo, se muestran todos los servicios configurados en todos los modelos de datos de formularios de la instancia de Experience Manager. Al elegir un servicio del modelo de datos de formulario, aparecen más campos en los que se pueden asignar objetos de formulario con parámetros de entrada y salida para el servicio especificado. Consulte la regla de ejemplo para invocar los servicios del Modelo de datos de formulario (FDM).
Además del servicio de modelo de datos de formulario, puede especificar una URL de WSDL directa para invocar un servicio web. Sin embargo, un servicio de modelo de datos de formulario tiene muchas ventajas y es el método recomendado para invocar un servicio.
Para obtener más información sobre la configuración de servicios en el modelo de datos de formulario (FDM), consulte integración de datos de Experience Manager Forms.
Establecer valor de Calcula y establece el valor del objeto especificado. Puede establecer el valor del objeto en una cadena, el valor de otro objeto, el valor calculado mediante una expresión o función matemática, el valor de una propiedad de un objeto o el valor de salida de un servicio configurado de modelo de datos de formulario. Al elegir la opción de servicio web, se muestran todos los servicios configurados en todos los modelos de datos de formularios de la instancia de Experience Manager. Al elegir un servicio del modelo de datos de formulario, aparecen más campos en los que se pueden asignar objetos de formulario con parámetros de entrada y salida para el servicio especificado.
Para obtener más información sobre la configuración de servicios en el modelo de datos de formulario (FDM), consulte integración de datos de Experience Manager Forms.
El tipo de regla Establecer propiedad permite establecer el valor de una propiedad del objeto especificado en función de una acción de condición. Puede establecer la propiedad en una de las siguientes opciones:
- visible (booleano)
- label.value (String)
- label.visible (booleano)
- description (cadena)
- habilitado (booleano)
- readOnly (booleano)
- obligatorio (booleano)
- screenReaderText (String)
- válido (booleano)
- errorMessage (Cadena)
- predeterminado (número, cadena, fecha)
- enumNames (String[])
- chartType (Cadena)
Por ejemplo, permite definir reglas para mostrar el cuadro de texto cuando se hace clic en un botón. Puede utilizar una función personalizada, un objeto de formulario, una propiedad de objeto o una salida de servicio para definir una regla.
Para definir una regla basada en una función personalizada, seleccione Salida de función en la lista desplegable y arrastre y suelte una función personalizada desde la pestaña Funciones. Si se cumple la acción de condición, el cuadro de entrada de texto se vuelve visible.
Para definir una regla basada en un objeto de formulario, seleccione Objeto de formulario en la lista desplegable y arrastre y suelte un objeto de formulario desde la pestaña Objetos de formulario. Si se cumple la acción de condición, el cuadro de entrada de texto se vuelve visible en el formulario adaptable.
La regla Set Property basada en una propiedad de objeto permite hacer visible el cuadro de entrada de texto en un formulario adaptable basándose en otra propiedad de objeto incluida en el formulario adaptable.
En la siguiente figura se muestra un ejemplo de cómo habilitar dinámicamente la casilla de verificación en función de cómo se oculta o se muestra un cuadro de texto en un formulario adaptable:
Clear Value Of. Borra el valor del objeto especificado.
Set Focus. Define el enfoque del objeto especificado.
Enviar formulario Envía el formulario.
Restablecer Restablece el formulario o el objeto especificado.
Validar Valida el formulario o el objeto especificado.
Add Instance. Agrega una instancia del panel repetible o fila de tabla especificados.
Remove Instance. Quita una instancia del panel repetible o fila de tabla especificados.
Salida de función Define una regla basada en funciones predefinidas o personalizadas.
Navegar a Navegar a otros Forms adaptables, otros recursos como imágenes o fragmentos de documento o una URL externa.
Evento de envío almacena en Déclencheur las acciones o comportamientos específicos en función de condiciones o eventos predefinidos.
Set Value Of set-value-of
El tipo de regla Fijar valor de le permite definir el valor de un objeto de formulario en función de si la condición especificada se cumple o no. El valor puede establecerse en un valor de otro objeto, una cadena literal, un valor derivado de una expresión matemática o una función, un valor de una propiedad de otro objeto o el resultado de un servicio de modelo de datos de formulario. Del mismo modo, se puede comprobar la existencia de una condición en un componente, una cadena, una propiedad o valores derivados de una función o expresión matemática.
El tipo de regla Set Value Of no está disponible para todos los objetos de formulario, como paneles y botones de la barra de herramientas. Una regla de valor definido estándar tiene la siguiente estructura:
Establezca el valor del objeto A en:
(Cadena ABC) O
(propiedad de objeto X del objeto C) O
(valor de una función) O
(valor de una expresión matemática) O
(valor de salida de un servicio del modelo de datos);
When (opcional):
(Condición 1 AND Condición 2 AND Condición 3) is TRUE;
El ejemplo siguiente selecciona el valor de Question2
como True
y establece el valor de Result
como correct
.
Ejemplo de la regla Set Value usando el servicio del modelo de datos de formulario.
Show show
Al usar el tipo de regla Show, puede escribir una regla para mostrar u ocultar un objeto de formulario en función de si una condición se cumple o no. El tipo de regla Show también activa la acción Hide (ocultar) en caso de que la condición no se cumpla o devuelva un valor False
.
Una regla Show típica se estructura de la siguiente manera:
Show Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Hide Object A;
Hide hide
Al igual que el tipo de regla Show, puede usar el tipo de regla Hide para mostrar u ocultar un objeto de formulario en función de si se cumple o no una condición. El tipo de regla Hide también activa la acción Show (mostrar) en caso de que la condición no se cumpla o devuelva un valor False
.
Una regla Hide típica se estructura de la siguiente manera:
Hide Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Show Object A;
Enable enable
El tipo de regla Enable permite activar o desactivar un objeto de formulario en función de si se cumple o no una condición. El tipo de regla Enable también activa la acción Disable en caso de que la condición no se cumpla o devuelva un valor False
.
Una regla Enable típica se estructura de la siguiente manera:
Enable Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Disable Object A;
Disable disable
Similar al tipo de regla Habilitar, el tipo de regla Deshabilitar permite habilitar o deshabilitar un objeto de formulario en función de si se cumple o no una condición. El tipo de regla Disable también activa la acción Enable (habilitar) en caso de que la condición no se cumpla o devuelva un valor False
.
Una regla Disable típica se estructura de la siguiente manera:
Disable Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Enable Object A;
Validate validate
El tipo de regla Validate valida el valor de un campo mediante una expresión. Por ejemplo, puede escribir una expresión para comprobar que el cuadro de texto para especificar un nombre no contenga caracteres especiales ni números.
Una regla Validar típica se estructura de la siguiente manera:
Validate Object A;
Using:
(Expression 1 AND Expression 2 AND Expression 3) is TRUE;
Siguiente paso
Ahora vamos a entender varios ejemplos de un editor de reglas para un formulario adaptable basado en componentes principales.
Consulte también
- Introducción al Editor de reglas para formularios adaptables basados en componentes principales
- Tipos de operadores y eventos en el editor de reglas de un formulario adaptable basado en componentes principales
- Interfaz de usuario del Editor de reglas para formularios adaptables basados en componentes principales
- Diferentes casos de uso del Editor de reglas para un formulario adaptable basado en componentes principales
- Diferencia en varias ediciones del editor de reglas
- Introducción a las funciones personalizadas para formularios adaptables basados en componentes principales
- Crear una función personalizada para un formulario adaptable basado en componentes principales
- Ejemplos de desarrollo y uso de funciones personalizadas