Funciones personalizadas en Forms adaptable (componentes principales)

Introducción

AEM Forms 6.5 ha introducido la capacidad de definir las funciones de JavaScript que se pueden utilizar para definir reglas comerciales complejas mediante el editor de reglas. AEM Forms proporciona varias de estas funciones personalizadas de forma predeterminada, pero tendrá que definir sus propias funciones personalizadas y utilizarlas en varios formularios.

Las funciones personalizadas amplían las capacidades de los formularios al facilitar la manipulación y el procesamiento de los datos introducidos para satisfacer requisitos específicos. También permiten la modificación dinámica del comportamiento del formulario en función de criterios predefinidos.
En Forms adaptable, puede usar funciones personalizadas dentro del editor de reglas de un formulario adaptable para crear reglas de validación específicas para los campos del formulario.
Comprendamos el uso de la función personalizada en la que los usuarios escriben la dirección de correo electrónico y desea asegurarse de que la dirección de correo electrónico introducida sigue un formato específico (contiene un símbolo "@" y un nombre de dominio). Cree una función personalizada como "ValidateEmail" que tome la dirección de correo electrónico como entrada y devuelva el valor "True" si es válido y el valor "False" en caso contrario.

function ValidateEmail(inputText)
{
    var email = /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$/;
    if(inputText.value.match(email))
        {
            alert("Valid email address!");
            return true;
        }
    else
    {
        alert("Invalid email address!");
        return false;
    }
}

En el ejemplo anterior, cuando el usuario intenta enviar el formulario, se invoca la función personalizada "ValidateEmail" para comprobar si la dirección de correo electrónico introducida es válida.

Usos de las funciones personalizadas uses-of-custom-function

Las ventajas de utilizar funciones personalizadas en Forms adaptable son:

Anotaciones JS admitidas

Asegúrese de que la función personalizada que escriba esté acompañada de jsdoc encima, en caso de que necesite una configuración y descripción personalizadas. Existen 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:

Tipos admitidos para la declaración de funciones function-declaration-supported-types

Instrucción de función

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

Esta función se incluye sin comentarios jsdoc.

Expresión de función

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

Instrucción y expresión de funció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án juntas. 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;
        }
    }
};

Crear función personalizada create-custom-function

Para crear una función personalizada, realice los siguientes pasos:

Puede hacer referencia a la carpeta función personalizada siguiente. AEM Descargue e instale esta carpeta en su instancia de.

Ahora puede utilizar la función personalizada en el formulario adaptable agregando la biblioteca de cliente.

Agregar una biblioteca de cliente en un formulario adaptable use-custom-function

Una vez que haya implementado la biblioteca de cliente en el entorno de Forms CS, utilice sus funcionalidades en el formulario adaptable. Para agregar la biblioteca de cliente en el formulario adaptable

Ahora puede crear una regla para utilizar funciones personalizadas en el editor de reglas:

Ahora, vamos a entender cómo configurar y utilizar una función personalizada usando el servicio Invocar del Editor de reglas en AEM Forms.