Charger des scripts
Le script doit d’abord être chargé en tant que ressource web de script pour l’utiliser sur un formulaire. 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. Lorsque vous utilisez TypeScript, il doit être transpilé 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.
Veillez à sélectionner le type Script(JScript).
Afin que les données de colonne de table puissent être incluses dans la logique d’un script, veillez à configurer le formulaire pour utiliser la colonne du formulaire. Outre la nécessité d’ajouter la colonne en tant que contrôle sur le formulaire, vous risquez que quelqu’un la supprime et provoque 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 :
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 dépend votre code.
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.
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.
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.
Au fur et à mesure que vous créez votre logique de script client et que vous devez apporter des modifications 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.