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


---

# Analysemethoden in Formeln abrufen

# Analysemethoden in Formeln abrufen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/kJtv0vNy6xNfTTfpdBiVxA "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.").

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

   <br />

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.  

   <br />

   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](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.
   {#get-indicator-analytics__ul_pcg_2nx_tfb}
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.  

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.  

## Indexindikator {#get-indicator-analytics__example_bdg_v2h_rsb}

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.
{#get-indicator-analytics__ul_ezd_m3q_4fb}  
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 {#get-indicator-analytics__example_xcc_fmz_3wb}

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 {#get-indicator-analytics__example_gfq_hlz_3wb}

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)](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

   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;

{#get-indicator-analytics__ol_exr_wm5_5fb}
* **[PAFormulaUtils-API](https://servicenow-prod.fluidtopics.net/kJtv0vNy6xNfTTfpdBiVxA)**   
  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.

**Zugehörige Konzepte**   

* [Verhindern, dass ein beitragender Indikator in einer Formel Aufgliederungen folgt](https://servicenow-prod.fluidtopics.net/2XBCmcq9K~FriLBtmwdKEw "Sie können beitragende Indikatoren in einer Formel so auswählen, dass sie nicht aufgeschlüsselt werden. Wenn ein Benutzer eine Aufgliederung auf einen Formelindikator anwendet, gilt die Aufgliederung für diese Indikatoren nicht.")
* [Aufgliederungsmatrizen in Formelindikatoren](https://servicenow-prod.fluidtopics.net/8hLWdd49T06LoVs8wEsOIA "Formelindikatoren erben Aufgliederungsmatrizen von Indikatoren in der Formel.")
* [Zeitreihen auf das Ergebnis oder beitragende Indikatoren anwenden](https://servicenow-prod.fluidtopics.net/vTl5BkeEAjr0Mhjc~ewEAA "Bei einem Formelindikator kann eine Zeitreihenaggregation entweder einzeln auf jeden Indikator in der Formel oder auf das Formelergebnis angewendet werden.")
* [Mehrerer Indikatoren in einer Formel indizieren](https://servicenow-prod.fluidtopics.net/PeKgK6Pnk4k~TAA0d0XgvQ "Sie können eine Formel schreiben, um den Abstand zum Gesamtziel mehrerer kombinierter Indikatoren zu messen. Ein solcher Formelindikator wird als „Indexindikator“ bezeichnet.")
* [Ä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.")  
**Zugehörige Tasks**   

* [Formelindikatoren erstellen](https://servicenow-prod.fluidtopics.net/q0Zxi814d2Taw0HsW~tpfw "Erstellen Sie einen Formelindikator, um neue berechnete Punktzahlen aus mindestens einem anderen Indikator zu erzeugen. Neben Indikatorpunktzahlen kann die Formel auch Berechnungen wie den Abstand zwischen einer Indikatorpunktzahl und dem Indikatorziel enthalten.")
* [Indikatoren ohne Punktzahl in einer Formel erkennen](https://servicenow-prod.fluidtopics.net/G_RrRTkxqZ_oq2aVwxuLTA "Als Formelersteller können Sie beitragende Indikatoren behandeln, deren Punktzahlen Null sind. Setzen Sie zunächst den Komponentenindikator, um die Formel zu berechnen, auch wenn sie eine Punktzahl Null enthält.")