Versie
Artikelkoppeling
AEM as a Cloud Service (Core Components)
Dit artikel
AEM as a Cloud Service (Foundation Components)
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. Enkele belangrijke acties die u met behulp van regels kunt uitvoeren op Adaptief 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 groep forms-users kunnen de scripts gebruiken, maar maken of bewerken geen scripts.

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 van de dropdown lijst worden geplaatst gebruikend de 2} Vastgestelde Opties van de Redacteur van de Regel van bezit.
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 de Vastgestelde Waarde van optie van de Redacteur van de Regel.
De Vastgestelde Waarde van optie steunt niet het 3} bezit van de output van de Dienst {voor het aanhalen van APIs in de Redacteur van de Regel.
NOTE
Om te zien hoe te om douanefuncties tot stand te brengen en in detail te gebruiken, verwijs naar functies van de Douane in Aanpassings Forms (de Componenten van de Kern)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 ) die wordt 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, bepaalt een regel eerst een voorwaarde die door een actie wordt gevolgd om teweeg te brengen. De constructie is vergelijkbaar met if-then statement in programmeertalen.

In regelredacteur, wanneer regeltype de voorwaarde-actie constructie afdwingt.

actie-Voorwaarde in deze constructie, bepaalt een regel eerst een actie om te teweegbrengen die door voorwaarden voor evaluatie wordt gevolgd. 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 regeltypes in regelredacteur.

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 regeltypes in regelredacteur.

  • 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: keert waar terug wanneer de gebruiker een bepaalde optie voor een checkbox, drop-down, radioknoop selecteert.
  • wordt geïnitialiseerd (gebeurtenis): keert waar terug wanneer een vormvoorwerp in browser teruggeeft.
  • wordt Gewijzigd (gebeurtenis): keert waar terug wanneer de gebruiker de ingegane waarde of de geselecteerde optie voor een vormvoorwerp verandert.

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 regelsschrijven.

When whenruletype

Het When regeltype volgt de voorwaarde-actie-afwisselende actie regelconstructie, of soms, enkel de voorwaarde-actie constructie. In dit regeltype geeft u eerst een voorwaarde op voor evaluatie gevolgd door een actie die moet worden geactiveerd als aan de voorwaarde is voldaan ( True). Terwijl het gebruiken van wanneer regeltype, kunt u veelvoudige EN en OF exploitanten gebruiken om genestelde uitdrukkingentot stand te brengen.

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:

de multi opties van waardevertoningen

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

Duidelijke waarde van

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

Meerdere velden toegestaan in When allowed-multiple-fields

In wanneer voorwaarde, hebt u de optie om andere gebieden behalve het gebied toe te voegen 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

_

Toegestane Meerdere gebieden binnen wanneer

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 component Guide Container van het adaptieve formulier.
  3. Klik de eigenschappen van de Container van de Gids eigenschappen van de Gids 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 Schakelt het opgegeven object in.

Disable Schakelt het opgegeven object uit.

Invoke service Roept een dienst aan die in een model van vormgegevens (FDM) wordt gevormd. Wanneer u de Invoke-service kiest, wordt een veld weergegeven. Als op het veld wordt getikt, worden alle services weergegeven die in het gehele formuliergegevensmodel (FDM) zijn geconfigureerd op uw 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 {de Integratie van 0} Gegevens 🔗.Experience Manager Forms

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 gehele FDM-formuliergegevensmodel zijn geconfigureerd op uw 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 {de Integratie van 0} Gegevens 🔗.Experience Manager Forms

Met het regeltype Set Property 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 (Koord [])
  • 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.

plaats Bezit

Als u een regel wilt definiëren die is gebaseerd op een aangepaste functie, selecteert u Function Output in de vervolgkeuzelijst en sleept u een aangepaste functie naar het tabblad Functions . Als aan de voorwaarde wordt voldaan, wordt het tekstinvoervak weergegeven.

Als u een regel wilt definiëren die is gebaseerd op een formulierobject, selecteert u Form Object in de vervolgkeuzelijst en sleept u een formulierobject van het tabblad Form Objects . 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:

Bezit van Objecten

Clear Value Of Wist de waarde van het opgegeven object.

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

Submit Form verzendt 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 verwijdert u een instantie van het opgegeven herhaalbare deelvenster of de opgegeven tabelrij.

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 Triggert de specifieke acties of gedragingen op basis van vooraf gedefinieerde voorwaarden of gebeurtenissen.

Set Value of set-value-of

Met het Set Value of -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 Vastgestelde Waarde van regeltype is niet beschikbaar voor alle vormvoorwerpen, zoals panelen en toolbarknopen. 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) OF
(outputwaarde van een dienst van het gegevensmodel);

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 het regeltype Show 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 als False wordt geretourneerd.

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 bij het regeltype Weergeven kunt u het regeltype Hide gebruiken 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 voor het geval dat niet aan de voorwaarde wordt voldaan of dat False wordt geretourneerd.

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

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

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

Net als bij het regeltype Enable kunt u met het Disable -regeltype 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 Inschakelen als de voorwaarde niet wordt vervuld of als False wordt geretourneerd.

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

Het regeltype Validate valideert de waarde in een veld met behulp van 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 in het veld Script validation message opgeven in de componenteigenschappen op de zijbalk.

manuscript-bevestiging

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 vormvoorwerp waarvoor u een regel wilt schrijven, en in Toolbar van de Component selecteren geef-regels uit. De gebruikersinterface van de regeleditor wordt weergegeven.

    creeer-regels

    Eventuele bestaande regels voor de geselecteerde formulierobjecten worden in deze weergave weergegeven. Voor informatie over het beheren van bestaande regels, zie regelsleiden.

  3. Selecteer 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.

    de Redacteur UI van de Regel

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

Het deelvenster links in de gebruikersinterface van de regeleditor bevat twee tabbladen: 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 lusje van 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. Voor meer informatie, zie kopiëren-kleeft regels.

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 regelsschrijven.

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

Met de knop Done kunt u een regel opslaan. 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. Voor meer informatie, zie regelsleiden.

Met de knop Cancel verwijdert u alle wijzigingen die u in een regel hebt aangebracht en sluit u de regeleditor.

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 component en selecteer geef-regels uit. Selecteer vervolgens Create om de regeleditor te starten.

    schrijven-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. Selecteer Select State vervolgkeuzelijst en selecteer is equal to . Het veld Enter a String wordt weergegeven.

    schrijven-rules-visual-editor-2

  3. Op het Enter a String gebied in de regel, uitgezocht Gehuwd van drop-down menu.

    schrijven-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 Show in de vervolgkeuzelijst Select Action .

    schrijven-rules-visual-editor-5

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

    schrijven-rules-visual-editor-6

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

  6. Klik op Add Else Section om een andere voorwaarde voor het veld Spouse Salary toe te voegen, voor het geval u de staat van het huwelijk als één voorwaarde selecteert.

    wanneer-anders

  7. Selecteer in de instructie else Hide in de vervolgkeuzelijst Select Action .
    wanneer-anders

  8. Sleep het veld Spouse Salary naar het tabblad Formulierobjecten in het veld Drop object or select here . U kunt ook het veld Drop object or select here selecteren en het veld Spouse Salary in het pop-upmenu selecteren, waarin alle formulierobjecten in het formulier worden vermeld.
    wanneer-anders

    De regel wordt als volgt weergegeven in de regeleditor.

    schrijven-rules-visual-editor-7

  9. Selecteer 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.

schrijven-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. U bereikt dit resultaat door Set value Of regels te maken voor het veld Beleenbaarheid van leningen.

    Op auteurswijze, selecteer het Loan Eligibility gebied en selecteer geef-regels uit. Selecteer vervolgens Create om de regeleditor te starten.

  2. Selecteer Set Value Of regel in de vervolgkeuzelijst met regels.

    schrijven-rules-visual-editor-10

  3. Selecteer Select Option en selecteer Mathematical Expression . Er wordt een veld voor het schrijven van wiskundige expressies geopend.

    schrijven-regels-visueel-redacteur-11

  4. In het expressieveld:

    • Selecteer of sleep-daling van het lusje van de Objecten van Forms het Salary gebied in het eerste Drop object or select here gebied.

    • Selecteer Plus in het veld Select Operator .

    • Selecteer of sleep-daling van het lusje van de Objecten van Forms het Spouse Salary gebied in het andere Drop object or select here gebied.

    schrijven-regels-visueel-redacteur-12

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

    schrijven-regels-visueel-redacteur-13

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

    schrijven-regels-visueel-redacteur-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. Selecteer Add Condition om de 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. schrijven-regels-visueel-redacteur-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.

    schrijven-regels-visueel-redacteur-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.

schrijven-regels-visueel-redacteur-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.

schrijven-regels-visueel-redacteur-19

Aangepaste functies in regeleditor custom-functions

Naast de uit-van-de-doos functies als Som van die onder Uitvoer van Functies vermeld zijn, kunt u douanefuncties in uw regelredacteur ook gebruiken. De redacteur van de regel steunt de syntaxis van JavaScript ECMAScript 2019 voor manuscripten en douanefuncties. Voor instructies bij het creëren van douanefuncties, verwijs naar de artikel Functies van de Douane in Aanpassings Forms.

Regels beheren manage-rules

Om het even welke bestaande regels op een vormvoorwerp zijn vermeld wanneer u het voorwerp selecteert en uitgezocht geef-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.

lijst-lijnen

U kunt de volgende handelingen op regels uitvoeren:

  • breid/Vouw samen: De kolom van de Inhoud in de regellijst toont de regelinhoud. Als de volledige regelinhoud niet zichtbaar in de standaardmening is, uitgezocht groter-regel-inhoud om het uit te breiden.

  • opnieuw rangschikt: Om het even welke nieuwe regel u creeert wordt gestapeld bij de bodem van de regellijst. 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 orde van een regel veranderen door soort-regels tegen het te tikken of belemmering-daling het aan de gewenste orde in de lijst.

  • geeft uit: Om een regel uit te geven, selecteer het controlevakje naast de regeltitel. Er worden opties weergegeven voor het bewerken en verwijderen van de regel. Selecteer Edit om de geselecteerde regel te openen in de regeleditor .

  • Schrapping: Om een regel te schrappen, selecteer de regel en selecteer Delete.

  • toelaten/onbruikbaar maken: Wanneer u gebruik van een regel tijdelijk moet onderbreken, kunt u één of meerdere regels selecteren en Disable in de toolbar van Acties selecteren om hen onbruikbaar te maken. 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.

maak regel onbruikbaar

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 vormvoorwerp waarvan u een regel wilt kopiëren, en in de componententoolbar uitgezocht geef regel uit. De gebruikersinterface van de regeleditor wordt weergegeven terwijl het formulierobject is geselecteerd en de bestaande regels worden weergegeven.

    exemplaarregel

    Voor informatie over het beheren van bestaande regels, zie regelsleiden.

  2. Schakel het selectievakje naast de titel van de regel in. Er worden opties voor het beheer van de regel weergegeven. Selecteer 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. Selecteer 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 uitdrukking

U kunt ook voorwaarden slepen en neerzetten in een regel om deze te bewerken. Selecteer en beweegt over het handvat ( handvat ) 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.

belemmering-en-daling

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.

de vergelijkingsvoorwaarde van het Aantal

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 gevraagde proef

Voorbeelden van regels example

Service Formuliergegevensmodel aanroepen invoke

Bekijk een webservice GetInterestRates die het bedrag van de lening, de looptijd en de creditscore van de aanvrager als input gebruikt en een leningenplan retourneert met daarin 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 toe 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.

voorbeeld-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? , dat opties Yes en No biedt. De waarde voor ja is 0 en Nr 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.

wanneer-regel-voorbeeld

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.

voorbeeld-functie-lijst

A. Row1 B. Hoeveelheid 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.

voorbeeld-functie-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