Analysemethoden in Formeln abrufen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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, der in Analytics Hub berechnet wurde, als Eingabe für eine Formel verwenden. 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. In der Liste wird für jede Methode eine beschreibende Bezeichnung anstelle des Methodennamens angezeigt.

      Liste der beschreibenden Bezeichnungen von Methoden im Dialogfeld „Der Formel eine Methode hinzufügen“, wobei „Globale Ziellücke des angegebenen Indikators abrufen“ hervorgehoben ist.
    4. Wählen Sie eine Methode aus.
      Wenn Sie eine Methode auswählen, wird eine Beschreibung geöffnet, die den Namen der Methode und alle Parameterfelder enthält.

      Das Dialogfeld „Methode zur Formel hinzufügen“ zeigt die Methode Globale Ziellücke abrufen des angegebenen Indikators und das Datum an, das als letzte gesammelte Punktzahl angegeben ist
      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. Füllen Sie alle Parameter aus, und klicken Sie auf Auswählen.
      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 aus einer Methode in der Formel
    7. Wählen Sie den Indikator aus.
    8. Wahlweise: Wählen Sie beliebige Aufgliederungen oder Elemente und eine Zeitreihenaggregation 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 das Kontrollkästchen In Methode verwenden sind aktiviert

    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 % für Analytics Hubfest.

    var lastPeriod = new GlideDateTime(score_start.getYear() + '-' + score_start.getMonth() + '-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;