---
sourceDocument: Analytics der Xanadu-Plattform
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Analytics der Xanadu-Plattform

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# PAFormulaUtils-API

# PAFormulaUtils-API {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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.
{#PAFormulaUtils__ul_rxq_nnk_ffb}

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](https://servicenow-prod.fluidtopics.net/XGrJoudiwqEruWGSdmUyiA "Bei Formelindikatoren werden die Werte der Variablen score_start und score_end basierend auf der Zeitzone des Benutzers berechnet, der die Formel ausführt. Wenn Benutzer in verschiedenen Zeitzonen dieselbe Formel ausführen, ändern sich die Werte score_start und score_end.").
* Ein Datumsparameter, den Sie selbst mit der GlideDate- oder GlideDateTime-API codiert haben.
{#PAFormulaUtils__ul_jsg_gzx_tfb}  
Warnung:  
Die PAFormulaUtil-API kann nur in Formelindikatoren verwendet werden, nicht in Skripts.

Die PAFormulaUtils-API enthält die folgenden Methoden:
* **[getChange(String indicator, Object fromDate, Object toDate)](https://servicenow-prod.fluidtopics.net/PI96JdGRZd2CjMHsEvT~Tw)**   
  Gibt die Änderung der Bewertung eines Indikators zwischen zwei angegebenen Daten zurück.
* **[getChangePercentage(String indicator, Object fromDate, Object toDate)](https://servicenow-prod.fluidtopics.net/d1OQv7q8g1_tu1~Az9P28Q)**   
  Gibt den Prozentsatz der Änderung in der Bewertung eines Indikators zwischen zwei angegebenen Daten zurück.
* **[getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/~odFh~~9IzC3AR0bT2iiXg)**   
  Gibt den Identifier der Zeitreihenaggregation (sys_id) vom Indikator der aktuellen Formel zurück. Die sys_id wird dynamisch zurückgegeben, da sich die Auswahl in Analytics Hub ändert.
* **[getCurrentBreakdownID()](https://servicenow-prod.fluidtopics.net/5IlVNasIhhp6ET8QivXRhQ)**   
  Gibt den Aufgliederungs-Identifier der Ebene 1 (sys_id) vom Indikator der aktuellen Formel zurück. Die sys_id wird dynamisch zurückgegeben, da sich die Auswahl in Analytics Hub ändert.
* **[getCurrentBreakdownLevel2ID()](https://servicenow-prod.fluidtopics.net/g2KD~7zIIfeM_kIubMQlEw)**   
  Gibt den Aufgliederungs-Identifier der Ebene 2 (sys_id) vom Indikator der aktuellen Formel zurück. Die sys_id wird dynamisch zurückgegeben, da sich die Auswahl in Analytics Hub ändert.
* **[getCurrentElementID()](https://servicenow-prod.fluidtopics.net/KxFXfIhIomyJJEe2ma65ig)**   
  Gibt den Aufgliederungs-Element-Identifier der Ebene 1 (sys_id) vom Indikator der aktuellen Formel zurück. Die sys_id wird dynamisch zurückgegeben, da sich die Auswahl in Analytics Hub ändert.
* **[getCurrentElementLevel2ID()](https://servicenow-prod.fluidtopics.net/0LDAsICddcV3BzvJYJpS2w)**   
  Gibt den Aufgliederungs-Element-Identifier der Ebene 2 (sys_id) vom Indikator der aktuellen Formel zurück. Die sys_id wird dynamisch zurückgegeben, da sich die Auswahl in Analytics Hub ändert.
* **[getGap(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/mt6Hm3tXTPqmq9f2iskbgQ)**   
  Gibt den Abstand des globalen Ziels für den spezifischen Indikator an einem bestimmten Datum zurück.
* **[getGlobalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/paCLq4KOO5pJczmWKmy0dw)**   
  Gibt das globale Ziel für den spezifischen Indikator an einem bestimmten Datum zurück.
* **[getPersonalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/vQTmkhFMVeYpWnM_EQIMxg)**   
  Gibt das persönliche Ziel für den spezifischen Indikator an einem bestimmten Datum zurück.
* **[getScore(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/fZppk2FzJsT9C4rnFtOTiQ)**   
  Gibt die Bewertung für den spezifischen Indikator an einem bestimmten Datum zurück.