Verfügbare Typen von Operatoren und Ereignissen im Regeleditor
Der Regeleditor bietet die folgenden logischen Operatoren und Ereignisse, mit deren Hilfe Sie Regeln erstellen können.
- Ist gleich - Prüft, ob das Formularobjekt mit einem angegebenen Wert übereinstimmt.
- Ist nicht gleich - Prüft, ob das Formularobjekt einem angegebenen Wert nicht entspricht.
- Beginnt mit - Prüft, ob das Formularobjekt mit einer angegebenen Zeichenfolge beginnt.
- Endet mit - Prüft, ob das Formularobjekt mit einer angegebenen Zeichenfolge endet.
- Enthält - Prüft, ob das Formularobjekt eine angegebene Unterzeichenfolge enthält.
- Enthält nicht - Prüft, ob das Formularobjekt eine angegebene Unterzeichenfolge nicht enthält.
- Ist leer - Prüft, ob das Formularobjekt leer ist oder nicht angegeben wurde.
- Ist nicht leer - Prüft, ob ein Formularobjekt vorhanden und nicht leer ist.
- Hat ausgewählt - Gibt „true“ zurück, wenn ein Benutzer eine bestimmte Kontrollkästchen-, Dropdown- oder Optionsfeldoption auswählt.
- Ist initialisiert (Ereignis) - Gibt „true“ zurück, wenn ein Formularobjekt im Browser gerendert wird.
- Wird geändert (Ereignis) - Gibt „true“ zurück, wenn ein Benutzer den Wert oder die Auswahl eines Formularobjekts ändert.
- Wird angeklickt (Ereignis) - Gibt „true“ zurück, wenn ein Benutzer auf ein Formularobjekt klickt, z. B. eine Schaltfläche. Ein Benutzer kann mehrere Bedingungen zum Klick auf die Schaltfläche hinzufügen.
- Ist gültig - Prüft, ob ein Formularobjekt die Validierungskriterien erfüllt.
- Ist ungültig - Prüft, ob ein Formularobjekt bei der Validierung fehlschlägt.
Verfügbare Typen von Regeln im Regeleditor
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
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;ANDAction 3 on Object 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
HINWEISFelder mit Mehrfachauswahl in Wenn
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
- Stellen Sie sicher, dass Kernkomponente auf Version 3.0.14 oder höher eingestellt ist um diese Funktion im Regeleditor zu verwenden.
- Falls Regeln auf verschiedene Felder in der Wenn-Bedingung angewendet werden, wird die Regel auch dann ausgelöst, wenn nur eines dieser Felder geändert wird.
- Sie können die mehreren Felder nur in der Wenn Bedingung eine AND)- hinzufügen. Eine OR-Regel nicht.
HINWEISWhen button is clicked AND text input equals '5'” gültig, während “When text input equals '5' AND button is clicked” nicht unterstützt wird.Wenn bei Feldern mit Mehrfachauswahl in der Wenn-Bedingung Probleme auftreten, führen Sie die Schritte zur Fehlerbehebung wie folgt aus:
- Öffnen Sie das Formular im Bearbeitungsmodus.
- Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars.
- Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften
- Klicken Sie auf „Fertig“ und speichern Sie das Dialogfeld erneut.
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.
HINWEISSiehe 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:
- visible (Boolescher Wert)
- label.value (Zeichenfolge)
- label.visible (Boolescher Wert)
- description (Zeichenfolge)
- aktiviert (Boolescher Wert)
- readOnly (Boolescher Wert)
- required (Boolescher Wert)
- screenReaderText (Zeichenfolge)
- valid (Boolescher Wert)
- errorMessage (Zeichenfolge)
- value (Zahl, Zeichenfolge, Datum)
- enumNames (Zeichenfolge[])
- chartType (Zeichenfolge)
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
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
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
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
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
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
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;
HINWEIS
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.