Operatortypen und -ereignisse im Regeleditor eines auf Kernkomponenten basierendes adaptiven Formulars

In AEM Forms as a Cloud Service umfasst der Regeleditor verschiedene Operatortypen und Ereignisse, mit denen Sie komplexe Bedingungen und Aktionen mühelos definieren und ausführen können.

Die im Regeleditor eines adaptiven Formulars verfügbaren Operatortypen bieten ein robustes Framework für die Erstellung präziser Bedingungen. Sie ermöglichen es Ihnen, Daten zu bearbeiten, Berechnungen durchzuführen und mehrere Bedingungen logisch und kohärent zu kombinieren. Unabhängig davon, ob Sie Werte vergleichen, arithmetische Operationen durchführen oder Zeichenfolgen bearbeiten, stellen diese Operatoren sicher, dass Ihre Regeln sowohl flexibel als auch leistungsstark sind.

Ereignisse im Regeleditor dienen als Trigger zum Aktivieren Ihrer Regeln. Sie definieren die spezifischen Aktionen, die ausgeführt werden, wenn bestimmte Bedingungen erfüllt sind. Durch die Nutzung verschiedener Ereignistypen können Sie die Reaktionen auf eine Vielzahl von Szenarien automatisieren, z. B. Benutzerinteraktionen, geplante Zeiten, Änderungen der Daten und Systemstatus. Mit der Möglichkeit, diese Trigger anzugeben, können Sie dynamische und responsive Regeln erstellen, die Ihren spezifischen Anforderungen entsprechen.

Durch das Verständnis und die Verwendung der verfügbaren Operatortypen und Ereignisse können Sie das volle Potenzial des Regeleditors ausschöpfen, wodurch Sie effiziente, effektive Regeln erstellen können, die Ihren individuellen Anforderungen entsprechen und die allgemeine Systemfunktionalität verbessern.

Verfügbare Typen von Operatoren und Ereignissen im Regeleditor available-operator-types-and-events-in-rule-editor

Der Regeleditor bietet die folgenden logischen Operatoren und Ereignisse, mit deren Hilfe Sie Regeln erstellen können.

Verfügbare Typen von Regeln im Regeleditor available-rule-types-in-rule-editor

Der Regeleditor bietet eine Reihe vordefinierter Regeltypen, mit denen Sie Regeln schreiben können. Im Folgenden werden die einzelnen Regeltypen detailliert dargestellt. Weitere Informationen zum Schreiben von Regeln im Regeleditor finden Sie unter Regeln schreiben.

Wenn whenruletype

Der Wenn-Regeltyp nutzt das Konstrukt Bedingung-Aktion-Alternative Aktion, in manchen Fällen auch nur das Konstrukt Bedingung-Aktion. Für diesen Regeltyp geben Sie zunächst eine auszuwertende Bedingung an und dann eine Aktion, die ausgelöst werden soll, wenn die Bedingung erfüllt ist (True). Bei Einsatz der Wenn-Regel können Sie mehrere UND- und ODER-Operatoren verwenden, um verschachtelte Ausdrücke zu erstellen.

Mit dem Wenn-Regeltyp können Sie eine Bedingung für ein Formularobjekt auswerten und Aktionen für ein oder mehrere Objekte ausführen.

Einfach ausgedrückt: Eine typische Wenn-Regel ist wie folgt aufgebaut:

When on Object A:

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

Then, do the following:

Action 2 on Object B;
AND
`Aktion 3 auf Objekt C;

Else, do the following:

Action 2 on Object C;
_

Beim Erstellen einer Regel für Komponenten mit mehreren Werten (z. B. Optionsfelder oder Listen) werden die Optionen automatisch abgerufen und dem Regelersteller zur Verfügung gestellt. Sie müssen die Optionswerte nicht erneut eingeben.

Eine Liste hat beispielsweise vier Optionen: „Rot“, „Blau“, „Grün“ und „Gelb“. Beim Erstellen der Regel werden die Optionen (Optionsfelder) automatisch abgerufen und dem Regelersteller wie folgt zur Verfügung gestellt:

Beim Schreiben der Wenn-Regel können Sie die Aktion „Wert löschen von“ auslösen. Die Aktion „Wert löschen von“ löscht den Wert des angegebenen Objekts. Mit „Wert löschen von“ als Option in der Wenn-Anweisung können Sie komplexe Bedingungen mit mehreren Feldern erstellen. Sie können die Else-Anweisung hinzufügen, um weitere Bedingungen hinzuzufügen

Felder mit Mehrfachauswahl in Wenn allowed-multiple-fields

In der Bedingung Wenn haben Sie die Möglichkeit, neben dem Feld, auf das die Regel angewendet wird, weitere Felder hinzuzufügen.

Beispielsweise können Sie mithilfe des Wenn-Regeltyps eine Bedingung für verschiedene Formularobjekte auswerten und die folgende Aktion durchführen:

Wenn:

(Objekt A Bedingung 1)

UND/ODER

(Objekt B Bedingung 2)

Gehen Sie dann wie folgt vor:

Aktion 1 auf Objekt A

_

Überlegungen bei Verwendung von Zulässigen mehreren Feldern in der Wenn-Bedingungsfunktion

Wenn bei Feldern mit Mehrfachauswahl in der Wenn-Bedingung Probleme auftreten, führen Sie die Schritte zur Fehlerbehebung wie folgt aus:

Ausblenden: Blendet das angegebene Objekt aus.

Anzeigen: Blendet das angegebene Objekt ein.

Aktivieren: Aktiviert das angegebene Objekt.

Deaktivieren: Deaktiviert das angegebene Objekt.

Dienst aufrufen Ruft einen Dienst auf, der in einem Formulardatenmodell (FDM) konfiguriert ist. Wenn Sie den Vorgang „Dienst aufrufen“ wählen, wird ein Feld angezeigt. Beim Antippen des Felds zeigt es sämtliche Dienste an, die in allen Formulardatenmodellen (FDM) in Ihrer Experience Manager-Instanz konfiguriert sind. Bei Auswahl eines Formulardatenmodell-Service erscheinen weitere Felder, in denen Sie Formularobjekte mit Eingabeparametern für den angegebenen Service zuordnen können. Sie können die Ausgabeparameter über die Payload-Option für das Ereignis für den angegebenen Service zuordnen. Sie können auch Regeln für die Verarbeitung von Erfolgs- und Fehlerantworten des Vorgangs „Service aufrufen“ mithilfe des Regeleditors erstellen.

Siehe die Beispielregel für den Aufruf von Formulardatenmodell(FDM)-Services.

Zusätzlich zum Formulardatenmodell-Service können Sie eine direkte WSDL-URL angeben, um einen Webservice aufzurufen. Ein Formulardatenmodell-Service hat jedoch viele Vorteile und stellt den empfohlenen Ansatz zum Aufrufen eines Service dar.

Weitere Informationen zum Konfigurieren von Diensten im Formulardatenmodell (FDM) finden Sie unter Experience Manager Forms Datenintegration.

Wert festlegen: Berechnet den Wert des angegebenen Objekts und legt ihn fest. Als Objektwert können Sie eine Zeichenfolge, den Wert eines anderen Objekts, den mithilfe eines mathematischem Ausdrucks oder einer Funktion berechneten Wert, den Wert einer Eigenschaft eines Objekts oder den von einem konfigurierten Formulardatenmodell-Service ausgegebenen Wert festlegen. Wenn Sie die Option „Web-Dienst“ wählen, werden sämtliche Dienste angezeigt, die in allen Formulardatenmodellen (FDM) in Ihrer Experience Manager-Instanz konfiguriert sind. Bei Auswahl eines Formulardatenmodell-Dienstes werden weitere Felder eingeblendet, in denen Sie Formularobjekte mit Ein- und Ausgabeparametern für den angegebenen Dienst zuordnen können.

Weitere Informationen zum Konfigurieren von Diensten im Formulardatenmodell (FDM) finden Sie unter Experience Manager Forms Datenintegration.

Mit dem Regeltyp Eigenschaft festlegen können Sie den Wert einer Eigenschaft des angegebenen Objekts basierend auf einer Bedingungsaktion festlegen. Sie können die Eigenschaft auf einen der folgenden Werte festlegen:

Beispielsweise können Sie damit Regeln definieren, die das Textfeld beim Klicken auf eine Schaltfläche anzeigen. Sie können eine benutzerdefinierte Funktion, ein Formularobjekt, eine Objekteigenschaft oder eine Service-Ausgabe verwenden, um eine Regel zu definieren.

Um eine Regel basierend auf einer benutzerdefinierten Funktion zu definieren, wählen Sie Funktionsausgabe in der Dropdown-Liste aus und ziehen Sie eine benutzerdefinierte Funktion mittels Drag-and-Drop aus der Registerkarte Funktionen. Wenn die Aktion der Bedingung erfüllt ist, wird das Texteingabefeld angezeigt.

Um eine auf einem Formularobjekt basierende Regel zu definieren, wählen Sie Formularobjekt in der Dropdown-Liste aus und ziehen Sie ein Formularobjekt per Drag-and-Drop aus der Registerkarte Formularobjekte. Wenn die Aktion der Bedingung erfüllt ist, wird das Texteingabefeld im adaptiven Formular angezeigt.

Mit einer Regel vom Typ „Eigenschaft festlegen“, die auf einer Objekteigenschaft basiert, können Sie das Texteingabefeld in einem adaptiven Formular basierend auf einer anderen Objekteigenschaft, die im adaptiven Formular enthalten ist, sichtbar machen.

Die folgende Abbildung zeigt ein Beispiel für das dynamische Aktivieren des Kontrollkästchens auf der Grundlage des Ausblendens oder Anzeigens eines Textfelds in einem adaptiven Formular:

Wert löschen von: Löscht den Wert des angegebenen Objekts.

Fokus festlegen: Legt den Fokus auf das angegebene Objekt.

Formular senden: Sendet das Formular.

Zurücksetzen Setzt das Formular oder das angegebene Objekt zurück.

Validieren Überprüft das Formular oder das angegebene Objekt.

Instanz hinzufügen: Fügt eine Instanz des angegebenen wiederholbaren Bereichs oder der Tabellenzeile hinzu.

Instanz entfernen: Entfernt eine Instanz des angegebenen wiederholbaren Bereichs oder der Tabellenzeile.

Funktionsausgabe Definiert eine Regel basierend auf vordefinierten Funktionen oder benutzerdefinierten Funktionen.

Navigieren zu Navigieren Sie zu anderen adaptiven Forms, anderen Assets (wie Bildern oder Dokumentfragmenten) oder zu einer externen URL.

Dispatch-Ereignis: Löst die spezifischen Aktionen oder Verhaltensweisen aus, die auf vordefinierten Bedingungen oder Ereignissen basieren.

Wert festlegen von set-value-of

Regeln vom Typ Wert festlegen ermöglichen es, den Wert eines Formularobjekts abhängig davon festzulegen, ob die angegebene Bedingung erfüllt ist oder nicht. Der Wert kann auf den Wert eines anderen Objekts, eine Literal-Zeichenfolge, einen von einem mathematischen Ausdruck oder einer Funktion abgeleiteten Wert, den Wert einer Eigenschaft eines anderen Objekts oder die Ausgabe eines Formulardatenmodell-Service festgelegt werden. In ähnlicher Weise können Sie auf eine Bedingung bei Komponenten, Zeichenfolgen, Eigenschaften oder Werten, die von Funktionen oder mathematischen Ausdrücken abgeleitet wurden, prüfen.

Der Regeltyp Wert festlegen steht für manche Formularobjekte nicht zur Verfügung (z. B. nicht für Bereiche und Schaltflächen von Symbolleisten). Eine standardmäßige Regel vom Typ „Wert festlegen“ hat die folgende Struktur:

Legen Sie für Objekt A den Wert fest auf:

(Zeichenfolge ABC) ODER
(Objekteigenschaft X von Objekt C) ODER
(Wert aus einer Funktion) ODER
(Wert aus einem mathematischen Ausdruck) ODER
(Ausgabewert eines Datenmodell-Service);

When (optional):

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

Im folgenden Beispiel wird der Wert von Question2 als True ausgewählt und der Wert von Result auf correct gesetzt.

Beispiel für die Regel „Wert festlegen“ unter Verwendung des Formulardatenmodell-Service.

Anzeigen show

Mithilfe des Regeltyps Anzeigen können Sie eine Regel schreiben, die ein Formularobjekt je nachdem, ob eine Bedingung erfüllt ist oder nicht, anzeigt oder ausblendet. Der Regeltyp „Anzeigen“ löst auch die Aktion „Ausblenden“ aus, falls die Bedingung nicht erfüllt ist oder False zurückgibt.

Eine typische Regel vom Typ „Anzeigen“ ist wie folgt strukturiert:

Show Object A;

When:

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

Else:

Hide Object A;

Ausblenden hide

Regeln vom Typ Ausblenden können ähnlich wie Regeln vom Typ „Anzeigen“ dazu verwendet werden, Formularobjekte je nachdem, ob eine Bedingung erfüllt ist oder nicht, anzuzeigen oder auszublenden. Der Regeltyp „Ausblenden“ löst auch die Aktion „Anzeigen“ aus, falls die Bedingung nicht erfüllt ist oder False zurückgibt.

Eine typische Regel vom Typ „Ausblenden“ ist wie folgt strukturiert:

Hide Object A;

When:

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

Else:

Show Object A;

Aktivieren enable

Mithilfe des Regeltyps Aktivieren können Sie ein Formularobjekt in Abhängigkeit davon aktivieren oder deaktivieren, ob eine Bedingung erfüllt ist oder nicht. Der Regeltyp „Aktivieren“ löst auch die Aktion „Deaktivieren“ aus, falls die Bedingung nicht erfüllt ist oder False zurückgibt.

Eine typische Regel vom Typ „Aktivieren“ ist wie folgt strukturiert:

Enable Object A;

When:

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

Else:

Disable Object A;

Deaktivieren disable

Regeln vom Typ Deaktivieren können ähnlich wie Regeln vom Typ „Aktivieren“ dazu verwendet werden, Formularobjekte in Abhängigkeit davon, ob eine Bedingung erfüllt ist oder nicht, zu aktivieren oder zu deaktivieren. Der Regeltyp „Deaktivieren“ löst auch die Aktion „Aktivieren“ aus, falls die Bedingung nicht erfüllt ist oder False zurückgibt.

Eine typische Regel vom Typ „Deaktivieren“ ist wie folgt strukturiert:

Disable Object A;

When:

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

Else:

Enable Object A;

Validieren validate

Regeln vom Typ Validieren überprüfen den Wert in einem Feld mithilfe eines Ausdrucks. Sie können beispielsweise einen Ausdruck schreiben, um zu überprüfen, ob das Textfeld zum Angeben eines Namens keine Sonderzeichen oder Zahlen enthält.

Eine typische Regel vom Typ „Validieren“ ist wie folgt strukturiert:

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

Navigieren zwischen den Bedienfeldern

Der Navigieren zwischen den Bereichen ermöglicht es Ihnen, den Fokus zwischen verschiedenen Bereichen in einem Formular zu verschieben. Sie können beispielsweise einen Ausdruck erstellen, um den Fokus in den nächsten Bereich zu verschieben.

Eine typische Regel Navigieren zwischen den Bereichen zum Verschieben des Fokus auf den nächsten Bereich ist wie folgt strukturiert:

Navigate among the panels

Shift focus to the next item Object A;

When:

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

Ebenso können Sie eine Regel Navigieren zwischen den Bereichen schreiben, um den Fokus auf das vorherige Bedienfeld zu verschieben:

Navigate among the panels

Shift focus to the previous item Object A;

When:

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

Weitere Informationen zum Erstellen einer Regel für die Navigation in einem Bedienfeld finden Sie hier.

Async-Funktionsaufruf

Dies ist eine Vorabveröffentlichungsfunktion, auf die über unseren Vorabveröffentlichungskanalzugegriffen werden kann.

Der Regeltyp Aufruf der asynchronen Funktion ermöglicht die Ausführung asynchroner Funktionen. Dies ermöglicht es Ihnen, einen Funktionsaufruf zu initiieren, der unabhängig vom Haupt-Ausführungs-Thread ausgeführt wird, sodass andere Prozesse weiter ausgeführt werden können, ohne auf den Abschluss der asynchronen Funktion zu warten.

Eine typische Regel für den Aufruf einer asynchronen Funktion zum Ausführen einer asynchronen Funktion ist wie folgt strukturiert:

When:

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

Async Function call

[Callback Function];

Weitere Informationen zur Verwendung des Aufrufs der asynchronen Funktion im visuellen Regeleditor finden Sie im Verwenden asynchroner Funktionsaufrufe im Regeleditor .

Nächster Schritt

Im Folgenden werden verschiedene Beispiele für einen Regeleditor für ein auf Kernkomponenten basierendes adaptives Formular).

Siehe auch