Regeleditor voor adaptieve formulieren adaptive-forms-rule-editor
Overzicht overview
Met de functie voor regeleditors in Adobe Experience Manager Forms 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. Bovendien slechts voor de gebruikers van de vormenmacht, verstrekt de regelredacteur een coderedacteur om regels en manuscripten te schrijven. Enkele belangrijke handelingen die u op adaptieve formulierobjecten kunt uitvoeren met behulp van regels 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
- Een service van een formuliergegevensmodel aanroepen en een bewerking uitvoeren
- Eigenschap van een object instellen
De redacteur van de regel vervangt de scriptmogelijkheden in AEM 6.1 Forms en vroegere versies. Nochtans, worden uw bestaande manuscripten bewaard in de nieuwe regelredacteur. Voor meer informatie over het werken met bestaande manuscripten in de regelredacteur, zie Effect van regeleditor op bestaande scripts
Gebruikers die zijn toegevoegd aan de gebruikersgroep voor formulieren, kunnen nieuwe scripts maken en bestaande scripts bewerken. Gebruikers in de groep met gebruikers van formulieren kunnen de scripts gebruiken, maar kunnen geen scripts maken of bewerken.
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 staat u toe om voorwaarden en acties in een regel te 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 andersom. U kunt de alternatieve standaardhandeling niet wijzigen.
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
- 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.
Wanneer when
De Wanneer 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
Action 3 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:
Tijdens het schrijven van een When-regel kunt u de Clear Value of action activeren. Met Waarde wissen van handeling wordt de waarde van het opgegeven object gewist. Met de instructie 'Wissen' als een optie in de instructie 'Wanneer' kunt u complexe voorwaarden maken met meerdere velden.
Verbergen Verbergt het opgegeven object.
Tonen Hiermee wordt het opgegeven object weergegeven.
Inschakelen Hiermee wordt het opgegeven object ingeschakeld.
Uitschakelen Hiermee wordt het opgegeven object uitgeschakeld.
Invoke-service Roept de dienst aan die in een model van vormgegevens wordt gevormd. Wanneer u de Invoke-service kiest, wordt een veld weergegeven. Als u op het veld tikt, worden alle services weergegeven die zijn geconfigureerd in alle formuliergegevensmodellen op uw AEM. Als u een service voor een formuliergegevensmodel kiest, worden extra velden weergegeven waarin u formulierobjecten kunt toewijzen met invoer- en uitvoerparameters voor de opgegeven service. Zie voorbeeldregel voor het aanroepen van formuliergegevensmodelservices.
Naast formuliergegevensmodelservice kunt u een directe WSDL-URL opgeven om een webservice aan te roepen. Een service voor een formuliergegevensmodel heeft echter vele voordelen en de aanbevolen aanpak om een service aan te roepen.
Voor meer informatie over het vormen van de diensten in het model van vormgegevens, zie AEM Forms-gegevensintegratie.
Waarde instellen van 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 de wiskundige expressie of functie, de waarde van een eigenschap van een object of de uitvoerwaarde van een geconfigureerde formuliergegevensmodelservice. Wanneer u de optie Webservice kiest, worden alle services weergegeven die in alle formuliergegevensmodellen op uw AEM zijn geconfigureerd. Als u een service voor een formuliergegevensmodel kiest, worden extra 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, zie AEM Forms-gegevensintegratie.
Eigenschap instellen Stelt de waarde in van een eigenschap van het opgegeven object.
Waarde wissen van Wist de waarde van het opgegeven object.
Focus instellen Hiermee wordt de focus op het opgegeven object ingesteld.
Formulier opslaan Hiermee slaat u het formulier op.
Forms verzenden Hiermee verzendt u het formulier.
Formulier opnieuw instellen Hiermee herstelt u het formulier.
Formulier valideren Hiermee valideert u het formulier.
Instantie toevoegen Hiermee wordt een instantie van het opgegeven herhaalbare deelvenster of de opgegeven tabelrij toegevoegd.
Instantie verwijderen Hiermee wordt een instantie van het opgegeven herhaalbare deelvenster of de opgegeven tabelrij verwijderd.
Waarde instellen van 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 van een formuliergegevensmodel. 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.
Merk op dat de Vastgestelde Waarde van regeltype niet beschikbaar voor alle vormvoorwerpen, zoals panelen en toolbarknopen is. 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
(uitvoerwaarde van een gegevensmodeldienst of webdienst);
Indien (optioneel):
(Voorwaarde 1 EN Voorwaarde 2 EN Voorwaarde 3) is WAAR;
In het volgende voorbeeld wordt de waarde in dependentid
veld als invoer en stelt de waarde van de Relation
aan de output van Relation
argument van de getDependent
service formuliergegevensmodel.
Voorbeeld van waardeceregel instellen met de service van het formuliergegevensmodel
Tonen show
Met de Tonen 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;
Verbergen hide
Net als het regeltype Tonen kunt u de opdracht Verbergen 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;
Inschakelen enable
De Inschakelen 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;
Uitschakelen disable
Gelijkaardig aan het Enable regeltype, Uitschakelen 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;
Valideren validate
De Valideren 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;
Het begrip van de regel redacteursgebruikersinterface 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.
-
Tik op het formulierobject waarvoor u een regel wilt schrijven en tik op de werkbalk Component . De gebruikersinterface van de regeleditor wordt weergegeven.
Eventuele bestaande regels voor de geselecteerde formulierobjecten worden in deze weergave weergegeven. Voor informatie over het beheren van bestaande regels raadpleegt u Regels beheren.
-
Tikken 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. Weergave componentregel a-component-rule-display
Hiermee geeft u de titel weer van het adaptieve formulierobject waarmee u de regeleditor hebt gestart en het regeltype dat momenteel is geselecteerd. In het bovenstaande voorbeeld wordt de regeleditor gestart van een adaptief formulierobject met de naam Salary 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 wordt een hiërarchische weergave weergegeven van alle objecten in het aangepaste 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 wel aangepaste functies ook.
In de linkerstructuur van de formulierobjecten kunt u op de formulierobjecten tikken 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 d-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. Schakelaar voor bewerkingsprogramma's met visuele code e-visual-code-editors-switcher
Gebruikers in de gebruikersgroep voor formulieren hebben toegang tot de code-editor. Voor andere gebruikers is de code-editor niet beschikbaar. Als u de rechten hebt, kunt u van visuele redacteurswijze aan de wijze van de coderedacteur van de regel, en vice versa schakelen, gebruikend de schakelaar recht boven de regelredacteur. Wanneer u regelredacteur de eerste keer lanceert, opent het op de visuele redacteurswijze. U kunt regels op de visuele redacteurswijze schrijven of op de wijze schakelen van de coderedacteur om een regelmanuscript te schrijven. Nochtans, merk op dat als u een regel wijzigt of een regel in coderedacteur schrijft, u niet terug naar de visuele redacteur voor die regel kunt schakelen tenzij u de coderedacteur ontruimt.
AEM Forms volgt de wijze van de regelredacteur u het laatst gebruikte om een regel te schrijven. Wanneer u de regelredacteur de volgende keer lanceert, opent het op die wijze. Nochtans, kunt u een standaardwijze ook vormen om de regelredacteur op de gespecificeerde wijze te openen. Daartoe:
-
Ga naar AEM webconsole op https://[host]:[poort]/system/console/configMgr.
-
Klik om te bewerken Adaptive Form and Interactive Communication Web Channel Configuration.
-
kiezen Visual Editor of Code Editor van de Default Mode for Rule Editor vervolgkeuzelijst
-
Klik op Save.
F. Gereed en annuleer knoppen f-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 gebruikend de visuele regelredacteur of de coderedacteur. Wanneer u de regelredacteur de eerste keer lanceert, opent het op de visuele redacteurswijze. U kunt op de wijze van de coderedacteur schakelen en regels schrijven. Nochtans, merk op dat als u een regel in code redacteur schrijft of wijzigt, u niet aan de visuele redacteur voor die regel kunt schakelen tenzij u de coderedacteur ontruimt. Wanneer u de regelredacteur de volgende keer lanceert, opent het op de wijze die u het laatst gebruikte om regel tot stand te brengen.
Laten we eerst bekijken hoe u regels schrijft met een visuele editor.
Visuele editor gebruiken using-visual-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. Tik op de knop Burgerlijke staat component en tik . Tik vervolgens op Create om de regeleditor te starten.
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, tikt u op Annuleren om de regeleditor af te sluiten en start u deze opnieuw vanuit het gewenste formulierobject.
-
Tikken Select State vervolgkeuzelijst en selecteer is equal to. De Enter a String wordt weergegeven.
In het keuzerondje Burgerlijke staat Gehuwd en Enkel opties worden toegewezen 0 en 1 respectievelijk. U kunt toegewezen waarden verifiëren op het tabblad Titel van het dialoogvenster Keuzerondje bewerken, zoals hieronder wordt weergegeven.
-
In de Een tekenreeks invoeren veld in de regel, geef 0.
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 de optie Show van de Select Action vervolgkeuzelijst.
-
Sleep de Echtsalaris in het tabblad Formulierobjecten op het tabblad Object neerzetten of hier selecteren veld. Of tik op de knop Object neerzetten of hier selecteren en selecteer de Echtsalaris in het pop-upmenu waarin alle formulierobjecten in het formulier worden vermeld.
De regel wordt als volgt weergegeven in de regeleditor.
Tikken Gereed om de regel op te slaan.
-
Herhaal de stappen 1 tot en met 5 om een andere regel te definiëren waarmee het veld Echtloon wordt verborgen als de staat van het huwelijk een enkele regel is. De regel wordt als volgt weergegeven in de regeleditor.
note note NOTE Alternatief, kunt u één Show regel op het gebied van de Salaris van de Echtgenote, in plaats van twee schrijven wanneer de regels op het gebied van de Burgerlijke Status, 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. Hiertoe maakt u Waarde instellen van regels betreffende het veld voor de toelaatbaarheid van leningen.
Tik in de ontwerpmodus op de knop Loan Eligibility veld en tik . Tik vervolgens op Create om de regeleditor te starten.
-
Selecteren Set Value Of van de regeldrop-down.
-
Tikken Select Option en selecteert u Mathematical Expression. Er wordt een veld voor het schrijven van wiskundige expressies geopend.
-
In het veld Expressie:
- Selecteer of sleep het slepen van het lusje van de Objecten van Forms Salaris veld in de eerste Object neerzetten of hier selecteren veld.
- Selecteren Plus van de Operator selecteren veld.
- Selecteer of sleep het slepen van het lusje van de Objecten van Forms Echtsalaris veld in het andere Object neerzetten of hier selecteren veld.
-
Tik vervolgens in het gemarkeerde gebied rond het expressieveld en tik op Expressie uitbreiden.
Selecteer in het veld Uitgebreide expressie de optie gedeeld door van de Operator selecteren veld en Getal van de Optie selecteren veld. Geef vervolgens 2 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.
-
Tikken Voorwaarde toevoegen om een instructie When toe te voegen.
In de instructie When:
- Selecteer of sleep het slepen van het lusje van de Objecten van Forms Burgerlijke staat veld in de eerste Object neerzetten of hier selecteren veld.
- Selecteren i s gelijk aan van de Operator selecteren veld.
- Tekenreeks selecteren in het andere Object neerzetten of hier selecteren veld en specificeren Gehuwd in de Een tekenreeks invoeren veld.
De regel wordt uiteindelijk als volgt weergegeven in de regeleditor.
Tikken Gereed om de regel op te slaan.
-
Herhaal stap 7 tot en met 12 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.
Code-editor gebruiken using-code-editor
Gebruikers die aan de gebruikers in formulieren worden toegevoegd, kunnen de code-editor gebruiken. De regeleditor genereert automatisch de JavaScript-code voor elke regel die u met een visuele editor maakt. U kunt van visuele redacteur aan de coderedacteur schakelen om de geproduceerde code te bekijken. Nochtans, als u de regelcode in de coderedacteur wijzigt, kunt u niet terug naar de visuele redacteur schakelen. Als u liever regels schrijft in code-editor dan in een visuele editor, kunt u regels opnieuw schrijven in de code-editor. Met de schakeloptie voor visuele-codeeditors kunt u schakelen tussen de twee modi.
De code-editor JavaScript is de expressietaal van adaptieve formulieren. Alle expressies zijn geldige JavaScript-expressies en gebruiken API's van het scriptmodel voor aangepaste formulieren. Deze expressies retourneren waarden van bepaalde typen. Voor de volledige lijst met adaptieve formulierklassen, gebeurtenissen, objecten en openbare API's raadpleegt u JavaScript Library API-referentie voor adaptieve formulieren.
Voor meer informatie over richtlijnen om regels in de coderedacteur te schrijven, zie Adaptieve formulierexpressies.
Bij het schrijven van JavaScript-code in de regeleditor zijn de volgende visuele aanwijzingen nuttig voor de structuur en syntaxis:
- Syntaxismarkeringen
- Automatische inspringing
- Tips en suggesties voor formulierobjecten, functies en eigenschappen
- Automatisch aanvullen van namen van formuliercomponenten en algemene JavaScript-functies
Aangepaste functies in regeleditor custom-functions
Naast de uit-van-de-doosfuncties zoals *Sum van, *die onder de Output van Functies vermeld zijn, kunt u douanefuncties schrijven die u vaak nodig hebt. Zorg ervoor dat de functie die u schrijft, vergezeld gaat van de jsdoc
boven.
Begeleidend jsdoc
is vereist:
- Als u aangepaste configuratie en beschrijving wilt.
- Omdat er meerdere manieren zijn om een functie in te declareren
JavaScript,
Met opmerkingen kunt u de functies bijhouden.
Zie voor meer informatie usejsdoc.org.
Ondersteund jsdoc
tags:
-
Persoonlijk
Syntaxis:
@private
Een functie van het type private is niet opgenomen als een aangepaste functie.
-
Naam
Syntaxis:
@name funcName <Function Name>
Alternatief
,
u kunt gebruiken:@function funcName <Function Name>
of@func
funcName <Function Name>
.funcName
is de naam van de functie (geen spaties toegestaan).<Function Name>
is de weergavenaam van de functie. -
Lid
Syntaxis:
@memberof namespace
Koppelt een naamruimte aan de functie.
-
Parameter
Syntaxis:
@param {type} name <Parameter Description>
U kunt ook het volgende gebruiken:
@argument
{type} name <Parameter Description>
of@arg
{type}
name <Parameter Description>
.Geeft parameters weer die door de functie worden gebruikt. Een functie kan meerdere parametertags hebben, één tag voor elke parameter in de volgorde waarin deze voorkomt.
{type}
vertegenwoordigt parametertype. Toegestane parametertypen zijn:- string
- getal
- boolean
Alle andere parametertypen worden in een van de bovenstaande categorieën ingedeeld. Geen wordt niet ondersteund. Selecteer een van de bovenstaande typen. Typen zijn niet hoofdlettergevoelig. Spaties zijn niet toegestaan in de parameter
name
.<Parameter Descrption>
-
Retourtype
Syntaxis:
@return {type}
U kunt ook
@returns {type}
.Voegt informatie over de functie toe, zoals zijn doel.
{type} staat voor het retourneringstype van de functie. Toegestane retourtypen zijn:
- string
- getal
- boolean
- date
- array
Alle andere retourneringstypen worden in een van de bovenstaande categorieën ingedeeld. Geen wordt niet ondersteund. Selecteer een van de bovenstaande typen. Retourtypen zijn niet hoofdlettergevoelig.
Een aangepaste functie toevoegen
U wilt bijvoorbeeld een aangepaste functie toevoegen die het gebied van een vierkant berekent. De zijlengte is de gebruikersinvoer naar de aangepaste functie, die wordt geaccepteerd met een numeriek vak in het formulier. De berekende uitvoer wordt weergegeven in een ander numeriek vak in het formulier. Als u een aangepaste functie wilt toevoegen, moet u eerst een clientbibliotheek maken en deze vervolgens toevoegen aan de CRX-opslagplaats.
Voer de volgende stappen uit om een clientbibliotheek te maken en deze toe te voegen in de CRX-opslagruimte.
-
Maak een clientbibliotheek. Zie voor meer informatie Client-Side bibliotheken gebruiken.
-
In CRXDE, voeg een bezit toe
categories
met tekenreekstype als waardecustomfunction
aan declientlib
map.note note NOTE customfunction
is een voorbeeldcategorie. U kunt elke naam kiezen voor de categorie die u maakt in het dialoogvensterclientlib
map.
Nadat u de clientbibliotheek in de CRX-opslagplaats hebt toegevoegd, gebruikt u deze in uw adaptieve formulier. Hiermee kunt u uw aangepaste functie als regel in uw formulier gebruiken. Voer de volgende stappen uit om de clientbibliotheek in het aangepaste formulier toe te voegen.
-
Open het formulier in de bewerkingsmodus.
Als u een formulier wilt openen in de bewerkingsmodus, selecteert u een formulier en tikt u op Openen.
-
Selecteer in de bewerkingsmodus een component en tik vervolgens op > Aangepaste formuliercontainer en tikt u vervolgens op .
-
Voeg in het zijpaneel, onder Naam van clientbibliotheek, uw clientbibliotheek toe. (
customfunction
in het voorbeeld.) -
Selecteer het invoervak en tik op om de regeleditor te openen.
-
Tikken Regel maken. Maak met de opties hieronder een regel om de kwadratwaarde van de invoer op te slaan in het veld Uitvoer van het formulier.
Tikken Gereed. Uw aangepaste functie wordt toegevoegd.
Ondersteunde typen functiedeclaratie function-declaration-supported-types
Functie, instructie
function area(len) {
return len*len;
}
Deze functie is opgenomen zonder jsdoc
opmerkingen.
Functie-expressie
var area;
//Some codes later
/** */
area = function(len) {
return len*len;
};
Functie-expressie en -instructie
var b={};
/** */
b.area = function(len) {
return len*len;
}
Functiedeclaratie als variabele
/** */
var x1,
area = function(len) {
return len*len;
},
x2 =5, x3 =true;
Beperking: aangepaste functie kiest alleen de eerste functiedeclaratie uit de lijst met variabelen, als deze samen is. U kunt functie-expressie gebruiken voor elke gedeclareerde functie.
Functiedeclaratie als object
var c = {
b : {
/** */
area : function(len) {
return len*len;
}
}
};
jsdoc
voor elke aangepaste functie. Hoewel jsdoc
opmerkingen worden aangemoedigd, inclusief lege jsdoc
om uw functie als aangepaste functie te markeren. Het laat standaardbehandeling van uw douanefunctie toe.Regels beheren manage-rules
Eventuele bestaande regels op een formulierobject worden weergegeven wanneer u op het object tikt en vervolgens op het object tikt . U kunt de titel en een voorvertoning van het regeloverzicht weergeven. Voorts staat UI u toe om de volledige regelsamenvatting uit te breiden en te bekijken, de orde van regels te veranderen, regels uit te geven, en regels te schrappen.
U kunt de volgende handelingen op regels uitvoeren:
-
Uitvouwen/samenvouwen: In de kolom Inhoud in de lijst met regels wordt de inhoud van de regel weergegeven. Tik op om het uit te breiden.
-
Opnieuw ordenen: 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 of sleep het naar de gewenste volgorde in de lijst.
-
Bewerken: Als u een regel wilt bewerken, schakelt u het selectievakje naast de titel van de regel in. Er verschijnen extra opties voor het bewerken en verwijderen van de regel. Tikken Bewerken om de geselecteerde regel op de regelredacteur op visuele of wijze van de coderedacteur afhankelijk van de wijze te openen die wordt gebruikt om de regel tot stand te brengen.
-
Verwijderen: Als u een regel wilt verwijderen, selecteert u de regel en tikt u op Verwijderen.
-
In-/uitschakelen: Mogelijk moet u het gebruik van een regel tijdelijk opschorten. U kunt een of meer regels selecteren en op Uitschakelen tikken op de werkbalk Handelingen tikken 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 tikt u op 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:
-
Tik op het formulierobject waarvan u een regel wilt kopiëren en tik op de componentwerkbalk . De gebruikersinterface van de regeleditor wordt weergegeven terwijl het formulierobject is geselecteerd en de bestaande regels worden weergegeven.
Voor informatie over het beheren van bestaande regels raadpleegt u Regels beheren.
-
Schakel het selectievakje naast de titel van de regel in. Er verschijnen extra opties voor het beheer van de regel. Tikken Kopiëren.
-
Selecteer een ander formulierobject waarop u de regel wilt plakken en tik Plakken. 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. -
Tikken Gereed om de regel op te slaan.
Geneste expressies nestedexpressions
De redacteur van de regel staat u toe om veelvoudige EN en OF exploitanten te 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.
U kunt ook voorwaarden slepen en neerzetten in een regel om deze te bewerken. Tik en houd de muisaanwijzer boven de greep ( ) 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.
Datumexpressievoorwaarden dateexpression
De redacteur van de regel staat u toe om datumvergelijkingen te 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 adaptieve 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.
Wanneer de datum waarop deze is ingevuld, eerder is dan de huidige datum, wordt het tekstbericht (Inkomsten) als volgt weergegeven:
Aantal vergelijkingsvoorwaarden number-comparison-conditions
De redacteur van de regel staat u toe om voorwaarden tot stand te brengen die twee aantallen vergelijken.
Na is een voorbeeldvoorwaarde die een statisch tekstvoorwerp toont als het aantal maanden een aanvrager bij zijn huidige adres blijft minder dan 36 is.
Wanneer de gebruiker mededeelt dat hij minder dan 36 maanden op zijn huidige woonplaats heeft gewoond, wordt op het formulier gemeld dat om een aanvullend bewijs van verblijf kan worden verzocht.
Effect van regeleditor op bestaande scripts impact-of-rule-editor-on-existing-scripts
In AEM Forms-versies vóór AEM 6.1 Forms-functiepak 1 schrijven formulierauteurs en -ontwikkelaars expressies naar het tabblad Scripts van het dialoogvenster Component bewerken om dynamisch gedrag toe te voegen aan adaptieve formulieren. Het tabblad Scripts wordt nu vervangen door de regeleditor.
Alle scripts of expressies die u op het tabblad Scripts moet schrijven, zijn beschikbaar in de regeleditor. Hoewel u ze niet kunt weergeven of bewerken in de visuele editor, kunt u scripts in de code-editor bewerken als u deel uitmaakt van de gebruikersgroep voor formulieren.
Voorbeelden van regels example
Formuliergegevensmodelservice 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 formuliergegevensmodel 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. Maak vervolgens een adaptief formulier dat velden van gegevensmodelobjecten bevat om gebruikersinvoer voor de hoeveelheid leningen, 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 zult vormen om het voorbeeldscenario te verwezenlijken.
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, Bent u een bestaande klant van de Geometrixx?, met de opties Ja en Nee. De waarde voor Ja is 0 en Nee is 1.
-
Een tekstveld, Geometrixx-klant-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.
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.
De regel wordt als volgt weergegeven in de code-editor.
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.
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 dit bereiken door een Set Value of rule te schrijven voor de cel Totaal aantal, zoals hieronder wordt weergegeven.
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. Hiervoor kunt u een validatieregel schrijven, zoals hieronder wordt weergegeven.