Configurer vos mesures d'investissement en tant que widgets

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Configurez les mesures d'investissement en fonction des besoins de votre entreprise. Ces mesures s'affichent sous forme de widgets sur la page Portail d'investissement.

    Avant de commencer

    Rôle requis : pps_admin

    Procédure

    1. Accédez à la Administration des projets > Widgets du portail d'investissement.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire :
      Tableau 1. Formulaire de widgets de carte du Portail
      Champ Description
      Nom Nom unique pour le widget que vous configurez.
      Ordre

      Ordre dans lequel vos widgets apparaissent à la fois sur votre Carte d'investissement et sur la page du Portail d'investissement. Les nombres plus bas apparaissent avant les nombres plus élevés.

      Par exemple, un widget avec un ordre défini sur 100 apparaît avant un widget avec un ordre défini sur 200.

      Type d'agrégat Type d'agrégation appliqué au calcul du widget d'investissement : Somme, Moyenne, Minimum, Maximum et Nombre.

      Imaginez par exemple que vous regroupiez le coût réel de trois projets A, B et C mis en évidence à l'aide d'un filtre. Les coûts réels sont de 1 000 pour le projet A, 2 000 pour le projet B et 3 000 pour le projet C.

      Si la somme est sélectionnée comme type d'agrégat, la valeur de la mesure de coût réel sera de 6 000. Si la moyenne est sélectionnée comme type d'agrégat, la valeur de la mesure de coût réel sera de 2 000. Si le minimum est sélectionné comme type d'agrégat, la valeur de la mesure de coût réel sera de 1 000. Si le maximum est sélectionné comme type d'agrégat, la valeur de la mesure de coût réel sera de 3 000. Si le nombre est sélectionné comme type d'agrégat, la valeur de la mesure de coût réel sera de 3.

      Scriptés Cochez la case pour spécifier un script pour le calcul du widget d'investissement.
      Afficher l'étiquette Cochez la case pour afficher l'étiquette ou l'indicateur de couleur.

      Si vous décochez la case, le champ Couleur s'affiche, vous permettant de définir la couleur.

      Actifs Cochez la case pour indiquer que le widget d'investissement est actif.
      Afficher sur la carte Cochez la case pour afficher le widget d'investissement sur votre carte d'investissement.
      Widget parent Widget parent de ce widget de mesure d'investissement. Un widget parent peut avoir jusqu'à trois widgets enfants.
      Inclure par défaut Cochez la case pour afficher un widget d'investissement actif par défaut sur :
      • les nouvelles cartes ;
      • les cartes existantes qui n'ont pas de sélection de widget configurée.
      La case est cochée par défaut.

      Pour en savoir plus sur la configuration des widgets sur une carte d'investissement, voir Configuration des widgets.

      Brève description Brève description du widget d'investissement.
      Script Script écrit pour le calcul dynamique du widget d'investissement. Ce champ n'est affiché que lorsque la case Scriptés est cochée.

      Le script suivant renvoie une chaîne contenant la sortie souhaitée à afficher sur le widget. Cinq variables (qui sont introduites par programmation dans le script) sont disponibles :

      • projectFilter : filtre de projet de la carte du Portail d'investissement.
      • demandFilter : filtre de demande de la carte du Portail d'investissement.
      • projectClass : classe de projet de la carte du Portail d'investissement qui est utilisée pendant l'évaluation de la valeur dans l'espace d'équipe. Elle renvoie tsp1_project pour la carte du Portail TeamSpace1.
      • demandClass : classe de demande de la carte du Portail d'investissement qui est utilisée pendant l'évaluation de la valeur dans l'espace d'équipe. Elle renvoie tsp1_demand pour la carte du Portail TeamSpace1.
      • boardSysId : SysId de la carte du Portail d'investissement. Il donne accès à plus d'informations sur la carte du Portail d'investissement si nécessaire.
      Exemple de widget scripté pour le coût du projet
      totalProjectCost();
      
      function totalProjectCost() 
      {
          var totalCost = 0;
          
          if(!JSUtil.nil(projectClass) && !JSUtil.nil(projectFilter))
      { 
              var projectGa = new GlideAggregate(projectClass);
              projectGa.addEncodedQuery(projectFilter);
              projectGa.setGroup(false);
              projectGa.addAggregate('SUM', 'cost');
      
              projectGa.query();
      
              if(projectGa.next()) 
      {
                  if(projectGa.getAggregate('SUM', 'cost'))
                  totalCost += parseFloat(projectGa.getAggregate('SUM', 'cost'));
              }
          }
          return PPMCurrencyHelper.defaultCurrencySymbol() + PPMCurrencyHelper.getFormattedAmount(totalCost);
      }
      Projet
      Colonne d'agrégat de projets L'agrégation est appliquée sur la colonne sélectionnée de la table Projet [pm_project].
      Table de projets Table à partir de laquelle les projets sont filtrés.
      Filtre de projet Critères appliqués pour filtrer les projets à partir de la table Projet.
      Demande
      Colonne d'agrégat de demandes L'agrégation est appliquée sur la colonne sélectionnée de la table Demande [dmn_demand].
      Table de demandes Table à partir de laquelle les demandes sont filtrées.
      Filtre de demande Critères appliqués pour filtrer les demandes à partir de la table Demand.
    4. Cliquez sur Envoyer.