PAFormulaUtils-API

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer

    • Mit der PAFormulaUtils-API können Sie einen Wert abrufen, der im Analytics Hub berechnet wurde, und diesen Wert als Eingabe für eine Formel verwenden.

    Um die PAFormulaUtils-API zu verwenden, müssen die folgenden Voraussetzungen erfüllt sein:
    • Performance Analytics muss aktiviert sein.
    • Der Benutzer, der den von dieser API verwendete Formelindikator erstellt, muss die Rolle „pa_power_user“, „pa_admin“ oder „admin“ besitzen.

    Ein Dollarzeichen ($) steht vor den Indikatornamen in den PAFormulaUtils-Parametern, wie der Indikator „Anzahl offener Incidents“ in diesem Beispiel: pa.getGap($[[Anzahl offener Incidents]], score_end);. Dieses Dollarzeichen bedeutet, dass die berechneten Analytics Hub -Werte für den Indikator anstelle der Indikatorpunktzahl zurückgegeben werden.

    Datumsparameter in PAFormulaUtils-Methoden haben eine der folgenden Formen:
    • 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.
    Warnung:
    Die PAFormulaUtil-API kann nur in Formelindikatoren verwendet werden, nicht in Skripts.

    Die PAFormulaUtils-API enthält die folgenden Methoden: