--- 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 --- Scripts clients du catalogue ============================ Scripts clients du catalogue {#ariaid-title1} ============================================= * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](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 aux éléments de catalogue de services ou aux jeux de variables, ce qui permet aux administrateurs d'utiliser les mêmes fonctionnalités que celles disponibles sur 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 la soumission du formulaire. * Ajoutez quelque chose au panier. * Commandez quelque chose immédiatement. {#c_CatalogClientScriptCreation__ul_fs2_2c1_dq} Considérations relatives au script client du catalogue {#ariaid-title2} ----------------------------------------------------------------------- Lorsque vous créez des scripts clients de catalogue, gardez à l'esprit les considérations suivantes. * Les scripts clients du 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 lorsqu'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 noms n'apparaissent pas dans la liste des variables disponibles. * Lorsque vous utilisez des scripts clients standard sur un formulaire Élément demandé ou 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 les deux présents sur un formulaire, le champ de table est mis en correspondance lorsque vous y accédez à l'aide d'un script. Si cela se produit, traitez spécifiquement la variable en la nommant `variable.variable name`. Par exemple : `g_form.setValue('variables.replacement', 'false') ;` * Si vous utilisez des créateurs d'enregistrements pour transmettre des variables du catalogue de services à d'autres types d'enregistrements, ces variables sont rendues visibles dans ces enregistrements avec un éditeur de variables, tel que le formateur d'interface utilisateur É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, avec quelques différences importantes. * Au lieu de sélectionner une table telle qu'Incident pour le script, sélectionnez un élément de catalogue ou un jeu de variables. Étant donné que votre système peut contenir 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 de catalogue onChange(), 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 toutes 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 | S'il faut appliquer cette option à 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, tel que 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 sur 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 que l'élément a été demandé. Disponible dans la vue du prestataire. Voir [Éditeur](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-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 [Éditeur](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-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. Voir [Éditeur de variable par défaut](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) . | [ ] {#create-catalog-client-script__table_bw1_3g1_dq} 4. Cliquez sur Envoyer. Exemples de scripts clients de catalogues {#ariaid-title5} ---------------------------------------------------------- Exemples de scripts clients pour effectuer des actions courantes. ### Obtenir la valeur d'une variable Utilisez la syntaxe suivante pour obtenir la valeur d'une variable de catalogue. 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, et non lorsque l'élément est commandé. function onLoad(){ var sd = g_form.getControl('short_description'); sd.maxLength=80; }