Bewertungslisten-API

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 22 Minuten Lesedauer
  • Die Bewertungslisten- API stellt Endpunkte bereit, mit denen Sie Daten zu Performance Analytics-Indikatoren abfragen können. Die Abfrageparameter entsprechen den Funktionen, die unter Analytics Hub für die Suche nach einem Indikator verfügbar sind.

    Bewertungslisten: GET /now/pa/scorecards

    Ruft Details zu -Indikatoren aus Analytics Hub ab.

    Der Zugriff auf Tabellen über die REST API wird durch BasicAuth eingeschränkt. Für Tabellen definierte Zugriffssteuerungslisten werden erzwungen, um den Zugriff auf Daten einzuschränken.

    Um Abfragen mit der API Performance Analytics durchzuführen, müssen Sie auch über die Rolle „pa_viewer“ verfügen.

    Fast alle Abfragen verwenden den Parameter sysparm_uuid. Dieser Parameter besteht aus der sys_id des Indikators gefolgt von einer durch Doppelpunkte getrennten Liste zusätzlicher, optionaler sys_ids. sysparm_uuid ist immer der erste Parameter.

    URL-Format

    URL mit Versionsnummer: /api/now/{api_version}/pa/scorecards

    Standard-URL: /api/now/pa/scorecards

    Hinweis:
    Verfügbare Versionen werden im REST-API-Explorerangegeben. Für geskriptete REST APIs finden Sie zusätzliche Versionsinformationen im Formular „Geskripteter REST-Service“.

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge

    Tabelle : 2. Abfrageparameter
    Parameter Beschreibung
    sysparm_breakdown Sys_id einer Aufgliederung zur Ausgabe von Diagramminformationen, die gemäß der Definition in der Aufgliederung organisiert sind. Beispiel: Die sys_id einer Prioritätsaufgliederung, um separate Aufgabendiagramminformationen für jeden Prioritätswert zurückzugeben, z. B. Anzahl der offenen Incidents/Priorität/2 – Hoch.

    Datentyp: Zeichenfolge

    sysparm_breakdown_relation Sys_id einer Aufgliederungsbeziehung zum Aufschlüsseln der zurückgegebenen Daten anhand dieser Beziehung.

    Datentyp: Zeichenfolge

    sysparm_contains Kommagetrennte Liste von Namen oder Beschreibungen, um Ergebnisse nur für Indikatoren mit einem übereinstimmenden Wert zurückzugeben. Alle durch Kommas getrennten Listenelemente müssen übereinstimmen, oder es werden keine Ergebnisse zurückgegeben: Die Liste folgt der UND-Logik, nicht der ODER-Logik.

    Datentyp: Zeichenfolge

    sysparm_display Kennzeichnung, die den Typ der zurückzugebenden Indikatoren angibt.
    Gültige Werte:
    • „wahr“: Gibt nur Indikatoren zurück, die im Analytics Hub angezeigt werden.
    • all: Gibt alle Indikatoren zurück.

    Datentyp: Zeichenfolge

    Standardwert: wahr

    sysparm_display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden auf Grundlage des tatsächlichen Werts in der Datenbank und der Benutzer- oder Systemeinstellungen und Voreinstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, hängt der zurückgegebene Wert vom Feldtyp ab.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch aussagekräftiger.
    • Datumsfelder: Der Datenbankwert liegt im UTC-Format vor, während der Anzeigewert auf der Zeitzone des Benutzers basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der Anzeigewert entsprechend dem Verschlüsselungskontext des Benutzers unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_id, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • true: Gibt die Anzeigewerte für alle Felder zurück.
    • false: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • all: Gibt sowohl die tatsächlichen als auch die Anzeigewerte zurück.

    Standardwert: false

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Das Angeben des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verwiesen werden muss. Weitere Informationen zu Anzeigewerten und tatsächlichen Werten finden Sie unter FAQs zur Table-API (KB0534905).
    sysparm_elements_filter Sys_id eines Elementfilters, der auf die zurückgegebenen Daten angewendet werden soll.

    Datentyp: Zeichenfolge

    sysparm_exclude_reference_link Kennzeichnung, die angibt, ob zusätzliche Informationen für Referenzfelder ausgeblendet werden sollen, z. B. der URI für die Referenzressource.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_favorites Kennzeichnung, die angibt, ob nur Indikatoren zurückgegeben werden sollen, die Favoriten des abfragenden Anwenders sind.
    Gültige Werte:
    • „wahr“: Gibt nur Indikatoren zurück, die Favoriten des abfragenden Anwenders sind.
    • „falsch“: Gibt alle Indikatoren zurück.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_from Frühestes Datum, ab dem Punktzahlen zurückgegeben werden sollen. Nur Ergebnisse von diesem Datum oder später werden zurückgegeben.

    Für diesen Parameter muss include_scores auf true festgelegt werden.

    Format: ISO-8601-Standard

    Datumstyp: Zeichenfolge

    sysparm_include_aggregates Kennzeichnung, die angibt, ob alle möglichen Aggregate für einen Indikator zurückgegeben werden sollen, einschließlich bereits angewendeter Aggregate.
    Gültige Werte:
    • „wahr“: Gibt alle möglichen Aggregate für einen Indikator zurück, einschließlich der bereits angewendeten Aggregate.
    • „falsch“: Gibt keine Aggregate zurück.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_available_aggregates Kennzeichnung, die angibt, ob alle verfügbaren Aggregate für einen Indikator zurückgegeben werden sollen, wenn kein Aggregat angewendet wurde.
    Gültige Werte:
    • „wahr“: Gibt alle verfügbaren Aggregate für einen Indikator zurück, wenn kein Aggregat angewendet wurde.
    • „falsch“: Gibt keine Aggregate zurück.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_available_breakdowns Kennzeichnung, die angibt, ob alle verfügbaren Aufgliederungen für einen Indikator zurückgegeben werden sollen.
    Gültige Werte:
    • „wahr“: Gibt alle verfügbaren Aufgliederungen für einen Indikator zurück.
    • „falsch“: Gibt keine Aufgliederungen zurück.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_forecast_scores Kennzeichnung, die angibt, ob das Element „prognose_scores“ zurückgegeben werden soll, das ein Array von Datums-Wert-Paaren enthält, die die Prognosedaten für Analytics Hub definieren.

    Dieser Parameter erfordert, dass der Parameter include_scores ebenfalls auf truefestgelegt ist.

    Gültige Werte:
    • „wahr“: Gibt das Element „prognose_scores“ zurück.
    • „falsch“: Element „prognose_scores“ nicht zurückgeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_realtime Kennzeichnung, die angibt, ob das Element „realtime_enabled“ zurückgegeben werden soll, das angibt, ob Echtzeit-Punktzahlen für den Indikator aktiviert sind, oder das Element „realtime_value“, das den Echtzeit-Punktzahlwert enthält. Dieser Parameter wird für Formelindikatoren nicht unterstützt.
    Gültige Werte:
    • „wahr“: Gibt das Element „realtime_enabled“ zurück.
    • „falsch“: Das Element „realtime_enabled“ wird nicht zurückgegeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_score_notes Kennzeichnung, die angibt, ob alle mit der Punktzahl verknüpften Notizen zurückgegeben werden sollen. Das Notizelement enthält den Notizentext sowie den Autor und den Zeitstempel, zu dem die Notiz hinzugefügt wurde.
    Gültige Werte:
    • wahr: Gibt alle Notizen zurück, die der Punktzahl zugeordnet sind.
    • „falsch“: Es werden nicht alle Notizen zurückgegeben, die der Punktzahl zugeordnet sind.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_scores Kennzeichnung, die angibt, ob Indikatorpunktzahlen für den gesamten unter Analytics Hub ausgewählten Zeitraum zurückgegeben werden sollen. Wenn kein Wert angegeben wird, wird dieser Parameter standardmäßig auf „false“ gesetzt und gibt nur den letzten Punktzahlen-Wert zurück.

    Um den Datumsbereich der zurückgegebenen Punktzahlen einzuschränken, kombinieren Sie diesen Parameter mit from und to.

    Gültige Werte:
    • „wahr“: Gibt Indikatorpunktzahlen für den gesamten ausgewählten Zeitraum zurück.
    • „falsch“: Indikatorpunktzahlen für den gesamten ausgewählten Zeitraum nicht zurückgeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_target_color_scheme Kennzeichnung, die angibt, ob das Element „target_color_scheme“ zurückgegeben werden soll, das den Mindest- und Höchstwert und die Farbe jedes Abschnitts des Zielfarbschemas für Analytics Hub enthält.
    Gültige Werte:
    • „wahr“: Gibt das Element „target_color_scheme“ zurück.
    • „falsch“: Element „target_color_scheme“ nicht zurückgeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_include_trendline_scores Kennzeichnung, die angibt, ob das Element „trendline_scores“ zurückgegeben werden soll, das ein Array von Datums-Wert-Paaren enthält, die die Trendlinie Analytics Hub definieren.

    Dieser Parameter erfordert, dass der Parameter include_scores ebenfalls auf truefestgelegt ist.

    Gültige Werte:
    • „wahr“: Gibt das Element „trendline_scores“ zurück.
    • „falsch“: Element „trendline_scores“ nicht zurückgeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_key Kennzeichnung, die angibt, ob Ergebnisse nur für Schlüsselindikatoren zurückgegeben werden sollen.
    Gültige Werte:
    • „wahr“: Gibt das Element „trendline_scores“ zurück.
    • „falsch“: Element „trendline_scores“ nicht zurückgeben.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_limit Maximale Anzahl der zurückzugebenden Punktzahlen.

    Datentyp: Zahl

    sysparm_page Seitenzahl Wenn Sie beispielsweise 20 Indikatoren mit dem Standardwert für „sysparm_per_page“ (10) abfragen, geben Sie für „sysparm_page“ den Wert 2 an, um die Indikatoren 11 bis 20 abzurufen.

    Datentyp: Zahl

    sysparm_per_page Maximale Anzahl von Indikatoren, die jede Abfrage auf einer Seite zurückgeben kann.

    Standard: 10

    Maximum: 100

    Datentyp: Zahl

    sysparm_sortby Wert, der beim Sortieren von Ergebnissen verwendet werden soll.
    Gültige Werte:
    • Aufzählung
    • Change
    • changeperc
    • Datum
    • Standard
    • direction
    • Fälligkeitsdatum
    • Häufigkeit
    • Lücke
    • Gapperc
    • Gruppe
    • indicator_group
    • name
    • Bestellen
    • Ziel
    • Trend
    • Wert

    Datentyp: Zeichenfolge

    Standard: Wert

    sysparm_sortdir Sortierrichtung.
    Gültige Werte:
    • asc: Steht aufsteigend
    • des: Bezeichnet absteigend

    Datentyp: Zeichenfolge

    Standard: Absteigend

    sysparm_step Numerischer Wert zum Überspringen von Punktzahlen, basierend auf der Indikatorhäufigkeit. Geben Sie beispielsweise den Wert 3 an, um nur die Bewertungen von jedem dritten Tag für einen täglichen Indikator oder von jeder dritten Woche für einen wöchentlichen Indikator zurückzugeben.

    Datentyp: Zahl

    sysparm_tags sys_id der Indikatorgruppe, in der die Indikatoren dieser Gruppe zurückgegeben werden sollen. Verwenden mit diesem Parameter Sie nicht sysparm_uuid.

    Sie können die sys_id einer Indikatorgruppe nicht mit dieser API abrufen. Rufen Sie stattdessen die sys_id aus dem Indikatorgruppendatensatz ab. Weitere Informationen zum Abrufen von sys_ids aus Datensätzen finden Sie unter Eindeutiger Datensatzbezeichner (sys_id).

    Datentyp: Zeichenfolge

    sysparm_target Kennzeichnung, die angibt, ob Ergebnisse nur für Indikatoren zurückgegeben werden sollen, für die ein Ziel auf Analytics Hub festgelegt ist.
    Gültige Werte:
    • true: Es werden nur Ergebnisse für Indikatoren zurückgegeben, für die ein Ziel festgelegt ist.
    • „falsch“: Gibt Ergebnisse für alle zutreffenden Indikatoren zurück.

    Datentyp: Boolesch

    Standardwert: false

    sysparm_to Spätestes Datum, ab dem Punktzahlen zurückgegeben werden sollen. Nur Ergebnisse von diesem Datum oder früher werden zurückgegeben.

    Für diesen Parameter muss include_scores auf true festgelegt werden.

    Datentyp: Zeichenfolge

    Format: ISO-8601-Standard

    sysparm_uuid Durch Doppelpunkte getrennte Liste von sys_id-Werten, um anzugeben, welche Indikatoren, Aufgliederungen, Aggregate und Domänen abgefragt werden sollen. Der Parameter folgt diesem Format:

    <indicator_sys_id>:<breakdown_sys_id>:<elements_filter_sys_id oder element_sys_ids>:<lvl-2 breakdown_sys_id>:<lvl-2 elements_filter_sys_id oder element_sys_ids>:<aggregate_sys_id>;<domain_sys_id>

    Der Parameter muss mit der sys_id eines Indikatordatensatzes beginnen. Optional können Sie die sys_id-Werte einer Aufgliederung und eines Aufgliederungselements anhängen, um die auf der Aufgliederung basierende Antwort zu gruppieren, und die sys_id einer Zusammenfassung, um diese Zusammenfassung anzuwenden. Sie können eine Aufgliederung mit einer Zusammenfassung verwenden oder nur je eines davon.

    Hinweis:
    Wenn ein Indikator so konfiguriert ist, dass er eine Standardzeitreihe verwendet, verwenden alle von dieser API für den Indikator abgerufenen Werte die ausgewählte Zusammenfassung.

    Datentyp: Zeichenfolge

    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    Kopfzeilen

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodes der REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Hängt von Anforderungsparametern ab.

    Alle Indikatoren im Analytics Hub werden abgerufen

    # Request a list of all indicators that
    # are displayed in the Analytics Hub,
    # including their unique record identifiers.
    
    curl --verbose --user "user:password" \
    –-header "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards"
    // The following response is truncated
    // to show only the Number of open incidents
    // indicator, which is used in the other
    // examples on this page.
    {
      "result" : [
    ...
      
        {
          "change_formatted" : "",
          "key" : false,
          "value_unit" : "",
          "value_formatted" : "",
          "period_title" : null,
          "gapperc" : null,
          "gap" : null,
          "target" : null,
          "period" : null,
          "target_formatted" : "",
          "favorite" : false,
          "direction_label" : "Minimize",
          "uuid" : "fb007202d7130100b96d45a3ce6103b4",
          "name" : "Number of open incidents",
          "value_color" : "#000000",
          "frequency_label" : "Daily",
          "change" : null,
          "gap_formatted" : "",
          "gapperc_formatted" : "",
          "value" : null,
          "unit" : {
            "display_value" : "#",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value" : "17b365e2d7320100ba986f14ce6103ad"
          },
          "changeperc_formatted" : "",
          "direction" : 2,
          "frequency" : 10,
          "precision" : 0,
          "changeperc" : null,
          "indicator" : {
            "display_value" : "Number of open incidents",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value" : "fb007202d7130100b96d45a3ce6103b4"
          },
          "description" : "Number of incidents open based on resolved date is empty."
        },
    ...
        
      ]
    }

    Indikatordetails zurückgeben

    Sie können Analytics Hub nach einem bestimmten Indikator abfragen, indem Sie den Parameter sysparm_uuid mit dem sys_id-Wert eines Indikators angeben.

    
    # In this example, you use the sys ID for the 
    # Number of open incidents indicator,
    # which you retrieved in the first example, 
    # when you got all the indicators in the 
    # Analytics Hub:
    # "uuid" : "fb007202d7130100b96d45a3ce6103b4",
    # "name" : "Number of open incidents"
    
    curl --verbose --user "user:password" \
    --header "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4"
    {
      "result" : [
        {
          "change_formatted" : "",
          "key" : false,
          "value_unit" : "",
          "value_formatted" : "",
          "period_title" : null,
          "gapperc" : null,
          "gap" : null,
          "target" : null,
          "period" : null,
          "target_formatted" : "",
          "favorite" : false,
          "direction_label" : "Minimize",
          "uuid" : "fb007202d7130100b96d45a3ce6103b4",
          "name" : "Number of open incidents",
          "value_color" : "#000000",
          "frequency_label" : "Daily",
          "change" : null,
          "gap_formatted" : "",
          "gapperc_formatted" : "",
          "value" : null,
          "unit" : {
            "display_value" : "#",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value" : "17b365e2d7320100ba986f14ce6103ad"
          },
          "changeperc_formatted" : "",
          "direction" : 2,
          "frequency" : 10,
          "precision" : 0,
          "changeperc" : null,
          "indicator" : {
            "display_value" : "Number of open incidents",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value" : "fb007202d7130100b96d45a3ce6103b4"
          },
          "description" : "Number of incidents open based on resolved date is empty."
        }
      ]
    }

    Gibt alle Aufgliederungen und Zusammenfassungen für einen Indikator zurück

    Fragen Sie eine Liste der verfügbaren Aufgliederungen und Aggregate für einen Indikator ab, indem Sie die Parameter sysparm_include_available_breakdowns und sysparm_include_available_aggregates auf „wahr“ setzen.

    curl -v -u "user:password" -H "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4&sysparm_include_available_breakdowns=true&sysparm_include_available_aggregates=true"
    {
      "result" : [
        {
          "key" : false,
          "change_formatted" : "",
          "aggregates" : [
            {
              "display_value" : "7d running SUM",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_aggregates/89ea4c11d7001100ba986f14ce6103dc",
              "value" : "89ea4c11d7001100ba986f14ce6103dc"
            },
            {
              "display_value" : "28d running SUM",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_aggregates/4dfa4c11d7001100ba986f14ce6103e2",
              "value" : "4dfa4c11d7001100ba986f14ce6103e2"
            },
            {
              "display_value" : "30d running SUM",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_aggregates/3e409011d7001100ba986f14ce610319",
              "value" : "3e409011d7001100ba986f14ce610319"
            },
            // Aggregates truncated for brevity
            
          ],
          "changeperc" : null,
          "value_formatted" : "",
          "period_title" : null,
          "gapperc" : null,
          "value_unit" : "",
          "target" : null,
          "period" : null,
          "target_formatted" : "",
          "favorite" : false,
          "gap" : null,
          "direction_label" : "Minimize",
          "uuid" : "fb007202d7130100b96d45a3ce6103b4",
          "name" : "Number of open incidents",
          "value_color" : "#000000",
          "frequency_label" : "Daily",
          "change" : null,
          "gap_formatted" : "",
          "gapperc_formatted" : "",
          "value" : null,
          "unit" : {
            "display_value" : "#",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value" : "17b365e2d7320100ba986f14ce6103ad"
          },
          "breakdowns" : [
            {
              "display_value" : "Priority",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_breakdowns/0df47e02d7130100b96d45a3ce610399",
              "value" : "0df47e02d7130100b96d45a3ce610399"
            },
            {
              "display_value" : "Category",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_breakdowns/1f918835d7231100b96d45a3ce6103fe",
              "value" : "1f918835d7231100b96d45a3ce6103fe"
            },
            {
              "display_value" : "Assignment Group",
              "link" : "https://instance.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
              "value" : "baec0752bf130100b96dac808c0739ed"
            },
            // Information for State and Age indicators truncated
            
          ],
          "changeperc_formatted" : "",
          "frequency" : 10,
          "precision" : 0,
          "direction" : 2,
          "indicator" : {
            "display_value" : "Number of open incidents",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value" : "fb007202d7130100b96d45a3ce6103b4"
          },
          "description" : "Number of incidents open based on resolved date is empty."
        }
      ]
    }

    Zeitreihenaggregation von Indikatorpunktzahlen zurückgeben

    # Apply the 7d running SUM aggregate returned in
    # the previous response to the
    # Analytics Hub using the
    # sysparm_uuid value
    # with the sys_id of the aggregate.
    
    curl -v -u "user:password" -H "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:89ea4c11d7001100ba986f14ce6103dc"
    {
      "result" : [
        {
          "key" : false,
          "change_formatted" : "",
          "value_unit" : "",
          "value_formatted" : "",
          "period_title" : null,
          "aggregate" : {
            "display_value" : "7d running SUM",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_aggregates/89ea4c11d7001100ba986f14ce6103dc",
            "value" : "89ea4c11d7001100ba986f14ce6103dc"
          },
          "gapperc" : null,
          "target" : null,
          "period" : null,
          "target_formatted" : "",
          "favorite" : false,
          "gap" : null,
          "direction_label" : "Minimize",
          "uuid" : "fb007202d7130100b96d45a3ce6103b4:89ea4c11d7001100ba986f14ce6103dc",
          "name" : "Number of open incidents / 7d running SUM",
          "value_color" : "#000000",
          "frequency_label" : "Daily",
          "change" : null,
          "gap_formatted" : "",
          "gapperc_formatted" : "",
          "value" : null,
          "unit" : {
            "display_value" : "#",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value" : "17b365e2d7320100ba986f14ce6103ad"
          },
          "changeperc_formatted" : "",
          "direction" : 2,
          "frequency" : 10,
          "precision" : 0,
          "changeperc" : null,
          "indicator" : {
            "display_value" : "Number of open incidents",
            "link" : "https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value" : "fb007202d7130100b96d45a3ce6103b4"
          },
          "description" : "Number of incidents open based on resolved date is empty."
        }
      ]
    }

    Elemente für eine Aufgliederung zurückgeben

    # To get the scores associated with
    # each element of a breakdown and
    # the sys_ids of those elements, pass
    # the sysparm_breakdown
    # parameter with the sys_id of the breakdown.
    # In this example, you get the elements of
    # the Assignment Group breakdown for the
    # Number of open incidents indicator.
    # From the previous example, you have the
    # sys_id of fb007202d7130100b96d45a3ce6103b4
    # for the Number of open incidents indicator and the
    # sys_id of baec0752bf130100b96dac808c0739ed
    # for the Assignment Group breakdown.
    
    curl -v -u "user:password" -H "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4&sysparm_breakdown=baec0752bf130100b96dac808c0739ed"
    // The response consists of a set of
    // indicator objects, each
    // containing one element object.
    // The element objects each
    // contain the name and sys_id of an object.
    // Because the information about the indicator
    // is the same for each indicator
    // object, in this example only the first 
    // indicator object is given
    // in detail.
    {
      "result":[
        { 
          "indicator": {
            "display_value":"Number of open incidents",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value":"fb007202d7130100b96d45a3ce6103b4"
          },
          "gap_formatted":"",
          "benchmarking":false,
          "frequency_label":"Daily",
          "changeperc_formatted":"0.0%",
          "direction_label":"Minimize",
          "precision":0,
          "breakdown": {
            "display_value":"Assignment Group",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value":"baec0752bf130100b96dac808c0739ed"
          },
          "personal_target":null,
          "description":"Number of incidents open based on resolved date is empty.",
          "value_color":"#455464",
          "uuid":"fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:unmatched",
          "frequency":10,
          "gap":null,
          "value_unit":"14",
          "indicator_frequency":10,
          "value":14.0,
          "indicator_aggregate":1,
          "facts_table": {
            "name":"incident",
            "label":"Incidents"
          },
          "key":false,
          "indicator_frequency_label":"Daily",
          "direction":2,
          "element": {
            "display_value":"Unassigned",      //Element name
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/unmatched",
            "value":"unmatched"                //No sys_id for unmatched scores
          },
          "period_title":"Jul 22",
          "period":"Jul 22",
          "target_formatted":"",
          "change":0.0,
          "gapperc_formatted":"",
          "query":"opened_atONToday@javascript:gs.beginningOfToday()@javascript:gs.endOfToday()^ORopened_at<javascript:gs.beginningOfToday()^resolved_atISEMPTY^ORresolved_at>javascript:gs.endOfToday()^state!=8",
          "realtime_enabled":true,
          "changeperc":0.0,
          "target":null,
          "unit": {
            "display_value":"#",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "type":"formatted",
            "value":"17b365e2d7320100ba986f14ce6103ad"
          },
          "value_formatted":"14",             // Score where Assignment Group=Unassigned
          "name":"Number of open incidents > Assignment Group = Unassigned",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        },
        {"indicator": {
          
          "element": {
            "display_value":"Software",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
            "value":"8a4dde73c6112278017a6a4baf547aa7"    // sys_id of element Software
          },
          ...
      
          "value_formatted":"6",                         // Score where Assignment Group: Software
          "name":"Number of open incidents > Assignment Group = Software",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        },
        {"indicator": {
          ...
       
          "element": {
            "display_value":"Service Desk",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/d625dccec0a8016700a222a0f7900d06",
            "value":"d625dccec0a8016700a222a0f7900d06"   // sys_id of element Service Desk
          },
      
          ...
          
          "value_formatted":"5",                        // Score for Assignment Group: Service Desk
          "name":"Number of open incidents > Assignment Group = Service Desk",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        },
        {"indicator": {
      
          ...
          
          "element": {
            "display_value":"Hardware",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
            "value":"8a5055c9c61122780043563ef53438e3"   // sys_id for element Hardware
          },
      
          ...
          
          "value_formatted":"3",                         // Score for Assignment Group: Hardware
          "name":"Number of open incidents > Assignment Group = Hardware",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        },
        {"indicator": {
      
      ...
    
          "element": {
            "display_value":"Network",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e",
            "value":"287ebd7da9fe198100f92cc8d1d2154e"},  // sys_id for element Network
      
    ... 
    
          "value_formatted":"3",                          // Score for Assignment Group: Network
          "name":"Number of open incidents > Assignment Group = Network",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        },
      ...
      ]
    ...
    }
    

    Indikator zurückgeben, der nach einer Aufgliederung und einem Element gefiltert ist

    # The GET request gets the details for 
    # the indicator Number of open
    # incidents, where the Priority of the
    # incident is 1 - Critical. The sys_id
    # values for the indicator, the 
    # Priority breakdown, and the  1 - 
    # Critical element are all passed in
    # the sysparm_uuid parameter.
    
    curl --verbose --user "username":"password" \
    --header "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:0df47e02d7130100b96d45a3ce610399:e5900140200331007665978299a805f3"
    {
    // The request is made Dec 12. The
    // score is 76, which is unchanged from
    // Dec 11, and which exceeds the
    // target of 70.
      "result": [ 
        { 
          "indicator": {
            "display_value":"Number of open incidents",
            "link":"https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value":"fb007202d7130100b96d45a3ce6103b4"
          },
          "gap_formatted":"-6",
          "benchmarking":false,
          "frequency_label":"Daily",
          "changeperc_formatted":"0.0%",
          "direction_label":"Minimize",
          "precision":0,
          "breakdown": {
            "display_value":"Priority",
            "link":"https://instance.service-now.com/api/now/v1/table/pa_breakdowns/0df47e02d7130100b96d45a3ce610399",
            "value":"0df47e02d7130100b96d45a3ce610399"
          },
          "personal_target":null,
          "description":"Number of incidents open based on resolved date is empty.",
          "value_color":"#ff8c00",
          "uuid":"fb007202d7130100b96d45a3ce6103b4:0df47e02d7130100b96d45a3ce610399:5f012106db5123003ee8f93baf9619bd",
          "frequency":10,
          "gap":-6.0,
          "value_unit":"76",
          "indicator_frequency":10,
          "value":76.0,
          "indicator_aggregate":1,
          "facts_table": {
            "name":"incident",
            "label":"Incidents"
          },
          "key":false,
          "indicator_frequency_label":"Daily",
          "direction":2,
          "element": {
            "display_value":"1 - Critical",
            "link":"https://instance.service-now.com/api/now/v1/table/sys_choice/5f012106db5123003ee8f93baf9619bd",
            "value":"5f012106db5123003ee8f93baf9619bd"
          },
          "period_title":"Dec 12",
          "period":"Dec 12",
          "target_formatted":"70",
          "change":0.0,
          "gapperc_formatted":"-8.6%",
          "query":"opened_atONToday@javascript:gs.beginningOfToday()@javascript:gs.endOfToday()^ORopened_at<javascript:gs.beginningOfToday()^resolved_atISEMPTY^ORresolved_at>javascript:gs.endOfToday()^state!=8^priority=1^EQ",
          "realtime_enabled":true,
          "changeperc":0.0,
          "target":70.0,
          "unit": {
            "display_value":"#",
            "link":"https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "type":"formatted","value":"17b365e2d7320100ba986f14ce6103ad"
          },
          "value_formatted":"76",
          "name":"Number of open incidents > Priority = 1 - Critical",
          "gapperc":-0.08571428571428572,
          "change_formatted":"0",
          "favorite":true,
          "personal_target_formatted":""
        }
      ]
    }

    Indikator nach Standort aufgegliedert zurückgeben

    curl -v -u "user:password" -H "Accept:application/json" \
    "https://<instance>.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4&sysparm_breakdown=656d5662eb23310065deac6aa206fee7"
    {
      "result": [
        {
          ...
          "element": {
            "display_value": "San Diego",
            "link": "https://<instance>.service-now.com/api/now/v1/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
            "value": "108752c8c611227501d4ab0e392ba97f",
            "longitude": -117.15726,
            "latitude": 32.71533
          },
          ...
        }
        {
          ...
          "element": {
            "display_value": "Florida",
            "link": "https://<instance>.service-now.com/api/now/v1/table/cmn_location/8e3e85f037d0200044e0bfc8bcbe5d14",
            "value": "8e3e85f037d0200044e0bfc8bcbe5d14",
            "longitude": -95.71289,
            "latitude": 37.09024
          },
          ...
        }
      ]
    }

    Aufgliederungspunktzahlen der ersten und zweiten Ebene zurückgeben

    Um mehrere Aufgliederungen anzuwenden, fügen Sie mehrere Aufgliederungs-sys_ids an den Parameter „sysparm_uuid“ an.

    # In this example, the data is broken
    # down by priority to show priority 1
    # incidents, and by category to show
    # database incidents.
    
    curl -v -u "user:password" -H "Accept:application/json" \
    "https://instance.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:0df47e02d7130100b96d45a3ce610399:e5900140200331007665978299a805f3:1f918835d7231100b96d45a3ce6103fe:9e418d40200331007665978299a805c1"
    {
      "result": [
        {
          "value_formatted": "",
          "indicator": {
            "display_value": "Number of open incidents",
            "link": "http://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value": "fb007202d7130100b96d45a3ce6103b4"
          },
          "gapperc": null,
          "change": null,
          "value_color": "#000000",
          "direction": 2,
          "target_formatted": "",
          "frequency": 10,
          "changeperc_formatted": "",
          "direction_label": "Minimize",
          "period_title": null,
          "description": "Number of incidents open based on resolved date is empty.",
          "name": "Number of open incidents / Priority / 1 - Critical / Category / Database",
          "value": null,
          "key": false,
          "gap_formatted": "",
          "element": {
            "display_value": "1 - Critical",
            "link": "http://instance.service-now.com/api/now/v1/table/sys_choice/e5900140200331007665978299a805f3",
            "value": "e5900140200331007665978299a805f3"
          },
          "precision": 0,
          "element_level2": {
            "display_value": "Database",
            "link": "http://instance.service-now.com/api/now/v1/table/sys_choice/9e418d40200331007665978299a805c1",
            "value": "9e418d40200331007665978299a805c1"
          },
          "breakdown": {
            "display_value": "Priority",
            "link": "http://instance.service-now.com/api/now/v1/table/pa_breakdowns/0df47e02d7130100b96d45a3ce610399",
            "value": "0df47e02d7130100b96d45a3ce610399"
          },
          "period": null,
          "favorite": false,
          "change_formatted": "",
          "unit": {
            "display_value": "#",
            "link": "http://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value": "17b365e2d7320100ba986f14ce6103ad"
          },
          "frequency_label": "Daily",
          "breakdown_level2": {
            "display_value": "Category",
            "link": "http://instance.service-now.com/api/now/v1/table/pa_breakdowns/1f918835d7231100b96d45a3ce6103fe",
            "value": "1f918835d7231100b96d45a3ce6103fe"
          },
          "target": null,
          "changeperc": null,
          "uuid": "fb007202d7130100b96d45a3ce6103b4:0df47e02d7130100b96d45a3ce610399:e5900140200331007665978299a805f3:1f918835d7231100b96d45a3ce6103fe:9e418d40200331007665978299a805c1",
          "gapperc_formatted": "",
          "value_unit": "",
          "gap": null
        }
      ]
    }

    Punktzahlen für eine Reihe von Datumsangaben für zwei Aufgliederungsebenen zurückgeben

    Um eine Liste einzelner Punktzahlen für alle verfügbaren Daten anzufordern, setzen Sie den Parameter „sysparm_include_scores“ auf „wahr“.

    Um den Datumsbereich der Punktzahlen festzulegen, verwenden Sie auch die Parameter sysparm_from und sysparm_to.

    # In this example, the level 1 breakdown and
    # element are Assignment Group: Software
    # (sys_id baec0752bf130100b96dac808c0739ed
    # and 8a4dde73c6112278017a6a4baf547aa7).
    # The level 2 breakdown and element are Priority: 1 -
    # Critical (sys_id 0df47e02d7130100b96d45a3ce610399
    # and e5900140200331007665978299a805f3).
    # Only scores on and after 30 November 2018 are returned.
    
    curl -v -u "resttest:resttest" -H "Accept:application/json" \
    "https://<instance>.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:8a4dde73c6112278017a6a4baf547aa7:0df47e02d7130100b96d45a3ce610399:e5900140200331007665978299a805f3&sysparm_include_scores=true&sysparm_from=2018-11-30"
    {
      "result": [
        { "indicator": {
            "display_value":"Number of open incidents",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value":"fb007202d7130100b96d45a3ce6103b4"
          },
          "gap_formatted":"",
          "benchmarking":false,
          "frequency_label":"Daily",
          "scores": [
            { "end_at":"2018-12-04",
              "period":"Dec 04",
              "value_formatted":"2",
              "start_at":"2018-12-04",
              "value":2.0
            },
    
            ...
           
            { "end_at":"2018-11-30",
              "period":"Nov 30",
              "value_formatted":"0",
              "start_at":"2018-11-30",
              "value":0.0
            }
          ],
          "changeperc_formatted":"",
          "direction_label":"Minimize",
          "precision":0,
          "breakdown": {                      //First-level breakdown
            "display_value":"Assignment Group",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value":"baec0752bf130100b96dac808c0739ed"
          },
          "personal_target":null,
          "description":"Number of incidents open based on resolved date is empty.",
          "value_color":"#455464",
          "uuid":"fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:8a4dde73c6112278017a6a4baf547aa7:0df47e02d7130100b96d45a3ce610399:e5900140200331007665978299a805f3",
          "frequency":10,
          "gap":null,
          "value_unit":"2",
          "indicator_frequency":10,
          "value":2.0,
          "indicator_aggregate":1,
          "key":false,
          "indicator_frequency_label":"Daily",
          "direction":2,
          "element": {                        //First-level breakdown element
            "display_value":"Software",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
            "value":"8a4dde73c6112278017a6a4baf547aa7"
          },
          "period_title":"Dec 04",
          "period":"Dec 04",
          "target_formatted":"",
          "change":2.0,
          "gapperc_formatted":"",
          "realtime_enabled":false,
          "changeperc":null,
          "target":null,
          "unit":{ 
            "display_value":"#",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "type":"formatted",
            "value":"17b365e2d7320100ba986f14ce6103ad"
          },
          "value_formatted":"2",               //Second-level breakdown and element
          "name":"Number of open incidents > Assignment Group = Software > Priority = e5900140200331007665978299a805f3",
          "gapperc":null,
          "change_formatted":"2",
          "favorite":false,
          "breakdown_level2": {
            "display_value":"Priority",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/0df47e02d7130100b96d45a3ce610399",
            "value":"0df47e02d7130100b96d45a3ce610399"
          },
          "personal_target_formatted":""
        }
      ]
    }

    Aufgliederungsbeziehungen für eine Aufgliederung und ein Element zurückgeben

    Um die sys_id-Werte für alle mit einem Indikator verknüpften Aufgliederungsbeziehungen abzurufen, verwenden Sie den Parameter sysparm_include_available_breakdowns. Fügen Sie im Parameter sysparm_uuiddie sys_ids der Aufgliederung der ersten Ebene und des Elements hinzu, deren Beziehungen Sie suchen möchten.

    # In this example, the sysparm_uuid
    # parameter includes the sys_id for the 
    # Assignment Group breakdown and the
    # sys_id for the Software element.
    # The sys_id of the Assignment Group
    # was obtained in the example where all
    # breakdowns and aggregates were returned.
    # The sys_id of the Software element was
    # obtained in the previous example, where
    # all the elements of Assignment Group were
    # returned. The sys_id of the Assignment
    # Group breakdown is
    # baec0752bf130100b96dac808c0739ed
    # and of the Software element is
    # 8a4dde73c6112278017a6a4baf547aa7.
    # The breakdown relation is obtained for the
    # Number of open incidents indicator,
    # whose sys_id is
    # fb007202d7130100b96d45a3ce6103b4.
    
    curl -v -u "user:password" -H "Accept:application/json" "https://<instance>.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:8a4dde73c6112278017a6a4baf547aa7&sysparm_include_available_breakdowns=true"
    {
      "result": [
        {
          "value_formatted": "37",
          "indicator": {
            "display_value": "Number of open incidents",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value": "fb007202d7130100b96d45a3ce6103b4"
          },
          "gapperc": null,
          "change": 9.0,
          "value_color": "#455464",
          "direction": 2,
          "target_formatted": "",
          "frequency": 10,
          "changeperc_formatted": "32.1%",
          "direction_label": "Minimize",
          "period_title": "Jul 22",
          "description": "Number of incidents open based on resolved date is empty.",
          "name": "Number of open incidents / Assignment Group / Software",
          "value": 37.0,
          "key": false,
          "gap_formatted": "",
          "element": {
            "display_value": "Software",
            "link": "https://<instance>.service-now.com/api/now/v1/table/sys_user_group/287ee6fea9fe198100ada7950d0b1b73",
            "value": "8a4dde73c6112278017a6a4baf547aa7"
          },
          "precision": 0,
          "breakdowns": [
            // Information about each breakdown
            
          ],
          "breakdown_relations": [
            {
              "display_value": "Child Groups",
              "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdown_relations/301fd511eb23310065deac6aa206fe31",
              "value": "301fd511eb23310065deac6aa206fe31"
            },
            {
              "display_value": "Parent Group",
              "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdown_relations/790b6e11eb23310065deac6aa206fe1c",
              "value": "790b6e11eb23310065deac6aa206fe1c"
            },
            {
              "display_value": "Sibling Groups",
              "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdown_relations/15e15a12eb233100871aac6aa206fe59",
              "value": "15e15a12eb233100871aac6aa206fe59"
            }
          ],
          "breakdown": {
            "display_value": "Assignment Group",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value": "baec0752bf130100b96dac808c0739ed"
          },
          "period": "Jul 22",
          "favorite": false,
          "change_formatted": "9",
          "unit": {
            "display_value": "#",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value": "17b365e2d7320100ba986f14ce6103ad"
          },
          "frequency_label": "Daily",
          "target": null,
          "changeperc": 0.32142857142857145,
          "uuid": "fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:8a4dde73c6112278017a6a4baf547aa7",
          "gapperc_formatted": "",
          "value_unit": "6",
          "gap": null
        }
      ]
    }

    Indikator mit einer Aufgliederungsbeziehung zurückgeben

    Um eine Aufgliederungsbeziehung zu verwenden, schließen Sie die sys_id-Werte des Indikators, der Aufgliederung und des Elements in den Parameter sysparm_uuid und die sys_id der Aufgliederungsbeziehung in den Parameter sysparm_breakdown_relation ein.

    # This example returns the
    # Sibling Group values for Assignment
    # Group: Software from the previous example.
    
    curl -v -u "user:password" -H "Accept:application/json" \
    "https://<instance>.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:8a4dde73c6112278017a6a4baf547aa7&sysparm_breakdown_relation=15e15a12eb233100871aac6aa206fe59"
    {
      "result": [
        {
          "indicator": {
          "gap_formatted":"",
          "benchmarking":false,
          "frequency_label":"Daily",
          "changeperc_formatted":"0.0%",
          "direction_label":"Minimize",
          "precision":0,
          "breakdown": {
            "display_value":"Assignment Group",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value":"baec0752bf130100b96dac808c0739ed"
          },
          "personal_target":null,
          "description":"Number of incidents open based on resolved date is empty",
          "value_color":"#455464",
          "uuid":"fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:0a52d3dcd7011200f2d224837e6103f2",
          "frequency":10,
          "gap":null,
          "value_unit":"0",
          "indicator_frequency":10,
          "value":0.0,
          "indicator_aggregate":1,
          "facts_table": {
            "name":"incident",
            "label":"Incidents"
          },
          "key":false,
          "indicator_frequency_label":"Daily",
          "direction":2,
          "element": {
            "display_value":"Application Development",
            "link":"https://<instance>.service-now.com/api/now/v1/table/sys_user_group/0a52d3dcd7011200f2d224837e6103f2",
            "value":"0a52d3dcd7011200f2d224837e6103f2"
          },
          "period_title":"Dec 03",
          "period":"Dec 03",
          "target_formatted":"",
          "change":0.0,
          "gapperc_formatted":"",
          "query":"opened_atONToday@javascript:gs.beginningOfToday()@javascript:gs.endOfToday()^ORopened_at<javascript:gs.beginningOfToday()^resolved_atISEMPTY^ORresolved_at>javascript:gs.endOfToday()^state!=8^assignment_group=0a52d3dcd7011200f2d224837e6103f2^EQ",
          "realtime_enabled":true,
          "changeperc":0.0,
          "target":null,
          "unit": {
            "display_value":"#",
            "link":"https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "type":"formatted",
            "value":"17b365e2d7320100ba986f14ce6103ad"
          },
          "value_formatted":"0",
          "name":"Number of open incidents > Assignment Group = Application Development",
          "gapperc":null,
          "change_formatted":"0",
          "favorite":false,
          "personal_target_formatted":""
        }
        // Followed by an indicator object with an element object for every element in the Sibling Group
      ]
    }

    Gefilterten Satz von Elementen für eine Aufgliederung zurückgeben

    Um einen Elementfilter auf die Analytics Hub -Daten anzuwenden, verwenden Sie den Parameter „sysparm_elements_filter“ mit der sys_id eines Performance Analytics -Elementfilterdatensatzes.

    # In this example, the element filter applies
    # to the Groups breakdown source, with the
    # condition [[Parent][is][Database]].
    # The sys_id of this element filter is
    # 7b9eb563eb11020065deac6aa206fe11.
    # The example gets the elements of the Assignment
    # Group breakdown that have the element Database
    # as a parent.
    
    curl -v -u "user:password" -H "Accept:application/json" \
    "https://<instance>.service-now.com/api/now/v1/pa/scorecards?sysparm_uuid=fb007202d7130100b96d45a3ce6103b4&sysparm_breakdown=baec0752bf130100b96dac808c0739ed&sysparm_elements_filter=7b9eb563eb11020065deac6aa206fe11"
    {
      "result": [
        {
          "value_formatted": "37",
          "indicator": {
            "display_value": "Number of open incidents",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value": "fb007202d7130100b96d45a3ce6103b4"
          },
          "gapperc": null,
          "change": 9.0,
          "value_color": "#455464",
          "direction": 2,
          "target_formatted": "",
          "frequency": 10,
          "changeperc_formatted": "32.1%",
          "direction_label": "Minimize",
          "period_title": "Jul 22",
          "description": "Number of incidents open based on resolved date is empty.",
          "name": "Number of open incidents / Assignment Group / Database",
          "value": 37.0,
          "key": false,
          "gap_formatted": "",
          "element": {
            "display_value": "Database",
            "link": "https://<instance>.service-now.com/api/now/v1/table/sys_user_group/287ee6fea9fe198100ada7950d0b1b73",
            "value": "287ee6fea9fe198100ada7950d0b1b73"
          },
          "precision": 0,
          "breakdown": {
            "display_value": "Assignment Group",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value": "baec0752bf130100b96dac808c0739ed"
          },
          "period": "Jul 22",
          "favorite": false,
          "change_formatted": "9",
          "unit": {
            "display_value": "#",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value": "17b365e2d7320100ba986f14ce6103ad"
          },
          "frequency_label": "Daily",
          "target": null,
          "changeperc": 0.32142857142857145,
          "uuid": "fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:287ee6fea9fe198100ada7950d0b1b73",
          "gapperc_formatted": "",
          "value_unit": "37",
          "gap": null
        },
        {
          "value_formatted": "20",
          "indicator": {
            "display_value": "Number of open incidents",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value": "fb007202d7130100b96d45a3ce6103b4"
          },
          // Database Atlanta
          "gapperc": null,
          "change": 4.0,
          "value_color": "#455464",
          "direction": 2,
          "target_formatted": "",
          "frequency": 10,
          "changeperc_formatted": "25.0%",
          "direction_label": "Minimize",
          "period_title": "Jul 22",
          "description": "Number of incidents open based on resolved date is empty.",
          "name": "Number of open incidents / Assignment Group / Database Atlanta",
          "value": 20.0,
          "key": false,
          "gap_formatted": "",
          "element": {
            "display_value": "Database Atlanta",
            "link": "https://<instance>.service-now.com/api/now/v1/table/sys_user_group/db53580b0a0a0a6501aa37c294a2ba6b",
            "value": "db53580b0a0a0a6501aa37c294a2ba6b"
          },
          "precision": 0,
          "breakdown": {
            "display_value": "Assignment Group",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value": "baec0752bf130100b96dac808c0739ed"
          },
          "period": "Jul 22",
          "favorite": false,
          "change_formatted": "4",
          "unit": {
            "display_value": "#",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value": "17b365e2d7320100ba986f14ce6103ad"
          },
          "frequency_label": "Daily",
          "target": null,
          "changeperc": 0.25,
          "uuid": "fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:db53580b0a0a0a6501aa37c294a2ba6b",
          "gapperc_formatted": "",
          "value_unit": "20",
          "gap": null
        },
        {
          "value_formatted": "19",
          "indicator": {
            "display_value": "Number of open incidents",
            "link": "https://<instance>.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4",
            "value": "fb007202d7130100b96d45a3ce6103b4"
          },
          ...
          
          // Database San Diego
          "gapperc": null,
          "change": 0.0,
          "value_color": "#455464",
          "direction": 2,
          "target_formatted": "",
          "frequency": 10,
          "changeperc_formatted": "0.0%",
          "direction_label": "Minimize",
          "period_title": "Jul 22",
          "description": "Number of incidents open based on resolved date is empty.",
          "name": "Number of open incidents / Assignment Group / Database San Diego",
          "value": 10.0,
          "key": false,
          "gap_formatted": "",
          "element": {
            "display_value": "Database San Diego",
            "link": "https://<instance>.service-now.com/api/now/v1/table/sys_user_group/db53a9290a0a0a650091abebccf833c6",
            "value": "db53a9290a0a0a650091abebccf833c6"
          },
          "precision": 0,
          "breakdown": {
            "display_value": "Assignment Group",
            "link": "http://localhost:8080/api/now/v1/table/pa_breakdowns/baec0752bf130100b96dac808c0739ed",
            "value": "baec0752bf130100b96dac808c0739ed"
          },
          "period": "Jul 22",
          "favorite": false,
          "change_formatted": "0",
          "unit": {
            "display_value": "#",
            "link": "http://<instance>.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad",
            "value": "17b365e2d7320100ba986f14ce6103ad"
          },
          "frequency_label": "Daily",
          "target": null,
          "changeperc": 0.0,
          "uuid": "fb007202d7130100b96d45a3ce6103b4:baec0752bf130100b96dac808c0739ed:db53a9290a0a0a650091abebccf833c6",
          "gapperc_formatted": "",
          "value_unit": "10",
          "gap": null
        }
      ]
    }