[AEM Forms]{class="badge positive" title="van toepassing op AEM Forms)."}
De gebruikersinterface van de Redacteur van de regel voor Adaptieve Forms die op de Componenten van de Kern wordt gebaseerd
De gebruikersinterface van de Rule Editor voor Adaptive Forms op basis van Core Components verbetert het proces voor het maken van formulieren in Adobe Experience Manager (AEM). Het stelt zowel zakelijke gebruikers als ontwikkelaars in staat dynamisch gedrag en complexe logica in formulieren te implementeren door regels te schrijven die handelingen activeren op basis van vooraf gedefinieerde voorwaarden, gebruikersinvoer en interacties. Deze functie ondersteunt moderne JavaScript-functies tot ES2022 en biedt een intuïtieve visuele editor die het regelschrijfproces vereenvoudigt.
De Editor voor regels is handig voor het stroomlijnen van de ervaring die het invullen van formulieren met zich meebrengt, zodat u zowel accuraat als efficiënt kunt werken. Hiermee kunt u deelvensters en formulieren valideren of opnieuw instellen en kunt u aangepaste functies uitvoeren om waarden van formulierobjecten te berekenen. Met zijn steun voor geneste voorwaarden en de capaciteit om de modeldiensten van de Gegevens van de Vorm aan te halen, is het Gebruikersinterface van de Redacteur van de Regel een essentiële component voor het creëren van ontvankelijke, gebruikersvriendelijke, en adaptieve vormen.
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:
-
Open een adaptief formulier in de ontwerpmodus.
-
Selecteer het vormvoorwerp waarvoor u een regel wilt schrijven, en in Toolbar van de Component selecteren
Eventuele bestaande regels voor de geselecteerde formulierobjecten worden in deze weergave weergegeven. Voor informatie over het beheren van bestaande regels, zie regels leiden.
-
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.
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:
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 een visuele regelredacteur, zie regels schrijven.
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 regels leiden.
De knoop Cancel verwerpt om het even welke veranderingen die u aan een regel aanbracht en sluit de regelredacteur.
Schrijfregels write-rules
U kunt regels schrijven met de visuele regeleditor
Laten we eerst bekijken hoe u regels schrijft met een visuele editor.
Laten we begrijpen hoe u een regel maakt in een visuele editor met behulp van het volgende voorbeeldformulier.
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:
-
Eerst schrijft u de regel om de zichtbaarheid van het veld Sjabloon bij echtgeno(o)t(e) in te stellen op basis van de optie die de gebruiker selecteert voor het keuzerondje Genderstatus.
Open het aanvraagformulier voor de lening in de ontwerpmodus. Selecteer de Marital Status component en selecteer
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.
-
Selecteer Select State vervolgkeuzelijst en selecteer is equal to . Het veld Enter a String wordt weergegeven.
-
Op het Enter a String gebied in de regel, uitgezocht Gehuwd van het drop-down menu.
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. -
Selecteer in de instructie Vervolgens Show in de vervolgkeuzelijst Select Action .
-
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.
Definieer vervolgens de handeling die moet worden uitgevoerd als deze voorwaarde false is.
-
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.
-
Selecteer in de instructie else Hide in de vervolgkeuzelijst Select Action .
-
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.
De regel wordt als volgt weergegeven in de regeleditor.
-
Selecteer Done om de regel op te slaan.
| note note |
|---|
| 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. |
-
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 lening.
Op auteurswijze, selecteer het Loan Eligibility gebied en selecteer
-
Selecteer Set Value Of regel in de vervolgkeuzelijst met regels.
-
Selecteer Select Option en selecteer Mathematical Expression . Er wordt een veld voor het schrijven van wiskundige expressies geopend.
-
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.
-
-
Selecteer vervolgens in het gemarkeerde gebied rond het expressieveld en selecteer Extend Expression .
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.
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.
-
Selecteer Add Condition om de instructie When toe te voegen.
In de instructie When:
-
Selecteer of sleep-daling van het lusje van de Objecten van Forms het Marital Status gebied in het eerste Drop object or select here gebied.
-
Selecteer is equal to in het veld Select Operator .
-
Selecteer String in het andere veld Drop object or select here en geef Married op in het veld Enter a String .
De regel wordt uiteindelijk als volgt weergegeven in de regeleditor.
-
-
Selecteer Done. Het bespaart de regel.
-
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.
U kunt ook de regel Waarde instellen van gebruiken om de beleenbaarheid van leningen te berekenen in de regel When die u hebt gemaakt om het veld Salaris van de echtgenoot weer te geven en te verbergen. De resulterende gecombineerde regel wanneer de Status van het Samenhang Enige is verschijnt als volgt in de regelredacteur.
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.
Ondersteuning voor functies en wiskundige expressies in invoerparameters
Invoerparameters ondersteunen nu zowel functie-uitvoer, bijvoorbeeld concat, trim en join, als wiskundige expressies. Dankzij deze verbetering kunnen auteurs van formulieren dynamisch berekende waarden direct doorgeven, regelconfiguraties stroomlijnen, de behoefte aan extra velden verminderen en formulieren beter aanpassen aan complexe logische en op berekeningen gebaseerde scenario's.
Verbroken regels verwerken
Regels kunnen soms worden verbroken wanneer een veld waarnaar wordt verwezen, wordt verplaatst of verwijderd. Wanneer dit gebeurt, markeert de Redacteur van de Regel de beïnvloede regel met een rode stipindicator.
-
Wanneer een veld wordt verplaatst (bijvoorbeeld van het ene naar het andere deelvenster), kan de bijbehorende regel worden verbroken. In dit geval opent u de regel en slaat u deze opnieuw op. De regel wordt automatisch hersteld.
-
Wanneer een veld wordt verwijderd, kan de regel niet worden hersteld.
Om de kwestie te begrijpen, houd over de regelstatus in de Redacteur van de Regel om het foutenbericht te bekijken.
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
U kunt de volgende handelingen op de 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
-
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 de eerste, tweede, derde, en vierde posities van de 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
-
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.
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:
-
Selecteer het vormvoorwerp waarvan u een regel wilt kopiëren, en in de componententoolbar uitgezocht
Voor informatie over het beheren van bestaande regels, zie regels leiden.
-
Schakel het selectievakje naast de titel van de regel in. Er worden opties voor het beheer van de regel weergegeven. Selecteer Copy .
-
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. -
Selecteer Done om de regel op te slaan.
Volgende stap
Om de diverse exploitanttypes en de gebeurtenissen in de regelredacteur van een Aanpassende Vorm te begrijpen, verwijs naar de Beschikbare Types en Gebeurtenissen van Exploitant in de Redacteur van de Regel van een Aangepast 1} artikel van de Vorm.
Zie ook
- Inleiding aan de Redacteur van de Regel voor AanpassingsForms die op de Componenten van de Kern wordt gebaseerd
- De types en de gebeurtenissen van de exploitant in regelredacteur van een Adaptief Vorm die op de Componenten van de Kern wordt gebaseerd
- De Redacteur van de regel Gebruikersinterface voor Adaptieve Forms die op de Componenten van de Kern wordt gebaseerd
- Verschillende gevallen van gebruik van de Rule Editor voor een adaptief formulier op basis van kerncomponenten
- Verschil in verschillende versies van de redacteur van de Regel
- Asynchrone functies in een adaptief formulier gebruiken
- De verhogingen van de Dienst van de aanwending in de Visuele Redacteur van de Regel voor vormen die op de Componenten van de Kern worden gebaseerd
- Inleiding tot aangepaste functies voor adaptieve Forms op basis van kerncomponenten
- Een aangepaste functie maken voor een adaptief formulier op basis van kerncomponenten
- Object Scope in aangepaste functies
- Voorbeelden van het ontwikkelen en gebruiken van een aangepaste functie