Adaptiva formuläruttryck adaptive-form-expressions

Adobe rekommenderar att man använder modern och utbyggbar datainhämtning Kärnkomponenterfor skapa ny Adaptive Formseller lägga till adaptiv Forms på AEM Sites-sidor. De här komponenterna utgör ett betydande framsteg när det gäller att skapa adaptiva Forms-filer, vilket ger imponerande användarupplevelser. I den här artikeln beskrivs det äldre sättet att skapa Adaptiv Forms med baskomponenter.

Anpassningsbara formulär ger optimerad och förenklad formulärifyllning för slutanvändare med dynamiska skriptfunktioner. Det gör att du kan skriva uttryck för att lägga till olika beteenden, till exempel dynamiska fält och paneler för att visa/dölja. Du kan också lägga till beräknade fält, skrivskydda fält, lägga till valideringslogik och mycket annat. Det dynamiska beteendet baseras på användarens indata eller förifyllda data.

JavaScript är uttrycksspråket i adaptiva formulär. Alla uttryck är giltiga JavaScript-uttryck och använder API:er för adaptiva formulär. Dessa uttryck returnerar värden av vissa typer. En fullständig lista över adaptiva formulärklasser, händelser, objekt och offentliga API:er finns på JavaScript Library API-referens för adaptiva formulär.

Bästa tillvägagångssätt för att skriva uttryck best-practices-for-writing-expressions

  • När du skriver uttryck kan du använda namnet på fältet eller panelen för att komma åt fält och paneler. Använd egenskapen value om du vill komma åt ett fälts värde. Exempel: field1.value
  • Använd unika namn för fält och paneler i hela formuläret. Det hjälper till att undvika eventuella konflikter med fältnamn som används när uttryck skrivs.
  • När du skriver flerradsuttryck kan du använda ett semikolon för att avsluta en -programsats.

Metodtips för uttryck som innehåller en upprepande panel best-practices-for-expressions-involving-repeating-panel

Upprepade paneler är instanser av en panel som läggs till eller tas bort dynamiskt med skript-API eller förifyllda data. Mer information om hur du använder en upprepande panel finns i skapa formulär med repeterbara avsnitt.

  • Om du vill skapa en upprepande panel öppnar du inställningarna i paneldialogrutan och anger värdet för fältet för högsta antal till mer än 1.

  • Minsta antal för upprepade panelinställningar kan vara en eller flera, men det får inte vara fler än högsta antal.

  • När ett uttryck refererar till ett fält med upprepande panel tolkas fältnamnen i uttrycket som det närmaste upprepade elementet.

  • Adaptiva formulär har några specialfunktioner som förenklar beräkning av repeterbara paneler som summa, antal, min, max, filter och många andra. En fullständig lista över funktioner finns i API-referens för JavaScript-bibliotek för adaptiva formulär

  • API:er för manipulering av instanser av upprepande panel är:

    • Så här lägger du till en panelinstans: panel1.instanceManager.addInstance()
    • Så här hämtar du en panel: panel1.instanceIndex
    • Så här hämtar du instanceManager för en panel: _panel1 or panel1.instanceManager
    • Så här tar du bort en instans av en panel: _panel1.removeInstance(panel1.instanceIndex)

Uttryckstyper expression-types

I anpassningsbara formulär kan du skriva uttryck för att lägga till beteenden som dynamiska visa/dölj-fält och paneler. Du kan också skriva uttryck för att lägga till beräknade fält, skrivskydda fält, valideringslogik och mycket annat. Adaptiva formulär har stöd för följande uttryck:

Åtkomstuttryck (aktiveringsuttryck) access-expression-enablement-expression

Du kan använda åtkomstuttrycket för att aktivera eller inaktivera ett fält. Om uttrycket använder ett fältvärde hämtas uttrycket när fältets värde ändras.

Gäller för: fält

Returtyp: Uttrycket returnerar ett booleskt värde som representerar om fältet är aktiverat eller inaktiverat. true visar att fältet är aktiverat och false representerar att fältet är inaktiverat.

Exempel: Om du bara vill aktivera ett fält när värdet för fält1 är inställd på X, är åtkomstuttrycket: field1.value == "X"

Beräkna uttryck calculate-expression

Beräkningsuttrycket används för att automatiskt beräkna värdet för ett fält med hjälp av ett uttryck. Vanligtvis används egenskapen value för andra fält i ett sådant uttryck. Till exempel: field2.value + field3.value. När värdet för field2eller field3ändras, uttrycket hämtas och värdet beräknas om.

Gäller för: fält

Returtyp: Uttrycket returnerar ett värde som är kompatibelt med det fält där uttrycksresultatet visas (till exempel decimal).

Exempel: Det beräkningsuttryck som ska visa summan av två fält i fält1 är:
field2.value + field3.value

Klicka på uttryck click-expression

Klickuttrycket hanterar de åtgärder som utförs på en knapps klickningshändelse. I GuideBridge finns API:er för att utföra olika funktioner som skicka, validera som används tillsammans med klickuttrycket. En fullständig lista över API:erna finns i GuideBridge API:er.

Gäller för: Knappfält

Returtyp: Klickuttrycket returnerar inget värde. Om något uttryck returnerar ett värde ignoreras värdet.

Exempel: Fylla i en textruta textbox1 på klickåtgärden för en knapp med värde AEM Forms, knappens klickuttryck är textbox1.value="AEM Forms"

Initieringsskript initialization-script

Initieringsskriptet aktiveras när ett anpassat formulär initieras. Beroende på scenarier fungerar initieringsskriptet på följande sätt:

  • När ett anpassat formulär återges utan förifyllning av data körs initieringsskriptet efter att formuläret har initierats.
  • När ett anpassat formulär återges med en dataförifyllning körs skriptet när förifyllningen har slutförts.
  • När serverbaserad omvalidering av ett adaptivt formulär utlöses körs initieringsskriptet.

Gäller för: fält och panel

Returtyp: Initieringsskriptuttrycket returnerar inget värde. Om något uttryck returnerar ett värde ignoreras värdet.

Exempel: Om du vill fylla i fält med standardvärden i ett datafrifyllningsscenario 'Adaptive Forms' När värdet sparas som null är initieringsskriptuttrycket:
if(this.value==null) this.value='Adaptive Forms';

Alternativuttryck options-expression

Alternativuttrycket används för att dynamiskt fylla i alternativ för ett nedrullningsbart listfält.

Gäller för: nedrullningsbara listfält

Returtyp: Alternativuttrycket returnerar en array med strängvärden. Varje värde kan vara en enkel sträng, till exempel Man eller i ett nyckel=värde-par, t.ex. 1=Man

Exempel: Om du vill fylla i ett fältvärde, baserat på värdet i ett annat fält, anger du ett enkelt alternativuttryck. Om du till exempel vill fylla i ett fält Antal barn, baserat på Civilstånd Uttryckt i ett annat fält är uttrycket:

marital_status.value == "married" ? ["1=One", "2=two"] : ["0=Zero"].

När värdet för marital_status fältändringar, hämtas uttrycket. Du kan också fylla i listrutan från en REST-tjänst. Mer information finns i Dynamiskt ifyllbara listrutor.

Sammanfattningsuttryck summary

Uttrycket Sammanfattning beräknar dynamiskt titeln på en underordnad panel i en dragspelslayoutpanel. Du kan ange uttrycket Sammanfattning i en regel som använder ett formulärfält eller en anpassad logik för att utvärdera titeln. Uttrycket körs när formuläret initieras. Om du förifyller ett formulär körs uttrycket efter att data har fyllts i i förväg eller när värdet för beroende fält som används i uttrycket ändras.

Sammanfattningsuttrycket används vanligtvis för att upprepa underordnade objekt i en dragspelslayoutpanel för att ge varje underordnad panel en meningsfull rubrik.

Gäller för: Paneler som är direkt underordnade en panel vars layout är konfigurerad som dragspelspanel.

Returtyp: Uttrycket returnerar en sträng som blir dragspelets titel.

Exempel: "Kontonummer: " + texbox1.value

Validera uttryck validate-expression

Validate-uttrycket används för att validera fälten med det angivna uttrycket. Vanligtvis använder sådana uttryck reguljära uttryck tillsammans med fältvärdet för att validera ett fält. Uttrycket återställs och fältets valideringsstatus beräknas om vid en ändring av ett fälts värde.

Gäller för: fält

Returtyp: Uttrycket returnerar ett booleskt värde som representerar fältets valideringsstatus. Värdet false visar att fältet är ogiltigt och true visar att fältet är giltigt.
Exempel: För ett fält som representerar postnummer för Storbritannien är valideringsuttrycket:

(this.value && this.value.match(/^(GIR 0AA|[A-Z]{1,2}\d[A-Z0-9]? ?[0-9][A-Z]{2}\s*)$/i) == null) ? false : true

I ovanstående exempel returneras uttrycket om det icke-tomma värdet inte matchar mönstret false för att ange att fältet inte är giltigt.

NOTE
Om du skriver ett valideringsuttryck för ett icke-obligatoriskt eller obligatoriskt fält utvärderas uttrycket oavsett fältets synlighetsstatus. Om du vill stoppa valideringen för de dolda fälten anger du egenskapen validationsDisabled i Initialization eller Value Commit Script till true. Exempel: this.validationsDisabled=true

Värde för implementeringsskript value-commit-script

Skriptet Värde implementeras aktiveras när:

  • En användare ändrar värdet för ett fält från användargränssnittet.
  • Värdet för ett fält ändras programmatiskt på grund av ändringar i ett annat fält.

Gäller för: fält

Returtyp: Värdet för implementeringsskriptuttrycket returnerar inget värde. Om något uttryck returnerar ett värde ignoreras värdet.

Exempel: Om du vill konvertera de alfabet som anges i fältet till versaler vid implementering, är värdet för implementeringsuttryck:
this.value=this.value.toUpperCase()

NOTE
Du kan inaktivera körningen av Value Commit Script när värdet för ett fält ändras programmatiskt. Gå till https://'[server]:[port]'/system/console/configMgr och change Adaptiv Forms-version för kompatibilitet till AEM Forms 6.1. Därefter körs Value Commit Script bara när användaren ändrar fältets värde från användargränssnittet.

Synlighetsuttryck visibility-expression

Synlighetsuttrycket används för att styra synligheten för fält/panel. Synlighetsuttrycket använder vanligtvis värdeegenskapen för ett fält och hämtas när värdet ändras.

Gäller för: fält och panel

Returtyp: Uttrycket returnerar ett booleskt värde som representerar att fältet/panelen är synlig eller inte. false visar att fältet eller panelen inte är synlig och att true anger att fältet eller panelen är synlig.

Exempel: För en panel som bara visas om värdet för fält1 är inställd på Man ​är synlighetsuttrycket: field1.value == "Male"

Uttryck för slutförande av steg step-completion-expression

Uttrycket för att slutföra steget används för att hindra en användare från att gå till nästa steg i en guidelayout. Dessa uttryck används när paneler har en guidelayout (ett flerstegsformulär som visar ett steg i taget). Användaren kan bara gå till nästa steg, panel eller underavsnitt om alla obligatoriska värden i det aktuella avsnittet är ifyllda och giltiga.

Gäller för: Paneler med objektets layout inställd på guide.

Returtyp: Uttrycket returnerar ett booleskt värde som representerar den aktuella panelen som är giltigt eller inte. True visar att den aktuella panelen är giltig och att användaren kan navigera till nästa panel.

Exempel: I ett formulär som är organiserat på olika paneler valideras den aktuella panelen innan du navigerar till nästa panel. I sådana fall används stegslutsuttryck. I allmänhet används validerings-API:t för GuideBridge. Ett exempel på uttryck för stegkomplettering är:
window.guideBridge.validate([],this.panel.navigationContext.currentItem.somExpression)

Valideringar i adaptiv form validations-in-adaptive-form

Det finns flera metoder för att lägga till fältvalidering i ett anpassat formulär. Om en valideringskontroll läggs till i ett fält, True representerar att det värde som anges i fältet är giltigt. Falskt representerar att värdet är ogiltigt. Om du tabbar in och ut ur ett fält genereras inget felmeddelande.

Du kan lägga till valideringar i ett fält på följande sätt:

Obligatoriskt required

Göra en komponent obligatorisk i Redigera -komponenten kan du välja Titel och text > Obligatoriskt. Du kan också lägga till lämpliga obligatoriskt meddelande (valfritt) också.

Valideringsmönster validation-patterns

Det finns flera valideringsmönster tillgängliga för ett fält. Om du vill välja ett valideringsmönster går du till Redigera -dialogruta för komponenten, leta upp Mönster avsnitt och markera mönster. Du kan skapa ett eget valideringsmönster i en Mönster textruta. Valideringsstatusen returneras True bara om de data som fylls i är kompatibla med valideringsmönstret, annars Falskt returneras. Mer information om hur du skriver egna valideringsmönster finns i Stöd för Picture-klausuler i HTML5-formulär.

Valideringsuttryck validation-expressions

Valideringen av ett fält kan också beräknas med uttryck i olika fält. De här uttrycken skrivs inuti Valideringsskript fält för Skript flik för Redigera -komponentens dialogruta. Valideringsstatusen för ett fält beror på värdet som uttrycket returnerar. Mer information om hur du skriver sådana uttryck finns i Validera uttryck.

Ytterligare information additional-information

Använda fältvisningsformat using-field-display-format

Visningsformat kan användas för att visa data i olika format. Du kan till exempel använda visningsformatet för att visa ett telefonnummer med bindestreck, formatera postnummer eller datumväljare. Dessa visningsmönster kan väljas på menyn Mönster i dialogrutan Redigera för en komponent. Du kan skriva anpassade visningsmönster som liknar de valideringsmönster som nämns ovan.

GuideBridge - API:er och händelser guidebridge-apis-and-events

GuideBridge är en samling API:er som kan användas för att interagera med adaptiva formulär i en webbläsares minnesmodell. Detaljerad introduktion till API:t för Guide Bridge, klassmetoder och exponerade händelser finns på JavaScript Library API-referens för adaptiva formulär.

NOTE
Du bör inte använda händelseavlyssnarna i GuideBridge i uttryck.

GuideBridge-användning i olika uttryck guidebridge-usage-in-various-expressions

  • Om du vill återställa formulärfält kan du aktivera guideBridge.reset() API på klickuttrycket för en knapp. Det finns också ett API för att skicka som kan anropas som ett klickuttryck guideBridge.submit().

  • Du kan använda setFocus() API för att ange fokus i olika fält eller paneler (för panelfokus ställs det första fältet automatiskt in). setFocus()innehåller ett stort antal alternativ för navigering, t.ex. navigering över paneler, föregående/nästa genomgång, inställning av fokus till ett visst fält och många andra alternativ. Om du till exempel vill gå till nästa panel kan du använda: guideBridge.setFocus(this.panel.somExpression, 'nextItem').

  • Om du vill validera ett adaptivt formulär eller dess specifika paneler använder du guideBridge.validate(errorList, somExpression).

Använda GuideBridge utanför uttryck  using-guidebridge-outside-expressions-nbsp

Du kan också använda API:erna för GuideBridge utanför uttrycken. Du kan till exempel använda API:t för GuideBridge för att ange kommunikation mellan HTML som är värd för det adaptiva formuläret och formulärmodellen. Dessutom kan du ange det värde som kommer från den överordnade delen av Iframe som är värd för formuläret.

Om du vill använda API:t för GuideBridge för ovanstående exempel hämtar du en instans av GuideBridge. Om du vill hämta instansen lyssnar du på bridgeInitializeStarthändelse för en windowobjekt:

window.addEventListener("bridgeInitializeStart", function(evnt) {

     // get hold of the guideBridge object

     var gb = evnt.detail.guideBridge;

     //wait for the completion of AF

     gb.connect(function (){

        //this function will be called after Adaptive Form is initialized

     })

})
NOTE
I AEM är det en god vana att skriva kod i en clientLib och inkludera den på din sida (header.jsp eller footer.jsp på sidan)

Använda GuideBridge efter att formuläret har initierats ( bridgeInitializeComplete -händelsen skickas), hämta GuideBridge-instansen med window.guideBridge. Du kan kontrollera initieringsstatusen för GuideBridge med guideBride.isConnected API.

GuideBridge Events guidebridge-events

GuideBridge innehåller även vissa händelser för externa skript på värdsidan. Externa skript kan lyssna på dessa händelser och utföra olika åtgärder. När användarnamnet i ett formulär ändras, till exempel, ändras även namnet som visas i sidhuvudet på sidan. Mer information om sådana händelser finns i JavaScript Library API-referens för adaptiva formulär.

Använd följande kod för att registrera hanterare:

guideBridge.on("elementValueChanged", function (event, data)  {

      // execute some logic when value of a field is changed

});

Skapa anpassade mönster för ett fält creating-custom-patterns-for-a-field

Som nämnts ovan kan man med adaptiva formulär skapa mönster för validering och visning. Förutom att använda utanför rutmönstren kan du definiera återanvändbara anpassade mönster för en adaptiv formulärkomponent. Du kan till exempel definiera ett textfält eller ett numeriskt fält. När du har definierat det kan du använda de här mönstren i alla formulär för den angivna typen av komponent. Du kan till exempel skapa ett anpassat mönster för ett textfält och använda det i textfälten i deras anpassade former. Du kan välja det anpassade mönstret genom att gå till mönsteravsnittet i redigeringsdialogrutan för en komponent. Mer information om mönsterdefinition eller -format finns i Stöd för Picture-klausuler i HTML5-formulär.

Utför följande steg för att skapa ett anpassat mönster för en viss fälttyp och återanvänd det för andra fält av samma typ:

  1. Navigera till CRXDE Lite i redigeringsinstansen.

  2. Skapa en mapp för att behålla dina anpassade mönster. Skapa en nod av typen sling:folder i katalogen /apps. Skapa till exempel en nod med namnet customPatterns. Skapa en annan nod av typen under den här noden nt:unstructed och namnge textboxpatterns. Den här noden innehåller de olika anpassade mönster som du vill lägga till.

  3. Öppna fliken Egenskaper för noden som skapades. Öppna till exempel fliken Egenskaper för textboxpatterns. Lägg till guideComponentType egenskapen för den här noden och ange dess värde till fd/af/components/formter/guideTextBox.

  4. Värdet för den här egenskapen varierar beroende på vilket fält du vill definiera mönstren för. För numeriska fält är värdet för guideComponentType egenskapen är fd/af/components/formter/guideNumericBox. Värdet för Datepicker-fältet är fd/af/components/formter/guideDatepicker. "

  5. Du kan lägga till ett eget mönster genom att tilldela en egenskap till textboxpatterns nod. Lägg till en egenskap med ett namn (till exempel pattern1) och ange värdet för mönstret som du vill lägga till. Lägg till en egenskap pattern1 med värdet Fax=text{99-999-9999999}. Mönstret är tillgängligt för alla textrutor som du använder i Adaptiv Forms.

    Skapa anpassade mönster för fält i CrxDe

    Skapa egna mönster

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2