Sie befinden sich hier: Referenzleitfäden > Regeln-Referenzleitfaden > Regeltypen und Regeleigenschaften

Regeltypen

Es gibt vier grundlegende Regeltypen in Winshuttle Composer: 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.

Allgemeine Regeleigenschaften

Zurück zum Anfang

Bildschirm: Winshuttle Composer Regel erstellen

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-Entwicklunsgtools 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
Geben Sie den zu erstellenden Regeltyp an. Abhängig vom gewählten Regeltyp werden weitere Optionen angezeigt. Klicken Sie für weitere Informationen einen Regeltyp an.

Validierung
Formatierung
Aktion

Bedingung
Wenn die angegebene Bedingung wahr ist, wird diese Regel ausgeführt, anderenfalls wird sie nicht ausgeführt.

Validierungsregeln

Zurück zum Anfang

Eine Validierungsregel kann verwendet werden, um eine Fehlermeldung anzuzeigen, wenn ungültige Daten in ein Formularfeld eingegeben werden. Sie können die Bedingungen festlegen, unter denen die Fehlermeldung angezeigt wird.

Sie können zum Beispiel eine Regel erstellen, dass ein Fehler angezeigt wird, wenn eine Zahl in ein Feld eingegeben wird, die größer als oder kleiner als ein bestimmter Wert ist, oder beides.

Bezeichnung: Eine beschreibende Bezeichnung für die Regel.
Regel beim Laden des Formulars ausführen: Bei Aktivierung wird die Regel ausgeführt, wenn das Formular zum ersten Mal geladen wird.
Bedingung: Hier klicken, um den Regelbedingungen-Generator zu öffnen, um die Bedingungen zu definieren, unter denen die Regel in Kraft tritt. Bedingungen können grundlegende Wertvergleiche sein oder komplexe Formeln beinhalten.
Typ: Der Regeltyp.
Fehlermeldung: Der Fehlermeldungstext, der angezeigt werden soll, wenn die von Ihnen definierten Bedingungen erfüllt werden.
Popup verwenden: Zeigt ein Dialogfeld mit der Validierungsnachricht an, anstatt den Fehler im Formular hervorzuheben.
Hinweis: Diese Option wird nur zum Anzeigen einer Nachricht verwendet. Die Regel wird nicht vor dem Einreichen des Formulars validiert.
Popup-Titel: Der Titel für das Popup-Feld.

Formatierungsregeln

Zurück zum Anfang

Formatierungsregeln wenden eine bestimmte Formatierung auf ein Formularfeld an, wenn bestimmten Bedingungen erfüllt sind.

Wenn der in ein Formularfeld eingegebene Wert zum Beispiel zu hoch ist, können Sie eine Regel erstellen, die das Formularfeld gelb markiert.

Bezeichnung: Eine beschreibende Bezeichnung für die Regel.
Regel beim Laden des Formulars ausführen: Bei Aktivierung wird die Regel ausgeführt, wenn das Formular zum ersten Mal geladen wird.
Bedingung: Hier klicken, um den Regelbedingungen-Generator zu öffnen, um die Bedingungen zu definieren, unter denen die Regel in Kraft tritt. Bedingungen können grundlegende Wertvergleiche sein oder komplexe Formeln beinhalten.
Typ: Der Regeltyp.
Stile auf Felder anwenden: Das Feld, auf das die Formatierung angewendet wird.
Formatierungsoptionen: Schriftart- und Farboptionen: fett, kursiv, unterstrichen, durchgestrichen, Hintergrund- und Textfarbe.

Formatierungsregelfeld – Composer 11.0.3

Schriftstilmodifikationen

Formularkomponentenmodifikationen

Schriftstilmodifikationen (auf die Formularkomponente dieses Felds anwenden)

Fettgedruckt
Kursiv
Unterstrichen
Durchgestrichen
Hintergrundfarbe
Textfarbe

Um ein Feld auszublenden, erforderlich zu machen oder zu deaktivieren, erstellen Sie eine Aktionsregel mit Feldeigenschaften ändern. Für weitere Informationen siehe den Eintrag zu Feldeigenschaften ändern in derSchnellreferenztabelle für Aktionsregeln.

Hinweis: In früheren Composer Versionen (11.0.2 und früher) erstellte Lösungen zeigen weiterhin die folgenden Optionen an.

Komponentengruppe ausblenden: Die gesamte Gruppe ausblenden, die das Feld beinhaltet, wenn die Bedingung wahr ist.
Komponente ausblenden: Das Feld und seine Bezeichnungen ausblenden, wenn die Bedingung wahr ist.
Diese Komponente deaktivieren: Das Feld deaktivieren, wenn die Bedingung wahr ist.
Komponente erforderlich: Das Feld auf „Erforderlich“ festlegen (d. h., das Formular kann nicht eingereicht werden, wenn das Feld leer ist), wenn die Bedingung wahr ist.

Neue Regeln, die in Composer 11.0.3 und höher erstellt wurden, müssen eine neue Aktionsregel verwenden: „Feldeigenschaften ändern“ (wie oben beschrieben).

Aktionsregeln

Zurück zum Anfang

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.

Bezeichnung: Eine beschreibende Bezeichnung für die Regel.
Regel beim Laden des Formulars ausführen: Bei Aktivierung wird die Regel ausgeführt, wenn das Formular zum ersten Mal geladen wird.
Bedingung: Hier klicken, um den Regelbedingungen-Generator zu öffnen, um die Bedingungen zu definieren, unter denen die Regel in Kraft tritt. Bedingungen können grundlegende Wertvergleiche sein oder komplexe Formeln beinhalten.
Typ: Der Regeltyp.
Hinzufügen: Hier klicken, um die Regel hinzuzufügen und das Dialogfeld „Regelaktion hinzufügen“ zu öffnen (siehe unten).

Sobald Sie die grundlegenden Informationen und Bedingungen für eine Aktionsregel angegeben haben:

Aktion: Wählen Sie die Aktion aus dem Dropdownmenü. Siehe die Schnellreferenztabelle für Regeln für eine Beschreibung von Regelaktionen.
Feld: Wählen Sie das Feld, auf die die Aktion angewendet wird. Sie können auch einen Feldnamen eingeben, um automatisch nach ihm zu suchen.
Wert: Geben Sie einen Wert ein oder klicken Sie auf f(x) (Funktion), um eine Formel einzufügen, die als Teil der Aktion ausgeführt wird.

Schnellreferenztabelle für Aktionsregeln

Zurück zum Anfang

Die unten stehende Tabelle bietet eine Übersicht über die zur Verfügung stehenden Aktionsregeln, eine Beschreibung dazu, was Regeln tun, und die mit der Aktion verknüpften Parameter.

Aktion	Beschreibung
Neue Zeile hinzufügen	Fügt einer wiederholten Tabelle oder Gruppe eine neue Zeile hinzu. Parameter Gruppe: Die wiederholte Gruppe, der eine neue Zeile hinzugefügt wird.
Feldeigenschaften ändern	Ändert die Eigenschaften eines Felds dahingehend Eingaben einzublenden, auszublenden, zu aktivieren/deaktivieren oder erforderlich/nicht erforderlich zu machen. Parameter Verfügbare Optionen: Einblenden \| Ausblenden \| Aktivieren \| Deaktivieren \| Erforderlich\Nicht erforderlich Feld: Das zu ändernde Feld.
Gruppenanzeige ändern	Zeigt an, blendet aus, erweitert oder reduziert eine Gruppe basierend auf einem bestimmten Feld in der Gruppe. Parameter Feld in Gruppe: Die Felddaten, die den Anzeigestatus der beinhalteten Gruppe steuern. (Einblenden \| Ausblenden \| Erweitern \| Reduzieren)
Zeilenoptionen löschen	Aktivieren: Das Symbol „Papierkorb“" (löschen) einblenden. Deaktivieren: Das Symbol „Papierkorb“" (löschen) ausblenden. Parameter Gruppe: Die wiederholte Gruppe, für die „Zeilenoptionen löschen“ aktiviert/deaktiviert wird.
Leere Tabelle	Löscht alle Daten aus einer wiederholten Tabelle oder Gruppe. Parameter Gruppe: Die wiederholte Gruppe, aus der alle Daten gelöscht werden sollen.
Abfrage ausführen	Führt eine Abfragesteuerung im Formular aus. Parameter Abfragesteuerung: Die auszuführende Abfrage.
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 Feld: Das Feld, auf dem die Regel ausgeführt wird.
Webdienst ausführen	Führt eine Webdienststeuerung im Formular aus. Parameter Webdienststeuerung: Der auszuführende Webdienst.
Wiederholten Inhalt filtern	Aktiviert das Filtern von wiederholten Tabellen/Gruppen, wobei der Inhalt aufrechterhalten 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 Gruppe: Die Gruppe, die auf Grundlage der Filterkriterien gefiltert werden soll. Filter: Die Filterlogik für die Dropdownliste erstellen. Zum Beispiel können Sie „Is Equal To“ angeben und einen bestimmten Wert sowie And/Or-Operatoren eingeben.
Neue Zeilenoptionen	Aktivieren: Die Verknüpfung „Neue Zeile hinzufügen“ in einer wiederholten Tabelle/Gruppe einblenden. Deaktivieren: Die Verknüpfung „Neue Zeile hinzufügen“ in einer wiederholten Tabelle/Gruppe ausblenden. Parameter Gruppe: Die wiederholte Gruppe, für die „Neue Zeilenoptionen“ aktiviert/deaktiviert wird.
Dropdown-Optionen erneut laden	Führt zu einem erneuten Laden der Optionen in einer Dropdownliste oder einem Kombinationsfeld. Dies kann für dynamische Optionslisten verwendet werden. Parameter Feld: Das Dropdownfeld, in dem die Optionen erneut geladen werden.
Zuordnung darstellen	Sendet eine neue Adresse an eine Zuordnungssteuerung im Formular. Parameter Kartenelement: Die mit einer neuen Adresse zu aktualisierende Kartensteuerung. Beschreibung: Die Beschreibung, die dem neuen Ort auf der Karte zugewiesen wird. Adresse: Die Adresse des neuen Orts auf der Karte. Stadt: Die Stadt des neuen Orts auf der Karte. Bundesland: Das Bundesland des neuen Orts auf der Karte. Postleitzahl: Die Postleitzahl des neuen Orts auf der Karte. Land: Das Land des neuen Orts auf der Karte.
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 Gruppe: Gruppenname Beinhaltet: Feldname
Einen Feldwert festlegen	Diese Aktion ermöglicht es Ihnen, den Wert eines Felds im Formular zu ändern. Parameter Feld: Das Zielfeld, dessen Wert Sie festlegen wollen. Wert: Die zu evaluierende Formel, um den neuen Wert für das Feld zu erhalten. Dies kann andere Feldwerte, Funktionsaufrufe, externe Datenreferenzen oder konstante Werte umfassen.
Eine Bezeichnung festlegen	Diese Regelaktion ähnelt „Einen Feldwert festlegen“ (oben), jedoch wird hierdurch die Bezeichnung (oder Unterbezeichnung) eines Formularelements geändert. Parameter XPath: Das Feld (aus einem Dropdownmenü ausgewählt), für das der Bezeichnungswert des Formularelements geändert wird. Wert: Die zu evaluierende Formel, um den neuen Wert für das Feld zu erhalten. Dies kann andere Feldwerte, Funktionsaufrufe, externe Datenreferenzen oder konstante Werte umfassen. Unterbezeichnungen (True/False): Auf „True“ festlegen, um die Unterbezeichnung des angegebenen Elements zu ändern.
Wiederholte Inhalte sortieren	Sortiert die Elemente in einer wiederholten Tabelle. Parameter Feld in Gruppe: Das Feld im wiederholten Inhalt, nach dem sortiert wird. Sortierungsreihenfolge: Aufsteigend oder absteigend.
Formular abschicken	Diese Aktion ermöglicht es, die Schaltfläche „Einreichen“ auf dem Formular zu simulieren. Parameter Einreichungstyp: Die Disposition des Einreichungstyps: Abschließen – die aktuelle Aufgabe abschließen. Genehmigen – die aktuelle Aufgabe mit der Disposition „Genehmigt“ abschließen. Ablehnen – die aktuelle Aufgabe mit der Disposition „Abgelehnt“ abschließen. Speichern – das Formular speichern aber den Prozess nicht starten oder fortsetzen. Speichern und weiterleiten – das Formular speichern und den Prozess starten.