Adaptiva formuläruttryck adaptive-form-expressions

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 visa/dölj-fält och paneler. 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 skriptmodell 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å API-referens för JavaScript-bibliotek för adaptiva formulär.

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

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.

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: Aktivera ett fält endast 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 fältet där uttrycksresultatet visas (till exempel decimal).

Exempel: Beräkningsuttrycket 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:

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

Alternativ 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älts vä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 UK ä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.

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

Skriptet Värde implementeras aktiveras när:

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()

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 layout för objekt inställt 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 Edit -komponenten kan du välja alternativ Title and Text > Required. 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 Edit -komponenten, leta upp Patterns avsnitt och markera patterns. 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 Validation Script fält för Script flik för Edit -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 Patterns i Edit -dialogruta 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å API-referens för JavaScript-bibliotek för adaptiva formulär.

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

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

     })

})

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 API-referens för JavaScript-bibliotek 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: