Anpassade funktioner i Adaptive Forms (Core Components)

Introduktion

I AEM Forms 6.5 introducerades möjligheten att definiera JavaScript-funktioner som kan användas för att definiera komplexa affärsregler med regelredigeraren. AEM Forms har ett antal anpassade funktioner som du kan använda, men du måste definiera egna funktioner och använda dem i flera formulär.

Med de anpassade funktionerna kan man bättre hantera blanketterna genom att underlätta hanteringen och bearbetningen av inmatade data. De möjliggör också dynamisk ändring av formulärbeteende baserat på fördefinierade kriterier.
I Adaptiv Forms kan du använda anpassade funktioner i regelredigerare för ett anpassat formulär för att skapa specifika valideringsregler för formulärfält.
Låt oss förstå hur den anpassade funktionen används där användare anger e-postadressen och du vill se till att den angivna e-postadressen har ett visst format (den innehåller symbolen"@" och ett domännamn). Skapa en anpassad funktion som"ValidateEmail", som tar e-postadressen som indata och returnerar true om den är giltig och i annat fall false.

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

I ovanstående exempel anropas den anpassade funktionen "ValidateEmail" för att kontrollera om den angivna e-postadressen är giltig när användaren försöker skicka formuläret.

Användning av anpassade funktioner uses-of-custom-function

Fördelarna med att använda anpassade funktioner i Adaptive Forms är:

JS-anteckningar som stöds

Se till att den anpassade funktionen som du skriver åtföljs av jsdoc ovan, om du behöver en anpassad konfiguration och beskrivning. Det finns flera sätt att deklarera en funktion i JavaScript, och kommentarer gör att du kan hålla reda på funktionerna. Mer information finns i usejsdoc.org.

Stöds jsdoc taggar:

Typer som stöds för funktionsdeklaration function-declaration-supported-types

Funktionssats

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

Den här funktionen ingår utan jsdoc kommentarer.

Funktionsuttryck

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

Funktionsuttryck och -programsats

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

Funktionsdeklaration som variabel

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

Begränsning: den anpassade funktionen väljer bara den första funktionsdeklarationen från variabellistan, om den används tillsammans. Du kan använda funktionsuttryck för varje deklarerad funktion.

Funktionsdeklaration som objekt

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

Skapa anpassad funktion create-custom-function

Så här skapar du en anpassad funktion:

Du kan se följande anpassad funktion mapp. Hämta och installera den här mappen i AEM.

Nu kan du använda den anpassade funktionen i ditt adaptiva formulär genom att lägga till klientbiblioteket.

Lägga till klientbibliotek i ett adaptivt formulär use-custom-function

När du har distribuerat klientbiblioteket till Forms CS-miljön kan du använda funktionerna i ditt adaptiva formulär. Lägga till klientbiblioteket i ditt adaptiva formulär

Nu kan du skapa en regel som använder anpassade funktioner i regelredigeraren:

Nu ska vi förstå hur man konfigurerar och använder en anpassad funktion med Regelredigerarens anropstjänst i AEM Forms.