Statusparameter für Clients
Client-Statusparameter verwenden, um Werte an Komponentenkonfigurationen zu binden. Wenn sich der Wert des Client-Statusparameters ändert, wird die Komponente aktualisiert, um den neuen Wert zu verwenden.
Was ist eine clientseitige Interaktion?
- Durch Klicken auf eine Schaltfläche
- Anwenden eines Filters
- Sortieren einer Liste
- Eine Liste wird aktualisiert
- Bereitstellung von Inline-Suchergebnissen
- Einen Benutzer auf unvollständige oder falsche Daten warnen
Benutzer interagieren manchmal mit -Seiten, um zu anderen Seiten zu navigieren. In anderen Fällen möchten Anwender den Inhalt, das Erscheinungsbild oder die Daten einer Seite aktualisieren. Anstatt die gesamte Seite zu aktualisieren, aktualisieren clientseitige Interaktionen nur die betroffenen Teile einer Seite.
Beispielsweise kann ein Benutzer eine Liste sortieren, indem er auf einen Spaltenheader klickt. Beim Sortieren wird nur die Liste und nicht die gesamte Seite neu gezeichnet.
- Statusparameter für Clients
- Events
- Client-Skripts
Was sind Statusparameter für Clients?
Client-Statusparameter sind Seitenvariablen. Definieren und konfigurieren Sie einen Client-Statusparameter und verwenden Sie den Wert zum Konfigurieren von Komponenten. Client-Statusparameter zentralisieren die Verwaltung von Konfigurationswerten für Seitenkomponenten. UI Builder verwendet Client-Statusparameter, um die Anwender-Experience zu verbessern und personalisierte Inhalte und Services bereitzustellen.
Beispiel für Client-Statusparameter
Im Beispiel hat eine Seite einen Client-Statusparameter namens „color“. Zwei der drei Komponenten sind für die Verwendung des Client-Statusparameters „Farbe“ konfiguriert. Wenn die Farbe auf orange festgelegt ist, sind die Komponenten orange. Wenn die Farbe auf Lila festgelegt ist, sind die Komponenten lila. Wenn die Farbe auf Grün festgelegt ist, sind die Komponenten grün. Der Client-Statusparameter ist ein zentraler Ort, um einen allgemeinen Wert für die Seite zu verwalten. Ohne den Client-Statusparameter muss jede Komponente, die einen Wert verwendet, einzeln aktualisiert werden, wenn sich dieser Wert ändert.
Beispielsweise speichert eine Web-Experience die Primärfarbe, die von Komponenten im Farb-Client-Statusparameter verwendet wird. Wenn die Komponenten für die Verwendung des Client-Statusparameters konfiguriert sind, werden die Komponenten durch Ändern des Werts des Client-Statusparameters auf den neuen Wert aktualisiert.
Der Experience können Schaltflächen hinzugefügt werden, damit Benutzer eine Farbe für die Seitenkomponenten auswählen können. Mit einem einzigen Klick kann ein Anwender gleichzeitig die Farbe aller Komponenten auf einer Seite ändern. Speichern Sie die Farbauswahl des Anwenders in einem Client-Statusparameter, und verwenden Sie dann den Client-Statusparameter, um die Komponenten der Seite zu konfigurieren. Wenn eine Benutzerinteraktion zu einer Änderung des Werts des Client-Statusparameters führt, werden die Komponenten der Seite in Echtzeit aktualisiert.
Der Client-Statusbereich
Der Client-Statusbereich ist standardmäßig reduziert. Klicken Sie in der linken Navigationsleiste auf das Symbol „Client-Status“, um den Client-Statusbereich zu öffnen.
- Client-Statusparameter: Die Client-Statusparameter für die Seite
- Vorschau auf Clientstatus: Das JSON-Objekt für die Clientstatusparameter der Seite
Erstellen von Client-Statusparametern
Um einer Seite einen Client-Statusparameter hinzuzufügen, klicken Sie im Abschnitt „Client-Statusparameter“ auf die Schaltfläche + Hinzufügen.
- Name: Der Name des Parameters. Namen dürfen keine Leerzeichen enthalten
- Typ: Der Typ des Parameters
- Zeichenfolge
- Nummer
- Boolean
- JSON
- Anfangswert: Der Standardwert für den Parameter
- OpportunityTypeQuery ist eine Zeichenfolge ohne Standardwert
- OpportunityListTitle ist eine Zeichenfolge mit dem Standardwert „ Alle besonderen Anlässe“.
Arbeiten mit Statusparametern für Clients
Was können Sie mit einem Client-Statusparameter tun? Um mit Client-Statusparametern zu arbeiten, binden Sie zuerst den Wert der Client-Statusparameter an Komponentenkonfigurationen. Wenn sich der Wert des Client-Statusparameters ändert, wird die Komponente aktualisiert, um den neuen Wert zu verwenden. Eine Möglichkeit, den Wert eines Client-Statusparameters zu ändern, sind Ereignishandler.
Im Beispiel der Seite zum Erstellen von Client-Statusparametern wurden der Anwendung für besondere Anlässe zwei Client-Statusparameter hinzugefügt: incidentTypeQuery und incidentListTitle. Der Parameter „ OpportunityTypeQuery “ hat standardmäßig keinen Wert, und für „ OpportunityListTitle “ wird der Standardwert für alle besonderen Anlässeverwendet. Diese Client-Statusparameter werden auf die Komponente „Anlassliste“ angewendet, um Titel und Filter der Liste festzulegen. Eine Schaltfläche wird verwendet, um die Werte dieser Client-Statusparameter zu aktualisieren und die Liste dynamisch zu aktualisieren.
Bindende Statusparameter des Clients
Client-Statusparameterwerte können auf die gleiche Weise an Komponentenkonfigurationsfelder gebunden werden wie Seitenkontext, Nutzlast und Datenressourcen. Bewegen Sie den Mauszeiger beim Konfigurieren von Komponenten über ein Feld, und wählen Sie dann die Schaltfläche Dynamische Datenbindung ( 
), um einen Client-Statusparameter an den Feldwert zu binden. Im Beispiel ist die Schaltfläche Dynamische Datenbindung für das Filterfeld der Komponente „Anlassliste“ hervorgehoben.
Das Zeichen @ gibt eine Datenbindung an, und das Statusobjekt enthält die Client-Statusparameter. Wählen Sie in der Auswahlliste einen Client-Statusparameter aus. Das Beispiel zeigt die Auswahl des Client-Statusparameters „gelegenheitsTypeQuery“. Der Standardwert für den Clientstatusparameter „ gelegenheitsTypeQuery“ ist leer, sodass standardmäßig kein Filter angewendet wird.
Der Titel für die Komponente wird auf ähnliche Weise festgelegt: Wählen Sie die Schaltfläche Dynamische Datenbindung für das Feld Titel aus, oder geben Sie @ ein, und wählen Sie dann in der Auswahlliste den Client-Statusparameter state. incidentListTitle aus. Der Standardwert für den Client-Statusparameter für Gelegenheitstiteltitel ist Alle Sonderanlässe. Im Beispiel sind sowohl Titel als auch Filter für die Verwendung von Client-Statusparametern konfiguriert.
Wenn beide Client-Statusparameter angewendet werden, wird kein Filter auf die Liste angewendet, und der Titel lautet Alle Besondere Anlässe.
Die Client-Statusparameter-Werte für „AngelegenheitstypAbfrage“ und „Anlassliste-Titel“ bleiben unverändert, bis ein Benutzer mit einer Komponente interagiert, die den Wert des Client-Statusparameters ändert.
Ändern Sie die Statusparameterwerte für Clients
Verwenden Sie den Ereignis-Handler Client-Statusparameter aktualisieren, um den Wert eines Client-Statusparameters zur Laufzeit zu ändern. Der Event-Handler „Client-Statusparameter aktualisieren“ hat zwei Eigenschaften: den zu aktualisierenden Client-Statusparameter und den neuen Wert, der für den Client-Statusparameter verwendet werden soll.
Als Beispiel wird über der Komponente „Anlassliste“ in der Anwendung „Besondere Anlässe“ eine Schaltfläche „Geburtstage“ hinzugefügt. Das Ziel dieser Schaltfläche besteht darin, den Titel der Liste in „Alle Geburtstage“ zu ändern und den Filter der Liste so anzupassen, dass nur Geburtstage angezeigt werden. Um dieses Ziel zu erreichen, werden dem Ereignis „Schaltfläche geklickt“ für die Schaltfläche zwei Ereignis-Handler zugeordnet: einer zum Ändern des Client-Statusparameters „angelegenheitTypeQuery“ und der andere zum Ändern des Client-Statusparameters „ gelegenheitslistetitel“. Die Abbildung zeigt den Ereignis-Handler Client-Statusparameter aktualisieren, der so konfiguriert ist, dass der Client-Statusparameter „gelegenheitTypeQuery“ auf special_OCCase=Geburtstagfestgelegt ist. Dadurch wird die Liste so gefiltert, dass nur Geburtstage angezeigt werden.
Wenn das Ereignis „Schaltfläche angeklickt“ Ereignishandlern zugeordnet ist, um die Clientstatusparameter „gelegenheitstypeQuery“ und „gelegenheitslistetitel“ zu aktualisieren, werden durch Klicken auf die Schaltfläche die Statusparameter des Clients aktualisiert, wodurch die Komponente „Anlasssliste“ automatisch mit den neuen Werten aktualisiert wird.