Daten mithilfe von Controllern an UI Builder-Seiten binden (erweiterte Funktion)
Controller vereinfachen die Verknüpfung von Daten und Event-Logik, um Komponentenvoreinstellungen in UI Builderzu ermöglichen.
Mit Controllern können Seitenersteller auf einfache Weise eine Verbindung zu Daten und Skripts für ihre Seiten in UI Builderherstellen . Ein Controller ist eine Art Datenressource, die von Komponentenvoreinstellungen zum Binden von Daten an Komponenten verwendet wird. Controller unterscheiden sich von anderen Datenressourcen dadurch, dass sie Daten und Event-Logik enthalten, die Voreinstellungen für Komponenten ermöglicht. Ein Controller übermittelt Daten vom Server an eine Komponente und aktualisierte Daten basierend auf Interaktionen mit der Komponente zurück an den Server. Weitere Informationen zu Komponentenvoreinstellungen finden Sie unter Konfigurieren Sie Komponenten automatisch mithilfe von Voreinstellungen.
Typen von Datencontrollern in UI Builder
- Datencontroller
- Datencontroller entscheiden, welche Informationen auf den Seiten von UI Builder angezeigt werden sollen. Datencontroller verwenden Datenressourcen, um Informationen in Echtzeit zu synchronisieren und Daten/Tabellen zu aktualisieren, wenn ein Benutzer Informationen eingibt. Sie können Datencontroller manuell zu einer Seite hinzufügen.
- UI-Controller
- UI-Controller werden Seiten hinzugefügt, wenn UI Builder Seitenvorlagen verwendet werden, und können nicht manuell hinzugefügt werden.
Verwenden von Controllern mit Voreinstellungen in UI Builder
Sie können einer Seite UI Builder mehrere Controller hinzufügen, aber Sie können denselben Controller nicht zweimal verwenden. Wenn Sie versuchen, eine Komponentenvoreinstellung zu verwenden, die einen Controller benötigt, werden Sie von UI Builder aufgefordert, ihn hinzuzufügen.
Nicht alle Komponenten funktionieren mit Controllern, aber Sie können in der Komponentenbibliothek leicht sehen, welche funktionieren. Wenn Sie auf Ihrer Seite UI Builder einen Controller konfiguriert haben, können Sie die Komponentenbibliothek öffnen, um anzuzeigen, welche Komponenten über Voreinstellungen verfügen. Komponenten mit verfügbaren Voreinstellungen werden in der Komponentenbibliothek hervorgehoben.
Fügen Sie einen Controller hinzu
Fügen Sie Ihrer Seite einen Datencontroller hinzu, um Komponentenvoreinstellungen zu verwenden.
Vorbereitungen
Erforderliche Rolle: admin
Warum und wann dieser Vorgang ausgeführt wird
Der Datensatz-Controller ist der einzige Controller, den Sie einer Seite in Washington DChinzufügen können.
Prozedur
-
Wählen Sie Datenressource aus.
-
Wählen Sie Hinzufügen.
-
Füllen Sie die Felder aus, um den Controller zu konfigurieren.
Ergebnisse
Der Formular-Controller wird im Abschnitt „ Datenressourcen “ angezeigt.
Bearbeiten Sie einen Controller
Konfigurieren Sie einen Controller, um Daten aus einer Tabelle abzurufen.
Vorbereitungen
Erforderliche Rolle: admin
Prozedur
-
Wählen Sie im Drawer Daten und Skripts den Controller aus, den Sie bearbeiten möchten.
Löschen Sie einen Controller
Löschen Sie einen Controller, den Sie nicht mehr benötigen, in UI Builder.
Vorbereitungen
Erforderliche Rolle: admin
Warum und wann dieser Vorgang ausgeführt wird
Controller können nicht aus Seiten gelöscht werden, die mit einer Seitenvorlage erstellt wurden.
Prozedur
-
Wählen Sie das Menüsymbol (
) neben dem Controller aus, den Sie löschen möchten.
-
Wählen Sie Löschen.
Der Controller wird aus den lokalen Datenressourceninstanzen entfernt.
Zeigen Sie Eigenschaften und Events in der Controller-API an
Die öffentliche Controller-API definiert die Ausgabedaten, die ein Controller für eine Voreinstellung bereitstellt. Dies umfasst die Eigenschaftswerte und behandelten Ereignisse, die von einer Komponente verwendet werden, wenn eine Voreinstellung ausgewählt wird. Eigenschafts- und Ereignisinformationen können in UI Builder angezeigt werden.
Die Komponenteneigenschaftswerte in einer Voreinstellung können statische Werte oder Pfade zu Controller-Ausgabedaten sein. Sie können den Datenressourceninspektor in UI Builder verwenden, um die Werte aus der Controller-Datenstruktur anzuzeigen, die von einer Voreinstellung verwendet wird. Um die Nutzlast eines Events in der Voreinstellung anzuzeigen, können Sie in der Event-Handler-Auswahl nach diesem Event suchen.
Eigenschaften in der Controller-API anzeigen
Sie können voreingestellte Eigenschaften im UIB-Dateninspektor anzeigen. Wenn Sie die verfügbaren Werte kennen, können Sie verstehen, wie sich eine Komponente in Ihrem Design verhält, und Eigenschaften in der Voreinstellung identifizieren, die Sie überschreiben möchten.
Bei diesem Verfahren wird davon ausgegangen, dass Sie eine Komponente mit einer Voreinstellung auf der Seite platziert und einen Controller konfiguriert haben. Anweisungen finden Sie unter Controller hinzufügen.
Auf der Registerkarte „Konfiguration“ werden voreingestellte Eigenschaftswerte als Pfad zur Controller-Ausgabe angezeigt. Der Basisdatenpfad wird als @data ausgedrückt.<controller_name> . Der Rest des Pfads wird aus den Inhalten der Kategorien innerhalb der Controller-Datenhierarchie erstellt. Sie können diesen Pfad verwenden, um die aktuellen Werte für den Datensatz anzuzeigen, für den der Controller konfiguriert wurde.
- Um die Datenressourcen für eine Komponente anzuzeigen, wählen Sie das Datensymbol in der linken unteren Seitenleiste aus.
Der dreispaltige UIB-Dateninspektor wird angezeigt.
- Wählen Sie in der ersten Spalte, in der die Datenressourcen aufgelistet sind, den Controller aus, dessen Ausgabe Sie anzeigen möchten.Die Konfigurationsdaten für den ausgewählten Controller werden auf der Registerkarte „Konfiguration“ der zweiten Spalte angezeigt. Dies sind die Eingabeeigenschaften, die Sie eingegeben haben, als Sie den Controller für die erste Komponente mit einer Voreinstellung konfiguriert haben, die Sie auf der Seite platziert haben. Sie können diese Verbindungswerte hier bearbeiten, wenn Sie möchten.Hinweis:Wenn Sie -1 für den Wert im Feld Sys-ID konfigurieren, wird der Controller für einen neuen Datensatz konfiguriert. Der Controller generiert dann eine vollständige GUID, die Sie zum Speichern von Daten für den Datensatz verwenden können, bevor er gespeichert wird. Auf diese Weise können Sie Aktionen in einem neu erstellten Datensatz ausführen, z. B. Anhänge speichern.
- Wählen Sie in der dritten Spalte Ausgaben der obersten Ebene aus.
Dies ist die übergeordnete Ebene der Controller-Datenhierarchie, die mit dem Präfix
@data angegeben wird., gefolgt von der Controller-ID. Diese Kombination bildet den Stammpfad zu den Daten. Die in den Ausgaben der obersten Ebene enthaltenen Daten werden im angrenzenden Codefeld angezeigt und stehen zur Verwendung durch Voreinstellungen und Skripts zur Verfügung. Andere Eigenschaften auf dieser Ebene sind einige allgemeine Eigenschaften, die für alle Datensätze gelten.Wenn die Voreinstellung der Controller-Ausgabe eine Komponenteneigenschaft zuordnet, wird anstelle des Werts der Pfad zur Ausgabe angezeigt. Pfade werden als @data.<Controller-ID>.<Pfad von oberster Ebene zur Ausgabeeigenschaft> bezeichnet und können als Werte oder als Teil von Formelausdrücken verwendet werden.
In diesem Beispiel führt die Zuordnung in der Voreinstellung zu einem Pfad zu
@data.gform.table. - Um Daten unterhalb der obersten Ebene anzuzeigen, wählen Sie die untergeordnete Kategorie aus, die durch den Pfad im voreingestellten Eigenschaftswert angegeben wird.
Der Name der untergeordneten Kategorie wird im Pfad als
@data angezeigt.<controller ID> .<category> . Die Daten aus dieser Kategorie werden dann an diesen Pfad angehängt. Der Stammpfad über dem Codefeld gibt die verwendete untergeordnete Kategorie an. In diesem Beispiel wird der Pfad zur Eigenschaft Ansicht in derFormularkategorieals@data.gform.form.viewausgedrückt. Dieser voreingestellte Wert zeigt Formulare in der Arbeitsbereichsansicht an.In diesem Beispiel werden mehrere Controller-Ausgabeeigenschaften in einem Formelausdruck verwendet, um ein Objekt zu erstellen.
- Um einen geskripteten Eigenschaftswert anzuzeigen, wählen Sie das Schlosssymbol neben der Eigenschaft aus.
Dadurch wird die Eigenschaft in den Bearbeitungsmodus versetzt und ein Dialogfeld zum Bearbeiten des Skripts geöffnet.
Events in der Controller-API [ anzeigen
- Wechseln Sie in UI Builder zur Registerkarte Ereignisse.
- Um die Zuordnung für ein voreingestelltes Event anzuzeigen, wählen Sie die Event-Kachel aus.
Ein Dialogfeld mit den Nutzlasteigenschaften für das voreingestellte Event wird angezeigt. Sie können das Event in diesem Modal deaktivieren.
- Um dem Event einen Event-Handler hinzuzufügen, wählen Sie + Event-Handler hinzufügen unter der Event-Kachel aus.
Ein Dialogfeld mit einer Liste der verfügbaren behandelten Events wird angezeigt. Sie können eine beliebige Aktion aus der Liste auswählen, einschließlich eines Event Handlers von einem der aufgeführten Controller.
- Wählen Sie einen Event Handler aus der Liste aus, und wählen Sie Hinzufügen.
Der neue Handler wird unter der Event-Kachel aufgelistet.