PAFormulaUtils-API

Mit der API „PAFormulaUtils“ können Sie einen Wert abrufen, der in berechnet wurde Analytics Hub Und verwenden Sie diesen Wert als Eingabe für eine Formel.

Zur Verwendung von PAFormelUtils API müssen Sie diese Anforderungen erfüllen:

• Performance Analytics Muss aktiviert sein.
• Der Anwender, der den Formelindikator erstellt, der diese API verwendet, muss über die Rollen PA_Power_user, PA_admin oder admin verfügen.

Ein Dollarzeichen, $, steht vor Indikatornamen in PAFormelUtils Parameter, z. B. der Indikator „Anzahl der offenen Incidents“ in diesem Beispiel: pa.getGap($[[Anzahl der offenen Incidents]], Score_end); . Dieses Dollarzeichen bedeutet, dass Analytics Hub Berechnete Werte für den Indikator werden anstelle der Indikatorpunktzahl zurückgegeben.

Datumsparameter in PAFormelUtils Methoden haben eine der folgenden Formen:

• 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.

Warnung:

Die PAFormelUtils API kann nur in Formelindikatoren verwendet werden, nicht in Skripts.

Die PAFormelUtils API enthält die folgenden Methoden:

• GetChange(Zeichenfolgenindikator, Objekt fromDate, Objekt bis Datum)
  Gibt die Änderung der Punktzahl eines Indikators zwischen zwei angegebenen Daten zurück.
• GetChangePercentage (Zeichenfolgenindikator, Objekt fromDate, Objekt bis Datum)
  Gibt den Prozentsatz der Änderung der Punktzahl eines Indikators zwischen zwei angegebenen Daten zurück.
• GetCurrentAggregateID()
  Gibt den Bezeichner des Zeitreihenaggregats (sys_ID) aus dem Indikator der aktuellen Formel zurück. Die sys_ID wird dynamisch als Auswahl in zurückgegeben Analytics Hub Changes.
• GetCurrentBreakdownID()
  Gibt den Aufgliederungsbezeichner der Ebene 1 (sys_ID) aus dem Indikator der aktuellen Formel zurück. Die sys_ID wird dynamisch als Auswahl in zurückgegeben Analytics Hub Changes.
• GetCurrentBreakdownLevel2ID()
  Gibt den Aufgliederungsbezeichner der Ebene 2 (sys_ID) aus dem Indikator der aktuellen Formel zurück. Die sys_ID wird dynamisch als Auswahl in zurückgegeben Analytics Hub Changes.
• GetCurrentElementID()
  Gibt den Bezeichner des Aufgliederungselements der Ebene 1 (sys_ID) aus dem Indikator der aktuellen Formel zurück. Die sys_ID wird dynamisch als Auswahl in zurückgegeben Analytics Hub Changes.
• GetCurrentElementLevel2ID()
  Gibt den Bezeichner des Aufgliederungselements der Ebene 2 (sys_ID) aus dem Indikator der aktuellen Formel zurück. Die sys_ID wird dynamisch als Auswahl in zurückgegeben Analytics Hub Changes.
• GetGap(Zeichenfolgenindikator, Objekt onDate)
  Gibt die globale Ziellücke für den angegebenen Indikator am angegebenen Datum zurück.
• GetGlobalTarget(Zeichenfolgenindikator, Objekt onDate)
  Gibt das globale Ziel zurück, das dem angegebenen Indikator für das angegebene Datum zugeordnet ist.
• GetPersonalTarget (Zeichenfolgenindikator, Objekt onDate)
  Gibt das persönliche Ziel zurück, das dem angegebenen Indikator für das angegebene Datum zugeordnet ist.
• GetScore(Zeichenfolgenindikator, Objekt onDate)
  Gibt die Punktzahl des angegebenen Indikators für das angegebene Datum zurück.