Scripts clients

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 la soumission du formulaire ou lorsqu’un champ change de valeur.

    Utilisez des scripts clients pour configurer des formulaires, des champs de formulaire et des valeurs de champ pendant que 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 dans un champ en fonction de la valeur dans d’autres champs
    • Modifier les options d’une liste de choix en fonction du rôle d’un utilisateur
    • afficher des messages en fonction d’une valeur dans un champ

    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 autres méthodes pour contrôler les valeurs de champ figurant sur une liste.
    • Créez un contrôle d’accès pour restreindre qui peut 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ésactivez l’édition de liste pour la table.
    Remarque :
    Les scripts clients ne sont pas pris en charge dans ServiceNow Mobile les applications.

    Formulaire 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. Typiquement, les scripts clients onLoad() effectuent des manipulations côté client du formulaire courant ou définissent les 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 les éléments du formulaire et s’assurent que la soumission a un sens. Un script client onSubmit() peut annuler la soumission du formulaire en renvoyant la valeur false.

    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 sur Mobile et dans Service Portal.
    • oldValue: la valeur que le widget avait lors du chargement de l’enregistrement.
      Remarque :
      Les anciennes valeurs ne sont pas renvoyées pour le type de champ HTML.
    • newValue: la valeur du widget 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 la valeur d’une 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: la table des éléments en cours de modification.
    • oldValues: les anciennes valeurs des cellules en cours de modification.
    • newValue: la nouvelle valeur des cellules en cours de modification.
    • callback: un rappel qui poursuit l’exécution de tous les autres scripts d’édition de cellule associés. Si la valeur true est transmise en tant que paramètre, les autres scripts sont exécutés ou le changement est validé s’il n’y a plus de scripts. Si faux est transmis en tant que paramètre, tous les autres scripts ne sont pas exécutés et le changement n’est pas 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 scripts onChange ou onCellEdit).
    Application Application dans laquelle réside ce script client.
    Actif 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 l’objectif 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, consultez Traduire un message de 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 false.