Adaptieve formulierexpressies adaptive-form-expressions

Adaptieve formulieren bieden een geoptimaliseerde en vereenvoudigde manier van invullen van formulieren voor eindgebruikers met dynamische scriptmogelijkheden. Hiermee kunt u expressies schrijven waarmee u verschillende gedragingen kunt toevoegen, zoals dynamische tonen/verbergen van velden en deelvensters. Ook kunt u berekende velden toevoegen, velden alleen-lezen maken, validatielogica toevoegen en nog veel meer. Het dynamische gedrag is gebaseerd op de gebruikersinvoer of voorgevulde gegevens.

JavaScript is de expressietaal van adaptieve formulieren. Alle expressies zijn geldige JavaScript-expressies en gebruiken API's van het scriptmodel voor aangepaste formulieren. Deze expressies retourneren waarden van bepaalde typen. Voor de volledige lijst met adaptieve formulierklassen, gebeurtenissen, objecten en openbare API's raadpleegt u JavaScript Library API-referentie voor adaptieve formulieren.

Aanbevolen werkwijzen voor het schrijven van expressies best-practices-for-writing-expressions

Aanbevolen werkwijzen voor expressies waarbij het deelvenster wordt herhaald best-practices-for-expressions-involving-repeating-panel

Herhalende deelvensters zijn instanties van een deelvenster die dynamisch worden toegevoegd of verwijderd met behulp van API voor scripts of vooraf ingevulde gegevens. Zie voor meer informatie over het gebruik van een deelvenster voor herhalingen formulieren maken met herhaalbare secties.

Expressietypen expression-types

In adaptieve formulieren kunt u expressies schrijven om gedrag toe te voegen, zoals velden en deelvensters voor dynamisch tonen/verbergen. U kunt ook expressies schrijven om berekende velden toe te voegen, velden alleen-lezen te maken, validatielogica toe te voegen en nog veel meer. Adaptieve formulieren ondersteunen de volgende expressies:

Access Expression (Enablement Expression) access-expression-enablement-expression

U kunt de toegangsuitdrukking gebruiken om een gebied in of onbruikbaar te maken. Als de expressie de waarde van een veld gebruikt, wordt de expressie opnieuw geactiveerd wanneer de waarde van het veld verandert.

Van toepassing op: velden

Retourtype: De expressie retourneert een Booleaanse waarde die aangeeft of het veld is in- of uitgeschakeld. true geeft aan dat het veld is ingeschakeld en false geeft aan dat het veld is uitgeschakeld.

Voorbeeld: Een veld alleen inschakelen als de waarde van field1 is ingesteld op X, is de toegangsuitdrukking: field1.value == "X"

Expressie berekenen calculate-expression

De expressie calculate wordt gebruikt om de waarde van een veld automatisch te berekenen met behulp van een expressie. In dergelijke expressies wordt doorgaans de eigenschap value van een ander veld gebruikt. Bijvoorbeeld, field2.value + field3.value. Wanneer de waarde van field2of field3wijzigt, wordt de expressie opnieuw geactiveerd en wordt de waarde opnieuw berekend.

Van toepassing op: velden

Retourtype: De expressie retourneert een waarde die compatibel is met het veld waarin het resultaat van de expressie wordt weergegeven (bijvoorbeeld decimaal).

Voorbeeld: De expressie Berekenen die de som van twee velden in field1 is:
field2.value + field3.value

Klikken op uitdrukking click-expression

De klikuitdrukking behandelt de acties die op de klikgebeurtenis van een knoop worden uitgevoerd. GuideBridge beschikt over API's die verschillende functies kunnen uitvoeren, zoals verzenden, valideren die samen met de klikexpressie worden gebruikt. Voor een volledige lijst van de API's raadpleegt u GuideBridge-API's.

Van toepassing op: Knopvelden

Retourtype: De klikuitdrukking keert geen waarde terug. Als een expressie een waarde retourneert, wordt de waarde genegeerd.

Voorbeeld: Een tekstvak vullen textbox1 op de klikactie van een knoop met waarde AEM Forms, is de klikexpressie van de knop textbox1.value="AEM Forms" "

Initialisatiescript initialization-script

Het initialisatiescript wordt geactiveerd wanneer een adaptief formulier wordt geïnitialiseerd. Afhankelijk van scenario's, gedraagt het initialisatiescript zich op de volgende manier:

Van toepassing op: velden en deelvenster

Retourneringstype: De initialisatiescript-expressie retourneert geen waarde. Als een expressie een waarde retourneert, wordt de waarde genegeerd.

Voorbeeld: Als u velden met de standaardwaarde wilt vullen in een scenario vóór het invullen van de gegevens 'Adaptive Forms' wanneer hun waarde als ongeldig wordt bewaard, is de initialisatiescriptexpressie:
if(this.value==null) this.value='Adaptive Forms';

Opties options-expression

De optiesuitdrukking wordt gebruikt om opties van een drop-down lijstgebied dynamisch te vullen.

Van toepassing op: vervolgkeuzelijstvelden

Retourtype: De optiesuitdrukking keert een serie van koordwaarden terug. Elke waarde kan een eenvoudige tekenreeks zijn, zoals Mannelijk, of in een key=value paarformaat, zoals 1=Mannelijk

Voorbeeld: Als u de waarde van een veld wilt vullen op basis van de waarde van een ander veld, geeft u een eenvoudige expressie voor opties op. Als u bijvoorbeeld een veld wilt vullen, Aantal kinderen op basis van de Burgerlijke staat uitgedrukt in een ander veld, wordt de volgende expressie gebruikt:

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

Wanneer de waarde van huwelijks_status veldwijzigingen, wordt de expressie opnieuw geactiveerd. U kunt dropdown van de dienst van REST ook bevolken. Zie voor meer informatie Dropdowns dynamisch vullen.

Samenvattingsexpressie summary

De expressie Samenvatting berekent dynamisch de titel van een onderliggend deelvenster van een accordeonlay-outdeelvenster. U kunt de expressie Samenvatting opgeven in een regel, die een formulierveld of een aangepaste logica gebruikt om de titel te evalueren. De expressie wordt uitgevoerd wanneer het formulier wordt geïnitialiseerd. Als u een formulier vooraf invult, wordt de expressie uitgevoerd nadat de gegevens zijn voorgevuld of wanneer de waarde van afhankelijke velden die in de expressie worden gebruikt, verandert.

De expressie Samenvatting wordt doorgaans gebruikt voor het herhalen van onderliggende items van een accordeonlay-outdeelvenster, zodat elk onderliggend deelvenster een betekenisvolle titel krijgt.

Van toepassing op: Deelvensters die directe onderliggende elementen zijn van een deelvenster waarvan de lay-out is geconfigureerd als Accordeon.

Retourneringstype: De expressie retourneert een tekenreeks die de titel van de accordeon wordt.

Voorbeeld: "Rekeningnummer: "+ textbox1.value

Expressie valideren validate-expression

De expressie validate wordt gebruikt om de velden te valideren met de opgegeven expressie. Dergelijke expressies gebruiken doorgaans reguliere expressies samen met de veldwaarde om een veld te valideren. De expressie wordt opnieuw geactiveerd en de validatiestatus van het veld wordt opnieuw berekend bij elke wijziging in de waarde van een veld.

Van toepassing op: velden

Retourtype: De expressie retourneert een Booleaanse waarde die de validatiestatus van het veld vertegenwoordigt. De waarde false geeft aan dat het veld ongeldig is en true geeft aan dat het veld geldig is.

Voorbeeld: Voor een veld met postcode van het Verenigd Koninkrijk is de validatie-expressie:

(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

Als in het bovenstaande voorbeeld de niet-lege waarde niet overeenkomt met het patroon, wordt de expressie geretourneerd false om aan te geven dat het veld niet geldig is.

Waarde script vastleggen value-commit-script

Het script voor vastleggen van waarde wordt geactiveerd wanneer:

Van toepassing op: velden

Retourneringstype: De waarde commit script expression retourneert geen waarde. Als een expressie een waarde retourneert, wordt de waarde genegeerd.

Voorbeeld: Als u het hoofdlettergebruik van in het veld ingevoerde alfabeten wilt omzetten in hoofdletters bij doorvoeren, voert u de volgende expressie voor waarde uit:
this.value=this.value.toUpperCase()

Zichtbaarheidsexpressie visibility-expression

De uitdrukking van de Zichtbaarheid wordt gebruikt om de zichtbaarheid van gebied/paneel te controleren. De zichtbaarheidsexpressie gebruikt doorgaans de eigenschap value van een veld en wordt opnieuw geactiveerd wanneer die waarde verandert.

Van toepassing op: velden en deelvenster

Retourtype: De uitdrukking keert een waarde Van Boole terug, die het gebied/het paneel vertegenwoordigt is zichtbaar of niet. false geeft aan dat het veld of deelvenster niet zichtbaar is en true aangeeft dat het veld of deelvenster zichtbaar is.

Voorbeeld: Voor een deelvenster dat alleen zichtbaar wordt als de waarde van field1 is ingesteld op Mannelijk, is de zichtbaarheidsexpressie: field1.value == "Male"

Uitdrukking voor stapvoltooiing step-completion-expression

De expressie voor het voltooien van de stap wordt gebruikt om te voorkomen dat een gebruiker naar de volgende stap van een wizardlay-out gaat. Deze expressies worden gebruikt wanneer deelvensters een wizardlay-out hebben (een formulier dat uit meerdere stappen bestaat en één stap tegelijk weergeeft). De gebruiker kan alleen naar de volgende stap, het volgende deelvenster of de volgende subsectie gaan als alle vereiste waarden in de huidige sectie zijn ingevuld en geldig zijn.

Van toepassing op: Deelvensters waarvan de layout van het item is ingesteld op de wizard.

Retourtype: De uitdrukking keert een waarde Van Boole terug, die het huidige paneel vertegenwoordigt is geldig of niet. Waar geeft aan dat het huidige deelvenster geldig is en dat de gebruiker naar het volgende deelvenster kan navigeren.

Voorbeeld: Voordat u naar het volgende venster navigeert in een formulier dat is ingedeeld in verschillende deelvensters, wordt het huidige deelvenster gevalideerd. In dergelijke gevallen worden de expressies voor stapvoltooiing gebruikt. Over het algemeen maken deze expressies gebruik van de GuideBridge-API voor validatie. Een voorbeeld van een expressie voor het voltooien van stappen is:
window.guideBridge.validate([],this.panel.navigationContext.currentItem.somExpression)

Validaties in adaptieve vorm validations-in-adaptive-form

Er zijn meerdere methoden om veldvalidatie toe te voegen aan een adaptief formulier. Als een validatiecontrole wordt toegevoegd aan een veld, Waar geeft aan dat de waarde die in het veld wordt ingevoerd, geldig is. Onwaar geeft aan dat de waarde ongeldig is. Als u in- en uitgaat van een veld, wordt het foutbericht niet gegenereerd.

U kunt als volgt validaties toevoegen aan een veld:

Vereist required

Om een onderdeel verplicht te maken, kunt u in het gedeelte Edit van de component, kunt u optie selecteren Title and Text > Required. U kunt ook de juiste vereist bericht (facultatief) eveneens. .

Validatiepatronen validation-patterns

Er zijn meerdere validatiepatronen beschikbaar voor een veld. Als u een validatiepatroon wilt selecteren, gaat u in het dialoogvenster Edit van de component, zoekt u de Patterns en selecteert u patterns. U kunt uw eigen aangepaste validatiepatroon maken in een Patroon tekstvak. De validatiestatus wordt geretourneerd Waar alleen als de ingevulde gegevens voldoen aan het validatiepatroon, anders Onwaar wordt geretourneerd. Als u uw eigen aangepaste validatiepatroon wilt schrijven, raadpleegt u Ondersteuning voor afbeeldingsclausules voor HTML5-formulieren.

Validatie-expressies validation-expressions

De validatie van een veld kan ook worden berekend met behulp van expressies in verschillende velden. Deze expressies worden geschreven binnen Validation Script van het Script tabblad van Edit van de component. De validatiestatus van een veld is afhankelijk van de waarde die de expressie retourneert. Zie voor informatie over het schrijven van dergelijke expressies Expressie valideren.

Aanvullende informatie additional-information

Veldweergave-indeling gebruiken using-field-display-format

De indeling van de weergave kan worden gebruikt om de gegevens in verschillende indelingen weer te geven. U kunt bijvoorbeeld de weergave-indeling gebruiken om een telefoonnummer met afbreekstreepjes, ZIP-code of datumkiezer weer te geven. Deze weergavepatronen kunnen worden geselecteerd in het menu Patterns van de Edit van een component. U kunt aangepaste weergavepatronen schrijven, vergelijkbaar met de hierboven vermelde validatiepatronen.

GuideBridge - API's en gebeurtenissen guidebridge-apis-and-events

GuideBridge is een verzameling API's die kunnen worden gebruikt voor interactie met adaptieve formulieren in het geheugenmodel in een browser. Zie voor gedetailleerde informatie over Guide Bridge API, klassemethoden, belichte gebeurtenissen JavaScript Library API-referentie voor adaptieve formulieren.

Gebruik van GuideBridge in verschillende expressies guidebridge-usage-in-various-expressions

GuideBridge gebruiken buiten expressies  using-guidebridge-outside-expressions-nbsp

U kunt de GuideBridge API's ook buiten de expressies gebruiken. U kunt bijvoorbeeld de GuideBridge-API gebruiken om communicatie in te stellen tussen pagina-HTML die als host fungeert voor het adaptieve formulier en het formuliermodel. Bovendien kunt u de waarde instellen die afkomstig is van het bovenliggende item van het Iframe-bestand dat het formulier host.

Als u GuideBridge API wilt gebruiken voor het bovenstaande voorbeeld, neemt u een instantie van GuideBridge op. Om de instantie vast te leggen, luistert u naar bridgeInitializeStarteen windowobject:

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

     })

})

Als u GuideBridge wilt gebruiken nadat het formulier is geïnitialiseerd (de bridgeInitializeComplete -gebeurtenis is verzonden), de GuideBridge-instantie ophalen met window.guideBridge. U kunt de GuideBridge-initialisatiestatus controleren met de guideBride.isConnected API.

GuideBridge-gebeurtenissen guidebridge-events

GuideBridge biedt ook bepaalde gebeurtenissen voor externe scripts op de hostpagina. Externe scripts kunnen naar deze gebeurtenissen luisteren en verschillende bewerkingen uitvoeren. Als de gebruikersnaam in een formulier bijvoorbeeld wordt gewijzigd, verandert ook de naam die in de koptekst van de pagina wordt weergegeven. Zie voor meer informatie over dergelijke gebeurtenissen JavaScript Library API-referentie voor adaptieve formulieren.

Gebruik de volgende code om handlers te registreren:

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

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

});

Aangepaste patronen maken voor een veld creating-custom-patterns-for-a-field

Zoals hierboven vermeld, kunnen met adaptieve formulieren ontwerpers patronen voor validatie- of weergaveindelingen leveren. U kunt niet alleen patronen uit het vak gebruiken, maar ook herbruikbare aangepaste patronen definiëren voor een adaptieve formuliercomponent. U kunt bijvoorbeeld een tekstveld of een numeriek veld definiëren. Als u deze patronen eenmaal hebt gedefinieerd, kunt u deze patronen in alle formulieren gebruiken voor het opgegeven type component. U kunt bijvoorbeeld een aangepast patroon maken voor een tekstveld en dit gebruiken in de tekstvelden in de aangepaste formulieren. U kunt het aangepaste patroon selecteren door de patroonsectie te openen in het dialoogvenster Bewerken van een component. Zie voor meer informatie over de definitie of indeling van patronen Ondersteuning voor afbeeldingsclausules voor HTML5-formulieren.

Voer de volgende stappen uit om een aangepast patroon te maken voor een specifiek veldtype en dit opnieuw te gebruiken voor andere velden van hetzelfde type: