Investitionsmetriken als Widgets konfigurieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Konfigurieren Sie Investitionsmetriken entsprechend Ihren Geschäftsanforderungen. Diese Metriken werden auf der Seite „Investitionsportal“ als Widgets angezeigt.

    Vorbereitungen

    Erforderliche Rolle: pps_admin

    Prozedur

    1. Navigieren zu Projektadministration > Investmentportal-Widgets.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus:
      Tabelle : 1. Formular „Portaltafel-Widget“
      Feld Beschreibung
      Name Eindeutiger Name für das Widget, das Sie konfigurieren.
      Reihenfolge

      Reihenfolge, in der die Widgets in der Investitionstafel und auf der Seite „Investitionsportal“ angezeigt werden. Niedrigere Zahlen werden vor höheren Zahlen platziert.

      Beispielsweise wird ein Widget mit dem Reihenfolgewert 100 vor einem Widget mit dem Reihenfolgewert 200 angezeigt.

      Zusammenfassungstyp Typ der Zusammenfassung, die zur Berechnung des Investitions-Widget angewendet wird: Summe, Durchschnitt, Minimum, Maximum und Anzahl.

      Beispiel: Sie fassen die tatsächlichen Kosten der drei Projekte A, B und C zusammen, die durch einen Filter angezeigt werden. Die tatsächlichen Kosten betragen 1000 für Projekt A, 2000 für Projekt B und 3000 für Projekt C.

      Wenn „Summe“ als Zusammenfassungstyp ausgewählt wird, wäre der Wert für die Metrik für tatsächliche Kosten 6000. Wenn „Durchschnitt“ als Zusammenfassungstyp ausgewählt wird, wäre der Wert für die Metrik für tatsächliche Kosten 2000. Wenn „Minimum“ als Zusammenfassungstyp ausgewählt wird, wäre der Wert für die Metrik für tatsächliche Kosten 1000. Wenn „Maximum“ als Zusammenfassungstyp ausgewählt wird, wäre der Wert für die Metrik für tatsächliche Kosten 3000. Wenn „Anzahl“ als Zusammenfassungstyp ausgewählt wird, wäre der Wert für die Metrik für tatsächliche Kosten 3.

      Geskriptet Kontrollkästchen zum Angeben eines Skripts für die Berechnung des Investitions-Widget.
      Bezeichnung anzeigen Kontrollkästchen zum Anzeigen der Beschriftung oder des Farbindikators.

      Wenn Sie das Kontrollkästchen deaktivieren, wird das Feld Farbe angezeigt, über das Sie die Farbe festlegen können.

      Aktiv Aktivieren Sie das Kontrollkästchen, um anzugeben, dass das Investitions-Widget aktiv ist.
      Auf Tafel anzeigen Kontrollkästchen zum Anzeigen des Investitions-Widget in Ihrer Investitionstafel.
      Übergeordnetes Widget Übergeordnetes Widget für dieses Investitionsmetrik-Widget. Ein übergeordnetes Widget kann bis zu drei untergeordnete Widgets haben.
      Standardmäßig einbeziehen Kontrollkästchen, mit dem festgelegt wird, das ein aktives Investitions-Widget standardmäßig angezeigt wird in:
      • neuen Tafeln
      • vorhandenen Tafeln, für die keine Widget-Auswahl konfiguriert ist
      Das Kontrollkästchen ist standardmäßig aktiviert.

      Weitere Informationen zum Konfigurieren von Widgets in einer Investitionstafel finden Sie unter Widget-Konfiguration.

      Kurzbeschreibung Kurze Beschreibung des Investitions-Widget.
      Skript Skript, das für die dynamische Berechnung des Investitions-Widget geschrieben wurde. Dieses Feld wird nur angezeigt, wenn das Kontrollkästchen Geskriptet aktiviert ist.

      Das folgende Skript gibt eine Zeichenfolge zurück, die die gewünschte Ausgabe enthält, die im Widget angezeigt werden soll. Fünf Variablen (die programmgesteuert in das Skript eingeführt werden) sind verfügbar:

      • projectFilter: Projektfilter der Tafel „Investitionsportal“.
      • demandFilter: Bedarfsfilter der Tafel „Investitionsportal“.
      • projectClass: Projektklasse der Tafel „Investitionsportal“, die bei der Auswertung des Teamspaces-Werts verwendet wird. Für die Portaltafel „Teamspace1“ gibt sie tsp1_project zurück.
      • demandClass: Bedarfsklasse der Tafel „Investitionsportal“, die bei der Auswertung des Teamspaces-Wert verwendet wird. Für die Portaltafel „Teamspace1“ gibt sie tsp1_demand zurück.
      • boardSysId: SysId der Tafel „Investitionsportal“. Bietet bei Bedarf Zugriff auf weitere Informationen in der Tafel „Investitionsportal“.
      Beispiel für ein geskriptetes Widget für Projektkosten
      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);
      }
      Tabelle : 2. Projektabschnitt des Formulars „Portaltafel-Widget“.
      Feld Beschreibung
      Projektaggregatspalte Die Zusammenfassung wird auf die ausgewählte Spalte der Projekttabelle [pm_project] angewendet.
      Projekttabelle Tabelle, aus der Projekte gefiltert werden.
      Projektfilter Kriterien, die zum Filtern von Projekten aus der Projekttabelle angewendet werden.
      Tabelle : 3. Abschnitt „Bedarf“ des Formulars „Portaltafel-Widget“.
      Feld Beschreibung
      Nachfrage-Aggregatspalte Die Zusammenfassung wird auf die ausgewählte Spalte der Bedarfstabelle [pm_project] angewendet.
      Bedarfstabelle Tabelle, aus der Bedarfe gefiltert werden.
      Bedarfsfilter Kriterien, die zum Filtern von Bedarfen aus der Bedarfstabelle angewendet werden.
    4. Klicken Sie auf Absenden.