Scripts clients

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Les scripts clients permettent au système d’exécuter 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 l’envoi d’un formulaire ou lorsqu’un champ change de valeur.

    Utilisez les scripts clients pour configurer les formulaires, les champs de formulaire et les valeurs de champ lorsque l’utilisateur utilise le formulaire. Les scripts clients peuvent :

    • Rendre les champs masqués ou visibles
    • rendre les champs accessibles en lecture seule ou en écriture
    • Rendre les champs facultatifs ou obligatoires en fonction du rôle de l’utilisateur
    • Définir la valeur d’un champ en fonction de la valeur des autres champs
    • Modifier les options d’une liste de choix en fonction du rôle d’un utilisateur
    • Afficher les messages en fonction d’une valeur dans un champ
    Avertissement :

    Les scripts clients sont destinés à optimiser l’expérience utilisateur sur un formulaire. Les scripts clients ne sont pas conçus pour protéger les accès indésirables aux données.

    Pour empêcher tout accès indésirable aux données, assurez-vous que les champs sensibles sont masqués ou en lecture seule via les ACL ou les politiques de données.

    Pour plus d'informations, voir Access Control List Rules ou Data policy.

    Emplacement d’exécution des scripts clients

    À l’exception des scripts clients onCellEdit(), les scripts clients ne s’appliquent qu’aux formulaires et aux pages de recherche. Si vous créez un script client pour contrôler les valeurs de champ sur un formulaire, vous devez utiliser l’une de ces méthodes pour contrôler les valeurs de champ sur une liste.
    • Créez un contrôle d’accès pour limiter les utilisateurs autorisés à modifier les valeurs de champ.
    • Créez une règle métier pour valider le contenu.
    • Créez une politique de données pour valider le contenu.
    • Créez un script client onCellEdit() pour valider le contenu.
    • Désactiver la modification de liste pour la table.
    Remarque :
    Les scripts clients ne sont pas pris en charge dans les ServiceNow Mobile applications.

    Formulaire de script client

    Champ Description
    Nom Nom du script client.
    Table Table à laquelle le script client s’applique.
    Type d’interface utilisateur Interface utilisateur cible à laquelle le script client s’applique.
    Type

    onLoad() : s’exécute lorsque le système affiche le formulaire pour la première fois et avant que les utilisateurs puissent saisir des données. En règle générale, les scripts clients onLoad() effectuent une manipulation côté client du formulaire actif ou définissent des valeurs d’enregistrement par défaut.

    onSubmit() — s’exécute lorsqu’un formulaire est soumis. En règle générale, les scripts onSubmit() valident des éléments sur le formulaire et s’assurent que la soumission a un sens. Un script client onSubmit() peut annuler la soumission d’un formulaire en renvoyant la valeur faux.

    onChange() — s’exécute lorsqu’une valeur de champ particulière change sur le formulaire. Le script client onChange() doit spécifier ces paramètres.
    • control: le widget DHTML dont la valeur a changé.
      Remarque :
      control n’est pas accessible dans Mobile et Portail de services.
    • oldValue: valeur du widget lors du chargement de l’enregistrement.
      Remarque :
      Les anciennes valeurs ne sont pas renvoyées pour le type de champ HTML.
    • newValue: la valeur que le widget a après le changement.
    • isLoading: détermine si le changement se produit dans le cadre d’un chargement de formulaire.
    • isTemplate: identifie si le changement se produit dans le cadre du chargement d’un modèle.
    onCellEdit() — s’exécute lorsque l’éditeur de liste modifie une valeur de cellule. Le script client onCellEdit() doit spécifier ces paramètres.
    • sysIDs: tableau des sys_ids pour tous les éléments en cours de modification.
    • table: table des éléments en cours de modification.
    • oldValues: les anciennes valeurs des cellules en cours d’édition.
    • newValue: la nouvelle valeur des cellules en cours d’édition.
    • callback: rappel qui poursuit l’exécution de tout autre script de modification de cellule associé. Si la valeur est définie sur true, les autres scripts sont exécutés ou le changement est validé s’il n’y a plus de scripts. Si la valeur faux est transmise en paramètre, aucun autre script n’est exécuté et le changement n’est validé.
    Nom de champ Nom du champ auquel le script s’applique. Disponible uniquement si le script répond à un changement de valeur de champ (types de script onChange ou onCellEdit).
    Application Application dans laquelle réside ce script client.
    Actives Active le script client lorsqu’il est sélectionné. Désélectionnez ce champ pour désactiver le script client.
    Hérité Indique si le script client s’applique aux tables étendues.
    Global Si vrai, le script client s’exécute sur toutes les vues de la table.
    Vue Visible uniquement lorsque l’option Global est désélectionnée. Vues sur lesquelles le script client s’exécutera.
    Description Contenu décrivant la fonctionnalité et la finalité du script client.
    Messages Chaîne de texte (une par ligne) disponible pour le script client en tant que messages localisés utilisant getMessage(« [message] ») Pour plus d’informations, voir Traduire un message en script client.
    Script Contient le script client.
    Isoler le script Les nouveaux scripts clients sont exécutés en mode strict, avec l’accès DOM direct désactivé. L’accès à jQuery, prototype et l’objet de la fenêtre est également désactivé. Pour désactiver cette option pour chaque script, configurez ce formulaire et cochez la case Isoler le script . Pour désactiver cette fonctionnalité pour tous les nouveaux scripts côté client inclus dans le champ d’application global, définissez la propriété système glide.script.block.client.globals sur faux.