[AEM Forms]{class="badge positive" title="van toepassing op AEM Forms)."}

Een aangepaste functie maken voor een adaptief formulier op basis van kerncomponenten

Adaptieve Forms op basis van Core Components biedt een dynamische gebruikerservaring door de inhoud en het gedrag aan te passen op basis van de gebruikersinvoer. Met aangepaste functies kunnen ontwikkelaars hun functionaliteit uitbreiden, zodat formulieren aan specifieke vereisten voldoen. Door douanefuncties te integreren, kunnen de ontwikkelaars complexe logica uitvoeren, processen automatiseren, en unieke interactie introduceren die zich op specifieke bedrijfsvereisten of gebruikersverwachtingen richten. Het zorgt ervoor dat de formulieren niet alleen worden aangepast aan uiteenlopende omstandigheden, maar ook een preciezere en effectievere oplossing bieden voor verschillende gebruiksgevallen.
Dit artikel begeleidt u door de stappen voor het maken van aangepaste functies voor Adaptive Forms met behulp van kerncomponenten.

Overwegingen

Vereisten om een aangepaste functie te maken

Voordat u een aangepaste functie toevoegt aan de Adaptive Forms, moet u het volgende doen:

Software:

Een aangepaste functie maken

Creeer een cliëntbibliotheek om douanefuncties in de regelredacteur te roepen. Voor meer informatie, zie ​ Gebruikend cliënt-Kant Bibliotheken ​.

Stappen voor het maken van aangepaste functies zijn:

Een clientbibliotheek maken create-client-library

U kunt aangepaste functies toevoegen door een clientbibliotheek toe te voegen. Voer de volgende stappen uit om een clientbibliotheek te maken:

Kloon de Bewaarplaats

Kloon uw ​ Bewaarplaats van AEM Forms as a Cloud Service ​:

Met deze opdracht downloadt u de opslagplaats en maakt u een lokale map van de gekloonde opslagplaats op uw computer. Door deze gids, verwijzen wij naar deze omslag als [ AEMaaCS projectfolder ].

voeg een Omslag van de Bibliotheek van de Cliënt toe

Om nieuwe omslag van de cliëntbibliotheek aan de [ AEMaaCS projectfolder ] toe te voegen, volg deze stappen:

voegt dossiers en omslagen aan de omslag van de Bibliotheek van de Cliënt toe

Voeg het volgende toe aan de toegevoegde omslag van de cliëntbibliotheek:

Location is: [AEMaaCS project directory]/ui.apps/src/main/content/jcr_root/apps/experience-league/customclientlibs/

omvat de nieuwe omslag in filter.xml:

stel de pas gecreëerde de bibliotheekomslag van de Cliënt aan uw milieu van AEM op

Stel AEM as a Cloud Service, [ AEMaaCS projectfolder ], aan uw milieu van Cloud Service op. Distribueren naar uw Cloud Service-omgeving:

Als u niet reeds opstelling een pijpleiding hebt, verwijs naar de gids op ​ hoe te opstelling een pijpleiding voor AEM Forms as a Cloud Service ​.

Zodra de pijpleiding met succes wordt uitgevoerd, wordt de douanefunctie die in de cliëntbibliotheek wordt toegevoegd beschikbaar in uw ​ Aangepaste redacteur van de Regel van de Vorm ​.

Clientbibliotheek toevoegen aan een adaptief formulier use-custom-function

Zodra u de clientbibliotheek hebt geïmplementeerd in uw Forms CS-omgeving, gebruikt u de mogelijkheden van de clientbibliotheek in uw adaptieve formulier. De clientbibliotheek toevoegen aan uw adaptieve formulier

U kunt de douanefunctie in de ​ regelredacteur van een Aangepaste Vorm ​ gebruiken gebruikend de ​ annotaties van JavaScript ​.

Een aangepaste functie gebruiken in een adaptief formulier

In een AanpassingsVorm, kunt u ​ douanefuncties binnen de regelredacteur ​ gebruiken. Voeg de volgende code toe aan het JavaScript-bestand (Function.js ) om de leeftijd te berekenen op basis van de geboortedatum (JJJJ-MM-DD). Maak een aangepaste functie als calculateAge() die de geboortedatum als invoer neemt en de leeftijd retourneert:

    /**
        * Calculates Age
        * @name calculateAge
        * @param {object} field
        * @return {string}
    */

    function calculateAge(field) {
    var dob = new Date(field);
    var now = new Date();

    var age = now.getFullYear() - dob.getFullYear();
    var monthDiff = now.getMonth() - dob.getMonth();

    if (monthDiff < 0 || (monthDiff === 0 && now.getDate() < dob.getDate())) {
    age--;
    }

    return age;
    }

In het bovenstaande voorbeeld wordt de aangepaste functie calculateAge aangeroepen en wordt de leeftijd geretourneerd wanneer de gebruiker de geboortedatum in de notatie invoert (JJJJ-MM-DD).

Bekijk een voorbeeld van het formulier om te zien hoe de aangepaste functies worden geïmplementeerd via de regeleditor:

Functies van Aangepaste functies

Aangepaste functies in AEM-formulieren bieden een robuuste oplossing voor het uitbreiden en aanpassen van de functionaliteit van uw formulieren. U kunt de aangepaste functies gebruiken om aan de specifieke behoeften van uw organisatie te voldoen.

Deze functies ondersteunen diverse mogelijkheden, zoals het werken met specifieke gebieden, het gebruiken van globale gebieden, en asynchrone verrichtingen, evenals het opnemen van caching mechanismen. Dankzij deze flexibiliteit kunnen formulieren zich aanpassen aan complexe vereisten en een efficiënte, op maat gemaakte gebruikerservaring bieden. Door gebruik te maken van deze geavanceerde functies kunt u de interactie van formulieren verbeteren en de prestaties optimaliseren, zodat uw AEM-formulieren zowel functioneler als responsiever worden.

Laten we eens kijken naar de functies van aangepaste functies.

Asynchrone ondersteuning in aangepaste functies support-of-async-functions

U kunt asynchrone functies in de regelredacteur uitvoeren gebruikend douanefuncties. Voor begeleiding op hoe te om dit te doen, verwijs naar het artikel ​ Gebruikend asynchrone functies in een AanpassingsVorm ​.

Veld- en globale bereikobjecten ondersteunen aangepaste functies support-field-and-global-objects

Veldobjecten verwijzen naar de afzonderlijke componenten of elementen in een formulier, zoals tekstvelden, selectievakjes. Het object Globals bevat alleen-lezen variabelen, zoals formulierinstantie, doelveldinstantie en methoden voor het uitvoeren van formulierwijzigingen binnen aangepaste functies.

Voor meer informatie over werkingsgebiedvoorwerpen, zie de ​ voorwerpen van het Toepassingsgebied in douanefuncties ​ artikel.

Ondersteuning voor caching in aangepaste functies

De adaptieve Forms voert caching voor douanefuncties uit om reactietijd te verbeteren terwijl het terugwinnen van de lijst van de douanefunctie in de regelredacteur. Er verschijnt een bericht als Fetched following custom functions list from cache in het error.log -bestand.

Als de aangepaste functies worden gewijzigd, wordt het in cache plaatsen ongeldig en wordt het geparseerd.

Problemen oplossen

Volgende stap

Laat ons nu diverse ​ voorbeelden van douanefuncties voor een Aangepaste Vorm zien die op de Componenten van de Kern ​ wordt gebaseerd.

Zie ook