Benutzeroberfläche des Regeleditors für adaptive Formulare, die auf Kernkomponenten basieren
Die auf Kernkomponenten basierende Benutzeroberfläche des Regeleditors für adaptive Forms verbessert den Prozess der Formularerstellung in Adobe Experience Manager (AEM). Es ermöglicht Geschäftsbenutzern und Entwicklern, dynamisches Verhalten und komplexe Logik in Formulare zu implementieren, indem Regeln geschrieben werden, die Trigger-Aktionen basierend auf vordefinierten Bedingungen, Benutzereingaben und Interaktionen erstellen. Diese Funktion unterstützt moderne JavaScript-Funktionen bis ES2022 und bietet einen intuitiven visuellen Editor, der den Regelerstellungsprozess vereinfacht.
Der Regeleditor ist für das optimierte Ausfüllen des Formulars von entscheidender Bedeutung, da er sowohl Genauigkeit als auch Effizienz gewährleistet. Dies ermöglicht die Validierung oder das Zurücksetzen von Bereichen und Formularen sowie die Ausführung benutzerdefinierter Funktionen zum Berechnen von Werten von Formularobjekten. Durch die Unterstützung verschachtelter Bedingungen und die Möglichkeit, Formulardatenmodell-Services aufzurufen, ist die Benutzeroberfläche des Regeleditors eine zentrale Komponente für die Erstellung responsiver, benutzerfreundlicher und adaptiver Formulare.
Grundlegendes zur Benutzeroberfläche des Regeleditors understanding-the-rule-editor-user-interface
Der Regeleditor bietet eine umfangreiche und dennoch einfache Benutzeroberfläche zum Erstellen und Verwalten von Regeln. Sie können die Benutzeroberfläche des Regeleditors im Autorenmodus von einem adaptiven Formular aus aufrufen.
So starten Sie die Benutzeroberfläche des Regeleditors:
-
Öffnen Sie ein adaptives Formular im Autorenmodus.
-
Wählen Sie das Formularobjekt aus, für das Sie eine Regel schreiben möchten, und wählen Sie in der Komponenten-Symbolleiste
. Die Benutzeroberfläche des Regeleditors wird angezeigt.
Alle vorhandenen Regeln für die ausgewählten Formularobjekte werden in dieser Ansicht aufgelistet. Weitere Informationen zum Verwalten vorhandener Regeln finden Sie unter Verwalten von Regeln.
-
Wählen Sie Erstellen, um eine neue Regel zu erstellen. Wenn Sie den Regeleditor zum ersten Mal starten, wird standardmäßig der Visual Editor der Regeleditor-Benutzeroberfläche geöffnet.
Nachfolgend werden die einzelnen Komponenten der Benutzeroberfläche des Regeleditors im Detail beschrieben.
A. Ansicht „Komponente und Regel“ a-component-rule-display
Zeigt den Titel des adaptiven Formularobjekts, über das Sie den Regeleditor aufgerufen haben, sowie den derzeit ausgewählten Regeltyp an. Im oben gezeigten Beispiel wurde der Regeleditor über ein adaptives Formularobjekt namens „Question 1“ (Frage 1) gestartet und der Regeltyp „Wenn“ ist ausgewählt.
B. Formularobjekte und Funktionen b-form-objects-and-functions-br
Im linken Bereich der Benutzeroberfläche des Regeleditors stehen zwei Registerkarten zur Verfügung: Formularobjekte und Funktionen.
Die Registerkarte „Formularobjekte“ zeigt eine hierarchische Ansicht aller Objekte an, die in dem adaptiven Formular enthalten sind. Angezeigt werden Titel und Typ der Objekte. Wenn Sie eine Regel erstellen, können Sie Formularobjekte in den Regeleditor ziehen und dort ablegen. Wenn Sie beim Erstellen oder Bearbeiten einer Regel ein Objekt oder eine Funktion in einen Platzhalter ziehen, übernimmt dieser Platzhalter automatisch den entsprechenden Wertetyp.
Die Formularobjekte, auf die eine oder mehrere gültige Regeln angewendet wurden, sind mit einem grünen Punkt markiert. Ist eine der auf ein Formularobjekt angewendeten Regeln ungültig, wird das Formularobjekt mit einem gelben Punkt markiert.
Die Registerkarte „Funktionen“ enthält eine Reihe integrierter Funktionen (z. B. „Summe von“, „Minimum von“, „Maximum von“, „Durchschnitt von“, „Anzahl von“ und „Formular validieren“). Sie können diese Funktionen verwenden, um Werte in wiederholbaren Bereichen und Tabellenzeilen zu berechnen und sie beim Erstellen von Regeln in den Aktions- und Bedingungsanweisungen zu verwenden. Sie können jedoch auch benutzerdefinierte Funktionen erstellen.
Einige der Listen von Funktionen werden in der Abbildung angezeigt:
In der linken Baumstruktur der Formularobjekte können Sie die Formularobjekte auswählen, um die Regeln anzuzeigen, die auf die einzelnen Objekte angewendet werden. Sie können nicht nur durch die Regeln der verschiedenen Formularobjekte navigieren, sondern auch Regeln zwischen den Formularobjekten kopieren und einfügen. Weitere Informationen finden Sie unter Kopieren und Einfügen von Regeln.
C. Umschalten zwischen Formularobjekten und Funktionen c-form-objects-and-functions-toggle-br
Durch Tippen auf die Schaltfläche schalten Sie zwischen den Bereichen für Formularobjekte und Funktionen um.
D. Visueller Regeleditor visual-rule-editor
Der visuelle Regeleditor ist im visuellen Editormodus der Benutzeroberfläche des Regeleditors der Bereich, in dem Sie Regeln schreiben. Sie können hier einen Regeltyp auswählen und die entsprechenden Bedingungen und Aktionen definieren. Beim Definieren von Bedingungen und Aktionen in einer Regel können Sie Formularobjekte und Funktionen aus dem Bereich „Formularobjekte und Funktionen“ ziehen und ablegen.
Weitere Informationen zur Verwendung eines visuellen Regeleditors finden Sie unter Regeln schreiben.
F. Schaltflächen „Fertig“ und „Abbrechen“ done-and-cancel-buttons
Die Schaltfläche Fertig wird verwendet, um eine Regel zu speichern. Sie können eine unvollständige Regel speichern. Unvollständige Regeln sind jedoch ungültig und werden nicht ausgeführt. Gespeicherte Regeln für ein Formularobjekt werden aufgelistet, wenn Sie den Regeleditor das nächste Mal von demselben Formularobjekt aus starten. In dieser Ansicht können Sie vorhandene Regeln verwalten. Weitere Informationen finden Sie unter Verwalten von Regeln.
Die Abbrechen-Schaltfläche verwirft alle Änderungen, die Sie an einer Regel vorgenommen haben, und schließt den Regeleditor.
Regeln schreiben write-rules
Sie können Regeln mit dem visuellen Regeleditor schreiben
Sehen wir uns zunächst an, wie Regeln mit einem visuellen Editor geschrieben werden.
Anhand des folgenden Beispielformulars soll das Erstellen einer Regel in einem visuellen Editor verständlich gemacht werden.
Im Abschnitt für die Kreditvoraussetzungen in diesem Beispielformular für einen Kreditantrag müssen die Antragstellenden ihren Familienstand, ihr Gehalt und, falls verheiratet, das Gehalt der Partnerin bzw. des Partners angeben. Basierend auf den Benutzereingaben wird mithilfe der Regel der Kreditanspruchsbetrag berechnet und im Feld für den Kreditanspruch angegeben. Wenden Sie die folgenden Regeln an, um dieses Szenario zu implementieren:
- Das Feld für das Gehalt der Partnerin bzw. des Partners wird nur angezeigt, wenn als Familienstand „Verheiratet“ angegeben wurde.
- Der Kreditanspruchsbetrag beträgt 50 % des Gesamtgehalts.
Gehen Sie wie folgt vor, um Regeln zu erstellen:
-
Schreiben Sie zunächst die Regel, um die Sichtbarkeit des Felds Gehalt des Partners basierend auf der Option zu steuern, die der Benutzer für das Optionsfeld Familienstand auswählt.
Öffnen Sie das Kreditantragsformular im Autorenmodus. Wählen Sie die Komponente Familienstand und
aus. Wählen Sie als Nächstes Erstellen aus, um den Regeleditor zu starten.
Wenn Sie den Regeleditor starten, ist standardmäßig die Wenn-Regel ausgewählt. Darüber hinaus wird das Formularobjekt (in diesem Fall „Familienstand“), von dem aus Sie den Regeleditor gestartet haben, in der Wenn-Anweisung angegeben.
Sie können zwar das ausgewählte Objekt nicht bearbeiten oder ändern, es ist jedoch möglich, über die Dropdown-Liste für Regeln einen anderen Regeltyp wählen (siehe unten). Wenn Sie eine Regel für ein anderes Objekt erstellen möchten, wählen Sie „Abbrechen“ aus, um den Regeleditor zu beenden, und starten Sie ihn erneut über das gewünschte Formularobjekt.
-
Wählen Sie die Dropdown-Liste Status auswählen und Ist gleich aus. Das Feld Eine Zeichenfolge eingeben wird angezeigt.
-
Wählen in der Regel im Feld Geben Sie eine Zeichenfolge ein aus dem Dropdown-Menü die Option Verheiratet“ aus.
Sie haben die Bedingung als
When Marital Status is equal to Marrieddefiniert. Definieren Sie anschließend die Aktion, die ausgeführt werden soll, wenn diese Bedingung „True“ lautet. -
Wählen Sie für die Dann-Anweisung die Option Anzeigen aus der Dropdown-Liste Aktion auswählen.
-
Ziehen Sie das Feld Partnergehalt aus der Registerkarte „Formularobjekte“ in das Feld Legen Sie das Objekt ab oder wählen Sie hier aus. Stattdessen können Sie auch das Feld Objekt hier einfügen oder auswählen auswählen und das Feld Gehalt des Partners aus dem Popup-Menü wählen, in dem sämtliche Formularobjekte im Formular aufgeführt sind.
Definieren Sie anschließend die Aktion, die ausgeführt werden soll, wenn diese Bedingung „false“ lautet.
-
Klicken Sie auf Abschnitt „Andernfalls“ hinzufügen, um eine weitere Bedingung für das Feld Partnergehalt hinzuzufügen, falls für den Familienstand „Einzelperson“ ausgewählt wird.
-
Wählen Sie für die Sonst-Anweisung die Option Ausblenden aus der Dropdown-Liste Aktion auswählen aus.
-
Ziehen Sie das Feld Partnergehalt aus der Registerkarte „Formularobjekte“ in das Feld Legen Sie das Objekt ab oder wählen Sie hier aus. Stattdessen können Sie auch das Feld Objekt hier einfügen oder auswählen auswählen und das Feld Gehalt des Partners aus dem Popup-Menü wählen, in dem sämtliche Formularobjekte im Formular aufgeführt sind.
Die Regel wird im Regeleditor wie folgt angezeigt.
-
Wählen Sie Fertig aus, um die Regel zu speichern.
| note note |
|---|
| NOTE |
| Alternativ zu diesem Verfahren können Sie dieses Verhalten auch implementieren, indem Sie für das Feld „Partnergehalt“ lediglich eine Regel vom Typ „Anzeigen“ anstelle zweier Wenn-Regeln für das Feld „Familienstand“ erstellen. |
-
Als Nächstes erstellen Sie eine Regel für die Berechnung des Kreditanspruchsbetrags (50 % des Gesamtgehalts) und zur Anzeige des Betrags im Feld für den Kreditanspruch. Um dies zu erreichen, erstellen Sie Wert festlegen von-Regeln für das Feld „Kreditanspruch“.
Wählen Sie im Autorenmodus das Feld Kreditanspruch und dann
aus. Wählen Sie anschließend Erstellen aus, um den Regeleditor zu starten. -
Wählen Sie in der Dropdown-Liste „Regeln“ die Regel Wert festlegen aus.
-
Wählen Sie Option auswählen und dann Mathematischer Ausdruck aus. Ein Feld, in das Sie mathematische Ausdrücke schreiben können, wird geöffnet.
-
Gehen Sie in diesem Ausdrucksfeld wie folgt vor:
-
Wählen Sie das Feld Gehalt im ersten Feld Legen Sie das Objekt ab oder wählen Sie hier aus aus oder ziehen Sie es von der Registerkarte „Formularobjekt“ hierhin.
-
Wählen Sie aus dem Feld Operator auswählen die Option plus aus.
-
Wählen Sie das Feld Gehalt des Partners auf der Registerkarte „Formularobjekt“ aus oder ziehen Sie es in das zweite Feld Legen Sie das Objekt ab oder wählen Sie hier aus und legen Sie es dort ab.
-
-
Wählen Sie als Nächstes etwas im hervorgehobenen Bereich um das Ausdrucksfeld und wählen Sie dann Ausdruck erweitern aus.
Wählen Sie im Feld für den erweiterten Ausdruck im Feld Operator auswählen die Option geteilt durch und im Feld Option auswählen die Option Zahl aus. Geben Sie 2 in das Zahlenfeld ein.
note note NOTE Sie können mithilfe von Komponenten, Funktionen, mathematischen Ausdrücken und Eigenschaftswerten aus dem Feld „Option auswählen“ komplexe Ausdrücke erstellen. Erstellen Sie als Nächstes eine Bedingung, bei der bei Rückgabe von „True“ der Ausdruck ausgeführt wird.
-
Wählen Sie Bedingung hinzufügen aus, um eine Wenn-Anweisung hinzuzufügen.
Gehen Sie in der Wenn-Anweisung wie folgt vor:
-
Wählen Sie auf der Registerkarte „Formularobjekt“ das Feld Familienstand im ersten Feld Objekt hier einfügen oder auswählen.
-
Wählen Sie Ist gleich im Feld Operator wählen aus.
-
Wählen Sie in dem anderen Feld Legen Sie das Objekt ab oder wählen Sie hier aus den Eintrag „String“ (Zeichenfolge) aus und geben Sie Verheiratet in das Feld Geben Sie eine Zeichenfolge ein ein.
Die Regel wird schließlich wie folgt im Regeleditor angezeigt.
-
-
Klicken Sie auf Fertig. Dadurch wird die Regel gespeichert.
-
Folgen Sie wiederum Schritt 7 bis 14, um eine andere Regel zu definieren, mit deren Hilfe der Kreditanspruch berechnet wird im Falle, dass der Familienstand „Ledig“ ist. Die Regel wird im Regeleditor wie folgt angezeigt.
Sie können auch die Regel „Wert einstellen von“ verwenden, um den Kreditanspruch über die Wenn-Regel zu berechnen, die Sie erstellt haben, um das Feld für das Gehalt der Partnerin bzw. des Partners ein- bzw. auszublenden. Die resultierende kombinierte Regel (für den Familienstand „Ledig“) wird wie folgt im Regeleditor angezeigt.
Sie können eine kombinierte Regel erstellen, die die Sichtbarkeit des Felds für das Gehalt der Partnerin bzw. des Partners steuert, und mit der Sonst-Bedingung die Darlehensberechtigung für den Familienstand „Verheiratet“ berechnet.
Unterstützung von Funktionen und mathematischen Ausdrücken in Eingabeparametern
Eingabeparameter unterstützen jetzt beide Funktionsausgaben, z. B. concat, trim und join, sowie mathematische Ausdrücke. Diese Verbesserung ermöglicht es Formularautorinnen und -autoren, dynamisch berechnete Werte direkt zu übergeben, optimiert die Regelkonfigurationen, reduziert den Bedarf an zusätzlichen Feldern und macht Formulare besser an komplexe Logik und berechnungsgesteuerte Szenarien anpassbar.
Umgang mit fehlerhaften Regeln
Regeln können manchmal fehlschlagen, wenn ein referenziertes Feld verschoben oder gelöscht wird. In diesem Fall markiert der Regeleditor die betroffene Regel mit einem roten Punkt.
-
Wenn ein Feld verschoben wird (z. B. von einem Bedienfeld in ein anderes), kann die zugehörige Regel beschädigt werden. Öffnen Sie in diesem Fall die Regel und speichern Sie sie erneut. Die Regel wird automatisch wiederhergestellt.
-
Wenn ein Feld gelöscht wird, kann die Regel nicht repariert werden.
Um das Problem zu verstehen, bewegen Sie den Mauszeiger im Regeleditor über den Regelstatus, um die Fehlermeldung anzuzeigen.
Benutzerdefinierte Funktionen im Regeleditor custom-functions
Zusätzlich zu den vorkonfigurierten Funktionen wie beispielsweise Summe von, die unter Funktionsausgabe aufgeführt sind, können Sie in Ihrem Regeleditor auch benutzerdefinierte Funktionen verwenden. Der Regeleditor unterstützt die JavaScript ECMAScript 2019-Syntax für Skripte und benutzerdefinierte Funktionen. Anweisungen zum Erstellen benutzerdefinierter Funktionen finden Sie im Artikel Benutzerdefinierte Funktionen in adaptiven Formularen.
Verwalten von Regeln manage-rules
Wenn Sie das Objekt und dann
Sie können die folgenden Aktionen für die Regeln ausführen:
-
Anzeigen/Reduzieren: Die Inhaltsspalte in der Regelliste zeigt den Regelinhalt an. Wenn in der Standardansicht nicht der gesamte Regelinhalt sichtbar ist, wählen Sie
aus, um die Ansicht zu erweitern. -
Anordnung ändern: Jede neue Regel, die Sie erstellen, wird am unteren Rand der Regelliste gestapelt. Die Regeln werden von oben nach unten ausgeführt. Die Regel oben wird zuerst ausgeführt, gefolgt von anderen Regeln desselben Typs. Wenn Sie beispielsweise die Regeln „Wenn“, „Anzeigen“, „Aktivieren“ und „Wenn“ an der ersten, zweiten, dritten bzw. vierten Position von der obersten Position haben, wird die Wenn-Regel oben zuerst ausgeführt, gefolgt von der Wenn-Regel an der vierten Position. Danach werden die Anzeigen- und die Aktivieren-Regel ausgeführt.
Sie können die Position einer Regel in der Reihenfolge ändern, indem Sie auf für die Regel tippen oder die Regel an die gewünschte Stelle in der Liste ziehen und dort ablegen. -
Bearbeiten: Zum Bearbeiten einer Regel aktivieren Sie das Kontrollkästchen neben ihrem Titel. Weitere Optionen zum Bearbeiten und Löschen der Regel werden angezeigt. Wählen Sie Bearbeiten aus, um die ausgewählte Regel im Regeleditor zu öffnen.
-
Löschen: Um eine Regel zu löschen, wählen Sie die Regel aus und dann Löschen.
-
Aktivieren/Deaktivieren: Wenn Sie die Verwendung einer Regel vorübergehend aussetzen müssen, können Sie eine oder mehrere Regeln auswählen und in der Aktionsleiste Deaktivieren wählen, um sie zu deaktivieren. Wenn eine Regel deaktiviert ist, wird sie zur Laufzeit nicht ausgeführt. Um eine deaktivierte Regel zu aktivieren, können Sie sie auswählen und dann in der Aktionssymbolleiste „Aktivieren“ auswählen. Die Statusspalte der Regel zeigt an, ob die Regel aktiviert oder deaktiviert ist.
Kopieren und Einfügen von Regeln copy-paste-rules
Es ist möglich, Regeln aus einem Feld zu kopieren und in andere, ähnliche Felder einzufügen, um Zeit zu sparen.
Gehen Sie wie folgt vor, um Regeln zu kopieren und einzufügen:
-
Wählen Sie das Formularobjekt aus, von dem Sie eine Regel kopieren möchten, und wählen Sie in der Komponentensymbolleiste
. Die Benutzeroberfläche des Regeleditors wird angezeigt, wobei das Formularobjekt ausgewählt ist und die vorhandenen Regeln angezeigt werden.
Weitere Informationen zum Verwalten vorhandener Regeln finden Sie unter Verwalten von Regeln.
-
Aktivieren Sie das Kontrollkästchen neben dem Titel der Regel. Es werden Optionen für das Verwalten der Regel angezeigt. Wählen Sie Kopieren.
-
Wählen Sie ein anderes Formularobjekt aus, in das Sie die Regel einfügen möchten, und wählen Sie dann Einfügen aus. Darüber hinaus können Sie die Regel bearbeiten, um Änderungen daran vorzunehmen.
note note NOTE Sie können eine Regel nur dann in ein anderes Formularobjekt einfügen, wenn dieses Formularobjekt das Ereignis der kopierten Regel unterstützt. So unterstützt beispielsweise eine Schaltfläche das Klickereignis. Sie können eine Regel, die ein Klickereignis enthält, in eine Schaltfläche, nicht jedoch in ein Kontrollkästchen einfügen. -
Wählen Sie Fertig aus, um die Regel zu speichern.
Nächster Schritt
Informationen zu den verschiedenen Typen von Operatoren und Ereignissen im Regeleditor eines adaptiven Formulars finden Sie im Verfügbare Typen von Operatoren und Ereignissen im Regeleditor eines adaptiven Formulars .
Siehe auch
- Einführung in den Regeleditor für adaptive Formulare, die auf Kernkomponenten basieren
- Operatortypen und -ereignisse im Regeleditor eines auf Kernkomponenten basierendes adaptiven Formulars
- Benutzeroberfläche des Regeleditors für adaptive Formulare, die auf Kernkomponenten basieren
- Verschiedene Anwendungsfälle des Regeleditors für ein auf Kernkomponenten basierendes adaptives Formular
- Unterschiede in verschiedenen Editionen des Regeleditors
- Verwenden von asynchronen Funktionen in einem adaptiven Formular
- Aufrufen von Diensterweiterungen im visuellen Regeleditor für Formulare, die auf Kernkomponenten basieren
- Einführung in benutzerdefinierte Funktionen für adaptive Formulare, die auf Kernkomponenten basieren
- Erstellen einer benutzerdefinierten Funktion für ein auf Kernkomponenten basierendes adaptives Formular
- Umfangsobjekt in benutzerdefinierten Funktionen
- Beispiele für die Entwicklung und Verwendung benutzerdefinierter Funktionen