Créer une dépendance de widget

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • Dans Service Portal, vous pouvez lier des fichiers JavaScript et CSS aux 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 : admin ou sp_admin

    Pourquoi et quand exécuter cette tâche

    Les dépendances sont chargées de façon asynchrone à partir du serveur en cas de besoin.

    Les widgets peuvent avoir autant 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épendances.

      Un package de dépendances est une collection de fichiers JavaScript et CSS qui peuvent ensuite ê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 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 des dépendances.
        Inclure lors du chargement de page Sélectionnez cette option si vous souhaitez que votre dépendance soit chargée sur la page lors du chargement initial de la page de Service Portal, ou si vous ne cochez pas cette case 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. Indiquez le nom du module Angular en cours de chargement afin qu’il puisse être injecté dans l’application Service Portal Angular.
    2. Ajoutez des fichiers au package de dépendances.

      Une fois que vous avez enregistré les informations de votre package de dépendances, utilisez les listes connexes pour ajouter des fichiers Include JS et CSS. Pour chaque liste connexe, incluez les informations suivantes :

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

      Pour un include JS, 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. Ajoutez un package de dépendances à un widget.
      Une fois que vous avez 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. Cliquez sur Modifier dans la liste connexe Dépendances.
      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 sur la droite.
      4. Enregistrez la page pour revenir à l’enregistrement du widget.