De types en de gebeurtenissen van de exploitant in regelredacteur van een Adaptief Vorm die op de Componenten van de Kern wordt gebaseerd

In AEM Forms als Cloud bevat de regeleditor verschillende typen operatoren en gebeurtenissen waarmee u eenvoudig complexe voorwaarden en handelingen kunt definiëren en uitvoeren.

De operatortypen die beschikbaar zijn in de regeleditor van een adaptief formulier bieden een robuust kader voor het samenstellen van nauwkeurige voorwaarden. Hiermee kunt u gegevens manipuleren, berekeningen uitvoeren en meerdere voorwaarden op een logische en coherente manier combineren. Of u nu waarden vergelijkt, rekenkundige bewerkingen uitvoert of tekenreeksen manipuleert, deze operatoren zorgen ervoor dat uw regels zowel flexibel als krachtig zijn.

De gebeurtenissen in de regelredacteur dienen als trekkers die uw regels activeren. Ze definiëren de specifieke acties die optreden wanneer aan bepaalde voorwaarden wordt voldaan. Door gebruik te maken van verschillende soorten gebeurtenissen, kunt u reacties op een breed scala aan scenario's automatiseren, bijvoorbeeld gebruikersinteracties, geplande tijden, wijzigingen in gegevens en systeemstatussen. Met de mogelijkheid om deze triggers te specificeren, kunt u dynamische en responsieve regels maken die voldoen aan uw specifieke vereisten.

Door de beschikbare exploitanttypes en de gebeurtenissen te begrijpen en te gebruiken, kunt u het volledige potentieel van de regelredacteur ontgrendelen, die u toelaat om efficiënte, en efficiënte regels tot stand te brengen die aan uw unieke behoeften voldoen en algemene systeemfunctionaliteit te verbeteren.

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 - Controleert als een vormvoorwerp een gespecificeerde waarde aanpast.
  • is niet Gelijk aan - Controleert als een vormvoorwerp geen gespecificeerde waarde aanpast.
  • begint met - Controleert als een vormvoorwerp met een gespecificeerd koord begint.
  • eindigt met - Controleert als een vormvoorwerp met een gespecificeerd koord beëindigt.
  • bevat - controleert als een vormvoorwerp een gespecificeerd substring omvat.
  • bevat niet - controleert als een vormvoorwerp geen gespecificeerd substring omvat.
  • is Leeg - Controleert als een vormvoorwerp leeg is of niet verstrekt.
  • is niet Leeg - Controleert als een vormvoorwerp aanwezig en niet leeg is.
  • heeft Geselecteerd - Keert waar terug wanneer een gebruiker een specifieke checkbox, drop-down, of radioknoopoptie selecteert.
  • wordt geïnitialiseerd (gebeurtenis) - keert waar terug wanneer een vormvoorwerp in browser wordt teruggegeven.
  • wordt Veranderd (gebeurtenis) - Keert waar terug wanneer een gebruiker de waarde of de selectie van een vormvoorwerp wijzigt.
  • wordt geklikt (gebeurtenis) - Keert waar terug wanneer een gebruiker een vormvoorwerp, bijvoorbeeld, een knoop klikt. Een gebruiker kan veelvoudige voorwaarden aan de knoop toevoegen klikt.
  • is Geldig - Controleert als een vormvoorwerp aan bevestigingscriteria voldoet.
  • is niet Geldig - Controleert als een vormvoorwerp bevestigingscriteria ontbreekt.

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 de 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 het regeltype alleen ondersteuning biedt voor single-level then-else statements.
Toegestaan Meerdere velden in When allowed-multiple-fields

In de voorwaarde 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

_

Toegestane Meerdere gebieden binnen wanneer

Overwegingen terwijl het gebruiken van Toegestane Meerdere gebieden in wanneer voorwaardelement

  • Zorg ervoor dat de kerncomponent aan versie 3.0.14 of recenterwordt geplaatst om deze eigenschap in de regelredacteur te gebruiken.
  • Als regels worden toegepast op verschillende velden binnen de voorwaarde Wanneer, wordt de regel geactiveerd, zelfs als slechts een van deze velden wordt gewijzigd.
  • U kunt alleen de meerdere velden toevoegen in de voorwaarde Wanneer voor een EN-regel . Het is niet mogelijk voor een OF-regel .
NOTE
Als u meerdere voorwaarden wilt toevoegen die een klik op een knop bevatten, moet u ervoor zorgen dat de gebeurtenis 'Klikken op knop' als eerste voorwaarde is geplaatst. Is When button is clicked AND text input equals '5' bijvoorbeeld geldig, terwijl When text input equals '5' AND button is clicked wordt niet ondersteund.

Als er problemen optreden met de toegestane meerdere velden in de functie Wanneer-voorwaarde, volgt u de stappen voor probleemoplossing als:

  1. Open het formulier in de bewerkingsmodus.
  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 Toont het opgegeven object.

Enable Hiermee schakelt u 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 invoerparameters voor de opgegeven service. U kunt de uitvoerparameters toewijzen via de optie voor gebeurtenislading voor de opgegeven service. U kunt regels voor de behandeling van succes en mislukkingsreacties van de Invoke de dienstverrichting ook tot stand brengen gebruikend de regelredacteur.

NOTE
Meer over de Invoke dienst leren, klik hier.

Zie de voorbeeldregel voor het aanhalen 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 behulp van een 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 de 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 aangepaste functie, een formulierobject, een objecteigenschap of een service-uitvoer gebruiken om een regel te definiëren.

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 Navigeer 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:

(Snaar ABC) OF
(object eigenschap X van Object C) OF
(waarde van een functie) OF
(waarde van een wiskundige uitdrukking) OF
(outputwaarde van een datamodelservice);

Wanneer (optioneel):

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

In het volgende voorbeeld wordt de waarde van Question2 geselecteerd als True en wordt de waarde van Result als correctingesteld.

reeks-waarde-web-dienst

Voorbeeld van waardeceregel 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 als volgt gestructureerd:

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 Hide regeltype 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 actie Weergeven voor het geval niet aan de voorwaarde wordt voldaan of terugkeert 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

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 een 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

Met het regeltype Navigate among the panels kunt u de focus verplaatsen tussen verschillende deelvensters in een formulier. U kunt bijvoorbeeld een expressie maken om de focus naar het volgende deelvenster te verplaatsen.

Een typisch navigeert onder de panelen regel voor het verschuiven van nadruk naar het volgende paneel is gestructureerd als volgt:

Navigate among the panels

Shift focus to the next item Object A;

When:

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

Op dezelfde manier kunt u navigeren onder de panelen regel voor het verschuiven van nadruk naar het vorige paneel:

Navigate among the panels

Shift focus to the previous item Object A;

When:

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

Voor meer details op hoe te om een regel tot stand te brengen om in een paneel te navigeren, klik hier.

Async Function call

Dit is een pre-versieeigenschap en toegankelijk door ons pre-vrijgavekanaal.

Met het Async Function call -regeltype kunt u asynchrone functies uitvoeren. Het laat u toe om een functievraag in werking te stellen die onafhankelijk van de belangrijkste uitvoeringsdraad werkt, toestaand andere processen blijven lopend zonder het wachten op de asynchrone functie te voltooien.

Een typisch Async de vraagregel van de Functie om asynchrone functie uit te voeren is gestructureerd als volgt:

When:

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

Async Function call

[Callback Function];

Voor meer informatie over hoe te om de vraag van de Functie Async in de Visuele Redacteur van de Regel te gebruiken, verwijs naar Gebruikend asynchrone functievraag in het artikel van de regeleditor.

Volgende stap

Laten wij nu diverse voorbeelden voor een Redacteur van de Regel voor een AanpassingsVorm begrijpen die op de Componenten van de Kernwordt gebaseerd.

Zie ook

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