Scripts d'interface utilisateur
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
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
Créez un script d’interface utilisateur pour définir le code JavaScript réutilisable côté client.
Procédure
| 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. |
Exécuter les scripts d’interface utilisateur
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. Dans la macro d’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
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
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.