Créer une dépendance de widget

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • Dans Portail de services, vous pouvez lier des fichiers JavaScript et CSS à des widgets pour créer des dépendances entre les widgets et les bibliothèques tierces, les feuilles de style externes et les modules angulaires.

    Avant de commencer

    Rôle requis : sp_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Les dépendances sont chargées de façon asynchrone à partir du serveur si nécessaire.

    Les widgets peuvent avoir autant ou aussi peu de dépendances que nécessaire. Cependant, plus vous en ajoutez, plus un widget doit télécharger de contenu pour s’afficher sur la page. Réduisez au maximum les dépendances pour des temps de chargement plus efficaces.

    Procédure

    1. Créez un package de dépendance.

      Un package de dépendance est une collection de fichiers JavaScript et CSS qui peuvent être connectés à un widget.

      1. Accédez à la Portail de services > Dépendances.
      2. Dans l’enregistrement de dépendance, définissez les champs suivants.
        Champ Description
        Nom Le nom de votre dépendance. (Utile pour sélectionner une dépendance dans une liste déroulante.)
        Application Périmètre de l’application pour l’enregistrement de dépendance.
        Inclure lors du chargement de page Sélectionnez si vous souhaitez que votre dépendance soit chargée sur la page lors du chargement initial de la page de Portail de services, ou laissez l’option décochée pour charger la dépendance uniquement lorsque le widget lié est chargé sur une page.
        Nom du module d’angle Facultatif. Définissez la valeur si le JavaScript lié est un module Angular. Fournissez le nom du module Angular en cours de chargement, afin qu’il puisse être injecté dans l’application Angular du Service Portal.
    2. Ajouter des fichiers au package de dépendance.

      Après avoir enregistré les informations de votre package de dépendance, utilisez les listes connexes pour ajouter des fichiers d’inclusion JS et CSS. Pour chaque liste connexe, incluez les informations suivantes :

      Champ Description
      Nom d’affichage Nom de l’include de script.
      Source Selon que vous ajoutez un JS Include ou un CSS Include, sélectionnez l’une des options suivantes dans la liste :
      • URL
      • Script d’interface utilisateur (pour un JS Include) ou feuille de style (pour un CSS Include)

      Pour un JS Include, utilisez le champ Script d’interface utilisateur pour référencer un script d’interface utilisateur trouvé dans Interface utilisateur du système > Scripts d'interface utilisateur.

      Pour l’include CSS, utilisez le champ Feuille de style pour référencer un enregistrement dans la table sp_css .
    3. Ajouter un package de dépendance à un widget.
      Après avoir créé un package de dépendance et ajouté des fichiers, créez une relation entre la dépendance et un widget.
      1. Accédez à la Portail de services > Widgets et recherchez l’enregistrement de widget auquel vous souhaitez ajouter la dépendance.
      2. Dans la liste connexe Dépendances, cliquez sur Modifier.
      3. Dans la zone de liste double, recherchez la dépendance que vous avez créée et double-cliquez pour l’ajouter à la colonne des éléments sélectionnés à droite.
      4. Enregistrez la page pour revenir à l’enregistrement du widget.