Referenzleitfaden für Winshuttle Composer JavaScript

JavaScript-Referenzleitfäden

Die Winshuttle Composer Regeloberfläche verwendet die JavaScript-Engine des Webbrowsers. Der Composer Regelassistent definiert integrierte Regeln, die dann während der Ausführung des Formulars in JavaScript-Code umgewandelt werden.

Sollte der Composer Regelassistent nicht für Ihre Zwecke ausreichen, können Sie mithilfe von erweiterten JavaScript-Regeln spezifische Funktionen erstellen und anpassen, die in der Regel folgendermaßen aufgebaut sind:

Funktionstyp	Beschreibung
Formularfunktionen	Allgemeine Formularfunktionen, die zur Bearbeitung von Formularfeldern und Formularelementen verwendet werden, wie etwa das Erstellen oder Ausblenden von Gruppen, das erneute Laden von Dropdown-Optionen, das Festlegen von Werten in Feldern und vieles mehr.
Workflow-Funktionen	Allgemein verwendete Funktionen, die für Workflow-Übergänge verwendet und angewendet werden, um die Workflow-Logik zu steuern.
Globale Hilfsfunktionen	Diverse verdeckte Funktionen, die allgemein verwendet werden, um Daten in Feldern zu bearbeiten und Aufgaben auszuführen, wie etwa die Konvertierung von Text von Groß- in Kleinbuchstaben, die Mittelwertberechnung eines Wertesatzes, die Ausgabe der Anzahl der Werte in einer wiederholten Gruppe.
JQuery-Funktionen	Ein kleiner Satz Hilfsfunktionen, die von JQuery-Benutzern verwendet werden können.

Wichtige Hinweise – Bitte lesen

Sie können Regeln dauerhaft in JavaScript-Code umwandeln und benutzerdefinierte CSS-Stylesheets für Ihre Formulare erstellen.
Nachdem eine Regel zu JavaScript-Code umgewandelt wurde, kann sie nicht mehr zurück in eine integrierte Regel umgewandelt werden. Ab diesem Zeitpunkt kann die Regel nur noch mit dem JavaScript-Code-Editor (nicht mehr mit der Benutzeroberfläche des Regelassistenten) verwaltet werden.
Der Winshuttle Support kann Ihnen nicht dabei behilflich sein, JavaScript zu erstellen oder Fehler in JavaScript zu beheben.

Hinzufügen von benutzerdefiniertem JavaScript/CSS zu einem Formular

Die Composer Lösungsstruktur verfügt über zwei Knoten, an denen benutzerdefinierter JavaScript-Code und benutzerdefinierte CSS (Styles) gespeichert werden.

Öffnen Sie Composer.
Öffnen Sie die Lösungsdatei.
Klicken Sie auf die Registerkarte Lösung.
Doppelklicken Sie im Bereich Lösung auf einen der beiden Knoten (JavaScript-Code oder Benutzerdefinierte Styles), um den integrierten JavaScript- oder CSS-Code-Editor zu öffnen. (Siehe Beispiel rechts.)

Sie können auch mit der rechten Maustaste auf einen Knoten klicken, um das Kontextmenü zu öffnen, und können dann die JavaScript/CSS-Referenzen bearbeiten. Die Dialogfelder „Referenzen“ erlauben es Ihnen, beliebige Link-URLs in die JavaScript- und die CSS-Dateien einzufügen.

Zugriff auf Formularfeldwerte

Um auf ein Feld zuzugreifen oder es zu bearbeiten, verwenden Sie $form.getValue und $form.setValue in dem Formular.

Greifen Sie nicht direkt auf DOM-Elemente zu, um die Werte zu ändern. Andernfalls wird die korrekte Ereignisbehandlung und Regelweitergabe innerhalb des Formular-Renderers gestört.

Verwenden von jQuery

Der Formular-Renderer verwendet jQuery, das innerhalb der Regeln benutzt werden kann.

Anstatt $ zu verwenden, um auf Funktionen von jQuery zuzugreifen, sollten Sie das Alias $j oder den vollständigen Funktionsnamen von jQuery verwenden.