Komponenten mithilfe von Voreinstellungen automatisch konfigurieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer
  • Verwenden Sie Komponentenvoreinstellungen, um Komponenten auf kompatiblen Seiten automatisch zu konfigurieren.

    Verwenden Sie Komponentenvoreinstellungen, um vordefinierte Konfigurationswerte und Ereigniszuordnungen auf Komponenten anzuwenden. Die Seitenvorlagen UI Builder enthalten Controller, die von Voreinstellungen zum Definieren von Komponentenkonfigurationswerten verwendet werden.

    Voreinstellungen wenden vorgefertigte Konfigurationen auf Komponenteneigenschaften und Ereignishandler an und sind nur für bestimmte Komponenten verfügbar. Sie basieren auf gängigen Anwendungsfällen für Komponenten, z. B. der Konfiguration einer Formularkomponente mit Feldern, die normalerweise auf einer Datensatzseite enthalten sind.

    Durch das Anwenden einer Voreinstellung werden Komponenten automatisch so konfiguriert, dass sie sofort funktionieren, was die Erstellung und Wartung von Seiten für Seitenautoren vereinfacht.

    Voreinstellungen bieten Seitenautoren folgende Vorteile:

    • Umgang mit komplexen Daten- und Ereignisbindungen für Komponenten
    • Reduzierte Betriebs- und Wartungskosten, da außerhalb von Seiten definiert wird

    Im Konfigurationsbereich können Sie auswählen, ob eine Voreinstellung auf die ausgewählte Komponente angewendet oder manuell konfiguriert werden soll. Standardvoreinstellungen werden automatisch für Komponenten angewendet, wenn eine Seite aus einer Vorlage erstellt wird oder der für die Voreinstellung erforderliche Controller bereits der Seite hinzugefügt wurde. Alle durch die Voreinstellung konfigurierten Eigenschaften oder Ereignisse werden schreibgeschützt angezeigt, wenn eine Voreinstellung angewendet wird.

    Sie können durch eine Voreinstellung konfigurierte Werte überschreiben, übernehmen damit jedoch den Besitz der Komponentenkonfiguration und -wartung.

    Unterseiten erben keine Controller und können keine Voreinstellungen in Xanaduverwenden.
    Abbildung : 1. Voreinstellung angewendet auf eine -Komponente
    Überschriftenkomponenteneigenschaften, die durch eine Voreinstellung konfiguriert werden.

    Daten- und Ereignisbindungen

    Voreinstellungen können Bindungen enthalten für:

    • Controller-Ausgabeeigenschaften (@data)
    • Ereignis-Nutzlasten (@payload)
    • Sitzungskontext (@context.session)
    • Komplexe Formeln (Client-Transformationen)

    Voreinstellungen können auch Event-Zuordnungen zu den behandelten Events eines Controllers enthalten. Weitere Informationen finden Sie unter Aktionen in UI Builder-Seiten verwalten (erweiterte Funktion).

    Controller

    Voreinstellungen verbinden Komponenten mithilfe eines Controllers mit Daten und Ereigniszuordnungen. Wenn der für eine Voreinstellung erforderliche Controller nicht bereits auf der Seite vorhanden ist, werden Sie in der Voreinstellung aufgefordert, die erforderlichen Eigenschaften des Controllers zu konfigurieren, und der Controller wird hinzugefügt. Nachdem ein Controller einer Seite hinzugefügt wurde, werden Komponenten, die über mit dem Controller verknüpfte Voreinstellungen verfügen, in der Komponentenliste hervorgehoben. Weitere Informationen finden Sie unter Daten mithilfe von Controllern an Seiten UI Builder binden (erweiterte Funktion).

    Abbildung : 2. Komponenten mit Voreinstellungen
    Registerkarte „Komponenten“ mit Komponenten mit hervorgehobener Voreinstellungsbezeichnung.

    Wählen Sie eine Komponentenvoreinstellung aus

    Wählen Sie eine Komponentenvoreinstellung aus, wenn Sie Ihrer Seite eine Komponente hinzufügen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Now-Experience-Framework > UI Builder.
    2. Öffnen Sie eine Experience, um darin zu arbeiten, oder erstellen Sie eine Experience, indem Sie auswählen Erstellen > Experience.
      Weitere Informationen zum Erstellen von Experiences finden Sie unter Konfigurieren Sie, wie Benutzer in mit Ihren Anwendungen interagieren UI Builder.
    3. Erstellen oder öffnen Sie eine Seite oder Seitenvariante.
      Weitere Informationen zum Erstellen einer Seite in UI Builder finden Sie unter Seite in UI Builder erstellen.
    4. Öffnen Sie die Toolbox.
    5. Fügen Sie Ihrer Seite eine grün hervorgehobene Komponente hinzu.

      Für grün hervorgehobene Komponenten sind Voreinstellungen verfügbar.

      Öffnen Sie die Komponentenbibliothek, und ziehen Sie eine grün hervorgehobene Komponente auf Ihre Seite.
    6. Die Komponente wird automatisch mit der Standardvoreinstellung konfiguriert.
      Die Standardkomponentenvoreinstellung wird in der Dropdownliste für Voreinstellungen angezeigt.
    7. Wahlweise: Wählen Sie in der Liste im Konfigurationsbereich eine andere Voreinstellung aus.
      Sie können eine Komponente so konfigurieren, dass keine Voreinstellung verwendet wird, indem Sie Entfernenwählen.
      1. Wählen Sie „ Fortsetzen“, um die vorhandene Voreinstellung zu ersetzen.
      Wählen Sie eine andere Voreinstellung oder keine Voreinstellung aus der Liste aus.
    8. Klicken Sie auf Speichern.

    Überschreiben Sie eine Komponentenvoreinstellung

    Überschreiben Sie eine Komponentenvoreinstellung, um Ihre eigenen anwenderdefinierten Werte einzugeben.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Wählen Sie eine Komponente mit einer Voreinstellung aus.
      Wählen Sie in der Inhaltsstruktur die Komponente aus, die Sie überschreiben möchten.
    2. Suchen Sie im Konfigurationsbereich nach dem Datenwert, den Sie überschreiben möchten.
    3. Klicken Sie auf das Schlosssymbol im Datenfeld.
    4. Geben Sie den Datenwert ein, mit dem Sie den voreingestellten Wert überschreiben möchten.
    5. Wählen Sie Speichern.
      Überschreiben Sie voreingestellte Komponentenwerte mit anwenderdefinierten Werten.

    Ergebnisse

    Im Konfigurationsbereich wird der anwenderdefinierte Wert im Feld angezeigt.

    Setzen Sie eine Komponente zurück

    Setzen Sie die Komponentenvoreinstellungen auf ihre Standardwerte zurück.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Wählen Sie in der Inhaltsstruktur die Komponente aus, die Sie zurücksetzen möchten.
      Wählen Sie in der Inhaltsstruktur die Komponente aus, die Sie überschreiben möchten.
    2. Wählen Sie im Konfigurationsbereich den Komponentennamen aus.
      Komponentenname im Konfigurationsbereich.
    3. Klicken Sie auf Komponente zurücksetzen.
      Setzen Sie die Komponentenwerte mit der Option „Komponente zurücksetzen“ zurück.
    4. Klicken Sie auf Zurücksetzen.

    Ergebnisse

    Die Komponentenvoreinstellung wird auf die Standardwerte zurückgesetzt.