Skripting in Performance Analytics

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Performance AnalyticsStellt mehrere Skriptobjekte zur Verwendung in Skripts und APIs zum Abfragen bereit Performance AnalyticsDaten. Die Skripts dienen als Aufgliederungszuordnungen oder zur Berechnung eines Werts aus einem Indikator.

    Tipps zu Skripts

    • Verwenden Sie im Allgemeinen Skripts nur, um Indikatoren wie Alter mit Datumsverarbeitung zu unterstützen, indem Sie verwenden Score_Start Und Punktzahl_Ende Variablen.
    • Begrenzen Sie unnötige Felder. Jedes Mal, wenn Sie ein zusätzliches Dot-Walking-Feld hinzufügen, fügen Sie der Abfrage einen zusätzlichen Join hinzu.
    • Versuchen Sie, manuelle Aufgliederungen durch zu ersetzen DatenbankansichtenFür eine bessere Leistung.
    • Versuchen Sie, Skripteinbindungen für allgemeine Funktionen zu verwenden. Weitere Informationen finden Sie unter Skripteinbindungen .
    • Wenn die Daten nicht so strukturiert sind, wie Sie für die Berichterstellung benötigen, versuchen Sie, den Betriebstabellen „Berichtsfelder“ hinzuzufügen, anstatt Skripts zu erstellen. Weitere Informationen finden Sie hier Community-Beitrag .
    • Wenn Sie ein Hintergrundskript ausführen, das abfragt Performance AnalyticsPunktzahlen oder Snapshots-Tabellen. Sie können nur auf Daten zu einer bereichsbezogenen Anwendung zugreifen, wenn Sie über eine entsprechende Rolle für diese Anwendung verfügen.
    Warnung:
    Versuchen Sie, nicht zu verwenden GlideRecords Oder GlideAggregate In Performance AnalyticsSkripts oder Formelindikatoren. Obwohl Sie diese Vorgänge manchmal verwenden müssen, um das zu erhalten, was Sie möchten, sind sie teuer und werden möglicherweise Hunderttausende Male ausgeführt. Stellen Sie sicher, dass keine Alternative vorhanden ist, bevor Sie sie verwenden.

    Aufgliederungszuordnung und Indikatorskripts

    A AufgliederungszuordnungSkript gibt normalerweise entweder eine sys_ID eines Aufgliederungselements oder eine Ganzzahl zurück, um die Punktzahl in einen Bucket zu setzen. Indikatorskripts geben eine Punktzahl zurück, die aus einem oder mehreren Feldern berechnet wird. Dasselbe Skript kann sowohl als Aufgliederungszuordnungsskript als auch als Indikatorskript dienen.

    Aufgliederungsskript

    Betrachten Sie beispielsweise das bereitgestellte Skript „Incident.age.days“, das verwendet Geöffnet_um Feld aus der Incident-Tabelle. Dieses Skript dient als Aufgliederungszuordnung für die Altersaufgliederung, die die Incident-Altersbereiche (Tage) verwendet Bucket-GruppeAls Aufgliederungsquelle.

    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
days(current.opened_at, score_end);

    In diesem Beispiel Current.opened_at Ruft den Zeitstempel ab, wann der aktuell ausgewertete Datensatz geöffnet wurde. Die Punktzahl_Ende Skriptvariable Stammt von DatenerfasserUnd ist an den erfassten Zeitraum gebunden. Wenn beispielsweise ein monatlicher Indikator erfasst wird, wird Punktzahl_Ende Ist das Ende des Monats. Hier wird der Zeitstempel, wann der Incident geöffnet wurde, vom Zeitstempel des Endes des Sammlungszeitraums abgezogen, und das Ergebnis wird in Tage konvertiert.

    Dieses Beispiel enthält Incident.opened_at Feld, das in angegeben ist Felder Feld für dieses Skript. Sie können verwenden Score_Start Und Punktzahl_Ende Ohne sie in zu definieren Felder Feld.

    Erstellen Sie ein Skript in Performance Analytics

    Um ein Skript zu erstellen, wählen Sie zuerst die Faktentabelle aus, für die das Skript gilt, und wählen Sie explizit beliebige Felder aus.

    Vorbereitungen

    Erforderliche Rolle: administrator, PA_admin. Um auf Daten für bereichsbezogene Anwendungen in zuzugreifen Performance AnalyticsTabellen benötigen Sie auch die entsprechende Administratorrolle für diese Anwendung.

    Prozedur

    1. Navigieren zu Alle > Performance Analytics > Skripte Und klicken Sie auf Neu .
    2. Geben Sie dem Skript eine Beschreibung Name .
    3. Wählen Sie aus Faktentabelle Für die das Skript gilt.
      Nur Indikatoren, die dieselbe Faktentabelle verwenden, können dieses Skript verwenden.
    4. Wählen Sie die Faktentabelle aus Felder , Falls vorhanden, wird dies im Skript verwendet.
      Sie wählen Felder anhand ihrer Bezeichnungen aus.
    5. Schreiben Sie das Skript.
      Das Skript muss den folgenden Beziehungen und Einschränkungen entsprechen:
      • Sie können nur die in diesem Formular ausgewählten Felder und Skriptvariablen einschließen. Weitere Informationen finden Sie im Abschnitt über Performance Analytics-Variablen.
      • Wenn Sie ein Feld im Skript verwenden, verwenden Sie den Spaltennamen. Suchen Sie bei Bedarf in der Faktentabelle nach dem Spaltennamen.
      • Wenn Sie ein Feld aus einer Datenbankansicht verwenden, müssen Sie das Präfix einfügen. Beispielsweise enthält die Datenbankansicht „Incident_sla“ die Tabelle „Task_sla“ mit dem Präfix „taskslatable“. Task_sla enthält die Spalte „Business_duration“. Um das Feld „Business_duration“ in der Datenbankansicht „Incident_sla“ zu verwenden, schreiben Sie es als Taskslatable_Business_duration . Wenn Sie keinen Zugriff auf die Datenbankansicht haben, bitten Sie Ihren Systemadministrator, das Präfix für Sie zu finden.

    Nächste Maßnahme

    Nachdem Sie das Skript erstellt haben, erstellen Sie eine Aufgliederungszuordnung oder einen Indikator, die das Skript verwendet. Sie können eine Aufgliederungszuordnung oder ein Indikatorformular öffnen, indem Sie auf klicken Neu Entweder auf der Registerkarte „Aufgliederungszuordnung“ oder „Indikator“. Die Aufgliederungszuordnungen und Indikatoren, die dieses Skript verwenden, werden auf diesen Registerkarten aufgeführt.

    Performance Analytics Variablen

    Mehrere Variablen sind zur Verwendung in verfügbar Performance AnalyticsSkripts und Formelindikatoren.

    Sie können die folgenden Variablen in verwenden Performance AnalyticsSkripts und Formeln.

    • Score_Start : Erste Sekunde des Tages der ersten Indikatorpunktzahl-Sammlung. Bei Skripts wird die Zeit basierend auf der Differenz zwischen der Zeitzone des Anwenders „Ausführen als“ für den Sammlungsauftrag und der Datenbankzeitzone (GMT) berechnet. Bei Formeln wird die Zeit basierend auf der Differenz zwischen der Zeitzone des Anwenders, der die Formel ausführt, und GMT berechnet. Ein Anwender führt eine Formel aus, indem er den Formelindikator in einem Dashboard-Widget oder auf anzeigt Analytics Hub.
    • Punktzahl_Ende : Letzte Sekunde des Tages der letzten Indikatorpunktzahl-Sammlung. Die Zeit wird auf die gleiche Weise berechnet wie für Score_Start .
    • PA : Eine Formelvariable, die in Skripts nicht verwendbar ist und einen Satz von bereitstellt Analytics HubAttribute und Methoden.

    In Skripts sind die Start- und Endvariablen der Punktzahlsammlung GlideElementGlideObject Objekte. Sie können einen erhalten GlideDateTime Objekt aus diesen Variablen durch Aufrufen GetGlideObject() , Z. B. in diesem Beispiel: gs.log("Punktzahl Main = " + Score_end.getGlideObject().getDayOfWeek());

    In Formeln sind die Start- und Endvariablen der Punktzahlsammlung bereits vorhanden GlideDateTime Objekte. Daher können Sie die Variablen direkt verwenden, ohne aufzurufen GetGlideObject() , Z. B. in diesem Beispiel: gs.log("Punktzahl Main = " + Score_end.getDayOfWeek());

    Die Werte der Variablen Start und Ende sind an den erfassten Zeitraum gebunden. Wenn beispielsweise ein monatlicher Indikator erfasst wird, wird Punktzahl_Ende Ist das Ende des Monats.

    Die Score_Start Und Punktzahl_Ende Werte werden basierend auf der Zeitzone des relevanten Anwenders berechnet. Für Performance AnalyticsSkripts: Dies ist die Zeitzone „Ausführen als“ für den Sammlungsauftrag. Bei Formeln ist dies die Zeitzone des Anwenders, der den Formelindikator in einem Dashboard-Widget oder in anzeigt Analytics Hub. Anwender in verschiedenen Zeitzonen können daher unterschiedliche Daten für haben Score_Start Und Punktzahl_Ende In einer Formel.