Skripte hochladen

Abgeschlossen

Das Skript zunächst als Skript-Webressource hochgeladen werden, um Client-Scripting auf einem Formular zu verwenden. Sie können Skript-Webressourcen verwenden, um Bibliotheken von Client-Skriptfunktionen zu verwalten, die in JavaScript (oder TypeScript) geschrieben sind und auf die über ein Formular einer modellgesteuerten App zugegriffen werden kann oder über die Befehlsleiste-Menübanddefinition. Bei Verwendung von TypeScript muss dies vor dem Hochladen als Webressource in JavaScript transpiliert werden.

Erstellen Sie im Formular-Editor eine neue Formularbibliothek, um eine Skript-Webressource hochzuladen.

Screenshot des Dialogfelds „Bibliothek hinzufügen“

Stellen Sie sicher, dass Sie Script(JScript) als Typ ausgewählt haben.

Screenshot des Dialogfelds zum Hinzufügen von Webressourcen mit ausgewähltem Skripttyp

Sie müssen sicherstellen, dass Sie das Formular für die Verwendung der Spalte im Formular konfigurieren, damit Tabellenspaltendaten zur Einbeziehung in die Logik eines Skripts verfügbar sind. Zusätzlich dazu, dass Sie die Spalte als Steuerelement zum Formular hinzufügen müssen, besteht die Gefahr, dass jemand sie entfernt und Ihr Skript abbricht, da die referenzierte Spalte nicht mehr verfügbar ist. Sie können die Spalte als Abhängigkeit hinzufügen, um sicherzustellen, dass die Spaltendaten für Ihre Skript-Logik immer verfügbar sind. Die folgende Abbildung zeigt das Hinzufügen der Ideenbewertung aus der Tabelle Idee als eine Abhängigkeit.

Screenshot des Hinzufügens der Kontonummernspalte aus der Kontotabelle als eine Abhängigkeit

Webressourcenabhängigkeiten

Neben Datenabhängigkeiten können Sie auch andere Webressourcenabhängigkeiten konfigurieren. Diese Abhängigkeit spart Zeit und vereinfacht das Laden der Logik, da das Formular nicht explizit verschiedene abhängige Webressourcen laden muss, wenn Sie ein Skript für ein Formularereignis, einen Menübandbefehl oder Regeln zur Menübandaktivierung registrieren. Mit der Abhängigkeitskonfiguration können Sie das primäre Skript registrieren und die Abhängigkeitskonfiguration die anderen Ressourcen laden lassen, von denen Ihr Code abhängt.

Es ist wichtig, dass Abhängigkeiten von Webressourcen keine Kontrolle über die Reihenfolge bieten, in der die Webressourcen geladen werden. Alle Webressourcen werden asynchron und parallel geladen. Wenn Sie über eine JavaScript-Webressource verfügen, die davon abhängt, dass eine andere JavaScript-Webressource geladen und initialisiert werden kann, bevor sie initialisiert werden kann, müssen Sie diese Abhängigkeit auf andere Art und Weise verwalten.

Client-Skriptbibliotheken verwenden

Sobald Sie als Skript-Webressource konfiguriert wurden, können Client-Skriptbibliotheken Menübandbefehlen und Formularereignissen zugeordnet werden. Klicken Sie auf Formularbibliotheken in der Symbolleiste und dann auf Bibliothek hinzufügen, um ein Skript mit einem Formular zu verknüpfen.

Screenshot der Formularbibliotheken und des Hinzufügens einer Bibliothek

Im Dialogfeld Bibliothek hinzufügen können Sie entweder eine bestehende hochgeladene Skript-Webressource zuordnen oder eine neue erstellen.

Screenshot des Dialogfelds Bibliothek hinzufügen, der zeigt, wie Sie entweder eine bestehende hochgeladene Skript-Webressource zuordnen oder eine neue erstellen können

Das Verknüpfen der Skriptbibliothek mit dem Formular muss pro Skript und Formular nur einmal durchgeführt werden, unabhängig davon, wie viele Ereignishandler Sie in diesem Formular registrieren.

Während Sie Ihre Client-Skriptlogik erstellen und nach dem ersten Hochladen Änderungen vornehmen müssen, kehren Sie zur Skriptwebressource in der Lösung zurück und laden die neue Version der Datei hoch. Nach dem Hochladen müsse die Skript-Webressource veröffentlichen, damit die neuesten Änderungen in der App verwendet werden.