Auf dieser Seite werden die folgenden Möglichkeiten zur Arbeit mit Regeln beschrieben:
- Regelaktionen
- Eine neue Regel hinzufügen
- Regeln ändern oder löschen
- Regelinspektor verwenden
- Mit Bedingungen arbeiten
Regeln sind leistungsstarke Tools, die die Logik steuern und helfen, Funktionen in einem Formular zu automatisieren, wie das Aktualisieren eines Feldes, wenn Daten in einem anderen Feld geändert werden. Regeln können Formeln auf Daten anwenden, Daten ändern und das Erscheinungsbild von Daten in einem Formular ändern.
Zum Beispiel können Sie eine Regel verwenden, damit eine Schaltfläche eine bestimmte Funktion auslöst, wie das Durchsuchen einer Datenbank, das Aktivieren eines Webdienstes oder das Festlegen eines Feldwertes. Sie können eine Regel ebenfalls dafür verwenden, auf eine inkorrekte Dateneingabe hinzuweisen, indem die Feldfarbe zu Rot geändert wird, um einen inkorrekten Wert anzuzeigen.
Für erweiterte Regeln
Falls der Lösungs-Generator nicht die für das Erstellen einer Regel benötigte Flexibilität bietet, können fortgeschrittene Benutzer Regeln durch benutzerdefiniertes JavaScript erstellen. Siehe JavaScript-Referenzleitfaden für Information zu unterstützten JavaScript-Wrappern, Syntax und mehr.
Regelaktionen
Jede Regel kann aus einer oder mehreren Aktionen bestehen. Im oben stehenden Beispiel könnte eine einzelne Regel verwendet werden, um beide Funktionen zu handhaben, wobei jede eine separate Aktion wäre. Zum Beispiel können Sie eine Regel verwenden, um auf Grundlage der durch den Benutzer in die Felder „Positionspreis“ und „Menge“ eingegebenen Werte automatisch den Gesamtpreis im Formularfeld zu errechnen und zu aktualisieren.
Wenn Sie mehr als eine Regel auf ein Feld oder eine Schaltfläche anwenden, können die folgenden Aktionen nur einmal verwendet werden und müssen die letzte Regel in der Sequenz sein:
- Query ausführen
- Webdienst ausführen
- Formular abschicken
Der Grund hierfür ist eine Anforderung an den Server, damit keine weiteren Regeln ausgeführt werden können, sobald die Anforderung ausgeführt wurde.
Felder, auf die Regeln angewendet werden, erscheinen im Bereich Lösung auf der Registerkarte Lösung mit einem Häkchensymbol neben ihrem Namen. Beispiel:
Eine Regel besteht aus einem Regeltyp (Aktion, Formatierung oder Validierung), einer oder mehreren Bedingungen sowie einer oder mehreren Aktionen.
Eine neue Regel hinzufügen
- Klicken Sie im Bereich „Eigenschaften“ auf Eigenschaften.
- Klicken Sie im Bereich „Eigenschaften“ neben Regeln auf die Schaltfläche Optionen [...].
- Der Regelinspektor wird im Bereich „Eigenschaften“ geöffnet.
- Klicken Sie auf Regel hinzufügen.
- Geben Sie für die Regel die folgenden Informationen ein:
- Bezeichnung: Geben Sie einen beschreibenden Namen für die Regel ein.
- Regel beim Laden des Formulars ausführen: Wählen Sie diese Option, um die Regel auszuführen, sobald das Formular geladen wird.
- Typ: Wählen Sie einen Regeltyp: Validierung, Formatierung oder Aktionen.
- Bedingung: Hier klicken, um die Bedingung(en) dafür zu erstellen, wann die Regel ausgelöst wird, z. B. wenn ein bestimmtes Formularfeld sich ändert. Zusätzliche Informationen hierzu finden Sie unter Mit Bedingungen arbeiten (unten).
- Nachricht: Geben Sie eine Nachricht ein, die dem Benutzer angezeigt wird, wenn die Regel ausgeführt wird.
- Popup verwenden: Aktivieren Sie dieses Kästchen, um ein Popup zu verwenden, um dem Benutzer die Nachricht anzuzeigen.
- Popup-Titel: Wenn Sie „Popup verwenden“ ausgewählt haben, geben Sie einen Namen für das Popup-Fenster in dieses Feld ein.
- Klicken Sie zum Fertigstellen auf OK.
Bestehenden Regeln ändern oder löschen
Klicken Sie in das Feld oder Element, das die Regel beinhaltet, die Sie ändern möchten.
- Klicken Sie im Bereich „Eigenschaften“ auf Eigenschaften.
- Klicken Sie im Bereich „Eigenschaften“ neben Regeln auf die Optionen-Schaltfläche [...].
- Im Regeleditor:
- Klicken Sie auf Hinzufügen, um eine Regelaktion hinzuzufügen.
- Klicken Sie auf das Symbol Bearbeiten, um die Regel im Editor zu bearbeiten.
- Klicken Sie auf das Symbol Löschen (Papierkorb), um die Regel zu löschen.
- Klicken Sie auf die Bedingung, um die Bedingung der Regel zu ändern. Zusätzliche Informationen hierzu finden Sie unter Arbeiten mit Bedingungen (unten).
- Klicken Sie auf Bedingung löschen (der Papierkorb), um eine Bedingung zu löschen.
- Klicken Sie auf OK, um Ihre Änderungen abzuschließen.
Regelinspektor verwenden
Verwenden Sie den Regelinspektor, um eine Momentaufnahme oder eine Dashboard-Übersicht über alle Regeln in Ihrer Lösung zu erhalten.
Im Regelinspektor können Sie:
- In der Suchleiste nach bestimmten Regeln suchen, um Ergebnisse zu filtern.
- Die Ergebnisse ausdrucken.
- Eine Regel bearbeiten, indem Sie auf ihren Namen klicken.
- Alle Regeln anzeigen, die auf ein Feld angewendet werden, indem Sie auf den Namen des Felds klicken.
Mit Bedingungen arbeiten
Der Bedingungen-Generator bietet eine einfache, grafische Oberfläche für das Erstellen der Logik und der Regeln für Ihre Bedingung.
- Klicken Sie auf Bedingung hinzufügen, um eine Bedingung hinzufügen.
- Klicken Sie auf Gruppe hinzufügen, um eine Untergruppe von Bedingungen hinzufügen.
- Wählen Sie Formularfelder und logische Operatoren (wie zum Beispiel „Is Equal To“ oder „Not Equal To“) aus den Dropdown-Menüs.
- Klicken Sie auf Löschen, um eine Bedingung oder Gruppe zu löschen.
Unten: Eine Beispielbedingung im Bedingungen-Generator
Regeltypen
Es gibt vier grundlegende Regeltypen: Validierung, Formatierung, Aktion und JavaScript (siehe JavaScript-Referenzleitfaden für weitere Informationen zu JavaScript-Regeln). Jeder Regeltyp wird ebenfalls durch einen gemeinsamen Satz von allgemeinen Eigenschaften gesteuert.
Siehe unten für Einzelheiten zu den folgenden Punkten:
- Allgemeine Regeleigenschaften
- Validierungsregeln
- Formatierungsregeln
- Aktionsregeln
- Schnellreferenztabelle für Aktionsregeln
Allgemeine Regeleigenschaften
Regel beim Laden des Formulars ausführen Gibt an, ob die Regel sofort ausgeführt werden soll, wenn das Formular geladen wird.
Ausführung im Debugger anhalten, bevor diese Regel ausgeführt wird
Diese Option eignet sich für die Fehlerbehebung bei Regeln. Durch das Aktivieren dieser Option wird ein Debug-Haltepunkt in den JavaScript-Code genau vor die Ausführung der Regel eingesetzt. Wenn die Browser-Entwicklungstools aktiv sind und diese Regel ausgeführt wird, wird die Browser-Debugging-Sitzung genau vor dem Ausführen der Regel angehalten, damit der Code weiter untersucht werden kann.
Regel deaktivieren
Das Aktivieren dieser Option verhindert das Ausführen der Regel, wenn das Formular ausgeführt wird.
Typ Gibt den zu erstellenden Regeltyp an. Abhängig vom gewählten Regeltyp werden weitere Optionen angezeigt. Weitere Informationen dazu finden Sie unten:
- Validierung
- Formatierung
- Aktion
Bedingung Wenn die angegebene Bedingung Bedingung auf True gesetzt ist, wird diese Regel ausgeführt, andernfalls wird sie nicht ausgeführt.
Wenn Sie eine Bedingung zum Vergleichen mit einer Refrenzdatenliste verwenden Spalte „Ja/Nein“: Der Wert muss True oder False lauten (ohne Anführungszeichen usw.) Der erste Buchstabe muss groß geschrieben werden, d. h. „True“ oder „False“ und nicht „true/false“.
1. Validierungsregeln
|
2. Formatierungsregeln
|
3. Aktionsregeln
Aktionsregeln sind die vielseitigsten Regeln. Aktionsregeln können eine Vielzahl an Funktionen ausführen, wie Werte in bestimmten Feldern festlegen, Werte in Feldern vergleichen, Werte auf Grundlage von Formeln berechnen, und mehr.
|
Sobald Sie die grundlegenden Informationen und Bedingungen für eine Aktionsregel angegeben haben:
|
Aktionsregeln – Schnellreferenztabelle für Aktionsregeln
Unten finden Sie eine Beschreibung dessen, was jede Aktionsregel bewirkt, sowie die mit der Aktion verbundenen Parameter.
Aktion | Beschreibung |
---|---|
Neue Zeile hinzufügen |
Fügt einer wiederholten Tabelle oder Gruppe eine neue Zeile hinzu. Parameter
|
Feldeigenschaften ändern |
Ändert die Eigenschaften eines Felds dahingehend Eingaben einzublenden, auszublenden, zu aktivieren/deaktivieren oder erforderlich/nicht erforderlich zu machen. Parameter
|
Gruppenanzeige ändern |
Zeigt an, blendet aus, erweitert oder reduziert eine Gruppe basierend auf einem bestimmten Feld in der Gruppe. Parameter
|
Als Zeilen kopieren |
Diese Regel kann verwendet werden, um Zeilen von einer wiederholten Tabelle oder wiederholten Gruppe in eine andere wiederholte Tabelle oder wiederholte Gruppe zu kopieren. Diese Regel gleicht den Spaltenwert im wiederholten Quellelement ab, um festzustellen, welche Zeilen auf Basis der Eigenschaft „Auswahlfeld“ kopiert werden sollen. Die Aktion „Zeilen kopieren“ legt fest, ob die übereinstimmenden Zeilen überschrieben oder als neue Zeilen zum wiederholten Zielelement hinzugefügt werden sollen. |
Tabellendaten kopieren |
Sie können Daten zwischen Tabellen kopieren, indem Sie die Regel Tabellendaten kopieren verwenden, die in der Benutzeroberfläche des Lösungs-Generators verfügbar ist. Wenn Sie auf diese Funktion zugreifen möchten, wenden Sie sich bitte an Ihren Vertriebsansprechpartner, um weitere Informationen zu erhalten. Parameter
Hinweise und Einschränkungen
|
Zeilenoptionen löschen |
Parameter
|
Leere Tabelle |
Löscht alle Daten aus einer wiederholten Tabelle oder Gruppe. Parameter
|
Query ausführen |
Führt eine Abfragesteuerung im Formular aus. Parameter
|
Regeln für Feld ausführen |
Führt die Regel auf einem anderen Feld aus. Dies kann nützlich sein, wenn zwei Felder miteinander in Verbindung stehende Regeln besitzen. Parameter
|
Webdienst ausführen |
Führt eine Webdienststeuerung im Formular aus. Parameter
|
Wiederholten Inhalt filtern |
Aktiviert das Filtern von wiederholten Tabellen/Gruppen, wobei der Inhalt beibehalten wird. Sie können eine „Bedingung“ dahingehend konfigurieren, dies zu verwenden. Zum Beispiel „field1= "dies" and field2 != "das"“. Nur Zeilen, die diese Bedingung(en) erfüllen, werden in der wiederholten Tabelle/Gruppe angezeigt. Parameter
|
Neue Zeilenoptionen |
Parameter
|
Dropdown-Optionen erneut laden |
Führt zu einem erneuten Laden der Optionen in einer Dropdown-Liste oder einem Kombinationsfeld. Dies kann für dynamische Optionslisten verwendet werden. Parameter
|
Zuordnung darstellen |
Sendet eine neue Adresse an eine Zuordnungssteuerung im Formular. Parameter
|
Wiederholte Inhalte suchen |
Dies bietet einen Mechanismus, um alle Felder nach einem „Muster“ zu durchsuchen (zum Beispiel, ob ein Feld „abcd“ enthält). In diesem Fall werden alle Zeilen in der wiederholten Tabelle/Gruppe angezeigt, in denen zumindest ein Feld dieses Muster aufweist. Parameter
|
Feldwert festlegen |
Diese Aktion ermöglicht es Ihnen, den Wert eines Felds im Formular zu ändern. Parameter
|
Beschriftung festlegen |
Diese Regelaktion ähnelt „Einen Feldwert festlegen“ (oben), jedoch wird hierdurch die Bezeichnung (oder Unterbezeichnung) eines Formularelements geändert. Parameter
|
Nachricht anzeigen |
Hiermit wird ein Pop-Up-Kästchen mit dem Nachrichtentext, der in der Regel festgelegt wurde, angezeigt. Die Eigenschaften dieser Regel leiten sich standardmäßig von den Feldern eines Formulars ab. |
Wiederholte Inhalte sortieren |
Sortiert die Elemente in einer wiederholten Tabelle. Parameter
|
Formular abschicken |
Diese Aktion ermöglicht es Ihnen, die Schaltfläche „Einreichen“ auf dem Formular zu simulieren. Parameter
|