---
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


---

API de script client : ServiceNow Fluent
========================================

API de script client : ServiceNow Fluent {#ariaid-title1}
=========================================================

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API Script client inclut des objets qui définissent les scripts clients \[sys_script_client\] qui exécutent JavaScript sur le client (navigateur Web) lorsque des événements liés au client se produisent, par exemple lors du chargement d'un formulaire, après la soumission du formulaire ou lorsqu'un champ change de valeur.

Objet ClientScript {#ariaid-title2}
-----------------------------------

Créez un script client \[sys_script_client\] pour configurer des formulaires, des champs de formulaire et des valeurs de champ lorsque l'utilisateur utilise le formulaire.
{#client-script-object-now-ts__table_vy2_525_jq__entry__3}

|       Nom        |       Type       |                                                                                                                                                                          Description                                                                                                                                                                           |
|------------------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| $id              | Chaîne ou numéro | Requis. ID unique pour l'objet de métadonnées fourni au format suivant, où `< valeur >` est une chaîne ou un numéro. $id: Now.ID[<value>] Lorsque vous créez l'application, cet ID est haché en une sys_ID unique.                                                                                                                                             |
| table            | Chaîne           | Requis. Nom de la table sur laquelle le script client s'exécute.                                                                                                                                                                                                                                                                                               |
| nom              | Chaîne           | Requis. Nom du script client.                                                                                                                                                                                                                                                                                                                                  |
| actif            | Booléen          | Marqueur indiquant si le script client est activé. Valeurs valides : * true : le script est activé. * false : le script n'est pas activé. {#client-script-object-now-ts__ul_cxj_srr_4bc} Par défaut : true                                                                                                                                                     |
| applies_extended | Booléen          | Marqueur indiquant si le script client s'applique aux tables étendues à partir de la table spécifiée. Valeurs valides : * true : le script s'applique aux tables étendues. * false : le script ne s'applique pas aux tables étendues. {#client-script-object-now-ts__ul_q5n_ltz_pbc} Valeur par défaut : false                                                 |
| ui_type          | Chaîne           | Interface utilisateur à laquelle le script client s'applique. Valeurs valides : bureau, mobile_or_service_portal, tous Par défaut : ordinateur de bureau                                                                                                                                                                                                       |
| description      | Chaîne           | Description de la fonctionnalité et de l'objectif du script client.                                                                                                                                                                                                                                                                                            |
| messages         | Chaîne           | Chaînes de texte disponibles pour le script client en tant que messages localisés utilisant getMessage(\<\< \[message\] \>\>) Pour plus d'informations, voir [Traduire un message de script client](https://www.servicenow.com/docs/access?context=t_TranslateAClientScriptMessage&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). |
| isolate_script   | Booléen          | Marqueur indiquant si les scripts s'exécutent en mode strict, avec l'accès au DOM direct, jQuery, prototype et l'objet de fenêtre désactivé. Valeurs valides : * true : isole le script et ne l'exécute pas en mode strict. * false : exécuter le script en mode strict. {#client-script-object-now-ts__ul_s1q_c5z_pbc} Valeur par défaut : false              |
| script           | Script           | Script en ligne précédé d'une balise `de script` au format suivant : script: script`gs.info('info')`, Remarque : L'importation de fonctions à partir de modules JavaScript ou de bibliothèques tierces n'est pas prise en charge dans les scripts clients.                                                                                                     |
| global           | Booléen          | Marqueur indiquant les vues de la table sur lesquelles le script client s'exécute. Valeurs valides : * true : le script s'exécute sur toutes les vues. * false : le script ne s'exécute que sur les vues spécifiées. {#client-script-object-now-ts__ul_mvv_l5h_qbc} Par défaut : true                                                                          |
| vue              | Chaîne           | Les vues de la table sur laquelle le script client s'exécute. Cette propriété s'applique uniquement lorsque la propriété globale est définie sur faux.                                                                                                                                                                                                         |
| type             | Chaîne           | Type de script client, qui définit le moment de son exécution. Pour en savoir plus sur les types pris en charge, reportez-vous à la section [Client scripts](https://www.servicenow.com/docs/access?context=client-scripts&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). Valeurs valides : onCellEdit, onChange, onLoad, onSubmit          |
| champ            | Chaîne           | Champ de la table auquel le script client s'applique. Cette propriété s'applique uniquement lorsque la propriété type est définie sur onChange ou onCellEdit.                                                                                                                                                                                                  |
[Tableau 1. Propriétés]

{#client-script-object-now-ts__table_vy2_525_jq}  

    import { ClientScript } from '@servicenow/sdk/core'

    export const cs = ClientScript({
       $id: Now.ID['my_scripts'], 
       name: 'my_scripts',
       table: 'incident',
       active: true, 
       applies_extended: false, 
       global: true,
       ui_type: 'all', 
       messages: '', 
       isolate_script: false, 
       type: 'onLoad',
       script: script`function onLoad() { const x = 'util' g_form.addInfoMessage(x) }`,
    })