---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Scripts clients du catalogue

# Scripts clients du catalogue {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

Les scripts côté client peuvent ajouter des effets dynamiques et une validation aux formulaires. Les scripts peuvent s'appliquer à des éléments de catalogue de services ou à des jeux de variables, ce qui permet aux administrateurs d'utiliser les mêmes fonctionnalités que celles disponibles dans d'autres formulaires.

Vous pouvez utiliser des scripts côté client pour :

* Obtenir ou définir des valeurs de variables.
* Masquer ou afficher les variables.
* Rendre les variables obligatoires ou non.
* Validez l'envoi du formulaire.
* Ajouter quelque chose au panier.
* Commandez quelque chose immédiatement.
{#c_CatalogClientScriptCreation__ul_fs2_2c1_dq}

## Considérations relatives aux scripts clients de catalogue {#ariaid-title2}

Lorsque vous créez des scripts clients de catalogue, tenez compte des considérations suivantes.
* Les scripts clients de catalogue s'exécutent lorsqu'un utilisateur commande un élément à partir du catalogue de services. Les scripts clients de catalogue peuvent également s'exécuter lorsque des variables ou des jeux de variables d'un élément de catalogue sont affichés lorsqu'un utilisateur demande cet élément.
* Pour qu'une variable soit accessible à l'aide d'un script client de catalogue, elle doit avoir un nom de variable. Les variables sans nom n'apparaissent pas dans la liste des variables disponibles.
* Lorsque vous utilisez des scripts clients standard sur un élément demandé ou un formulaire de tâche du catalogue, notez les champs portant le même nom que les variables. Si un champ de table et une variable du même nom sont tous deux présents dans un formulaire, le champ de table est mis en correspondance lorsque l'accès y a été effectué à l'aide d'un script. Si cela se produit, adressez spécifiquement la variable en la nommant `variables.nom de variable.` Par exemple : `g_form.setValue('variables.replacement', 'false') ;`
* Si vous utilisez des créateurs d'enregistrement pour transmettre des variables du catalogue de services à d'autres types d'enregistrements, ces variables sont rendues visibles dans ces enregistrements à l'aide d'un éditeur de variables, tel que le formateur d'interface utilisateur de l'éditeur de variable de changement sur les formulaires de demande de changement. Vous pouvez manipuler ces variables à l'aide de méthodes de script client standard, telles que `setDisplay`, `setMandatory`, `setValue` et `getValue`.
* Les scripts clients de catalogue peuvent être utilisés pour les éléments de catalogue inclus dans un assistant.
* Vous pouvez utiliser l'API `g_form.refreshSlushbucket(fieldName)` pour mettre à jour une variable de collecteur de liste.

## Différences de scripts clients du catalogue {#ariaid-title3}

Les scripts clients de catalogue sont très similaires aux scripts clients standard, à quelques différences près.
* Au lieu de sélectionner une table telle que Incident pour le script, sélectionnez un élément de catalogue ou un jeu de variables. Votre système pouvant comporter un grand nombre d'éléments de catalogue, vous devez sélectionner un élément de catalogue ou un jeu de variables à l'aide d'un champ de référence au lieu de la liste de choix utilisée par le formulaire de script client standard.
* Lors de l'utilisation d'un script client <var class="keyword varname">de catalogue onChange(),</var> il est lié à une variable particulière au lieu d'un champ. Le système remplit automatiquement la liste de sélection des noms de variables avec les variables nommées de l'élément de catalogue ou du jeu de variables sélectionné.
{#r_CatalogClientScriptDifferences__ul_dvh_llb_jbb}

## Créer un script client de catalogue {#ariaid-title4}

Suivez cette procédure pour créer un script client de catalogue.

### Procédure

1. Accédez à la ToutCatalogue de servicesAdministration des cataloguesScripts clients du catalogue.  
   Une liste des scripts clients actuels du catalogue personnalisé s'affiche.
2. Cliquez sur Nouveau.
3. Renseignez les champs comme il convient (voir la table).  
   {#create-catalog-client-script__table_bw1_3g1_dq__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Entrez un nom unique pour le script client du catalogue. |
   | Concerne | Sélectionnez le type d'élément auquel ce script client s'applique : * Un élément de catalogue : active le champ Élément de catalogue. * Un jeu de variables : active le champ Jeu de variables. {#create-catalog-client-script__ul_nx1_3g1_dq} |
   | Actif | Cochez cette case pour activer le script client. Décochez la case pour désactiver le script. |
   | Type d'interface utilisateur | Indique s'il faut l'appliquer à un ordinateur de bureau, un appareil mobile ou les deux. |
   | Script | Entrez le script client qui doit s'exécuter sur l'élément de catalogue de services. |
   | Type | Sélectionnez le moment où le script doit s'exécuter, par exemple onLoad ou onSubmit. |
   | Élément de catalogue ou jeu de variables | Sélectionnez un élément de catalogue ou un jeu de variables dans la liste. Le nom du champ et les options disponibles dépendent de la sélection dans le champ S'applique à. |
   | S'applique sur une vue d'élément de catalogue | Cochez la case pour appliquer le script client du catalogue aux éléments de catalogue affichés dans l'écran de commande du catalogue de services. Disponible dans la vue du demandeur. |
   | S'applique sur des éléments demandés | Cochez la case pour appliquer le script client du catalogue sur un formulaire d'élément demandé, une fois l'élément demandé. Disponible dans la vue du prestataire. Voir [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) . |
   | S'applique sur des tâches du catalogue | Cochez la case pour appliquer le script client du catalogue lorsqu'un formulaire de tâche du catalogue est affiché pour l'élément. Disponible dans la vue du prestataire. Voir [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) . |
   | S'applique sur l'enregistrement cible | Case à cocher pour prendre en charge la politique d'interface utilisateur du catalogue sur un enregistrement créé pour les tables de tâche étendues via des créateurs d'enregistrement. [Reportez-vous à la section Éditeur de variables par défaut](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) . |
   [ ]

   {#create-catalog-client-script__table_bw1_3g1_dq}
4. Cliquez sur Envoyer.

## Exemples de scripts clients de catalogue {#ariaid-title5}

Exemples de scripts clients pour effectuer des actions courantes.  

### Obtenir la valeur d'une variable

Pour obtenir la valeur d'une variable de catalogue, utilisez la syntaxe suivante. Notez que la variable doit avoir un nom. Remplacez `variable_name` par le nom de la variable.

    g_form.getValue('variable_name');

### Limiter le nombre de caractères qu'un utilisateur peut saisir dans une variable

Il s'agit d'un exemple de script qui s'exécute lorsque la variable est affichée, plutôt que lorsque l'élément est commandé.

    function onLoad(){
      var sd = g_form.getControl('short_description');
      sd.maxLength=80;
    }