Versie
Artikelkoppeling
AEM as a Cloud Service (kerncomponenten)
Dit artikel
AEM as a Cloud Service (stichtingscomponenten)
Klik hier
AEM 6,5
Klik hier

Regels toevoegen aan een adaptief formulier (kerncomponenten) adaptive-forms-rule-editor

Met de functie voor regeleditors kunnen zakelijke gebruikers en ontwikkelaars regels schrijven voor adaptieve formulierobjecten. Met deze regels worden acties gedefinieerd die op formulierobjecten worden geactiveerd op basis van vooraf ingestelde voorwaarden, gebruikersinvoer en gebruikersacties op het formulier. Hierdoor wordt de ervaring met het invullen van formulieren verder gestroomlijnd, zodat u nauwkeurige en snelle informatie krijgt.

De regelredacteur verstrekt een intuïtieve en vereenvoudigde gebruikersinterface om regels te schrijven. De redacteur van de regel biedt een visuele redacteur voor alle gebruikers aan. Een aantal belangrijke handelingen die u met behulp van regels kunt uitvoeren op adaptieve formulierobjecten zijn:

  • Een object tonen of verbergen
  • Een object in- of uitschakelen
  • Een waarde instellen voor een object
  • De waarde van een object valideren
  • Functies uitvoeren om de waarde van een object te berekenen
  • Roep de service Form Data Model (FDM) aan en voer een bewerking uit
  • Eigenschap van een object instellen

Gebruikers die zijn toegevoegd aan de gebruikersgroep voor formulieren, kunnen scripts maken en bestaande scripts bewerken. Gebruikers in de forms-users groep kan de scripts gebruiken, maar geen scripts maken of bewerken.

Verschil tussen de redacteur van de Regel in de Componenten van de Kern en de Redacteur van de Regel in de Componenten van de Stichting

De volgende lijst toont het verschil tussen de eigenschappen beschikbaar in de Componenten van de Kern van de Redacteur van de Regel en de Componenten van de Stichting van de Redacteur van de Regel aan:

Functies
Adptive Form Foundation Components
Adptive Form Core-componenten
Opties voor de vervolgkeuzelijst instellen
De opties voor de vervolgkeuzelijst worden ingesteld met behulp van de opties van de Regeleditor Opties instellen voor eigenschap.
De dropdown opties worden geplaatst gebruikend de douanefuncties.
Wiskundige bewerkingen uitvoeren in het veld van het herhaalbare deelvenster
OTB Wiskundige functies kunnen worden toegepast op herhaalbare deelvenstervelden om functies uit te voeren zoals de som en het gemiddelde.
Wiskundige bewerkingen in het veld van het herhaalbare deelvenster kunnen worden uitgevoerd met behulp van aangepaste functies.
Veld/deelvenster/formulierregel valideren/opnieuw instellen in 'Dan'
Validatie- en herstelfuncties ondersteunen alleen formulierobjecten in de regeleditor.
Validatie- en herstelfuncties ondersteunen formulier-, deelvenster- en veldobject in de Regeleditor.
ES10-ondersteuning
ES10 wordt nog niet ondersteund.
Ondersteuning voor moderne JavaScript-functies zoals let- en pijlfuncties (ES10-ondersteuning) binnen aangepaste functies.
Service-uitvoereigenschap
Het de outputbezit van de Dienst wordt gesteund in Waarde instellen van optie van de Redacteur van de Regel.
De Waarde instellen van biedt geen ondersteuning voor de Service-uitvoer eigenschap voor het aanroepen van API's in de Rule Editor.
NOTE
Zie voor meer informatie over het maken en gebruiken van aangepaste functies Aangepaste functies in Adaptive Forms (Core Components) artikel.

Een regel begrijpen understanding-a-rule

Een regel is een combinatie van handelingen en voorwaarden. In de regeleditor omvatten handelingen zoals verbergen, weergeven, inschakelen, uitschakelen of de waarde van een object in een formulier berekenen. Voorwaarden zijn Booleaanse expressies die worden geëvalueerd door controles en bewerkingen uit te voeren op de status, waarde of eigenschap van een formulierobject. Handelingen worden uitgevoerd op basis van de waarde ( True of False) geretourneerd door een voorwaarde te evalueren.

De regelredacteur verstrekt een reeks vooraf bepaalde regeltypes, zoals wanneer, tonen, verbergen, toelaten, onbruikbaar maken, Vastgestelde Waarde van, en Valideren om u te helpen regels schrijven. Elk regeltype laat u voorwaarden en acties in een regel bepalen. Het document verklaart verder elk regeltype in detail.

Een regel volgt doorgaans een van de volgende constructies:

Voorwaarde-actie In deze constructie definieert een regel eerst een voorwaarde gevolgd door een handeling die moet worden geactiveerd. De constructie is vergelijkbaar met if-then statement in programmeertalen.

In de regeleditor Wanneer het regeltype dwingt de voorwaarde-actie constructie af.

Handeling-voorwaarde In deze constructie, bepaalt een regel eerst een actie die door voorwaarden voor evaluatie wordt gevolgd teweegbrengen. Een andere variatie van deze constructie is actie-voorwaarde-afwisselende actie, die ook een afwisselende actie bepaalt om te teweegbrengen als de voorwaarde Vals terugkeert.

Toon, verberg, laat toe, maak onbruikbaar, plaats Waarde van, en bevestig regeltypes in regelredacteur om de actie-voorwaarde regelconstructie af te dwingen. Standaard is de alternatieve actie voor Tonen Verbergen en voor Inschakelen Uitgeschakeld en de tegenovergestelde manier. U kunt de alternatieve standaardhandeling niet wijzigen.

NOTE
De beschikbare regeltypen, inclusief de voorwaarden en handelingen die u in de regeleditor definieert, zijn ook afhankelijk van het type formulierobject waarop u een regel maakt. In de regeleditor worden alleen geldige regeltypen en opties weergegeven voor het schrijven van voorwaarde- en handelingsinstructies voor een bepaald type formulierobject. U ziet bijvoorbeeld geen typen Valideren en Waarde instellen voor een deelvensterobject.

Voor meer informatie over regeltypes beschikbaar in de regelredacteur, zie Beschikbare regeltypen in regeleditor.

Richtlijnen voor het kiezen van een regelconstructie guidelines-for-choosing-a-rule-construct

Hoewel u de meeste gebruiksgevallen kunt bereiken door om het even welke regelconstructie te gebruiken, zijn hier sommige richtlijnen om één constructie over een andere te kiezen. Voor meer informatie over de beschikbare regels in regelredacteur, zie Beschikbare regeltypen in regeleditor.

  • Een typische regel van het duim wanneer het creëren van een regel is het denken over het in de context van het voorwerp waarop u een regel schrijft. Denk eraan dat u veld B wilt verbergen of weergeven op basis van de waarde die een gebruiker in veld A heeft opgegeven. In dit geval evalueert u een voorwaarde in veld A en activeert u een actie in veld B op basis van de waarde die de voorwaarde retourneert.

    Daarom als u een regel op gebied B (het voorwerp schrijft waarop u een voorwaarde) evalueert, gebruik de voorwaarde-actie constructie of het wanneer regeltype. Op dezelfde manier gebruikt u de handeling-voorwaarde constructie of toont of verbergt regeltype op gebied A.

  • Soms moet u meerdere handelingen uitvoeren op basis van één voorwaarde. In dergelijke gevallen wordt aangeraden de voorwaarde-actieconstruct te gebruiken. In deze constructie, kunt u een voorwaarde eens evalueren en veelvoudige actieverklaringen specificeren.

    Als u bijvoorbeeld velden B, C en D wilt verbergen op basis van de voorwaarde die controleert of de waarde is opgegeven in veld A, schrijft u één regel met een construct voor voorwaarde-actie of wanneer-regeltype op veld A en geeft u handelingen op om de zichtbaarheid van velden B, C en D te bepalen. Anders hebt u drie aparte regels nodig voor de velden B, C en D, waar elke regel de voorwaarde controleert en het desbetreffende veld weergeeft of verbergt. In dit voorbeeld is het efficiënter om het Wanneer regeltype op één object te schrijven in plaats van Regeltype tonen of verbergen op drie objecten.

  • Als u een actie wilt activeren op basis van meerdere voorwaarden, wordt aangeraden een handeling-voorwaardenconstructie te gebruiken. Als u bijvoorbeeld veld A wilt weergeven en verbergen door de voorwaarden in de velden B, C en D te evalueren, gebruikt u Regeltype tonen of verbergen in veld A.

  • Gebruik een voorwaarde-handeling of handeling als de regel één handeling voor één voorwaarde bevat.

  • Als een regel op een voorwaarde controleert en een actie onmiddellijk bij het verstrekken van een waarde op een gebied of het weggaan van een gebied uitvoert, wordt het geadviseerd om een regel met voorwaarde-actie constructie of het wanneer regeltype op het gebied te schrijven waarop de voorwaarde wordt geëvalueerd.

  • De voorwaarde in wanneer regel wordt geëvalueerd wanneer een gebruiker de waarde van het voorwerp verandert waarop wanneer regel wordt toegepast. Als u echter wilt dat de actie wordt geactiveerd wanneer de waarde aan de serverzijde verandert, bijvoorbeeld bij het vooraf invullen van de waarde, kunt u het beste een When-regel schrijven die de actie activeert wanneer het veld wordt geïnitialiseerd.

  • Wanneer u regels schrijft voor vervolgkeuzelijsten, keuzerondjes of selectievakjes, worden de opties of waarden van deze formulierobjecten in het formulier vooraf ingevuld in de regeleditor.

Beschikbare operatortypen en gebeurtenissen in regeleditor available-operator-types-and-events-in-rule-editor

De regeleditor biedt de volgende logische operatoren en gebeurtenissen waarmee u regels kunt maken.

  • Is gelijk aan
  • Is niet gelijk aan
  • Begint met
  • Eindigt met
  • Bevat
  • Bevat niet
  • Is leeg
  • Is niet leeg
  • Heeft geselecteerd: Retourneert true wanneer de gebruiker een bepaalde optie voor een selectievakje, vervolgkeuzelijst of keuzerondje selecteert.
  • Is geïnitialiseerd (gebeurtenis): Retourneert true wanneer een formulierobject in de browser wordt weergegeven.
  • Is gewijzigd (gebeurtenis): Retourneert true wanneer de gebruiker de ingevoerde waarde of de geselecteerde optie voor een formulierobject wijzigt.

Beschikbare regeltypen in regeleditor available-rule-types-in-rule-editor

De regelredacteur verstrekt een reeks vooraf bepaalde regeltypes die u kunt gebruiken om regels te schrijven. Laten we elk regeltype in detail bekijken. Voor meer informatie over het schrijven van regels in regelredacteur, zie Schrijfregels.

When whenruletype

De When regeltype volgt condition-action-alternate action regelconstructie, of soms alleen de voorwaarde-actie construct. In dit regeltype geeft u eerst een voorwaarde op voor evaluatie gevolgd door een handeling die wordt geactiveerd als aan de voorwaarde is voldaan ( True). Wanneer u het regeltype When gebruikt, kunt u meerdere AND- en OR-operatoren gebruiken om geneste expressies.

Met het regeltype 'Wanneer' kunt u een voorwaarde op een formulierobject evalueren en acties op een of meer objecten uitvoeren.

In duidelijke woorden, typisch wanneer de regel als volgt gestructureerd is:

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

Action 2 on Object B;
AND
"Actie 3 betreffende object C;

Else, do the following:

Action 2 on Object C;
_

Wanneer u een component met meerdere waarden hebt, zoals keuzerondjes of lijst, terwijl het creëren van een regel voor die component, worden de opties automatisch teruggewonnen en ter beschikking gesteld van de regelmaker. U hoeft de optiewaarden niet nogmaals te typen.

Een lijst heeft bijvoorbeeld vier opties: Rood, Blauw, Groen en Geel. Tijdens het creëren van de regel, worden de opties (radioknopen) automatisch teruggewonnen en ter beschikking gesteld van de regelschepper als volgt:

Meerdere waarden geeft opties weer

Tijdens het schrijven van een When-regel kunt u de Clear Value of action activeren. Met Waarde wissen wordt de waarde van het opgegeven object gewist. Met de instructie 'Wissen' als optie kunt u complexe voorwaarden maken met meerdere velden. U kunt de instructie Else toevoegen om meer voorwaarden toe te voegen

Waarde wissen van

NOTE
Als regeltype alleen single-level then-else instructies ondersteunt.

Meerdere velden toegestaan in When allowed-multiple-fields

In de Wanneer hebt u de mogelijkheid om andere velden toe te voegen dan het veld waarop de regel wordt toegepast.

Met het regeltype Wanneer kunt u bijvoorbeeld een voorwaarde evalueren voor verschillende formulierobjecten en de handeling uitvoeren:

Wanneer:

(Object A Voorwaarde 1)

EN/OF

(Voorwaarde B 2)

Voer vervolgens de volgende handelingen uit:

Actie 1 op object A

_

Meerdere velden toegestaan in

Overwegingen bij het gebruik van meerdere velden toegestaan in Wanneer voorwaarde
  • Zorg ervoor dat de kerncomponent is ingesteld op versie 3.0.14 of hoger om deze functie te kunnen gebruiken in de regeleditor.
  • Als regels worden toegepast op verschillende velden binnen de voorwaarde Wanneer, wordt de regel geactiveerd, zelfs als slechts een van die velden wordt gewijzigd.

Als er problemen optreden met de toegestane meerdere velden in de functie Wanneer voorwaarde, volgt u de stappen voor het oplossen van problemen:

  1. Open het formulier in de bewerkmodus.
  2. Open de browser Inhoud en selecteer de Guide Container van uw adaptieve formulier.
  3. Klik op de eigenschappen van de container van de hulplijn Eigenschappen van hulplijnen pictogram. Het dialoogvenster Aangepaste formuliercontainer wordt geopend.
  4. Klik op Gereed en sla het dialoogvenster opnieuw op.

Hide Verbergt het opgegeven object.

Show Hiermee wordt het opgegeven object weergegeven.

Enable Hiermee wordt het opgegeven object ingeschakeld.

Disable Hiermee wordt het opgegeven object uitgeschakeld.

Invoke service Roept de dienst aan die in een model van vormgegevens (FDM) wordt gevormd. Wanneer u de Invoke-service kiest, wordt een veld weergegeven. Bij het tikken van het gebied, toont het alle diensten die in al model van vormgegevens (FDM) op uw worden gevormd Experience Manager -instantie. Als u een service Formuliergegevensmodel kiest, worden meer velden weergegeven waarin u formulierobjecten kunt toewijzen met invoer- en uitvoerparameters voor de opgegeven service. Zie voorbeeldregel voor het aanroepen van de diensten van het Model van de Gegevens van de Vorm (FDM).

Naast de service Formuliergegevensmodel kunt u een directe WSDL-URL opgeven om een webservice aan te roepen. Nochtans, heeft de modeldienst van de Gegevens van het Vorm vele voordelen en de geadviseerde benadering om de dienst aan te halen.

Voor meer informatie over het vormen van de diensten in het model van vormgegevens (FDM), zie Experience Manager Forms Gegevensintegratie.

Set value of Berekent en stelt de waarde van het opgegeven object in. U kunt de objectwaarde instellen op een tekenreeks, de waarde van een ander object, de berekende waarde met wiskundige expressie of functie, de waarde van een eigenschap van een object of de uitvoerwaarde van een geconfigureerde service Formuliergegevensmodel. Wanneer u de optie Webservice kiest, worden alle services weergegeven die in het FDM-model (Form Data Model) zijn geconfigureerd Experience Manager -instantie. Als u een service Formuliergegevensmodel kiest, worden meer velden weergegeven waarin u formulierobjecten kunt toewijzen met invoer- en uitvoerparameters voor de opgegeven service.

Voor meer informatie over het vormen van de diensten in het model van vormgegevens (FDM), zie Experience Manager Forms Gegevensintegratie.

De Set Property Met regeltype kunt u de waarde van een eigenschap van het opgegeven object instellen op basis van een voorwaardenactie. U kunt eigenschap instellen op een van de volgende opties:

  • visible (Boolean)
  • label.value (String)
  • label.visible (Boolean)
  • description (String)
  • enabled (Boolean)
  • readOnly (Boolean)
  • required (Boolean)
  • screenReaderText (String)
  • valid (Boolean)
  • errorMessage (String)
  • default (Number, String, Date)
  • enumNames (String[])
  • chartType (String)

U kunt bijvoorbeeld regels definiëren om het tekstvak weer te geven wanneer op een knop wordt geklikt. U kunt een regel definiëren met behulp van een aangepaste functie, een formulierobject, objecteigenschap of een service-uitvoer.

Eigenschap instellen

Als u een regel wilt definiëren op basis van een aangepaste functie, selecteert u Function Output in de vervolgkeuzelijst en een aangepaste functie slepen en neerzetten vanuit de Functions tab. Als aan de voorwaarde wordt voldaan, wordt het tekstinvoervak weergegeven.

Als u een regel wilt definiëren op basis van een formulierobject, selecteert u Form Object in de vervolgkeuzelijst en een formulierobject slepen en neerzetten vanuit de Form Objects tab. Als aan de voorwaarde is voldaan, wordt het tekstinvoervak weergegeven in het adaptieve formulier.

Met de regel Eigenschap instellen die is gebaseerd op een objecteigenschap kunt u het tekstinvoervak zichtbaar maken in een adaptief formulier op basis van een andere objecteigenschap die is opgenomen in het adaptieve formulier.

De volgende afbeelding toont een voorbeeld van het dynamisch inschakelen van het selectievakje op basis van het verbergen of weergeven van een tekstvak in een adaptieve vorm:

Objecteigenschap

Clear Value Of Wist de waarde van het opgegeven object.

Set Focus Hiermee wordt de focus op het opgegeven object ingesteld.

Submit Form Hiermee verzendt u het formulier.

Reset Hiermee wordt het formulier of het opgegeven object opnieuw ingesteld.

Validate Valideert het formulier of het opgegeven object.

Add Instance Hiermee wordt een instantie van het opgegeven herhaalbare deelvenster of de opgegeven tabelrij toegevoegd.

Remove Instance Hiermee wordt een instantie van het opgegeven herhaalbare deelvenster of de opgegeven tabelrij verwijderd.

Function Output Definieert een regel op basis van vooraf gedefinieerde functies of aangepaste functies.

Navigate to Navigeert naar andere Adaptieve Forms, andere elementen, zoals afbeeldingen of documentfragmenten, of een externe URL.

Dispatch Event De specifieke acties of gedragingen worden geactiveerd op basis van vooraf gedefinieerde voorwaarden of gebeurtenissen.

Set Value of set-value-of

De Set Value of met regeltype kunt u de waarde van een formulierobject instellen, afhankelijk van het feit of aan de opgegeven voorwaarde wordt voldaan of niet. De waarde kan worden ingesteld op een waarde van een ander object, een letterlijke tekenreeks, een waarde die is afgeleid van een wiskundige expressie of een functie, een waarde van een eigenschap van een ander object of de uitvoer van een service Form Data Model. Op dezelfde manier kunt u controleren op een voorwaarde voor een component, een tekenreeks, een eigenschap of waarden die zijn afgeleid van een functie of wiskundige expressie.

De Waarde instellen van Regeltype is niet beschikbaar voor alle formulierobjecten, zoals deelvensters en werkbalkknoppen. Een standaardsetwaarde van regel heeft de volgende structuur:

Stel de waarde van Object A in op:

(tekenreeks ABC) OR (objecteigenschap X van object C) OR (waarde van een functie) OR (waarde van een wiskundige expressie) OR (uitvoerwaarde van een gegevensmodeldienst);

Wanneer (optioneel):

(Voorwaarde 1 EN Voorwaarde 2 EN Voorwaarde 3) is TRUE;

In het volgende voorbeeld wordt de waarde van Question2 as True geselecteerd en wordt de waarde van Result as ingesteld.correct

Webservice instellen

Voorbeeld van waardenregel instellen met de service Formuliergegevensmodel.

Show show

Met de Show regeltype, kunt u een regel schrijven om een formulierobject weer te geven of te verbergen op basis van het feit of aan een voorwaarde is voldaan of niet. Het regeltype Tonen activeert ook de handeling Verbergen als de voorwaarde niet wordt vervuld of wordt geretourneerd False.

Een typische Show regel is gestructureerd als volgt:

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

Hide hide

Net als het regeltype Tonen kunt u de opdracht Hide regeltype om een formulierobject weer te geven of te verbergen op basis van het feit of aan een voorwaarde is voldaan of niet. Het regeltype Verbergen activeert ook de handeling Tonen als de voorwaarde niet wordt vervuld of wordt geretourneerd False.

Een typische regel van de Huid is gestructureerd als volgt:

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

Enable enable

De Enable met regeltype kunt u een formulierobject in- of uitschakelen op basis van het feit of aan een voorwaarde wordt voldaan of niet. Het Enable regeltype activeert ook de Disable-actie voor het geval dat de voorwaarde niet wordt vervuld of wordt geretourneerd False.

Een typisch laat regel toe is gestructureerd als volgt:

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

Disable disable

Gelijkaardig aan het Enable regeltype, Disable met regeltype kunt u een formulierobject in- of uitschakelen op basis van het feit of aan een voorwaarde wordt voldaan of niet. Het regeltype Uitschakelen activeert ook de handeling Enable voor het geval dat de voorwaarde niet wordt vervuld of wordt geretourneerd False.

Een typisch onbruikbaar maken regel is gestructureerd als volgt:

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

Validate validate

De Validate regeltype valideert de waarde in een veld met een expressie. U kunt bijvoorbeeld een expressie schrijven om te controleren of het tekstvak voor het opgeven van de naam geen speciale tekens of getallen bevat.

Een typisch Validate regel is gestructureerd als volgt:

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

NOTE
Als de opgegeven waarde niet voldoet aan de regel Valideren, kunt u een validatiebericht voor de gebruiker weergeven. U kunt het bericht opgeven in het dialoogvenster Script validation message in de componenteigenschappen in de zijbalk.

Scriptvalidatie

Het begrip van de regel redacteur gebruikersinterface understanding-the-rule-editor-user-interface

De redacteur van de regel verstrekt een uitvoerige maar eenvoudige gebruikersinterface om regels te schrijven en te beheren. U kunt de gebruikersinterface van de regeleditor starten vanuit een adaptief formulier in de ontwerpmodus.

Om het gebruikersinterface van de regelredacteur te lanceren:

  1. Open een adaptief formulier in de ontwerpmodus.

  2. Selecteer het formulierobject waarvoor u een regel wilt schrijven en selecteer op de werkbalk Component de optie bewerkingsregels . De gebruikersinterface van de regeleditor wordt weergegeven.

    regels creëren

    Eventuele bestaande regels voor de geselecteerde formulierobjecten worden in deze weergave weergegeven. Voor informatie over het beheren van bestaande regels raadpleegt u Regels beheren.

  3. Selecteren Create om een nieuwe regel te schrijven. De visuele redacteur van het gebruikersinterface van de regelredacteur opent door gebrek wanneer u de regelredacteur de eerste keer lanceert.

    Gebruikersinterface van regeleditor

Laten wij elke component van de regelredacteur UI in detail bekijken.

A. Component-rule display a-component-rule-display

Hiermee geeft u de titel weer van het object Adaptief formulier waarmee u de regeleditor hebt gestart en het regeltype dat momenteel is geselecteerd. In het bovenstaande voorbeeld wordt de regeleditor gestart vanuit een adaptief formulierobject genaamd Vraag 1 en is het geselecteerde regeltype When.

B. Formulierobjecten en -functies b-form-objects-and-functions-br

De ruit op de linkerzijde in het gebruikersinterface van de regelredacteur omvat twee lusjes — Forms Objects en Functions.

Op het tabblad Formulierobjecten ziet u een hiërarchische weergave van alle objecten in het adaptieve formulier. De titel en het type van de objecten worden weergegeven. Bij het schrijven van een regel kunt u formulierobjecten naar de regeleditor slepen. Wanneer u een regel maakt of bewerkt en een object of functie naar een tijdelijke aanduiding sleept, neemt de tijdelijke aanduiding automatisch het juiste waardetype.

De formulierobjecten waarop een of meer geldige regels zijn toegepast, worden gemarkeerd met een groene stip. Als een van de regels die op een formulierobject zijn toegepast ongeldig is, wordt het formulierobject gemarkeerd met een gele stip.

Het tabblad Functies bevat een set ingebouwde functies, zoals som van, min of meer, max van, gemiddelde van, aantal en validerende vorm. U kunt deze functies gebruiken om waarden in herhaalbare deelvensters en tabelrijen te berekenen en deze tijdens het schrijven van regels te gebruiken in instructies voor handelingen en voorwaarden. U kunt echter ook aangepaste functies maken.

Enkele lijst van functies wordt getoond in het cijfer:

Het tabblad Functies

NOTE
U kunt tekstzoekopdrachten uitvoeren op namen en titels van objecten en functies op de tabbladen Objecten en Functies van Forms.

In de linkerstructuur van de formulierobjecten kunt u de formulierobjecten selecteren om de regels weer te geven die op elk object zijn toegepast. U kunt niet alleen door de regels van de verschillende formulierobjecten navigeren, u kunt ook regels kopiëren en plakken tussen de formulierobjecten. Zie voor meer informatie Regels kopiëren en plakken.

C. Schakelen tussen formulierobjecten en -functies c-form-objects-and-functions-toggle-br

Met de schakelknop schakelt u, wanneer hierop wordt getikt, de formulierobjecten en het deelvenster met functies in of uit.

D. Visuele regeleditor visual-rule-editor

De visuele regelredacteur is het gebied op de visuele redacteurswijze van het gebruikersinterface van de regelredacteur waar u regels schrijft. Hiermee kunt u een regeltype selecteren en voorwaarden en handelingen definiëren. Wanneer u voorwaarden en handelingen in een regel definieert, kunt u formulierobjecten en -functies slepen en neerzetten vanuit het deelvenster Formulierobjecten en -functies.

Voor meer informatie over het gebruiken van visuele regelredacteur, zie Schrijfregels.

E. Gereed en annuleer knoppen done-and-cancel-buttons

De Done wordt gebruikt om een regel op te slaan. U kunt een onvolledige regel opslaan. Onvolledig zijn echter ongeldig en worden niet uitgevoerd. Opgeslagen regels voor een formulierobject worden weergegeven wanneer u de regeleditor de volgende keer start vanuit hetzelfde formulierobject. U kunt bestaande regels in die weergave beheren. Zie voor meer informatie Regels beheren.

De Cancel de knoop verwerpt om het even welke veranderingen u aan een regel aanbracht en sluit de regelredacteur.

Schrijfregels write-rules

U kunt regels schrijven met de Visuele regeleditor

Laten we eerst kijken naar hoe u regels schrijft met de visuele editor.

De visuele editor gebruiken using-visual-editor

Laten we begrijpen hoe u een regel in de Visuele editor maakt met het volgende voorbeeldformulier.

Regelvoorbeeld maken

In het gedeelte met vereisten voor leningen in het voorbeeldformulier voor het aanvragen van leningen moeten aanvragers hun echtelijke staat, salaris en indien gehuwd, het salaris van hun echtgenoot vermelden. Op basis van de gebruikersinput wordt het bedrag dat voor de lening in aanmerking komt, berekend door de regel en wordt dit weergegeven in het veld Beleenbaarheid van de lening. Pas de volgende regels toe om het scenario uit te voeren:

  • Het veld Salaris van de echtgenoot wordt alleen weergegeven wanneer de huwelijksstatus wordt gehuwd.
  • De beleenbaarheid van de lening bedraagt 50% van het totale salaris.

Voer de volgende stappen uit om regels te schrijven:

  1. Schrijf eerst de regel om de zichtbaarheid van het veld Salaris van echtgenoot te regelen op basis van de optie die de gebruiker selecteert voor het keuzerondje Burgerlijke status.

    Open het aanvraagformulier voor de lening in de ontwerpmodus. Selecteer de Marital Status en selecteert u bewerkingsregels . Selecteer vervolgens Create om de regeleditor te starten.

    write-rules-visual-editor-1

    Wanneer u de regelredacteur lanceert, wanneer de regel door gebrek wordt geselecteerd. Bovendien wordt het formulierobject (in dit geval de huwelijksstatus) waaruit u de regeleditor hebt gestart, opgegeven in de instructie When.

    U kunt het geselecteerde object niet wijzigen of wijzigen, maar u kunt een ander regeltype selecteren met de vervolgkeuzelijst Regel, zoals hieronder wordt weergegeven. Als u een regel voor een ander object wilt maken, selecteert u Annuleren om de regeleditor af te sluiten en opnieuw te starten vanuit het gewenste formulierobject.

  2. Selecteren Select State vervolgkeuzelijst en selecteer is equal to. De Enter a String wordt weergegeven.

    write-rules-visual-editor-2

  3. In de Enter a String veld in de regel, selecteert u Gehuwd in het keuzemenu.

    write-rules-visual-editor-4

    U hebt de voorwaarde gedefinieerd als When Marital Status is equal to Married. Definieer vervolgens de actie die moet worden uitgevoerd als deze voorwaarde Waar is.

  4. Selecteer in de instructie Vervolgens de optie Show van de Select Action vervolgkeuzelijst.

    write-rules-visual-editor-5

  5. Sleep de Spouse Salary veld op het tabblad Formulierobjecten in het dialoogvenster Drop object or select here veld. U kunt ook de Drop object or select here en selecteer de Spouse Salary in het pop-upmenu waarin alle formulierobjecten in het formulier worden vermeld.

    write-rules-visual-editor-6

    Definieer vervolgens de handeling die moet worden uitgevoerd als deze voorwaarde false is.

  6. Klikken Add Else Section om een andere voorwaarde voor de Spouse Salary veld, voor het geval u de huwelijksstatus als enkelvoudig selecteert.

    when-else

  7. Selecteer in de instructie Else de optie Hide van de Select Action vervolgkeuzelijst.
    when-else

  8. Sleep de Spouse Salary veld op het tabblad Formulierobjecten in het dialoogvenster Drop object or select here veld. U kunt ook de Drop object or select here en selecteer de Spouse Salary in het pop-upmenu waarin alle formulierobjecten in het formulier worden vermeld.
    when-else

    De regel wordt als volgt weergegeven in de regeleditor.

    write-rules-visual-editor-7

  9. Selecteren Done om de regel op te slaan.

NOTE
Alternatief, kunt u een Show regel op het gebied van de Salaris van de Echtgenote, in plaats van een wanneer regels op het gebied van de Burgerlijke Status, schrijven om het zelfde gedrag uit te voeren.

write-rules-visual-editor-9

  1. Vervolgens schrijft u een regel om het beleenbare bedrag van de lening te berekenen, dat 50% van het totale salaris is, en geeft u dit weer in het veld Beleenbaarheid van de lening. Om dit resultaat te bereiken, kunt u Set value Of regels betreffende het veld voor de toelaatbaarheid van leningen.

    Selecteer in de ontwerpmodus de optie Loan Eligibility veld en selecteer bewerkingsregels . Selecteer vervolgens Create om de regeleditor te starten.

  2. Selecteren Set Value Of van de regeldrop-down.

    write-rules-visual-editor-10

  3. Selecteren Select Option en selecteert u Mathematical Expression. Er wordt een veld voor het schrijven van wiskundige expressies geopend.

    write-rules-visual-editor-11

  4. In het expressieveld:

    • Selecteer of sleep een neerzetbewerking op het tabblad Forms Object Salary veld in de eerste Drop object or select here veld.

    • Selecteren Plus van de Select Operator veld.

    • Selecteer of sleep een neerzetbewerking op het tabblad Forms Object Spouse Salary veld in het andere Drop object or select here veld.

    write-rules-visual-editor-12

  5. Selecteer vervolgens in het gemarkeerde gebied rond het expressieveld en selecteer Extend Expression.

    write-rules-visual-editor-13

    Selecteer in het veld Uitgebreide expressie de optie divided by van de Select Operator veld en Number van de Select Option veld. Geef vervolgens 2 in het nummerveld.

    write-rules-visual-editor-14

    note note
    NOTE
    U kunt complexe expressies maken met behulp van componenten, functies, wiskundige expressies en eigenschapwaarden in het veld Optie selecteren.

    Maak vervolgens een voorwaarde die, wanneer True wordt geretourneerd, de expressie uitvoert.

  6. Selecteren Add Condition om een instructie When toe te voegen.

    write-rules-visual-editor-15

    In de instructie Wanneer:

    • Selecteer of sleep vanaf het tabblad Formulierobject het Marital Status veld in het eerste Drop object or select here veld.

    • U kunt een keuze maken is equal to uit het Select Operator veld.

    • Selecteer Tekenreeks in het andere Drop object or select here veld en geef Married het op in het Enter a String veld.

    De regel wordt uiteindelijk als volgt weergegeven in de regeleditor. write-rules-visual-editor-16

  7. Selecteer Done. Het bespaart de regel.

  8. Herhaal stap 7 tot en met 14 om een andere regel te definiëren om de beleenbaarheid van de lening te berekenen als de burgerlijke stand eenmalig is. De regel wordt als volgt weergegeven in de regeleditor.

    write-rules-visual-editor-17

U kunt ook de regel Waarde instellen gebruiken om te bepalen of de lening in aanmerking komt in de Regel Wanneer die u hebt gemaakt om het veld Salaris van echtgenote te verbergen. De resulterende gecombineerde regel wanneer de Status van het Samenhang Enige is verschijnt als volgt in de regelredacteur.

write-rules-visual-editor-18

U kunt een gecombineerde regel schrijven om de zichtbaarheid van het veld Echtgenloon te bepalen en de beleenbaarheid van de lening berekenen wanneer de huwelijkse staat wordt gehuwd met behulp van de Else voorwaarde.

write-rules-visual-editor-19

Aangepaste functies in regeleditor custom-functions

Naast de functies die buiten de box vallen, zoals Som van die zijn vermeld in Uitvoer functies, kunt u douanefuncties in uw regelredacteur ook gebruiken. De redacteur van de regel steunt syntaxis JavaScript ECMAScript 2019 voor manuscripten en douanefuncties. Raadpleeg het artikel voor instructies over het maken van aangepaste functies Aangepaste functies in adaptieve Forms.

Regels beheren manage-rules

Eventuele bestaande regels voor een formulierobject worden weergegeven wanneer u het object selecteert en edit-rules1 . U kunt de titel en een voorvertoning van het regeloverzicht weergeven. Voorts laat UI u de volledige regelsamenvatting uitbreiden en bekijken, de orde van regels veranderen, regels uitgeven, en regels schrappen.

Lijstregels

U kunt de volgende handelingen op regels uitvoeren:

  • Uitvouwen/samenvouwen: De kolom Inhoud in de lijst met regels geeft de inhoud van de regel weer. Als de volledige regelinhoud niet zichtbaar is in de standaardweergave, selecteert u expandRule-content om het uit te breiden.

  • Opnieuw: Nieuwe regels die u maakt, worden onder aan de lijst met regels gestapeld. De regels worden van boven naar beneden uitgevoerd. De regel bij de bovenkant voert eerst gevolgd door andere regels van het zelfde type uit. Bijvoorbeeld, als u hebt wanneer, tonen, toelaten, en wanneer de regels bij eerste, tweede, derde, en vierde posities van bovenkant, respectievelijk, wanneer de regel bij de bovenkant eerst wordt uitgevoerd gevolgd door wanneer de regel bij de vierde positie. Vervolgens worden de regels Tonen en Inschakelen uitgevoerd.
    U kunt de volgorde van een regel wijzigen door te tikken sorteerregels of sleep het naar de gewenste volgorde in de lijst.

  • Bewerken: Als u een regel wilt bewerken, schakelt u het selectievakje naast de regeltitel in. Er worden opties weergegeven voor het bewerken en verwijderen van de regel. Selecteren Edit om de geselecteerde regel in de regeleditor te openen .

  • Verwijderen: Als u een regel wilt verwijderen, selecteert u de regel en selecteert u Delete.

  • In-/uitschakelen: Wanneer u het gebruik van een regel tijdelijk moet onderbreken, kunt u een of meer regels selecteren en Disable in de werkbalk Handelingen om deze uit te schakelen. Als een regel is uitgeschakeld, wordt deze niet uitgevoerd tijdens de runtime. Als u een uitgeschakelde regel wilt inschakelen, selecteert u deze en selecteert u Inschakelen op de werkbalk Handelingen. De statuskolom van de regel geeft aan of de regel is ingeschakeld of uitgeschakeld.

Regel uitschakelen

Regels kopiëren en plakken copy-paste-rules

U kunt een regel kopiëren-kleven van één gebied aan andere gelijkaardige gebieden om tijd te besparen.

Ga als volgt te werk om regels te kopiëren en te plakken:

  1. Selecteer het formulierobject waaruit u een regel wilt kopiëren en selecteer op de werkbalk van het onderdeel regel bewerken . De gebruikersinterface van de regeleditor wordt weergegeven terwijl het formulierobject is geselecteerd en de bestaande regels worden weergegeven.

    kopieerregel

    Voor informatie over het beheren van bestaande regels raadpleegt u Regels beheren.

  2. Schakel het selectievakje naast de titel van de regel in. Er worden opties voor het beheer van de regel weergegeven. Selecteren Copy.

    copyrule2

  3. Selecteer een ander formulierobject waarop u de regel wilt plakken en selecteer Paste. Bovendien kunt u de regel bewerken om er wijzigingen in aan te brengen.

    note note
    NOTE
    U kunt een regel alleen in een ander formulierobject plakken als dat formulierobject de gebeurtenis van de gekopieerde regel ondersteunt. Een knop ondersteunt bijvoorbeeld de gebeurtenis click. U kunt een regel met een klikgebeurtenis aan een knoop maar niet aan een controledoos kleven.
  4. Selecteren Done om de regel op te slaan.

Geneste expressies nestedexpressions

De redacteur van de regel laat u veelvoudige EN en OF exploitanten gebruiken om genestelde regels tot stand te brengen. U kunt veelvoudige EN en OF exploitanten in regels mengen.

Hieronder ziet u een voorbeeld van een geneste regel die een bericht weergeeft aan de gebruiker dat hij of zij in aanmerking komt voor de voogdij van een kind als aan de vereiste voorwaarden is voldaan.

Complexe expressie

U kunt ook voorwaarden slepen en neerzetten in een regel om deze te bewerken. Selecteren en boven de greep plaatsen ( handgreep ) vóór een voorwaarde. Zodra de aanwijzer verandert in het handsymbool zoals hieronder wordt weergegeven, sleept u de voorwaarde en zet u deze neer op een willekeurige plaats binnen de lijn. De regelstructuur verandert.

Slepen en neerzetten

Datumexpressievoorwaarden dateexpression

De redacteur van de regel laat u datumvergelijkingen gebruiken om voorwaarden tot stand te brengen.

Na is een voorbeeldvoorwaarde die een statisch tekstvoorwerp toont als de hypotheek op het huis reeds wordt genomen, dat de gebruiker door het datumgebied te vullen aangeeft.

Wanneer de hypotheekdatum van het onroerend goed, zoals door de gebruiker ingevuld, in het verleden ligt, geeft het Adaptief formulier een toelichting op de berekening van het inkomen. In de volgende regel wordt de datum die door de gebruiker is ingevuld, vergeleken met de huidige datum en als de datum die door de gebruiker is ingevuld eerder is dan de huidige datum, wordt in het formulier het tekstbericht (Income genoemd) weergegeven.

Voorwaarde datumexpressie

Als de ingevulde datum eerder is dan de huidige datum, wordt in het formulier het volgende tekstbericht (Inkomsten) weergegeven:

Datum-expressievoorwaarde voldaan

Numerieke vergelijkingsvoorwaarden number-comparison-conditions

De redacteur van de regel laat u voorwaarden tot stand brengen die twee aantallen vergelijken.

Na is een voorbeeldvoorwaarde die een statisch tekstvoorwerp toont als het aantal maanden een aanvrager op huidige adres minder dan 36 blijft.

Vergelijkingsvoorwaarde voor nummers

Wanneer de gebruiker aangeeft minder dan 36 maanden op het huidige woonadres te wonen, wordt in het formulier gemeld dat meer bewijs van verblijf kan worden aangevraagd.

Meer bewijs aangevraagd

Voorbeelden van regels example

Service Formuliergegevensmodel aanroepen invoke

Een webservice overwegen GetInterestRates die het bedrag van de lening, de looptijd en de kredietscore van de aanvrager als input neemt en een leningsprogramma retourneert met inbegrip van het bedrag en de rentevoet van het EMI. U maakt een FDM (Form Data Model) met de webservice als gegevensbron. U voegt gegevensmodelobjecten en een get service aan het formuliermodel. De service wordt weergegeven op het tabblad Services van het formuliergegevensmodel (FDM). Maak vervolgens een adaptief formulier dat velden van gegevensmodelobjecten bevat om de gebruikersinvoer voor het bedrag van de lening, de looptijd en de creditscore vast te leggen. Voeg een knop toe die de webservice activeert om plandetails op te halen. De uitvoer wordt ingevuld in de desbetreffende velden.

De volgende regel toont hoe u de Invoke de dienstactie vormt om het voorbeeldscenario te verwezenlijken.

Example-invoke-services

NOTE
Als de invoer van een arraytype is, zijn de velden die arrays ondersteunen zichtbaar onder de vervolgkeuzelijst Uitvoer.

Meerdere handelingen triggeren met de regel Wanneer triggering-multiple-actions-using-the-when-rule

In een aanvraagformulier voor een lening wilt u vastleggen of de aanvrager van de lening een bestaande klant is of niet. Op basis van de informatie die de gebruiker opgeeft, moet het veld met de klant-id worden weergegeven of verborgen. Ook, wilt u nadruk op het gebied van identiteitskaart van de klant plaatsen als de gebruiker een bestaande klant is. Het aanvraagformulier voor de lening bestaat uit de volgende onderdelen:

  • een keuzerondje, Are you an existing Geometrixx customer?, die Yes en No opties. De waarde voor Ja is 0 en Nee is 1.

  • Een tekstveld, Geometrixx customer ID om de klant-id op te geven.

Wanneer u wanneer regel op het radioknoop schrijft om dit gedrag uit te voeren, verschijnt de regel als volgt in de visuele regelredacteur.

When-rule-example

Regel in de visuele editor

In de voorbeeldregel, is de verklaring in wanneer sectie de voorwaarde is, die wanneer Waar terugkeert, de acties uitvoert die in de Dan sectie worden gespecificeerd.

Een functie-uitvoer in een regel gebruiken using-a-function-output-in-a-rule

In een inkooporderformulier hebt u de volgende tabel waarin gebruikers hun bestellingen invullen. In deze tabel:

  • De eerste rij is herhaalbaar, zodat kunnen de gebruikers tot veelvoudige producten opdracht geven en verschillende hoeveelheden specificeren. De elementnaam is Row1.
  • De titel van de cel in de kolom Product Quantity van de herhaalbare rij is Quantity. De elementnaam voor deze cel is productquantity.
  • De tweede rij in de tabel is niet-herhaalbaar en de titel van de cel in de kolom Hoeveelheid product in deze rij is Totale hoeveelheid.

Example-function-table

A. Rij1 B. Aantal C. Totale hoeveelheid

Nu, wilt u gespecificeerde hoeveelheden in de kolom van de Hoeveelheid van het Product voor alle producten toevoegen en de som in de Totale cel van de Hoeveelheid tonen. U kunt deze som bereiken door een Set Waarde van regel op de Totale cel van de Hoeveelheid te schrijven zoals hieronder getoond.

Example-function-output

Regel in de visuele editor

Een veldwaarde valideren met expressie validating-a-field-value-using-expression

In het inkooporderformulier dat in het vorige voorbeeld wordt beschreven, wilt u de gebruiker beperken om meer dan één hoeveelheid van een product te bestellen waarvan de prijs hoger is dan 10000. Voor deze validatie kunt u een validatieregel schrijven, zoals hieronder wordt weergegeven.

Voorbeeld-validate

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab