---
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 d'interface utilisateur
===============================

Scripts d'interface utilisateur {#ariaid-title1}
================================================

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

Les scripts d'interface utilisateur fournissent un moyen de regrouper JavaScript côté client dans un formulaire réutilisable, similaire à la façon dont les includes de script stockent JavaScript côté serveur. Les administrateurs peuvent créer des scripts d'interface utilisateur et les exécuter à partir de scripts clients et d'autres objets de script côté client et du code HTML.

Les scripts d'interface utilisateur ne sont pas pris en charge pour mobile.

Scripts d'interface utilisateur globaux {#ariaid-title2}
--------------------------------------------------------

Vous pouvez créer un script d'interface utilisateur et le désigner comme global, ce qui rend le script disponible sur n'importe quel formulaire du système. Vous ne pouvez pas créer un script d'interface utilisateur global dans une application incluse dans le périmètre.

Vous pouvez marquer un script d'interface utilisateur comme global pour le rendre disponible sur n'importe quel formulaire du système. Par exemple, vous pouvez créer un script d'interface utilisateur qui a une fonction helloWorld() et dont le champ Global est coché :  

    function helloWorld() {
      alert('Hi');
    }

Après avoir créé ce script d'interface utilisateur global, vous pouvez appeler la fonction helloWorld() à partir de n'importe quel script client ou politique d'interface utilisateur que vous écrivez.

Créer un script d'interface utilisateur {#ariaid-title3}
--------------------------------------------------------

Créez un script d'interface utilisateur pour définir le code JavaScript réutilisable côté client.

### Procédure

Pour créer des scripts d'interface utilisateur, accédez à Interface utilisateur du systèmeScripts d'interface utilisateur et créer ou modifier un enregistrement (voir la table des descriptions de champ).  
{#t_CreateAUIScript__table_zsc_z4z_sr__entry__2}

|     Champ     |                                                                                                                                                               Description                                                                                                                                                                |
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Nom du script | Nom du script d'interface utilisateur. Assurez-vous que le nom est unique sur votre système.                                                                                                                                                                                                                                             |
| Nom de l'API  | Le nom de l'API du script d'interface utilisateur, y compris le périmètre et le nom du script (par exemple, x_custom_app. Bonjour le monde).                                                                                                                                                                                             |
| Demande       | Application qui contient le script d'interface utilisateur.                                                                                                                                                                                                                                                                              |
| Actif         | Indicateur indiquant si le script d'interface utilisateur est actif. Seuls les scripts d'interface utilisateur actifs peuvent s'exécuter.                                                                                                                                                                                                |
| Global        | Indicateur indiquant si le script se charge sur chaque page du système. Remarque : Soyez prudent lors de la création de scripts d'interface utilisateur globaux, car ils peuvent avoir un impact sur les performances. Vous ne pouvez pas créer un script d'interface utilisateur global dans une application incluse dans le périmètre. |
| Description   | Résumé de l'objectif du script.                                                                                                                                                                                                                                                                                                          |
| Script        | Script côté client à exécuter lorsqu'il est appelé à partir d'autres scripts.                                                                                                                                                                                                                                                            |
[Tableau 1. Scripts d'interface utilisateur]

{#t_CreateAUIScript__table_zsc_z4z_sr}

Exécuter les scripts d'interface utilisateur {#ariaid-title4}
-------------------------------------------------------------

Suivez ces instructions lors de l'exécution de scripts d'interface utilisateur.

### Exécuter un script d'interface utilisateur à partir d'un formulaire

Pour exécuter un script d'interface utilisateur sur un formulaire, [créez un formateur et ajoutez-le à un formulaire](https://www.servicenow.com/docs/access?context=t_CreateAFormatter&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Dans la [macro d'interface utilisateur](https://servicenow-prod.fluidtopics.net/xsv8Zny8hnVR6uufn5Dg6A#c_UIMacros "Les macros d'interface utilisateur sont des composants scriptés discrets que les administrateurs peuvent ajouter à l'interface utilisateur.") associée, incluez une balise `g :requires` et spécifiez le name= paramètre comme nom du script d'interface utilisateur suivi de l'extension .jsdbx. Ajoutez le formateur dans la vue de formulaire.

Ce code garantit que les définitions et les résultats du script d'interface utilisateur sont immédiatement disponibles dans le navigateur.  

    <?xml version="1.0" encoding="utf-8" ?>  
    <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">  
        <g2:evaluate var="jvar_stamp">  
            var now_GR = new GlideRecord('sys_ui_script');  
            gr.orderByDesc('sys_updated_on');  
            gr.query();  
            gr.next();  
            gr.getValue('sys_updated_on');  
        </g2:evaluate>  
        <g:requires name="<UI SCRIPT NAME>.jsdbx" params="cache=$[jvar_stamp]" />  
    </j:jelly>

### Appeler un script d'interface utilisateur en HTML {#r_RunUIScripts__section_o5w_npl_d2b}

Pour exécuter un script d'interface utilisateur à partir du code HTML, utilisez la `<![CDATA[<script>balise ]]>` et spécifiez l'argument `src=` comme nom d'API du script d'interface utilisateur suivi de l'extension .jsdbx. Par exemple, incluez le script d'interface utilisateur nommé CoolClock avec ce code :  

    <script language="javascript" src="CoolClock.jsdbx" />

### Appeler un script d'interface utilisateur à partir du code côté client {#r_RunUIScripts__section_bs1_rpl_d2b}

Accédez aux scripts de l'interface utilisateur depuis le code côté client à l'aide de l'objet global g_ui_scripts . Pour plus d'informations, consultez [GlideUIScripts -Client](https://www.servicenow.com/docs/access?context=GUIScriptsAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US).  
Remarque :  
Cette classe ne prend pas en charge les scripts d'interface utilisateur dont le champ Global est défini sur vrai.

