--- sourceDocument: Yokohama Créer ou modifier des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Yokohama Créer ou modifier des applications ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- Paramètres de l'état du client ============================== Paramètres de l'état du client {#ariaid-title1} =============================================== * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture Utilisez les paramètres de l'état du client pour lier les valeurs aux configurations des composants. Lorsque la valeur du paramètre d'état client change, le composant se met à jour pour utiliser la nouvelle valeur. Qu'est-ce qu'une interaction côté client ? {#client-state-parameters__section_ylp_kfb_czb} ------------------------------------------------------------------------------------------ Dans les applications Web, tout ce qui se passe dans le navigateur est côté client. Les interactions côté client se produisent lorsque les utilisateurs interagissent avec les composants d'expérience en cliquant. Voici quelques exemples d'interactions côté client : * Cliquer sur un bouton * Application d'un filtre * Tri d'une liste * Actualiser une liste * Fourniture de résultats de recherche en ligne * Alerter un utilisateur de données incomplètes ou incorrectes {#client-state-parameters__ul_tmw_lfb_czb} Les utilisateurs interagissent parfois avec les pages afin de naviguer vers d'autres pages. Dans d'autres cas, les utilisateurs souhaitent mettre à jour le contenu, l'apparence ou les données d'une page. Plutôt que d'actualiser la page entière, les interactions côté client ne mettent à jour que les parties affectées d'une page. Par exemple, un utilisateur peut trier une liste en cliquant sur un en-tête de colonne. Le tri ne redessine que la liste et non la page entière. La création d'interactions Générateur d'IU côté client implique : * Paramètres de l'état du client * [Events](https://servicenow-prod.fluidtopics.net/K0EwI6TKxwwNHuG3POiXsA "Un mappage d’événements Générateur d'IU est le processus qui vous permet de mapper la charge utile ou les valeurs contextuelles d’un événement à l’objet ou au gestionnaire qui agit sur cet événement. Les quatre types d’événements sont les suivants : composant, page, ressource de données et action déclarative.") * [Scripts clients](https://servicenow-prod.fluidtopics.net/dj4GCOrFDds6OuKodjpt9Q "Ajoutez et modifiez des scripts clients afin de Générateur d'IU pouvoir mettre à jour l’état du client via des événements. Vous pouvez lier ces scripts à n’importe quel composant à l’aide d’un gestionnaire d’événements.") {#client-state-parameters__ul_wd1_zfb_czb} Quels sont les paramètres de l'état du client ? {#client-state-parameters__section_rk2_ff3_1zb} ----------------------------------------------------------------------------------------------- Les paramètres de l'état du client sont des variables de page. Définissez et configurez un paramètre d'état client et utilisez la valeur pour configurer les composants. Les paramètres de l'état du client centralisent la gestion des valeurs de configuration pour les composants de page. Générateur d'IU Utilise les paramètres de l'état du client pour améliorer l'expérience utilisateur et fournir un contenu et des services personnalisés. Exemple de paramètres de l'état du client {#client-state-parameters__section_qby_j2l_bzb} ----------------------------------------------------------------------------------------- Dans l'exemple, une page a un paramètre d'état client appelé couleur. Deux des trois composants sont configurés pour utiliser le paramètre d'état client de couleur. Si la couleur est définie sur orange, les composants sont orange. Si la couleur est définie sur violet, les composants sont violets. Si la couleur est définie sur le vert, les composants sont verts. Le paramètre d'état du client est un emplacement unique permettant de gérer une valeur commune pour la page. Sans le paramètre d'état client, chaque composant qui utilise une valeur devrait être mis à jour individuellement si cette valeur change. Par exemple, une expérience Web stocke la couleur primaire utilisée par les composants dans le paramètre d'état du client de couleur. Lorsque les composants sont configurés pour utiliser le paramètre d'état client, la modification de la valeur du paramètre d'état client met à jour les composants vers la nouvelle valeur. Des boutons peuvent être ajoutés à l'expérience pour permettre aux utilisateurs de sélectionner une couleur pour les composants de la page. D'un simple clic, un utilisateur peut modifier simultanément la couleur de tous les composants d'une page. Stockez le choix de couleur de l'utilisateur dans un paramètre d'état client, puis utilisez le paramètre état client pour configurer les composants de la page. Lorsqu'une interaction de l'utilisateur entraîne la modification de la valeur du paramètre de l'état du client, les composants de la page sont mis à jour en temps réel. Le panneau d'état du client {#client-state-parameters__section_e1y_dgb_czb} --------------------------------------------------------------------------- Le panneau d'état du client est réduit par défaut. Cliquez sur l'icône de l'état du client dans la barre de navigation de gauche pour ouvrir le panneau de l'état du client. Le panneau d'état du client contient deux sections : * Paramètres d'état du client : paramètres d'état du client pour la page * Aperçu de l'état du client : JSON pour les paramètres de l'état du client de la page {#client-state-parameters__ul_uhw_ggb_czb} Création de paramètres de l'état du client {#client-state-parameters__section_jpq_fkb_czb} ------------------------------------------------------------------------------------------ Pour ajouter un paramètre d'état client à une page, cliquez sur le bouton + Ajouter dans la section Paramètres d'état client. Les paramètres d'état du client ont trois champs de configuration. * Nom : nom du paramètre. Les noms ne doivent pas inclure d'espaces * Type : type du paramètre * Chaîne * Numéro * Booléen * JSON {#client-state-parameters__ul_p1f_kkb_czb} * Valeur initiale : valeur par défaut du paramètre {#client-state-parameters__ul_k5l_3kb_czb} Dans l'exemple, le panneau d'état du client comporte deux paramètres d'état du client. * occasionTypeQuery est une chaîne sans valeur par défaut * occasionListTitle est une chaîne dont la valeur par défaut est Toutes les occasions spéciales {#client-state-parameters__ul_tlp_nkb_czb} Utilisation des paramètres de l'état du client {#client-state-parameters__section_utq_22h_czb} ---------------------------------------------------------------------------------------------- Une fois que vous avez un paramètre d'état client, que pouvez-vous en faire ? Pour utiliser les paramètres d'état du client, lier d'abord la valeur du paramètre d'état du client aux configurations des composants. Lorsque la valeur du paramètre d'état client change, le composant se met à jour pour utiliser la nouvelle valeur. Une façon de modifier la valeur d'un paramètre d'état client consiste à utiliser des gestionnaires d'événements. Dans l'exemple de page de création de paramètres d'état du client, deux paramètres d'état du client ont été ajoutés à l'application occasions spéciales : occasionTypeQuery et occasionListTitle. Le paramètre occasionTypeQuery n'a pas de valeur par défaut et occasionListTitle a la valeur par défaut Toutes les occasions spéciales. Ces paramètres d'état du client sont appliqués au composant Liste d'occasions pour définir le titre et le filtre de la liste. Un bouton sera utilisé pour mettre à jour les valeurs de ces paramètres d'état client afin de mettre à jour dynamiquement la liste. Liaison des paramètres de l'état du client {#client-state-parameters__section_nqx_q3h_czb} ------------------------------------------------------------------------------------------ Les valeurs des paramètres de l'état du client peuvent être liées aux champs de configuration des composants de la même manière que le contexte de page, la charge utile et les ressources de données. Lors de la configuration des composants, survolez un champ, puis sélectionnez le bouton Liaison dynamique des données ( ![icône Liaison dynamique des données.]()) pour lier un paramètre d'état client à la valeur du champ. Dans l'exemple, le bouton Liaison dynamique des données est mis en surbrillance pour le champ de filtre du composant Liste d'occasions. Le caractère @ indique la liaison de données et l'objet d'état contient les paramètres d'état du client. Sélectionnez un paramètre d'état de client dans la liste de choix. L'exemple montre la sélection du paramètre d'état du client occasionTypeQuery . La valeur par défaut du paramètre d'état du client occasionTypeQuery est vide, par conséquent aucun filtre ne sera appliqué par défaut. Le titre du composant est défini de la même manière : sélectionnez le bouton Liaison dynamique des données pour le champ Titre ou tapez @, puis sélectionnez le paramètre d'état du client state.occasionListTitle dans la liste de choix. La valeur par défaut du paramètre d'état du client occasionListTitle est Toutes les occasions spéciales. L'exemple montre à la fois Titre et Filtre configurés pour utiliser les paramètres d'état du client. Lorsque les deux paramètres d'état du client sont appliqués, aucun filtre n'est appliqué à la liste et le titre est Toutes les occasions spéciales. Les valeurs des paramètres d'état client occasionTypeQuery et occasionListTitle restent inchangées jusqu'à ce qu'un utilisateur interagisse avec un composant qui modifie la valeur du paramètre d'état client. Changer les valeurs des paramètres de l'état du client {#client-state-parameters__section_cnh_wvj_dzb} ------------------------------------------------------------------------------------------------------ Utilisez le gestionnaire d'événements Mettre à jour le paramètre d'état du client pour modifier la valeur d'un paramètre d'état du client pendant l'exécution. Le gestionnaire d'événements Mettre à jour le paramètre d'état du client a deux propriétés : le paramètre d'état du client à mettre à jour et la nouvelle valeur à utiliser pour le paramètre d'état du client. Par exemple, un bouton Anniversaires est ajouté au-dessus du composant Liste d’occasions dans l'application Occasions spéciales . L'objectif de ce bouton est de changer le titre de la liste en Tous les anniversaires et d'ajuster le filtre de la liste pour n'afficher que les anniversaires. Pour atteindre cet objectif, deux gestionnaires d'événements sont mappés à l'événement Bouton cliqué pour le bouton, un pour modifier le paramètre d'état du client occasionTypeQuery et un autre pour modifier le paramètre d'état du client occasionListTitle . L'image montre le gestionnaire d'événements Mettre à jour l'état du client configuré pour définir le paramètre d'état du client occasionTypeQuery sur special_occasion=birthday, ce qui permet de filtrer la liste pour afficher uniquement les anniversaires. Lorsque l'événement Bouton cliqué est mappé à des gestionnaires d'événements pour mettre à jour les paramètres d'état du client occasionTypeQuery et occasionListTitle , un clic sur le bouton met à jour les paramètres d'état du client, ce qui met automatiquement à jour le composant de liste d’occasions avec les nouvelles valeurs. * **[Utilisation des paramètres d'état du client dans Générateur d'IU](https://servicenow-prod.fluidtopics.net/ICw~kKliEu3~Q6Rn8L~JjQ)** Créez un compteur simple en ajoutant le composant de texte stylisé et deux boutons à une page d'expérience. Utilisez un paramètre d'état du client pour implémenter la fonctionnalité de sorte que lorsque les boutons sont sélectionnés, le nombre augmente ou diminue. * **[Mettre à jour l'état d'un composant à l'aide des paramètres de l'état du client](https://servicenow-prod.fluidtopics.net/RE6TyklOINkugtRp~FJsng)** Créez et liez une valeur de paramètre d'état client à un composant dans Générateur d'IU. En ajoutant des valeurs personnalisées à vos composants, ces composants peuvent ensuite être automatiquement mis à jour via un script.