Rufen Sie Analytics-Methoden in Formeln ab

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Um einen berechneten Wert aus der Analytics Hub in eine Formel einzufügen, verwenden Sie eine Methode in der Formel.

    Vorbereitungen

    Erforderliche Rolle: pa_power_user, admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können einen Wert verwenden, der in berechnet wurde Analytics Hub Als Eingabe für eine Formel. Dieser Wert kann von jedem Indikator stammen, einschließlich vom aktuellen Formelindikator.

    Um einen Wert aus der Analytics Hub abzurufen, fügen Sie eine Methode aus PAFormulaUtils() in die Formel ein. Um eine dieser Methoden aufzurufen, verwenden Sie die Performance Analytics-Variable pa. Um zum Beispiel die Methode PAFormulaUtils.getScore zu verwenden, rufen Sie pa.getScore auf. Weitere Informationen finden Sie unter PAFormulaUtils-API.

    Prozedur

    1. Öffnen Sie den Formelindikatordatensatz.
    2. Klicken Sie unter dem Formelfeld auf Nach einer Methode suchen.
      Es wird ein Dialogfeld geöffnet, in dem Sie eine Methode auswählen können.
    3. Suchen Sie nach der Methode, die Ihren Anforderungen entspricht.
      Methoden beziehen sich entweder auf die aktuelle Formel, die Sie bearbeiten, oder auf einen anderen Indikator, den Sie angeben müssen. Die Liste zeigt eine beschreibende Bezeichnung für jede Methode anstelle des Methodennamens.

      Liste der beschreibenden Bezeichnungen von Methoden im Dialogfeld „der Formel eine Methode hinzufügen“, wobei die globale Ziellücke des angegebenen Indikators abgerufen werden muss.
    4. Wählen Sie eine Methode aus.
      Wenn Sie eine Methode auswählen, wird eine Beschreibung geöffnet, einschließlich des Namens der Methode und aller Parameterfelder.

      Das Dialogfeld „Methode zu Formel hinzufügen“, das die Methode zum Abrufen der globalen Ziellücke des angegebenen ausgewählten Indikators und das Datum anzeigt, das als letzte gesammelte Punktzahl angegeben wurde
      Datumsfelder können folgende Werte annehmen:
      • Ein absolutes Datum im Format JJJJ-MM-TT, z. B. 2018-12-21.
      • Die Variablen score_start und score_end. Diese Variablen stellen die erste und letzte Sekunde des Sammlungszeitraums dar, der für den referenzierten Indikator berechnet wird. Die Zeit wird basierend auf der Differenz zwischen der Zeitzone des Benutzers und der Datenbankzeitzone (GMT) berechnet. Weitere Informationen finden Sie unter Änderungen an score_start/end aufgrund verschiedener Benutzerzeitzonen.
      • Ein Datumsparameter, den Sie selbst mit der GlideDate- oder GlideDateTime-API codiert haben.
    5. Geben Sie alle Parameter ein, und klicken Sie auf Wählen Sie Aus .
      Der Dialog wird geschlossen, und die Methode erscheint im Formelfeld des Indikatorformulars.
    6. Wenn Sie für die Methode einen Indikator angeben müssen, wählen Sie den Parameter Indikator mit dem Cursor, und klicken Sie auf Nach Indikator suchen.
      Das Dialogfeld für die Indikatorauswahl wird geöffnet.
      Öffnen des Dialogfelds für die Indikatorauswahl über eine Methode in der Formel
    7. Wählen Sie den Indikator aus.
    8. Wahlweise: Wählen Sie beliebige Aufgliederungen oder Elemente und eine Zeitreihenzusammenfassung aus.
    9. Wählen Sie In Methode verwenden, und klicken Sie auf Absenden.
      Die Methode ist mit einem ausgewählten Indikator abgeschlossen. Beachten Sie, dass vor dem Indikator ein Dollarzeichen ($) steht. Dieses Dollarzeichen bedeutet, dass die Analytics Hub-Werte für den Indikator anstelle der Indikatorbewertung zurückgegeben werden. Es werden die Analytics Hub-Werte anstelle der Bewertung ausgewählt, wenn Sie die Checkbox In Methode verwenden auswählen.
      Indikator, Aufgliederung, Element und Kontrollkästchen „in Methode verwenden“ sind ausgewählt

    Indexindikator

    Indexindikatoren sind ein Anwendungsfall von Formelindikatoren zum Generieren einer einzelnen Punktzahl, die mehrere Indikatoren darstellt. Im folgenden Beispiel möchten Sie einen einzelnen Index, der den Abstand zwischen Punktzahl und globalem Ziel für die folgenden Indikatoren zusammenfasst:
    • Der Prozentsatz der Incidents, die überfällig sind.
    • Das durchschnittliche Alter der letzten Aktualisierung offener Incidents.
    • Die Gesamtanzahl offener Incidents.
    Um diesen einzelnen Index abzurufen, erstellen Sie einen Formelindikator, dessen Richtung auf Maximieren gesetzt ist. Alle Indexindikatoren müssen maximieren. Dann verwenden Sie die Funktionen Nach einer Methode suchen und Nach einem Indikator suchen zum Erstellen der folgenden Formel:
    var a = pa.getGap($[[% of open overdue incidents]], score_start) / pa.getGlobalTarget($[[% of open overdue incidents]],score_start);
var b = pa.getGap($[[Average age of last update of open incidents]], score_start) / pa.getGlobalTarget($[[Average age of last update of open incidents]], score_start);
var c = pa.getGap($[[Number of open incidents]], score_start) / pa.getGlobalTarget($[[Number of open incidents]], score_start);
var res = 100 - (100 * (a + b + c) / 3);
res;

    Legen Sie Ziele für einen Change selbst fest

    Sie möchten im Incident-Backlog ein monatliches Ziel von 10 % Reduktion für Ihre Teams festlegen. Sie erstellen einen Formelindikator mit der folgenden Formel und legen für diesen Indikator ein Ziel von 10% fest Analytics Hub.

    var lastPeriod = new GlideDateTime(score_start.getYearUTC() + '-' + score_start.getMonthUTC() + '-01');
lastPeriod.addDaysUTC(-1);
pa.getChangePercentage($[[Number of open incidents]], lastPeriod.addDaysUTC(-1), score_start);

    Filtern Sie Punktzahlen basierend auf Aufgliederung und Element heraus

    Sie möchten die Bewertungen von Incidents herausfiltern, bei denen die Priorität = 1 - Kritisch ist.
    1. Rufen Sie den eindeutigen Datensatz-Identifier für die Aufgliederung nach Priorität und das Element 1 - Kritisch ab. Aufgliederungsdatenätze befinden sich in der Aufgliederungstabelle. Die Position der Elementdatensätze variiert, wird jedoch in der Aufgliederungsquelle der Aufgliederung angegeben. In diesem Fall ist das Element ein Wahl-Datensatz [sys_choice]. Anweisungen zum Abrufen der eindeutigen Datensatzbezeichner finden Sie unter Der eindeutige Datensatzbezeichner (sys_ID) .

      Die eindeutigen Datensatz-Identifier (sys_id) lauten für die Aufgliederung nach Priorität baec0752bf130100b96dac808c0739ed und für das Element 1 -Kritisch 8a4dde73c6112278017a6a4baf547aa7.

    2. Legen Sie einen Indikator mit folgender Formel an:
      var res = [[Number of open incidents]];
if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
{
res = 0;
}
res;