Rufen Sie Analytics-Methoden in Formeln ab

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Dient zum Einfügen eines berechneten Werts aus Analytics HubVerwenden Sie in einer Formel 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 HubAls Eingabe für eine Formel. Dieser Wert kann von jedem Indikator stammen, einschließlich des aktuellen Formelindikators selbst.

    Um einen Wert von abzurufen Analytics Hub, Fügen Sie eine Methode aus ein PAFormulaUtils() In die Formel. Um eine dieser Methoden aufzurufen, verwenden Sie Performance AnalyticsVariable PA . Beispiel: Zur Verwendung von PAFormulaUtils.getScore Methode, Aufruf pa.getScore . Weitere Informationen finden Sie unter PAFormulaUtils-API.

    Prozedur

    1. Öffnen Sie den Formelindikator-Datensatz.
    2. Klicken Sie unter dem Feld „Formel“ auf Suchen Sie nach einer Methode .
      Ein Dialogfeld wird 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 wird.
    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 zum Formeldialog 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 die folgenden Werte annehmen:
      • Ein absolutes Datum im Format JJJJ-MM-TT, z. B. 2018-12-21.
      • Die Variable Score_Start Oder Punktzahl_Ende . Diese Variablen stellen die erste und letzte Sekunde des Sammlungszeitraums dar, der für den referenzierten Indikator berechnet wird. Die Zeiten werden aus der Differenz zwischen der Zeitzone des Anwenders und der Zeitzone des Datenbankservers berechnet, die GMT ist. Weitere Informationen finden Sie unter Ändert sich aufgrund verschiedener Anwenderzeitzonen an Score_Start/End.
      • Ein Datumsparameter, den Sie selbst mit codiert haben GlideDate Oder GlideDateTime API.
    5. Geben Sie alle Parameter ein, und klicken Sie auf Wählen Sie Aus .
      Das Dialogfeld wird geschlossen, und die Methode wird im Formelfeld des Indikatorformulars angezeigt.
    6. Wenn Sie für die Methode einen Indikator angeben müssen, wählen Sie aus Indikator Parameter mit Cursor und Klick Suchen Sie nach einem Indikator .
      Das Dialogfeld zur 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 Aufgliederungen oder Elemente und eine Zeitreihenzusammenfassung aus.
    9. Wählen Sie Aus In Methode verwenden Und klicken Sie auf Übermitteln .
      Die Methode ist abgeschlossen, wobei ein Indikator ausgewählt ist. Beachten Sie, dass dem Indikator ein Dollarzeichen, $, vorangestellt ist. Dieses Dollarzeichen bedeutet, dass Analytics HubWerte für den Indikator anstelle der Indikatorpunktzahl werden zurückgegeben. Die Analytics HubWerte werden anstelle der Punktzahl ausgewählt, wenn Sie auswählen In Methode verwenden Kontrollkästchen.
      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 die Lücke zwischen Punktzahl und globalem Ziel für die folgenden Indikatoren aggregiert:
    • Der Prozentsatz der überfälligen Incidents.
    • Das durchschnittliche Alter der letzten Aktualisierung offener Incidents.
    • Die Gesamtzahl der offenen Incidents.
    Um diesen einzelnen Index abzurufen, erstellen Sie einen Formelindikator mit Richtung Auf festlegen Maximieren . Alle Indexindikatoren müssen maximiert werden. Dann verwenden Sie Suchen Sie nach einer Methode Und Suchen Sie nach einem Indikator Funktionen 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 für Ihre Teams ein Ziel einer 10 %-Reduzierung von Monat zu Monat im Incident-Backlog festlegen. Sie erstellen einen Formelindikator mit der folgenden Formel und legen für diesen Indikator auf das Ziel „-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 Punktzahlen von Incidents herausfiltern, bei denen Priorität = 1 – Kritisch.
    1. Rufen Sie die eindeutigen Datensatzbezeichner für die Prioritätsaufgliederung und das Element „1 – Kritisch“ ab. Aufgliederungsdatensätze befinden sich in der Aufgliederungstabelle. Der Speicherort von Elementdatensätzen variiert, wird jedoch in der Aufgliederungsquelle der Aufgliederung identifiziert. In diesem Fall ist das Element ein Auswahldatensatz [sys_choice]. Anweisungen zum Abrufen der eindeutigen Datensatzbezeichner finden Sie unter Der eindeutige Datensatzbezeichner (sys_ID) .

      Die eindeutigen Datensatzbezeichner sind baec0752bf130100b96dac808c0739ed für die Prioritätsaufgliederung und 8a4dde73c6112278017a6a4baf547aaa7 für das Element „1 – kritisch“.

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