Editor de reglas de formularios adaptables

Información general

La función de editor de reglas de Adobe Experience Manager Forms permite a los usuarios y desarrolladores de formularios de negocios escribir reglas sobre objetos de formulario adaptables. Estas reglas definen las acciones que se deben realizar en el déclencheur de los objetos de formulario en función de las condiciones preestablecidas, las entradas del usuario y las acciones del usuario en el formulario. Esto ayuda a optimizar aún más la experiencia de cumplimentación de formularios, lo que garantiza la precisión y la velocidad.

El editor de reglas proporciona una interfaz de usuario intuitiva y simplificada para escribir reglas. El editor de reglas ofrece un editor visual para todos los usuarios. Además, solo para los usuarios avanzados de formularios, el editor de reglas proporciona un editor de código para escribir reglas y secuencias de comandos. Algunas de las acciones clave que se pueden realizar en objetos de formulario adaptables mediante reglas son:

  • Mostrar u ocultar un objeto
  • Habilitar o deshabilitar un objeto
  • Definición de un valor para un objeto
  • Validación del valor de un objeto
  • Ejecutar funciones para calcular el valor de un objeto
  • Invocar un servicio de modelo de datos de formulario y realizar una operación
  • Establecer la propiedad de un objeto

El editor de reglas reemplaza las funciones de secuencias de comandos de AEM 6.1 Forms y versiones anteriores. Sin embargo, las secuencias de comandos existentes se conservan en el nuevo editor de reglas. Para obtener más información sobre cómo trabajar con secuencias de comandos existentes en el editor de reglas, consulte Impacto del editor de reglas en secuencias de comandos existentes.

Los usuarios que se agregan al grupo de usuarios avanzados de formularios pueden crear nuevas secuencias de comandos y editar las existentes. Los usuarios del grupo de usuarios de formularios pueden utilizar las secuencias de comandos, pero no crearlas o editarlas.

Explicación de una regla

Una regla es una combinación de acciones y condiciones. En el editor de reglas, las acciones incluyen actividades como ocultar, mostrar, habilitar, deshabilitar o calcular el valor de un objeto en un formulario. Las condiciones son expresiones booleanas que se evalúan realizando comprobaciones y operaciones en el estado, valor o propiedad de un objeto de formulario. Las acciones se realizan en función del valor devuelto ( True o False) mediante la evaluación de una condición.

El editor de reglas proporciona un conjunto de tipos de reglas predefinidas, como Cuándo, Mostrar, Ocultar, Habilitar, Deshabilitar, Establecer valor de y Validar para ayudarle a escribir reglas. Cada tipo de regla permite definir condiciones y acciones en una regla. El documento explica cada tipo de regla en detalle.

Una regla suele seguir una de las siguientes construcciones:

Condition- ActionEn esta construcción, una regla primero define una condición seguida de una acción de déclencheur. La construcción es comparable a la declaración if-then en lenguajes de programación.

En el editor de reglas, el tipo de regla When impone la construcción de condición-acción.

Condición de acciónEn esta construcción, una regla primero define una acción en déclencheur seguida de condiciones para la evaluación. Otra variación de esta construcción es la acción alternativa de condición de acción, que también define una acción alternativa al déclencheur si la condición devuelve False.

Los tipos de reglas Mostrar, Ocultar, Habilitar, Deshabilitar, Establecer valor de y Validar del editor de reglas aplican la construcción de reglas de condición de acción. De forma predeterminada, la acción alternativa para Mostrar es Ocultar y Activar es Desactivar y viceversa. No se puede cambiar la acción alternativa predeterminada.

NOTA

Los tipos de reglas disponibles, incluidas las condiciones y las acciones definidas en el editor de reglas, también dependen del tipo de objeto de formulario en el que se esté creando una regla. El editor de reglas solo muestra tipos de reglas y opciones válidos para escribir condiciones y instrucciones de acción para un tipo de objeto de formulario concreto. Por ejemplo, no ve los tipos de reglas Validar, Establecer valor de, Habilitar y Deshabilitar para un objeto de panel.

Para obtener más información sobre los tipos de reglas disponibles en el editor de reglas, consulte Tipos de reglas disponibles en el editor de reglas.

Pautas para elegir una construcción de regla

Aunque puede lograr la mayoría de los casos de uso utilizando cualquier construcción de regla, estas son algunas pautas para elegir una construcción sobre otra. Para obtener más información sobre las reglas disponibles en el editor de reglas, consulte Tipos de reglas disponibles en el editor de reglas.

  • Una regla general típica al crear una regla es pensarla en el contexto del objeto en el que está escribiendo una regla. Tenga en cuenta que desea ocultar o mostrar el campo B en función del valor que un usuario especifica en el campo A. En este caso, está evaluando una condición en el campo A y, en función del valor que devuelve, está activando una acción en el campo B.

    Por lo tanto, si está escribiendo una regla en el campo B (el objeto sobre el que está evaluando una condición), utilice la construcción de condición-acción o el tipo de regla When . Del mismo modo, utilice la construcción de condición de acción o el tipo de regla Mostrar u Ocultar en el campo A.

  • A veces, es necesario realizar varias acciones en función de una condición. En estos casos, se recomienda utilizar el concepto de condición-acción. En esta construcción, puede evaluar una condición una vez y especificar varias instrucciones de acción.

    Por ejemplo, para ocultar los campos B, C y D en función de la condición que comprueba el valor que un usuario especifica en el campo A, escriba una regla con la estructura de acción condición o Cuando tipo de regla en el campo A y especifique acciones para controlar la visibilidad de los campos B, C y D. De lo contrario, necesitará tres reglas independientes en los campos B, C y D, donde cada regla comprueba la condición y muestra u oculta el campo respectivo. En este ejemplo, es más eficaz escribir el tipo de regla When en un objeto en lugar de Mostrar u Ocultar en tres objetos.

  • Para almacenar en déclencheur una acción basada en varias condiciones, se recomienda utilizar la construcción de condición de acción. Por ejemplo, para mostrar y ocultar el campo A mediante la evaluación de condiciones en los campos B, C y D, utilice Mostrar u Ocultar tipo de regla en el campo A.

  • Utilice la condición-acción o la condición de acción para construir si la regla contiene una acción para una condición.

  • Si una regla comprueba la existencia de una condición y realiza una acción inmediatamente al proporcionar un valor en un campo o al salir de un campo, se recomienda escribir una regla con la construcción de acción-condición o el tipo de regla When en el campo en el que se evalúa la condición.

  • La condición de la regla When se evalúa cuando un usuario cambia el valor del objeto en el que se aplica la regla When . Sin embargo, si desea que la acción se déclencheur cuando el valor cambie en el servidor, como en el caso de rellenar previamente el valor, se recomienda escribir una regla When que déclencheur la acción cuando el campo se inicialice.

  • Al escribir reglas para objetos de desplegables, botones de opción o casillas de verificación, las opciones o los valores de estos objetos de formulario en el formulario se rellenan previamente en el editor de reglas.

Tipos de operadores y eventos disponibles en el editor de reglas

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
  • Comienza con
  • Finaliza con
  • Contiene
  • Is Empty
  • Is Not Empty
  • Ha seleccionado: devuelve el valor "True" cuando el usuario selecciona una opción concreta para un botón de casilla de verificación, desplegable o radio.
  • Is Initialized (suceso): Devuelve el valor verdadero cuando se procesa un objeto de formulario en el explorador.
  • Is Changed (suceso): devuelve el valor "True" cuando el usuario cambia el valor introducido o la opción seleccionada para un objeto de formulario.

Tipos de reglas disponibles en el editor de reglas

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.

Cuando

El tipo de regla When sigue la construcción de regla condition-action-alternative action o, a veces, solo la construcción condition-action. En este tipo de regla, primero debe especificar una condición para la evaluación seguida de una acción de déclencheur si se cumple la condición ( True). Al utilizar el tipo de regla When , puede utilizar 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 de "Cuando" 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  
Action 3 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:

multivaluefcdisplaysoptions

Al escribir una regla de "Cuando", puede almacenar en déclencheur el valor de acción Borrar. Borrar valor de la acción borra el valor del objeto especificado. Tener un valor claro de como opción en la instrucción When permite crear condiciones complejas con varios campos.

clearvalueof

​HideOculta el objeto especificado.

​MostrarMuestra el objeto especificado.

​EnableActiva el objeto especificado.

​DisableDesactiva el objeto especificado.

Invocar servicioInvoca un servicio configurado en un modelo de datos de formulario. Al elegir la operación Invocar servicio, aparece un campo. Al pulsar el campo , se muestran todos los servicios configurados en todos los modelos de datos de formulario de la instancia de AEM. Al elegir un servicio del modelo de datos de formulario, aparecen campos adicionales en los que se pueden asignar objetos de formulario con parámetros de entrada y salida para el servicio especificado. Consulte regla de ejemplo para invocar servicios del modelo de datos de formulario.

Además del servicio del modelo de datos de formulario, puede especificar una URL WSDL directa para invocar un servicio web. Sin embargo, un servicio del modelo de datos de formulario tiene muchas ventajas y 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, consulte AEM Forms Data Integration.

Establezca el valor de Computes 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 expresión o función matemática, el valor de una propiedad de un objeto o el valor de salida de un servicio configurado del 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 formulario de la instancia de AEM. Al elegir un servicio del modelo de datos de formulario, aparecen campos adicionales 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, consulte AEM Forms Data Integration.

Set propertyDefine el valor de una propiedad del objeto especificado.

Borrar valor deBorra el valor del objeto especificado.

Definir el enfoque de FocusSets en el objeto especificado.

Guardar formularioGuarda el formulario.

Enviar formulariosEnvía el formulario.

Restablecer formularioRestablece el formulario.

Validar formularioValida el formulario.

Agregar instanciaAñade una instancia del panel repetible o fila de tabla especificados.

Quitar instanciaQuita una instancia del panel repetible especificado o de la fila de la tabla.

Valor definido de

El tipo de regla Set Value of permite establecer 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 del modelo de datos de formulario. Del mismo modo, se puede comprobar la existencia de una condición en un componente, cadena, propiedad o valores derivados de una función o expresión matemática.

Tenga en cuenta que el tipo Definir valor de regla 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:

Definir el valor del objeto A como:

(cadena ABC) OR
(propiedad de objeto X del objeto C) OR
(valor de una función) O
(valor de una expresión matemática) O
(valor de salida de un servicio de modelo de datos o servicio Web);

Cuando (opcional):

(Condición 1 Y condición 2 Y condición 3) es VERDADERO;

El ejemplo siguiente toma el valor del campo dependentid como entrada y establece el valor del campo Relation en la salida del argumento Relation del servicio del modelo de datos de formulario getDependent.

set-value-web-service

Ejemplo de regla Set Value utilizando el servicio del modelo de datos de formulario

NOTA

Además, se puede utilizar Definir valor de regla para rellenar todos los valores de un componente de lista desplegable desde la salida de un servicio de modelo de datos de formulario o un servicio Web. Sin embargo, asegúrese de que el argumento de salida que elija sea de un tipo de matriz. Todos los valores devueltos en una matriz estarán disponibles en la lista desplegable especificada.

Mostrar

Con el tipo de regla Mostrar, 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 Mostrar también déclencheur la acción Ocultar en caso de que la condición no se cumpla o devuelva False.

Una regla Mostrar típica está estructurada de la siguiente manera:

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

Ocultar

Al igual que Mostrar tipo de regla, puede utilizar el tipo de regla Ocultar para mostrar u ocultar un objeto de formulario en función de si una condición se cumple o no. El tipo de regla Ocultar también déclencheur la acción Mostrar en caso de que la condición no se cumpla o devuelva False.

Una regla de ocultación típica está estructurada de la siguiente manera:

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

Habilitar

El tipo de regla Enable permite habilitar o deshabilitar un objeto de formulario en función de si una condición se cumple o no. El tipo Enable rule también déclencheur la acción Disable en caso de que la condición no se cumpla o devuelva False.

Una regla Habilitar típica está estructurada de la siguiente manera:

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

Desactivar

Al igual que el tipo de regla Enable , el tipo de regla Disable permite habilitar o deshabilitar un objeto de formulario en función de si una condición se cumple o no. El tipo de regla Deshabilitar también déclencheur la acción Habilitar en caso de que la condición no se cumpla o devuelva False.

Una regla de desactivación 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;

Validar

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 el nombre no contenga caracteres especiales ni números.

Una regla de validación típica se estructura de la siguiente manera:

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

NOTA

Si el valor especificado no cumple la regla Validar , puede mostrar un mensaje de validación al usuario. Puede especificar el mensaje en el campo Script validation message de las propiedades del componente en la barra lateral.

script-validation

Explicación de la interfaz de usuario del editor de reglas

El editor de reglas proporciona una interfaz de usuario completa pero sencilla para escribir y administrar reglas. Puede iniciar la interfaz de usuario del editor de reglas desde un formulario adaptable en modo de creación.

Para iniciar la interfaz de usuario del editor de reglas:

  1. Abra un formulario adaptable en modo de creación.

  2. Pulse el objeto de formulario para el que desea escribir una regla y, en la barra de herramientas de componentes, pulse edit-rules. Aparecerá la interfaz de usuario del editor de reglas.

    create-rules

    Cualquier regla existente en los objetos de formulario seleccionados se muestra en esta vista. Para obtener información sobre la administración de reglas existentes, consulte Administrar reglas.

  3. Toque Crear para escribir una regla nueva. El editor visual de la interfaz de usuario del editor de reglas se abre de forma predeterminada cuando se inicia el editor de reglas por primera vez.
    Interfaz de usuario del Editor de reglas

    Haga clic en para
      ampliar. Veamos en detalle cada componente de la interfaz de usuario del editor de reglas.

A. Visualización de la regla de componente

Muestra el título del objeto de formulario adaptable a través del cual se ha iniciado el editor de reglas y el tipo de regla seleccionado actualmente. En el ejemplo anterior, el editor de reglas se inicia desde un objeto de formulario adaptable llamado Salario y el tipo de regla seleccionado es Cuando.

B. Objetos y funciones de formulario

El panel de la izquierda de la interfaz de usuario del editor de reglas incluye dos pestañas: Forms Objects y Functions.

La ficha Objetos de formulario muestra una vista jerárquica de todos los objetos contenidos en el formulario adaptable. Muestra el título y el tipo de los objetos. Al escribir una regla, puede arrastrar y soltar objetos de formulario en el editor de reglas. Al crear o editar una regla cuando arrastra y suelta un objeto o función en un marcador de posición, el marcador de posición toma automáticamente el tipo de valor apropiado.

Los objetos de formulario que tienen una o más reglas válidas aplicadas se marcan con un punto verde. Si alguna de las reglas aplicadas a un objeto de formulario no es válida, el objeto de formulario se marca con un punto amarillo.

La ficha Funciones incluye un conjunto de funciones integradas, como Suma de, Mínimo de, Máximo de, Promedio de, Número de y Validar formulario. Puede utilizar estas funciones para calcular valores en paneles repetibles y filas de tabla y utilizarlos en instrucciones de acción y condición al escribir reglas. Sin embargo, también puede crear funciones personalizadas.

La pestaña Funciones

NOTA

Puede buscar texto en nombres de objetos y funciones y títulos en las fichas Objetos y funciones de Forms.

En el árbol izquierdo de los objetos de formulario, puede pulsar los objetos de formulario para mostrar las reglas aplicadas a cada uno de los objetos. No solo puede desplazarse por las reglas de los distintos objetos de formulario, sino que también puede copiar y pegar reglas entre los objetos de formulario. Para obtener más información, consulte Copiar y pegar reglas.

C. Alternar objetos y funciones de formulario

Al pulsar el botón de alternancia, se alternan los objetos de formulario y el panel de funciones.

D. Editor de reglas visuales

El editor de reglas visuales es el área del modo de editor visual de la interfaz de usuario del editor de reglas donde se escriben las reglas. Permite seleccionar un tipo de regla y definir las condiciones y las acciones correspondientes. Al definir condiciones y acciones en una regla, puede arrastrar y soltar objetos y funciones de formulario desde el panel Objetos y funciones de formulario .

Para obtener más información sobre el uso del editor de reglas visuales, consulte Escribir reglas.

E. Conmutador de editores de código visual

Los usuarios del grupo de usuarios avanzados de formularios pueden acceder al editor de código. Para otros usuarios, el editor de código no está disponible. Si tiene los derechos, puede cambiar del modo de editor visual al modo de editor de código del editor de reglas y viceversa, utilizando el conmutador situado justo encima del editor de reglas. Cuando se inicia el editor de reglas por primera vez, se abre en el modo de editor visual. Puede escribir reglas en el modo de editor visual o cambiar al modo de editor de código para escribir una secuencia de comandos de regla. Sin embargo, tenga en cuenta que si modifica una regla o escribe una regla en el editor de código, no puede volver al editor visual para esa regla a menos que borre el editor de código.

AEM Forms rastrea el modo de editor de reglas que utilizó por última vez para escribir una regla. Cuando inicie el editor de reglas la próxima vez, se abrirá en ese modo. Sin embargo, también puede configurar un modo predeterminado para abrir el editor de reglas en el modo especificado. Para ello:

  1. Vaya a AEM consola web en https://[host]:[port]/system/console/configMgr.

  2. Haga clic en para editar Configuración del canal web de formulario adaptable y comunicación interactiva.

  3. elija Editor visual o Editor de código en la lista desplegable Modo predeterminado del Editor de reglas

  4. Haga clic en Guardar.

F. Botones Listo y Cancelar

El botón Listo se utiliza para guardar una regla. Puede guardar una regla incompleta. Sin embargo, los incompletos no son válidos y no se ejecutan. Las reglas guardadas en un objeto de formulario se enumeran cuando se inicia el editor de reglas la próxima vez desde el mismo objeto de formulario. Puede administrar las reglas existentes en esa vista. Para obtener más información, consulte Administrar reglas.

El botón Cancelar descarta los cambios realizados en una regla y cierra el editor de reglas.

Escribir reglas

Puede escribir reglas utilizando el editor visual de reglas o el editor de código. Cuando se inicia el editor de reglas por primera vez, se abre en el modo de editor visual. Puede cambiar al modo de editor de código y escribir reglas. Sin embargo, tenga en cuenta que si escribe o modifica una regla en el editor de código, no puede cambiar al editor visual para esa regla a menos que borre el editor de código. Cuando inicie el editor de reglas la próxima vez, se abrirá en el modo que utilizó por última vez para crear reglas.

Veamos primero cómo escribir reglas utilizando el editor visual.

Uso del editor visual

Vamos a comprender cómo crear una regla en el editor visual utilizando el siguiente formulario de ejemplo.

create-rule-example

La sección Requisitos de préstamo del formulario de solicitud de préstamo de ejemplo requiere que los solicitantes especifiquen su estado civil, su salario y, si están casados, el salario de su cónyuge. En función de las entradas del usuario, la regla calcula la cantidad de idoneidad para el préstamo y se muestra en el campo Elegibilidad del préstamo . Aplique las siguientes reglas para implementar el escenario:

  • El campo Salario del cónyuge sólo se muestra cuando el estado civil está casado.
  • El monto de elegibilidad del préstamo es el 50% del salario total.

Siga estos pasos para escribir reglas:

  1. En primer lugar, escriba la regla para controlar la visibilidad del campo Salario del cónyuge en función de la opción que seleccione el usuario para el botón de opción Estado civil.

    Abra el formulario de solicitud de préstamo en modo de creación. Pulse el componente Estado civil y pulse editar-reglas. A continuación, pulse Crear para iniciar el editor de reglas.

    write-rules-visual-editor-1

    Al iniciar el editor de reglas, la regla Cuando se selecciona de forma predeterminada. Además, el objeto de formulario (en este caso, Estado civil) desde el que se inició el editor de reglas se especifica en la instrucción When .

    Aunque no puede cambiar ni modificar el objeto seleccionado, puede utilizar la lista desplegable de reglas, como se muestra a continuación, para seleccionar otro tipo de regla. Si desea crear una regla en otro objeto, pulse Cancelar para salir del editor de reglas y volver a iniciarla desde el objeto de formulario deseado.

  2. Pulse la lista desplegable Select State y seleccione is equal to. Aparece el campo Enter a String.

    write-rules-visual-editor-2

    En el botón de opción Estado civil, las opciones Casado y Individual se asignan a los valores 0 y 1, respectivamente. Puede verificar los valores asignados en la ficha Título del cuadro de diálogo del botón de opción Editar como se muestra a continuación.

    Valores del botón de radio del editor de reglas

  3. En el campo Enter a String de la regla, especifique 0.

    write-rules-visual-editor-4

    Ha definido la condición como When Marital Status is equal to Married. A continuación, defina la acción que se realizará si esta condición es True.

  4. En la instrucción Then, seleccione Show en la lista desplegable Select Action.

    write-rules-visual-editor-5

  5. Arrastre y suelte el campo Salario del cónyuge de la ficha Objetos del formulario del objeto Soltar o seleccione aquí. También puede pulsar el objeto Drop o seleccionar aquí y seleccionar el campo Spouse Salary en el menú emergente, que enumera todos los objetos de formulario del formulario.

    write-rules-visual-editor-6

    La regla aparece de la siguiente manera en el editor de reglas.

    write-rules-visual-editor-7

    Toque Listo para guardar la regla.

  6. Repita los pasos del 1 al 5 para definir otra regla que oculte el campo Salario del cónyuge si el estado civil es único. La regla aparece de la siguiente manera en el editor de reglas.

    write-rules-visual-editor-8

    NOTA

    Como alternativa, puede escribir una regla Mostrar en el campo Salario del cónyuge, en lugar de dos reglas Cuando en el campo Estado civil, para implementar el mismo comportamiento.

    write-rules-visual-editor-9

  7. A continuación, escriba una regla para calcular el importe de idoneidad para el préstamo, que es el 50% del salario total, y muéstrela en el campo Elegibilidad del préstamo . Para conseguirlo, cree reglas Set value Of en el campo Loan Eligibility .

    En el modo de creación, pulse el campo Elegibilidad de préstamo y pulse editar-reglas. A continuación, pulse Crear para iniciar el editor de reglas.

  8. Seleccione la regla Set Value Of en la lista desplegable de reglas.

    write-rules-visual-editor-10

  9. Pulse Seleccionar opción y seleccione Expresión matemática. Se abre un campo para escribir una expresión matemática.

    write-rules-visual-editor-11

  10. En el campo de expresión:

    • Seleccione o arrastre y suelte desde la ficha Objeto de Forms el campo Salario del primer objeto Soltar o seleccione aquí.
    • Seleccione Plus en el campo Select Operator.
    • Seleccione o arrastre y suelte desde la ficha Objeto de Forms el campo Salario del cónyuge del otro objeto Soltar o seleccione aquí.

    write-rules-visual-editor-12

  11. A continuación, pulse el área resaltada alrededor del campo de expresión y pulse Extend Expression.

    write-rules-visual-editor-13

    En el campo de expresión extendida, seleccione dividido por en el campo Select Operator y Number en el campo Select Option. A continuación, especifique 2 en el campo de número.

    write-rules-visual-editor-14

    NOTA

    Puede crear expresiones complejas utilizando componentes, funciones, expresiones matemáticas y valores de propiedad del campo Seleccionar opción .

    A continuación, cree una condición que, cuando devuelva True, se ejecute la expresión.

  12. Toque Agregar condición para agregar una instrucción When.

    write-rules-visual-editor-15

    En la instrucción When :

    • Seleccione o arrastre y suelte desde la ficha Objeto de Forms el campo Estado civil del primer objeto Soltar o seleccione aquí.
    • Seleccione i s equal to en el campo Select Operator.
    • Seleccione Cadena en el otro objeto Drop o seleccione aquí y especifique Married en el campo Enter a String.

    La regla aparece finalmente de la siguiente manera en el editor de reglas. write-rules-visual-editor-16

    Toque Listo para guardar la regla.

  13. Repita los pasos del 7 al 12 para definir otra regla para calcular la idoneidad del préstamo si el estado civil es único. La regla aparece de la siguiente manera en el editor de reglas.

    write-rules-visual-editor-17

NOTA

También puede utilizar la regla Definir valor de para calcular la idoneidad del préstamo en la regla When que creó para mostrar u ocultar el campo Salario del cónyuge. La regla combinada resultante cuando el estado civil es único aparece de la siguiente manera en el editor de reglas.

Del mismo modo, puede escribir una regla combinada para controlar la visibilidad del campo Salario del cónyuge y calcular la idoneidad del préstamo cuando el estado civil está casado.

write-rules-visual-editor-18

Uso del editor de código

Los usuarios que se agregan al grupo de usuarios con capacidad para formularios pueden utilizar el editor de código. El editor de reglas genera automáticamente el código JavaScript para cualquier regla que cree con el editor visual. Puede cambiar del editor visual al editor de código para ver el código generado. Sin embargo, si modifica el código de regla en el editor de código, no puede volver al editor visual. Si prefiere escribir reglas en el editor de código en lugar de en el editor visual, puede escribir reglas de nuevo en el editor de código. El conmutador de editores de código visual le ayuda a cambiar entre los dos modos.

El editor de código JavaScript es el lenguaje de expresión de los formularios adaptables. Todas las expresiones son expresiones de JavaScript válidas y utilizan API de modelos de secuencias de comandos de formularios adaptables. Estas expresiones devuelven valores de ciertos tipos. Para obtener la lista completa de clases de formularios adaptables, eventos, objetos y API públicas, consulte Referencia de la API de la biblioteca JavaScript para formularios adaptables.

Para obtener más información sobre las directrices para escribir reglas en el editor de código, consulte Expresiones de formulario adaptables.

Mientras escribe código JavaScript en el editor de reglas, las siguientes indicaciones visuales le ayudan con la estructura y la sintaxis:

  • Elementos destacados de sintaxis
  • Sangría automática
  • Sugerencias y sugerencias para objetos de formulario, funciones y sus propiedades
  • Finalización automática de nombres de componentes de formulario y funciones comunes de JavaScript

javascriptruleeditor

Funciones personalizadas en el editor de reglas

Aparte de las funciones integradas como *Sum of, *que se enumeran en Salida de funciones, puede escribir funciones personalizadas que necesite con frecuencia. Asegúrese de que la función que escriba esté acompañada por el jsdoc situado encima de ella.

Se requiere jsdoc que acompaña:

  • Si desea una configuración y descripción personalizadas.
  • Dado que hay varias formas de declarar una función en JavaScript, y los comentarios permiten realizar un seguimiento de las funciones.

Para obtener más información, consulte usejsdoc.org.

Etiquetas jsdoc compatibles:

  • Privado

    Sintaxis: @private

    Una función privada no se incluye como función personalizada.

  • Nombre

    Sintaxis: @name funcName <Function Name>

    Como alternativa , puede utilizar: @function funcName <Function Name> o @func funcName <Function Name>.

    funcName es el nombre de la función (no se permiten espacios).

    <Function Name> es el nombre para mostrar de la función.

  • Miembro

    Sintaxis: @memberof namespace

    Adjunta un área de nombres a la función .

  • Parámetro

    Sintaxis: @param {type} name <Parameter Description>

    También puede utilizar: @argument {type} name <Parameter Description> o @arg {type} name <Parameter Description>.

    Muestra los parámetros utilizados por la función . Una función puede tener varias etiquetas de parámetro, una etiqueta para cada parámetro en el orden de incidencia.

    {type} representa el tipo de parámetro. Los tipos de parámetros permitidos son:

    1. Cadena
    2. número
    3. boolean

    Todos los demás tipos de parámetros se categorizan bajo uno de los anteriores. Ninguno no es compatible. Asegúrese de seleccionar uno de los tipos anteriores. Los tipos no distinguen entre mayúsculas y minúsculas. No se permiten espacios en el parámetro name. <Parameter Descrption>

  • Tipo de devolución

    Sintaxis: @return {type}

    Como alternativa, puede utilizar @returns {type}.

    Agrega información sobre la función, como su objetivo.

    {type} representa el tipo devuelto de la función. Los tipos de devolución permitidos son:

    1. Cadena
    2. número
    3. booleano
    4. date
    5. matriz

    Todos los demás tipos de devolución se clasifican en uno de los anteriores. Ninguno no es compatible. Asegúrese de seleccionar uno de los tipos anteriores. Los tipos de devolución no distinguen entre mayúsculas y minúsculas.

NOTA

Los comentarios antes de la función personalizada se utilizan como resumen. El resumen puede extenderse a varias líneas hasta que se encuentre una etiqueta. Limite el tamaño a un único para ver una descripción concisa en el generador de reglas.

Adición de una función personalizada

Por ejemplo, desea agregar una función personalizada que calcule el área de un cuadrado. La longitud lateral es la entrada del usuario a la función personalizada, que se acepta mediante un cuadro numérico en el formulario. El resultado calculado se muestra en otro cuadro numérico del formulario. Para agregar una función personalizada, primero debe crear una biblioteca de cliente y luego agregarla al repositorio CRX.

Realice los siguientes pasos para crear una biblioteca de cliente y agregarla en el repositorio CRX.

  1. Cree una biblioteca de cliente. Para obtener más información, consulte Uso de bibliotecas del lado del cliente.

  2. En CRXDE, agregue una propiedad categoriescon un valor de tipo cadena como customfunction a la carpeta clientlib.

    NOTA

    customfunctiones una categoría de ejemplo. Puede elegir cualquier nombre para la categoría que cree en la carpeta clientlib.

Después de agregar la biblioteca de cliente en el repositorio CRX, utilícela en su formulario adaptable. Permite utilizar la función personalizada como regla en el formulario. Realice los siguientes pasos para agregar la biblioteca de cliente en el formulario adaptable.

  1. Abra el formulario en modo de edición.

    Para abrir un formulario en modo de edición, seleccione un formulario y pulse Abrir.

  2. En el modo de edición, seleccione un componente, pulse nivel de campo > Contenedor de formulario adaptable y, a continuación, pulse cmppr.

  3. En la barra lateral, bajo Nombre de la biblioteca de cliente, agregue la biblioteca de cliente. ( customfunction en el ejemplo.)

    Adición de la biblioteca de cliente de funciones personalizada

  4. Seleccione el cuadro numérico de entrada y pulse edit-rules para abrir el editor de reglas.

  5. Puntee Crear regla. Con las opciones que se muestran a continuación, cree una regla para guardar el valor al cuadrado de la entrada en el campo Output del formulario.
    Uso de funciones personalizadas para crear una reglaPulse Listo. Se agrega la función personalizada.

Tipos admitidos para la declaración de funciones

Instrucción de función

function area(len) {
    return len*len;
}

Esta función se incluye sin jsdoc comentarios.

Expresión de función

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

Expresión de función y declaración

var b={};
/** */
b.area = function(len) {
    return len*len;
}

Declaración de función como variable

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

Limitación: la función personalizada selecciona solo la primera declaración de función de la lista de variables, si está junto. Puede utilizar la expresión de función para cada función declarada.

Declaración de función como objeto

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};
NOTA

Asegúrese de utilizar jsdoc para cada función personalizada. Aunque se recomiendan los jsdoccomentarios, incluya un comentario vacío jsdocpara marcar su función como función personalizada. Permite la gestión predeterminada de la función personalizada.

Administrar reglas

Cualquier regla existente en un objeto de formulario aparece enumerada cuando toca el objeto y toca edit-rules1. Puede ver el título y una vista previa del resumen de la regla. Además, la interfaz de usuario le permite expandir y ver el resumen completo de la regla, cambiar el orden de las reglas, editar las reglas y eliminarlas.

list-rules

Puede realizar las siguientes acciones en reglas:

  • Expandir/Contraer: La columna Contenido de la lista de reglas muestra el contenido de las reglas. Si todo el contenido de la regla no está visible en la vista predeterminada, pulse expand-rule-content para expandirlo.

  • Reordenar: Cualquier regla nueva que cree se apilará en la parte inferior de la lista de reglas. Las reglas se ejecutan de arriba a abajo. La regla de la parte superior se ejecuta primero seguida de otras reglas del mismo tipo. Por ejemplo, si tiene las reglas When, Show, Enable y When en las posiciones primera, segunda, tercera y cuarta desde la parte superior, respectivamente, la regla When en la parte superior se ejecuta primero seguida de la regla When en la cuarta posición. A continuación, se ejecutarán las reglas Mostrar y Activar .

    Para cambiar el orden de una regla, toque sort-rules en su lugar o arrástrela al orden deseado en la lista.

  • Editar: Para editar una regla, active la casilla de verificación situada junto al título de la regla. Aparecerán opciones adicionales para editar y eliminar la regla. Pulse Editar para abrir la regla seleccionada en el editor de reglas en modo visual o editor de código, según el modo utilizado para crear la regla.

  • Eliminar: Para eliminar una regla, selecciónela y pulse Eliminar.

  • Habilitar/Deshabilitar: Es posible que tenga que suspender temporalmente el uso de una regla. Puede seleccionar una o varias reglas y pulsar Deshabilitar en la barra de herramientas Acciones para desactivarlas. Si una regla está deshabilitada, no se ejecuta en tiempo de ejecución. Para habilitar una regla que esté deshabilitada, puede seleccionarla y pulsar Habilitar en la barra de herramientas de acciones. La columna de estado de la regla muestra si la regla está activada o desactivada.

disablerule

Copiar y pegar reglas

Puede copiar y pegar una regla de un campo a otros campos similares para ahorrar tiempo.

Para copiar y pegar reglas, haga lo siguiente:

  1. Pulse el objeto de formulario desde el que desea copiar una regla y, en la barra de herramientas de componentes, pulse editar. La interfaz de usuario del editor de reglas aparece con el objeto de formulario seleccionado y aparecen las reglas existentes.

    copyrule

    Para obtener información sobre la administración de reglas existentes, consulte Administrar reglas.

  2. Seleccione la casilla de verificación situada junto al título de la regla. Aparecen opciones adicionales para administrar la regla. Pulse Copiar.

    copyrule2

  3. Seleccione otro objeto de formulario al que desee pegar la regla y pulse Pegar. Además, puede editar la regla para realizar cambios en ella.

    NOTA

    Puede pegar una regla en otro objeto de formulario sólo si dicho objeto de formulario admite el suceso de regla copiada. Por ejemplo, un botón admite el suceso click. Puede pegar una regla con un suceso click en un botón, pero no en una casilla de verificación.

  4. Toque Listo para guardar la regla.

Expresiones anidadas

El editor de reglas permite utilizar varios operadores Y y O para crear reglas anidadas. Puede combinar varios operadores AND y OR en las reglas.

A continuación se muestra un ejemplo de una regla anidada que muestra un mensaje al usuario sobre la elegibilidad para la custodia de un niño cuando se cumplen las condiciones requeridas.

expresión de complejos

También puede arrastrar y soltar condiciones dentro de una regla para editarla. Toque y pase el ratón sobre el controlador ( handle) antes de una condición. Una vez que el puntero se convierta en el símbolo de mano como se muestra a continuación, arrastre y suelte la condición en cualquier lugar dentro de la regla. La estructura de reglas cambia.

arrastrar y soltar

Condiciones de expresión de fecha

El editor de reglas permite usar comparaciones de fechas para crear condiciones.

A continuación se muestra un ejemplo de condición que muestra un objeto de texto estático si la hipoteca de la casa ya se ha tomado, lo que el usuario significa rellenando el campo de fecha.

Cuando la fecha de hipoteca de la propiedad tal como la ha rellenado el usuario es anterior, el formulario adaptable muestra una nota sobre el cálculo de ingresos. La siguiente regla compara la fecha rellenada por el usuario con la fecha actual y si la fecha rellenada por el usuario es anterior a la fecha actual, el formulario muestra el mensaje de texto (denominada Ingresos).

dateexpressioncondition

Cuando la fecha de rellenado es anterior a la fecha actual, el formulario muestra el mensaje de texto (Ingresos) de la siguiente manera:

dateexpressionconditionmet

Condiciones de comparación de número

El editor de reglas permite crear condiciones que comparen dos números.

A continuación se muestra un ejemplo de condición que muestra un objeto de texto estático si el número de meses que un solicitante permanece en su dirección actual es menor de 36.

number ercomparisoncondition

Cuando el usuario indica que ha estado viviendo en su dirección residencial actual durante menos de 36 meses, el formulario muestra una notificación de que se puede solicitar una prueba de residencia adicional.

additional-proofrequested

Impacto del editor de reglas en scripts existentes

En las versiones de AEM Forms anteriores a AEM 6.1 Forms feature pack 1, los autores y desarrolladores de formularios solían escribir expresiones en la pestaña Scripts del cuadro de diálogo Editar componente para añadir el comportamiento dinámico a los formularios adaptables. La pestaña Scripts ahora se reemplaza con el editor de reglas.

Cualquier secuencia de comandos o expresión que deba haber escrito en la ficha Scripts está disponible en el editor de reglas. Aunque no se pueden ver ni editar en el editor visual, si forma parte del grupo de usuarios avanzados de formularios, puede editar secuencias de comandos en el editor de código.

Reglas de ejemplo

Invocar el servicio del modelo de datos de formulario

Considere un servicio web GetInterestRates que toma la cantidad del préstamo, la tenencia y la calificación crediticia del solicitante como entrada y devuelve un plan de préstamo que incluye la cantidad del IME y la tasa de interés. Puede crear un modelo de datos de formulario utilizando el servicio web como origen de datos. Los objetos del modelo de datos se agregan y el servicio get se agrega al modelo de formulario. El servicio aparece en la ficha Servicios del modelo de datos de formulario. A continuación, cree un formulario adaptable que incluya campos de objetos del modelo de datos para capturar entradas del usuario para la cantidad de préstamo, la tenencia y la puntuación de crédito. Agregue un botón que déclencheur el servicio web para obtener detalles del plan. La salida se rellena en los campos adecuados.

La siguiente regla muestra cómo configurará la acción Invocar servicio para que se realice el escenario de ejemplo.

example-invoke-services

Activación de varias acciones mediante la regla Cuando

En un formulario de solicitud de préstamo, se desea capturar si el solicitante del préstamo es o no un cliente existente. En función de la información que proporcione el usuario, el campo ID de cliente debería mostrarse u ocultarse. Además, desea centrarse en el campo ID del cliente si el usuario es un cliente existente. El formulario de solicitud de préstamo tiene los siguientes componentes:

  • Un botón de opción, ¿Es cliente de Geometrixx existente?, que proporciona las opciones Sí y No. El valor de Yes es 0 y No es 1.

  • Un campo de texto, ID de cliente de Geometrixx, para especificar el ID de cliente.

Cuando escriba una regla When en el botón de radio para implementar este comportamiento, la regla aparecerá de la siguiente manera en el editor de reglas visuales. when-rule-example

En la regla de ejemplo, la instrucción de la sección When es la condición que, cuando devuelve True, ejecuta las acciones especificadas en la sección Then.

La regla aparece de la siguiente manera en el editor de código.

when-rule-example-code

Uso de una salida de función en una regla

En un formulario de orden de compra, tiene la siguiente tabla, en la que los usuarios rellenarán sus pedidos. En esta tabla:

  • La primera fila es repetible, por lo que los usuarios pueden solicitar varios productos y especificar cantidades diferentes. Su nombre de elemento es Row1.
  • El título de la celda de la columna Cantidad de producto de la fila repetible es Cantidad. El nombre de elemento para esta celda es productquantity.
  • La segunda fila de la tabla es no repetible y el título de la celda de la columna Cantidad de producto de esta fila es Cantidad total.

example-function-table

A. Fila1 B. Cantidad C. Cantidad total

Ahora, desea agregar cantidades especificadas en la columna Cantidad de producto para todos los productos y mostrar la suma en la celda Cantidad total. Puede conseguirlo escribiendo una regla de valor definido en la celda Cantidad total como se muestra a continuación.

example-function-output

example-function-output-code

Validación de un valor de campo mediante la expresión

En el formulario de orden de compra que se explica en el ejemplo anterior, se desea restringir el pedido de más de una cantidad de cualquier producto cuyo precio sea superior a 10000. Para ello, puede escribir una regla de validación como se muestra a continuación.

example-validate

example-validate-code

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now