Scripts clients

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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 sa soumission ou lorsqu’un champ change de valeur.

    Utilisez les 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 d’un champ en fonction de la valeur des autres champs
    • Modifier les options d’une liste de choix basée sur le rôle d’un utilisateur
    • Afficher les 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 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 sur ServiceNow Mobile les 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 entrer 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 du sens. Un script client onSubmit() peut annuler la soumission du formulaire en retournant 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: la 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 du widget après le changement.
    • isLoading: détermine si le changement se produit dans le cadre du chargement d’un formulaire.
    • isTemplate: identifie si le changement se produit dans le cadre d’un chargement de 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: nouvelle valeur pour les cellules en cours de modification.
    • callback: rappel qui poursuit l’exécution de tous les autres scripts de modification de cellule associés. Si vrai est transmis comme paramètre, les autres scripts sont exécutés ou le changement est validé s’il n’y a plus de scripts. Si le paramètre false est transmis, 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 Uniquement visible lorsque Global est désélectionné. Vues sur lesquelles le script client sera exécuté.
    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, reportez-vous à la section 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 faux.