--- sourceDocument: Yokohama Erstellen oder ändern Sie Anwendungen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/application-development Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Erstellen oder ändern Sie Anwendungen ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- Statusparameter für Clients =========================== Statusparameter für Clients {#ariaid-title1} ============================================ * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer 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? {#client-state-parameters__section_ylp_kfb_czb} --------------------------------------------------------------------------------------- In webbasierten Anwendungen ist alles, was im Browser geschieht, clientseitig. Clientseitige Interaktionen treten auf, wenn Benutzer mit Experience-Komponenten interagieren, indem sie auf klicken. Beispiele für clientseitige Interaktionen sind unter anderem: * 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 {#client-state-parameters__ul_tmw_lfb_czb} 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. Das Erstellen clientseitiger Interaktionen in UI Builder umfasst: * Statusparameter für Clients * [Events](https://servicenow-prod.fluidtopics.net/7FMbV~jH3Bupz8DQEAOToA "Eine Ereigniszuordnung in UI Builder ist der Prozess, mit dem Sie die Nutzlast oder kontextbezogene Werte eines Ereignisses dem Objekt oder Handler zuordnen können, das bzw. den auf dieses Ereignis wirkt. Die vier Ereignistypen sind: Komponente, Seite, Datenressource und deklarative Aktion.") * [Client-Skripts](https://servicenow-prod.fluidtopics.net/ACLc2lpwXPFKygbYPPZmCA "Fügen Sie Client-Skripts in UI Builder hinzu, und bearbeiten Sie sie, um den Client-Status über Events zu aktualisieren. Sie können diese Skripts mithilfe eines Ereignishandlers an jede Komponente binden.") {#client-state-parameters__ul_wd1_zfb_czb} Was sind Statusparameter für Clients? {#client-state-parameters__section_rk2_ff3_1zb} ------------------------------------------------------------------------------------- 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 {#client-state-parameters__section_qby_j2l_bzb} ----------------------------------------------------------------------------------- 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 {#client-state-parameters__section_e1y_dgb_czb} ------------------------------------------------------------------------ Der Client-Statusbereich ist standardmäßig reduziert. Klicken Sie in der linken Navigationsleiste auf das Symbol „Client-Status", um den Client-Statusbereich zu öffnen. Der Client-Statusbereich enthält zwei Abschnitte: * Client-Statusparameter: Die Client-Statusparameter für die Seite * Vorschau auf Clientstatus: Das JSON-Objekt für die Clientstatusparameter der Seite {#client-state-parameters__ul_uhw_ggb_czb} Erstellen von Client-Statusparametern {#client-state-parameters__section_jpq_fkb_czb} ------------------------------------------------------------------------------------- Um einer Seite einen Client-Statusparameter hinzuzufügen, klicken Sie im Abschnitt „Client-Statusparameter" auf die Schaltfläche + Hinzufügen. Client-Statusparameter besitzen drei Konfigurationsfelder. * Name: Der Name des Parameters. Namen dürfen keine Leerzeichen enthalten * Typ: Der Typ des Parameters * Zeichenfolge * Nummer * Boolean * JSON {#client-state-parameters__ul_p1f_kkb_czb} * Anfangswert: Der Standardwert für den Parameter {#client-state-parameters__ul_k5l_3kb_czb} Im Beispiel weist der Clientstatusbereich zwei Clientstatusparameter auf. * OpportunityTypeQuery ist eine Zeichenfolge ohne Standardwert * OpportunityListTitle ist eine Zeichenfolge mit dem Standardwert „ Alle besonderen Anlässe“. {#client-state-parameters__ul_tlp_nkb_czb} Arbeiten mit Statusparametern für Clients {#client-state-parameters__section_utq_22h_czb} ----------------------------------------------------------------------------------------- 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-state-parameters__section_nqx_q3h_czb} ------------------------------------------------------------------------------------ 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 ( ![Symbol für 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 {#client-state-parameters__section_cnh_wvj_dzb} ----------------------------------------------------------------------------------------------- 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. * **[Verwenden von Client-Statusparametern in UI Builder](https://servicenow-prod.fluidtopics.net/alLOaopW13E08r26l6dPGg)** Erstellen Sie einen einfachen Zähler, indem Sie die stilisierte Textkomponente und zwei Schaltflächen zu einer Experience-Seite hinzufügen. Verwenden Sie einen Client-Statusparameter, um die Funktionalität zu implementieren, sodass die Anzahl erhöht oder verringert wird, wenn die Schaltflächen ausgewählt werden. * **[Aktualisiert den Status einer Komponente mithilfe von Client-Statusparametern](https://servicenow-prod.fluidtopics.net/Sq4aKQZZ20NTUkiTFg~t4w)** Erstellen und binden Sie einen Client-Statusparameterwert an eine Komponente in UI Builder. Durch Hinzufügen anwenderdefinierter Werte zu Ihren Komponenten können diese Komponenten dann automatisch über ein Skript aktualisiert werden.