Charger des scripts

  • 4 minutes

Pour utiliser un script client sur un formulaire, il doit d’abord être chargé en tant que ressource web de script. Les ressources web de script vous permettent de gérer des bibliothèques de fonctions de script client écrites en JavaScript ou TypeScript et vous pouvez les utiliser à partir d’un formulaire d’application pilotée par modèle ou de la définition de la barre de commandes. Si vous utilisez TypeScript, vous devez le transpiler en JavaScript avant de le charger en tant que ressource web.

Pour charger une ressource web de script, créez une bibliothèque de formulaires à partir de l’éditeur de formulaires.

Capture d’écran de la boîte de dialogue Ajouter une bibliothèque.

La fenêtre contextuelle Ajouter une bibliothèque JavaScript s’affiche alors. Cliquez sur + Nouvelle ressource web en haut à droite. Dans le volet Nouvelle ressource web, veillez à sélectionner JavaScript (JS) comme type.

Capture d’écran illustrant la boîte de dialogue d’ajout d’une ressource web avec le type JavaScript (JS) sélectionné.

Afin que les données d’une colonne de table puissent être incluses dans la logique d’un script, veillez à configurer le formulaire pour afficher la colonne. Notez que si quelqu’un supprime ultérieurement la colonne du formulaire, cela entraînera la rupture de votre script, car la colonne référencée n’est plus disponible. Vous pouvez ajouter la colonne en tant que dépendance pour vous assurer que les données de colonne sont toujours à la disposition de votre logique de script. L’image suivante illustre l’ajout de la colonne Score d’idée de la table Idée en tant que dépendance :

Capture d’écran de l’ajout de la colonne de numéro de compte de la table Compte en tant que dépendance.

Dépendances de ressource web

Outre des dépendances de données, vous pouvez également configurer des dépendances à d’autres ressources web. Cette dépendance vous permet de gagner du temps et de simplifier la logique de chargement, car le formulaire n’a pas besoin de charger explicitement plusieurs ressources web dépendantes lorsque vous enregistrez un script pour un événement de formulaire, une commande du ruban ou des règles d’activation du ruban. Grâce à la configuration des dépendances, vous pouvez enregistrer le script principal et laisser la configuration des dépendances charger les autres ressources dont votre code a besoin.

Notez que les dépendances de ressource web ne fournissent aucun contrôle sur l’ordre de chargement des ressources web. Toutes les ressources web sont chargées de manière asynchrone et en parallèle. Si vous disposez d’une ressource web JavaScript dépendant d’une autre ressource web JavaScript à charger et initialiser avant de pouvoir être initialisée, vous devez gérer cette dépendance d’une autre manière.

Utiliser des bibliothèques de scripts client

Une fois configurées en tant que ressource web de script, les bibliothèques de scripts client peuvent être associées aux commandes du ruban et aux événements de formulaire. Pour associer un script à un formulaire, cliquez sur Bibliothèques de formulaires dans la barre d’outils, puis sur Ajouter une bibliothèque.

Capture d’écran du bouton Ajouter une bibliothèque de la boîte de dialogue Bibliothèques de formulaires.

Dans la boîte de dialogue Ajouter une bibliothèque, vous pouvez associer une ressource web de script chargée existante ou en créer une.

Capture d’écran de la boîte de dialogue Ajouter une bibliothèque montrant que vous pouvez associer une ressource web de script chargée existante ou en créer une.

L’association de la bibliothèque de scripts au formulaire ne doit être effectuée qu’une seule fois par script pour chaque formulaire, quel que soit le nombre de gestionnaires d’événements que vous enregistrez sur ce formulaire.

Si vous devez apporter des modifications lorsque vous créez votre logique de script client après le chargement initial, revenez à la ressource web de script dans la solution et chargez la nouvelle version du fichier. Après le chargement, vous devez publier la ressource web de script, afin que l’application utilise les dernières modifications.