---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideAggregate: Bereichsbezogen

# GlideAggregate: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 13 Minuten Lesedauer

Die GlideAggregate- API ermöglicht die Erstellung von Datenbankzusammenfassungsabfragen.

Die GlideAggregate -Klasse ist eine Erweiterung der GlideRecord -Klasse und bietet Abfragen für die Datenbankzusammenfassung (AVG, COUNT, GROUP_CONCAT, GROUP_CONCAT_DISTINCT, MAX, MIN, STDDEV, SUM). Diese Funktion kann hilfreich sein, wenn Sie angepasste Berichte erstellen oder Berechnungen für berechnete Felder durchführen.

Wenn Sie GlideAggregate- Methoden für Währungs- oder Preisfelder verwenden, arbeiten Sie mit dem Bezugswährungswert. Stellen Sie sicher, dass Sie die Zusammenfassungswerte für die Anzeige in die Sitzungswährung des Benutzers konvertieren. Da sich der Umrechnungskurs zwischen dem [Währungs-](https://www.servicenow.com/docs/access?context=currency&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) oder Preiswert (angezeigter Wert) und dem Wert der Referenzwährung (Aggregationswert) ändern kann, entspricht das Ergebnis möglicherweise nicht den Erwartungen des Anwenders.  
Hinweis:  
Wenn Sie ein On-Premise-System verwenden, muss die Zeitzone des Datenbankservers auf GMT/UTC gesetzt sein, damit diese Klasse ordnungsgemäß funktioniert.

## Scoped GlideAggregate -- GlideAggregate(String tableName) {#ariaid-title2}

Erstellt ein GlideAggregate-Objekt in der angegebenen Tabelle.
{#r_ScopedGlideAggregateGlideAggregate_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle. |
[Tabelle : 1. Parameter]

{#r_ScopedGlideAggregateGlideAggregate_String__table_vy2_525_jq}  

    var count = new GlideAggregate('incident');

## Scoped GlideAggregate -- addAggregate(String agg, String name) {#ariaid-title3}

Fügt einer Datenbankabfrage ein Aggregat hinzu.
{#r_ScopedGlideAggregateAddAggregate_String_String__id_zgs_fl2_4nb__entry__3}{#r_ScopedGlideAggregateAddAggregate_String_String__agg-GlideAgg-row}

| Name | Typ | Beschreibung |
|-|-|-|
| agg | Zeichenfolge | Name des zu verwendenden Aggregats Gültige Werte: * AVG: Durchschnittswert des Ausdrucks. * COUNT: Anzahl der Nicht-Null-Werte. * GROUP_CONCAT: Verkettet alle Nicht-Null-Werte der Gruppe in aufsteigender Reihenfolge, verbindet sie mit einem Komma (',') und gibt das Ergebnis als Zeichenfolge zurück. * GROUP_CONCAT_DISTINCT: Verkettet alle Nicht-Null-Werte der Gruppe in aufsteigender Reihenfolge, entfernt Duplikate, verbindet sie mit einem Komma (',') und gibt das Ergebnis als Zeichenfolge zurück. * MAX: Größter oder maximaler Wert. * MIN: Mindestwert. * STDDEV: Standardabweichung der Grundgesamtheit. * SUM: Summe aller Werte. |
| name | Zeichenfolge | Optional. Name des Felds, nach dem die Ergebnisse der Zusammenfassung gruppiert werden sollen. Standard: Null |
[Tabelle : 2. Parameter]

{#r_ScopedGlideAggregateAddAggregate_String_String__id_zgs_fl2_4nb} {#r_ScopedGlideAggregateAddAggregate_String_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Ergebnisse]

{#r_ScopedGlideAggregateAddAggregate_String_String__table_qpt_3f5_jq1}  
Das folgende Beispiel zeigt, wie GlideAggregate- Funktionen in der Incident-Tabelle \[incident\] verwendet werden.

    var incidentGA = new GlideAggregate('incident');
    incidentGA.groupBy('category');
    incidentGA.orderByAggregate('COUNT', 'sys_mod_count');

    incidentGA.addAggregate('AVG', 'sys_mod_count');
    incidentGA.addAggregate('COUNT', 'sys_mod_count');
    incidentGA.addAggregate('GROUP_CONCAT', 'sys_mod_count');
    incidentGA.addAggregate('GROUP_CONCAT_DISTINCT', 'sys_mod_count');
    incidentGA.addAggregate('MAX', 'sys_mod_count');
    incidentGA.addAggregate('MIN', 'sys_mod_count');
    incidentGA.addAggregate('STDDEV', 'sys_mod_count');
    incidentGA.addAggregate('SUM', 'sys_mod_count');

    incidentGA.query();

    while (incidentGA.next()) {
    gs.info('CATEGORY: ' + incidentGA.getValue('category'));
    gs.info('AVG: ' + incidentGA.getAggregate('AVG', 'sys_mod_count'));
    gs.info('COUNT: ' + incidentGA.getAggregate('COUNT', 'sys_mod_count'));
    gs.info('GROUP_CONCAT: ' + incidentGA.getAggregate('GROUP_CONCAT', 'sys_mod_count'));
    gs.info('GROUP_CONCAT_DISTINCT: ' + incidentGA.getAggregate('GROUP_CONCAT_DISTINCT', 'sys_mod_count'));
    gs.info('MAX: ' + incidentGA.getAggregate('MAX', 'sys_mod_count'));
    gs.info('MIN: ' + incidentGA.getAggregate('MIN', 'sys_mod_count'));
    gs.info('STDDEV: ' + incidentGA.getAggregate('STDDEV', 'sys_mod_count'));
    gs.info('SUM: ' + incidentGA.getAggregate('SUM', 'sys_mod_count'));
    gs.info(' ');
    }

Ausgabe

    CATEGORY: inquiry
    AVG: 8.42424242424242424242424242424242424242E00
    COUNT: 33
    GROUP_CONCAT: 0,0,0,0,1,2,2,4,4,4,5,5,5,6,6,6,6,6,6,6,6,7,8,8,8,8,9,15,15,19,32,33,36
    GROUP_CONCAT_DISTINCT: 0,1,2,4,5,6,7,8,9,15,19,32,33,36
    MAX: 36
    MIN: 0
    STDDEV: 9.15843294125113629932710147135171494439E00
    SUM: 278
      
    CATEGORY: software
    AVG: 21
    COUNT: 13
    GROUP_CONCAT: 3,4,5,5,6,7,9,10,10,11,14,94,95
    GROUP_CONCAT_DISTINCT: 3,4,5,6,7,9,10,11,14,94,95
    MAX: 95
    MIN: 3
    STDDEV: 3.27693962918655755532970326989852794087E01
    SUM: 273
      
    CATEGORY: Hardware
    AVG: 6.8
    COUNT: 10
    GROUP_CONCAT: 2,5,5,6,6,6,7,7,9,15
    GROUP_CONCAT_DISTINCT: 2,5,6,7,9,15
    MAX: 15
    MIN: 2
    STDDEV: 3.39280283999985933622820108982884699755E00
    SUM: 68
      
    CATEGORY: network
    AVG: 18
    COUNT: 5
    GROUP_CONCAT: 3,12,17,21,37
    GROUP_CONCAT_DISTINCT: 3,12,17,21,37
    MAX: 37
    MIN: 3
    STDDEV: 1.25698050899765347157025586536136512302E01
    SUM: 90
      
    CATEGORY: 
    AVG: 9.5
    COUNT: 4
    GROUP_CONCAT: 8,8,10,12
    GROUP_CONCAT_DISTINCT: 8,10,12
    MAX: 12
    MIN: 8
    STDDEV: 1.91485421551267621995020382273964310607E00
    SUM: 38
      
    CATEGORY: database
    AVG: 29
    COUNT: 2
    GROUP_CONCAT: 8,50
    GROUP_CONCAT_DISTINCT: 8,50
    MAX: 50
    MIN: 8
    STDDEV: 2.969848480983499602483546320840365965E01
    SUM: 58

## Scope GlideAggregate -- addEncodedQuery (String query) {#ariaid-title4}

Fügt den anderen Abfragen, die möglicherweise für diese Zusammenfassung festgelegt wurden, eine verschlüsselte Abfrage hinzu.
{#r_ScopedGlideAggregateAddEncodedQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Eine verschlüsselte Abfrage, die der Zusammenfassung hinzugefügt werden soll. |
[Tabelle : 4. Parameter]

{#r_ScopedGlideAggregateAddEncodedQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddEncodedQuery_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Ergebnisse]

{#r_ScopedGlideAggregateAddEncodedQuery_String__table_qpt_3f5_jq1}  

    //Number of incidents varies depending on the current state
    //of the incident table
    var count = new GlideAggregate('incident');
    count.addEncodedQuery('active=true');
    count.addAggregate('COUNT');
    count.query();
    var incidents = 0;
    if (count.next())
       incidents = count.getAggregate('COUNT');
    gs.info(incidents);

## Scoped GlideAggregate -- addQuery(String name, String operator, String value) {#ariaid-title5}

Fügt der Zusammenfassung eine Abfrage hinzu.
{#r_ScopedGlideAggregateAddQuery_String_String_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Hinzuzufügende Abfrage |
| operator | Zeichenfolge | Operator für die Abfrage. |
| Wert | Zeichenfolge | Liste der Werte, die in die Abfrage aufgenommen werden sollen. |
[Tabelle : 6. Parameter]

{#r_ScopedGlideAggregateAddQuery_String_String_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddQuery_String_String_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Abfragebedingung. |
[Tabelle : 7. Ergebnisse]

{#r_ScopedGlideAggregateAddQuery_String_String_String__table_qpt_3f5_jq}  

    //Number of incidents varies depending on the current state
    //of the incident table
    var count = new GlideAggregate('incident');
    count.addQuery('active', '=','true');
    count.addAggregate('COUNT', 'category');
    count.query();  
    while (count.next()) {
       var category = count.category;
       var categoryCount = count.getAggregate('COUNT', 'category');
       gs.info("There are currently " + categoryCount + " incidents with a category of " + category);
    }

Ausgabe:

    There are currently 1 incidents with a category of database
    There are currently 5 incidents with a category of hardware
    There are currently 42 incidents with a category of inquiry
    There are currently 4 incidents with a category of network
    There are currently 4 incidents with a category of request
    There are currently 7 incidents with a category of software

## Scoped GlideAggregate -- addNotNullQuery(String fieldName) {#ariaid-title6}

Fügt der Zusammenfassung eine nicht leere Abfrage hinzu.
{#r_ScopedGlideAggregateAddNotNullQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldname | Zeichenfolge | Name des Felds. |
[Tabelle : 8. Parameter]

{#r_ScopedGlideAggregateAddNotNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddNotNullQuery_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Bereichsbezogene Abfragebedingung. |
[Tabelle : 9. Ergebnisse]

{#r_ScopedGlideAggregateAddNotNullQuery_String__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
      count.addNotNullQuery('short_description');
      count.query();   // Issue the query to the database to get all records
      while (count.next()) {   
         // add code here to process the aggregate
      }

## Scoped GlideAggregate -- addNullQuery(String fieldName) {#ariaid-title7}

Fügt der Zusammenfassung eine Nullabfrage hinzu.
{#r_ScopedGlideAggregateAddNullQuery_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Name des Felds. |
[Tabelle : 10. Parameter]

{#r_ScopedGlideAggregateAddNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddNullQuery_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideQueryCondition | Die bereichsbezogene Abfragebedingung. |
[Tabelle : 11. Ergebnisse]

{#r_ScopedGlideAggregateAddNullQuery_String__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
      count.addNullQuery('short_description');
      count.query();   // Issue the query to the database to get all records
      while (count.next()) {   
         // add code here to process the aggregate
      }

## Bereichsbezogenes GlideAggregate -- addTrend(String fieldName, String timeInterval, Number numUnits) {#ariaid-title8}

Fügt einen Trend für ein angegebenes Feld hinzu. Verwenden Sie einen Trend, um Muster über einen bestimmten Zeitraum anzuzeigen.
Hinweis:  
Um zu steuern, ob dayofweek Ergebnisse nach Jahr gruppiert werden sollen, verwenden Sie [Bereichsbezogenes GlideAggregate -- setIntervalYearIncluded(Boolean b)](https://www.servicenow.com/docs/qyy_xLDLM_kPqS80apWKVQ#ScopedGlAgg-setIntervalYearInclu_B "Legt fest, ob Ergebnisse für Wochentagtrends nach Jahr gruppiert werden sollen. Diese Trends werden mit der Methode „ addTrend() “ mit dem Zeitintervall dayofweek erstellt.").
{#r_ScopedGlideAggAddTrend_S_S__table_tlk_cdk_ws__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Name des Felds, für das Trends erstellt werden sollen. |
| timeInterval | Zeichenfolge | Zeitintervall für den Trend. Gültige Werte: * Datum * Wochentag * Stunde * Minute * Quartal * Wert * Woche * Jahr {#r_ScopedGlideAggAddTrend_S_S__ul_rm5_xqq_gnb} |
| AnzahlEinheiten | Nummer | Optional. Nur gültig, wenn timeInterval = Minute ist. Anzahl der Minuten, die in den Trend aufgenommen werden sollen. Standard: 1 |
[Tabelle : 12. Parameter]

{#r_ScopedGlideAggAddTrend_S_S__table_tlk_cdk_ws} {#r_ScopedGlideAggAddTrend_S_S__table_frl_fqd_3z__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#r_ScopedGlideAggAddTrend_S_S__table_frl_fqd_3z}  

    var ga = new GlideAggregate('incident');
    ga.addAggregate('COUNT'); // Count all incidents opened each quarter
    ga.addTrend('opened_at', 'quarter');
    ga.query();
    while(ga.next()) {
     gs.info([ga.getValue('timeref'), ga.getAggregate('COUNT')]);
    }

Ausgabe:

    3/2018, 9
    4/2018, 2
    1/2019, 38
    2/2019, 310

## Scoped GlideAggregate -- getAggregate(String agg, String name) {#ariaid-title9}

Gibt den Wert einer Zusammenfassung aus dem aktuellen Datensatz zurück.
{#r_ScopedGlideAggregateGetAggregate_String_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| agg | Zeichenfolge | Typ des Aggregats. Gültige Werte: * AVG: Durchschnittswert des Ausdrucks. * COUNT: Anzahl der Nicht-Null-Werte. * GROUP_CONCAT: Verkettet alle Nicht-Null-Werte der Gruppe in aufsteigender Reihenfolge, verbindet sie mit einem Komma (',') und gibt das Ergebnis als Zeichenfolge zurück. * GROUP_CONCAT_DISTINCT: Verkettet alle Nicht-Null-Werte der Gruppe in aufsteigender Reihenfolge, entfernt Duplikate, verbindet sie mit einem Komma (',') und gibt das Ergebnis als Zeichenfolge zurück. * MAX: Größter oder maximaler Wert. * MIN: Mindestwert. * STDDEV: Standardabweichung der Grundgesamtheit. * SUM: Summe aller Werte. |
| name | Zeichenfolge | Name des Felds, für das die Zusammenfassung ausgeführt werden soll. |
[Tabelle : 14. Parameter]

{#r_ScopedGlideAggregateGetAggregate_String_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGetAggregate_String_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert der Zusammenfassung. Wenn die aggregierten Werte FX-Währungswerte sind, hat der zurückgegebene Wert das -Format\<currency_code;currency_value\> , z. B.: `USD;134,980000` . Hinweis: Wenn das angegebene Feld FX-Währungswerte verschiedener Währungstypen enthält, kann die Methode die Werte nicht aggregieren und gibt ein Semikolon (;) zurück. |
[Tabelle : 15. Ergebnisse]

{#r_ScopedGlideAggregateGetAggregate_String_String__table_qpt_3f5_jq}  
Zeigt eine Zusammenfassung, die die Anzahl der Datensätze in der Incident-Tabelle zurückgibt.

    var count = new GlideAggregate('incident');
    count.addAggregate('COUNT');
    count.query();
    var incidents = 0;
    if (count.next()) {
      incidents = count.getAggregate('COUNT');
    }
    //Number of incidents varies depending on the current state
    //of the incident table
    gs.info('Number of incidents: ' + incidents);

Ausgabe: Anzahl der Incidents: 63.  
Zeigt die Zusammenfassung eines FX-Währungsfelds an.

    var ga = new GlideAggregate('laptop_tracker');
    ga.addAggregate('SUM', 'cost');
    ga.groupBy('name');
    ga.query();
    while (ga.next()) {
      gs.info('Aggregate results ' + ga.getValue('name') + ' => ' + ga.getAggregate('SUM', 'cost'));
    }

Ausgabe:

    *** Script: Aggregate results Apple MacBook Air => USD;1651.784280000000
    *** Script: Aggregate results Apple MacBook Pro => USD;1651.784280000000
    *** Script: Aggregate results Dell XPS => USD;470.852672000000
    *** Script: Aggregate results LG =>
    *** Script: Aggregate results Samsung Galaxy => USD;225.320000000000
    *** Script: Aggregate results Surface3 => USD;2895.560369520000
    *** Script: Aggregate results Toshiba => USD;9385.202875800000

## Scoped GlideAggregate -- getAggregateEncodedQuery() {#ariaid-title10}

Ruft die erforderliche Abfrage ab, um die aktuelle Zusammenfassung zurückzugeben.
{#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Codierte Abfrage zum Abrufen des Aggregats. |
[Tabelle : 17. Ergebnisse]

{#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
    count.addAggregate('MIN', 'sys_mod_count');
    count.groupBy('category');
    count.query();  
    while (count.next()) {
        gs.info(count.getAggregateEncodedQuery());
    }

Ausgabe:

    category=database
    category=hardware
    category=inquiry
    category=network
    category=request
    category=software

## Scoped GlideAggregate -- getEncodedQuery() {#ariaid-title11}

Ruft die verschlüsselte Abfrage ab.
{#r_ScopedGlideAggregateGetEncodedQuery__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 18. Parameter]

{#r_ScopedGlideAggregateGetEncodedQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateGetEncodedQuery__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Codierte Abfrage. |
[Tabelle : 19. Ergebnisse]

{#r_ScopedGlideAggregateGetEncodedQuery__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
    count.addAggregate('MIN', 'sys_mod_count');
    count.addAggregate('MAX', 'sys_mod_count');
    count.addAggregate('AVG', 'sys_mod_count');
    count.groupBy('category');
    count.query();
    gs.info(count.getEncodedQuery());

Ausgabe:

    ORDERBYcategory^GROUPBYcategory

## Scoped GlideAggregate -- getRowCount() {#ariaid-title12}

Ruft die Anzahl der Zeilen im GlideAggregate-Objekt ab.
{#r_ScopedGlideAggregateGetRowCount__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 20. Parameter]

{#r_ScopedGlideAggregateGetRowCount__table_vy2_535_jq} {#r_ScopedGlideAggregateGetRowCount__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Anzahl der Zeilen im GlideAggregate-Objekt. |
[Tabelle : 21. Ergebnisse]

{#r_ScopedGlideAggregateGetRowCount__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
      count.addAggregate('MIN', 'sys_mod_count');
      count.addAggregate('MAX', 'sys_mod_count');
      count.addAggregate('AVG', 'sys_mod_count');
      count.groupBy('category');
      count.query();
      gs.info(count.getRowCount());
      while (count.next()) {  
         var min = count.getAggregate('MIN', 'sys_mod_count');
         var max = count.getAggregate('MAX', 'sys_mod_count');
         var avg = count.getAggregate('AVG', 'sys_mod_count');
         var category = count.category.getDisplayValue();
         gs.info(category + " Update counts: MIN = " + min + " MAX = " + max + " AVG = " + avg);
      }

Ausgabe:

    6
    Database Update counts: MIN = 8 MAX = 48 AVG = 28.0000
    Hardware Update counts: MIN = 4 MAX = 14 AVG = 6.6250
    Inquiry / Help Update counts: MIN = 0 MAX = 34 AVG = 6.5714
    Network Update counts: MIN = 3 MAX = 37 AVG = 18.6000
    Request Update counts: MIN = 5 MAX = 39 AVG = 13.4000
    Software Update counts: MIN = 4 MAX = 98 AVG = 24.0000

## Scoped GlideAggregate -- getTableName() {#ariaid-title13}

Ruft den Tabellennamen ab, der diesem GlideAggregate-Objekt zugeordnet ist.
{#r_ScopedGlideAggregateGetTableName__table_vc2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 22. Parameter]

{#r_ScopedGlideAggregateGetTableName__table_vc2_525_jq} {#r_ScopedGlideAggregateGetTableName__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Tabellenname. |
[Tabelle : 23. Ergebnisse]

{#r_ScopedGlideAggregateGetTableName__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
    count.addAggregate('MIN', 'sys_mod_count');
    count.addAggregate('MAX', 'sys_mod_count');
    count.addAggregate('AVG', 'sys_mod_count');
    count.groupBy('category');
    count.query();
    gs.info(count.getTableName());

## Scoped GlideAggregate -- getValue(String name) {#ariaid-title14}

Gibt den Wert des angegebenen Felds zurück.
{#r_ScopedGlideAggregateGetValue_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des Felds in der aktuellen Tabelle, das zurückgegeben werden soll. |
[Tabelle : 24. Parameter]

{#r_ScopedGlideAggregateGetValue_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGetValue_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des angegebenen Felds. Gibt null zurück, wenn ungültig (nicht Teil des Ergebnissatzes). |
[Tabelle : 25. Ergebnisse]

{#r_ScopedGlideAggregateGetValue_String__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
    count.addAggregate('MAX', 'sys_mod_count');
    count.groupBy('category');
    count.query();   
    while (count.next()) {  
      gs.info(count.getValue('category') + " category had " + count.getAggregate('MAX', 'sys_mod_count') + " updates");  
    }

Ausgabe:

    category had 12 updates
    hardware category had 15 updates
    inquiry category had 36 updates
    network category had 37 updates
    software category had 95 updates

## Scoped GlideAggregate -- groupBy(String name) {#ariaid-title15}

Gibt den Namen eines Feldes an, das zur Gruppierung der Zusammenfassungen verwendet werden soll.
Kann mehrfach aufgerufen werden, um mehrere Gruppenfelder festzulegen.
{#r_ScopedGlideAggregateGroupBy_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des Felds. |
[Tabelle : 26. Parameter]

{#r_ScopedGlideAggregateGroupBy_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGroupBy_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Ergebnisse]

{#r_ScopedGlideAggregateGroupBy_String__table_qpt_3f5_jq1}  

    var count = new GlideAggregate('incident');
    count.addAggregate('MIN', 'sys_mod_count');
    count.addAggregate('MAX', 'sys_mod_count');
    count.addAggregate('AVG', 'sys_mod_count');
    count.groupBy('category');
    count.query();   
    while (count.next()) {  
         var min = count.getAggregate('MIN', 'sys_mod_count');
         var max = count.getAggregate('MAX', 'sys_mod_count');
         var avg = count.getAggregate('AVG', 'sys_mod_count');
         var category = count.category.getDisplayValue();
         gs.info(category + " Update counts: MIN = " + min + " MAX = " + max + " AVG = " + avg);
    }

Ausgabe:

    Database Update counts: MIN = 8 MAX = 48 AVG = 28.0000
    Hardware Update counts: MIN = 4 MAX = 14 AVG = 6.6250
    Inquiry / Help Update counts: MIN = 0 MAX = 34 AVG = 6.5714
    Network Update counts: MIN = 3 MAX = 37 AVG = 18.6000
    Request Update counts: MIN = 5 MAX = 39 AVG = 13.4000
    Software Update counts: MIN = 4 MAX = 98 AVG = 24.0000

## Scoped GlideAggregate -- hasNext() {#ariaid-title16}

Bestimmt, ob weitere Datensätze im GlideAggregate-Objekt vorhanden sind.
{#r_ScopedGlideAggregateHasNext__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 28. Parameter]

{#r_ScopedGlideAggregateHasNext__table_vy2_535_jq} {#r_ScopedGlideAggregateHasNext__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Abfragesatz weitere Ergebnisse enthält. Mögliche Werte: * wahr: Der Abfragesatz enthält weitere Ergebnisse. * „falsch": Keine weiteren Ergebnisse im Abfragesatz. {#r_ScopedGlideAggregateHasNext__ul_bkh_hhc_dtb} |
[Tabelle : 29. Ergebnisse]

{#r_ScopedGlideAggregateHasNext__table_qpt_3f5_jq}  

    var agg = new GlideAggregate('incident');
    agg.addAggregate('AVG', 'sys_mod_count');
    agg.groupBy('category');
    agg.query();
    while (agg.hasNext()) {
        agg.next();
        var avg = agg.getAggregate('AVG', 'sys_mod_count');
        var category = agg.category.getDisplayValue();
        gs.info(category + ': AVG = ' + avg);
    }

Ausgabe:

    Database: AVG = 32.5000
    Hardware: AVG = 12.0000
    Inquiry / Help: AVG = 7.6667
    Network: AVG = 24.0000
    Request: AVG = 16.4000
    Software: AVG = 27.0833

## Scoped GlideAggregate -- next() {#ariaid-title17}

Wechselt zum nächsten Datensatz im GlideAggregate.
{#r_ScopedGlideAggregateNext__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 30. Parameter]

{#r_ScopedGlideAggregateNext__table_vy2_535_jq} {#r_ScopedGlideAggregateNext__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Abfragesatz weitere Ergebnisse enthält. Mögliche Werte: * wahr: Der Abfragesatz enthält weitere Ergebnisse. * „falsch": Keine weiteren Ergebnisse im Abfragesatz. {#r_ScopedGlideAggregateNext__ul_bkh_hhc_dtb} |
[Tabelle : 31. Ergebnisse]

{#r_ScopedGlideAggregateNext__table_qpt_3f5_jq}  

    var count = new GlideAggregate('incident');
    count.addAggregate('COUNT');
    count.query();
    var incidents = 0;
    if (count.next()) {
       incidents = count.getAggregate('COUNT');
       gs.info(incidents);
    }

## Scoped GlideAggregate -- orderBy(String name) {#ariaid-title18}

Ordnet die Zusammenfassungen mit dem Wert des angegebenen Feldes an. Das Feld wird auch der Liste „Gruppieren nach" hinzugefügt.
{#r_ScopedGlideAggregateOrderBy_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des Feldes, nach dem die Zusammenfassungen sortiert werden sollen. Alternativ können Sie eine GlideFunktion zum Bestellen der Aggregate angeben, z. B. `glidefunction:length(short_description)`. Weitere Informationen zu Glidefunktionen finden Sie unter [Glidefunktions-Operationen](https://www.servicenow.com/docs/access?context=platform-support-functions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). |
[Tabelle : 32. Parameter]

{#r_ScopedGlideAggregateOrderBy_String__table_vy2_525_jq} {#r_ScopedGlideAggregateOrderBy_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Ergebnisse]

{#r_ScopedGlideAggregateOrderBy_String__table_qpt_3f5_jq1}  

    var agg = new GlideAggregate('incident');
    agg.addAggregate('count', 'category'); 
    agg.orderBy('category'); 
    agg.query(); 
    while (agg.next()) { 
      var category = agg.category;
      var count = agg.getAggregate('count', 'category');
      var agg2 = new GlideAggregate('incident');   
      agg2.addAggregate('count', 'category');
      agg2.orderBy('category');
      gs.info(category + ": Current number of incidents:" + count);
    }

Ausgabe:

    database: Current number of incidents:2
    hardware: Current number of incidents:8
    inquiry: Current number of incidents:28
    network: Current number of incidents:5
    request: Current number of incidents:5
    software: Current number of incidents:11

## Scoped GlideAggregate -- orderByAggregate(String agg, String fieldName) {#ariaid-title19}

Ordnet die Zusammenfassungen basierend auf der angegebenen Zusammenfassung und dem angegebenen Feld an.
{#r_ScopedGlideAggregateOrderByAggregate_String_String__table_ikq_hwt_vr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| agg | Zeichenfolge | Zusammenfassungstyp. |
| fieldName | Zeichenfolge | Name des Feldes, das zusammengefasst werden soll. |
[Tabelle : 34. Parameter]

{#r_ScopedGlideAggregateOrderByAggregate_String_String__table_ikq_hwt_vr} {#r_ScopedGlideAggregateOrderByAggregate_String_String__table_jkq_hwt_vr__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 35. Ergebnisse]

{#r_ScopedGlideAggregateOrderByAggregate_String_String__table_jkq_hwt_vr}  

    ga.addAggregate('COUNT', 'category');
    ga.orderByAggregate('count', 'category');
    ga.query();
    while(ga.next()) {
      gs.info('Category: ' + ga.category + ' ' + ga.getAggregate('COUNT', 'category'));
    }

Ausgabe:

    Category: inquiry 18
    Category: software 11
    Category: hardware 7
    Category: network 5
    Category: request 5
    Category:  4
    Category: database 2

## Scoped GlideAggregate -- orderByDesc(String name) {#ariaid-title20}

Sortiert die Zusammenfassungen in absteigender Reihenfolge basierend auf dem angegebenen Feld. Das Feld wird auch der Gruppieren-nach-Liste hinzugefügt.
{#r_ScopedGlideAggregateOrderByDesc_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des Felds. |
[Tabelle : 36. Parameter]

{#r_ScopedGlideAggregateOrderByDesc_String__table_vy2_525_jq} {#r_ScopedGlideAggregateOrderByDesc_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 37. Ergebnisse]

{#r_ScopedGlideAggregateOrderByDesc_String__table_qpt_3f5_jq1}  

    var agg = new GlideAggregate('incident');
    agg.addAggregate('count', 'category'); 
    agg.orderByDesc('category'); 
    agg.query(); 
    while (agg.next()) { 
      var category = agg.category;
      var count = agg.getAggregate('count', 'category');
      var agg2 = new GlideAggregate('incident');   
      agg2.addAggregate('count', 'category');
      agg2.orderBy('category');
      gs.info(category + ": Current number of incidents:" + count);
    }

Ausgabe:

    software: Current number of incidents:11
    request: Current number of incidents:5
    network: Current number of incidents:5
    inquiry: Current number of incidents:28
    hardware: Current number of incidents:8
    database: Current number of incidents:2

## Scoped GlideAggregate -- query() {#ariaid-title21}

Gibt die Abfrage aus und ruft die Ergebnisse ab.
{#r_ScopedGlideAggregateQuery__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 38. Parameter]

{#r_ScopedGlideAggregateQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateQuery__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 39. Ergebnisse]

{#r_ScopedGlideAggregateQuery__table_qpt_3f5_jq1}  

    var count = new GlideAggregate('incident');
    count.addAggregate('COUNT');
    count.query();
    var incidents = 0;
    if (count.next()) {
       incidents = count.getAggregate('COUNT');
    }
    gs.info('Number of incidents: ' + incidents);

## Bereichsbezogenes GlideAggregate -- setAggregateWindow(Number firstRow, Nummer lastRow) {#ariaid-title22}

Begrenzt die Anzahl der Zeilen aus der Tabelle, die in die Aggregatabfrage aufgenommen werden sollen.
{#ScopedGlAgg-setAggregateWindow_N_N__section_tjk_kfm_gtb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| firstRow | Nummer | Nullbasierter Index der ersten Zeile, die in die Aggregatabfrage aufgenommen werden soll, einschließlich. |
| letzte Reihe | Nummer | Nullbasierter Index der letzten Zeile, die in die Aggregatabfrage aufgenommen werden soll (exklusiv). |
[Tabelle : 40. Parameter]

{#ScopedGlAgg-setAggregateWindow_N_N__table_orv_jcm_gtb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 41. Ergebnisse]

{#ScopedGlAgg-setAggregateWindow_N_N__table_orv_jcm_gtb}  
Druckt die Anzahl jeder Kategorie für die ersten zehn Datensätze in der Incident-Tabelle \[incident\].

    var incidentGroup = new GlideAggregate('incident');
    incidentGroup.addAggregate('COUNT', 'category');
    incidentGroup.setAggregateWindow(0, 10);
    incidentGroup.query();
    while (incidentGroup.next()) {
       var incidentCount = incidentGroup.getAggregate('COUNT', 'category');
       gs.info('{0} count: {1}', [incidentGroup.getValue('category'), incidentCount]);
    }

Ausgabe:

    database count: 1
    Hardware count: 1
    inquiry count: 7
    software count: 1

## Scoped GlideAggregate -- setGroup(Boolean b) {#ariaid-title23}

Legt fest, ob die zurückgegebenen Ergebnisse gruppiert werden sollen.
{#r_ScopedGlideAggregateSetGroup_Boolean__table_w24_dxt_vr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| b | Boolean | Kennzeichnung, die angibt, ob die Ergebnisse gruppiert werden sollen. Gültige Werte: * wahr: Ergebnisse gruppieren. * „falsch": Ergebnisse nicht gruppieren. {#r_ScopedGlideAggregateSetGroup_Boolean__ul_ylw_phc_dtb} |
[Tabelle : 42. Parameter]

{#r_ScopedGlideAggregateSetGroup_Boolean__table_w24_dxt_vr} {#r_ScopedGlideAggregateSetGroup_Boolean__table_x24_dxt_vr__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 43. Ergebnisse]

{#r_ScopedGlideAggregateSetGroup_Boolean__table_x24_dxt_vr}  

    var ga = new GlideAggregate('incident');
    ga.addAggregate('COUNT', 'category');
     
    ga.setGroup(true);
    ga.groupBy("category");
     
    ga.query();
     
    while(ga.next()) {
      gs.info('Category ' + ga.category + ' ' + ga.getAggregate('COUNT', 'category'));
      }

Ausgabe:

    Category database 2
    Category hardware 7
    Category inquiry 18
    Category network 5
    Category request 5
    Category software 11

## Bereichsbezogenes GlideAggregate -- setIntervalYearIncluded(Boolean b) {#ariaid-title24}

Legt fest, ob Ergebnisse für Wochentagtrends nach Jahr gruppiert werden sollen. Diese Trends werden mit der Methode „ addTrend() " mit dem Zeitintervall dayofweek erstellt.
Abhängigkeit: [Bereichsbezogenes GlideAggregate - addTrend('](https://www.servicenow.com/docs/qyy_xLDLM_kPqS80apWKVQ#r_ScopedGlideAggAddTrend_S_S "Fügt einen Trend für ein angegebenes Feld hinzu. Verwenden Sie einen Trend, um Muster über einen bestimmten Zeitraum anzuzeigen.")\<fieldName\> ', 'Wochentag') .
{#ScopedGlAgg-setIntervalYearInclu_B__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| b | Boolean | Kennzeichnung, die angibt, ob ein Jahr für einen Trend mit einem Wochentag-Zeitintervall eingeschlossen werden soll. Gültige Werte: * wahr: Wochentagergebnisse nach Jahr gruppieren. * „falsch": Jahr aus Zeitintervallergebnissen ausschließen. {#ScopedGlAgg-setIntervalYearInclu_B__ul_uz2_dph_gzb} Standardwert: true |
[Tabelle : 44. Parameter]

{#ScopedGlAgg-setIntervalYearInclu_B__table_orv_jcm_gtb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 45. Ergebnisse]

{#ScopedGlAgg-setIntervalYearInclu_B__table_orv_jcm_gtb}  
Das folgende Beispiel zeigt, wie Incidents gezählt werden, die in den letzten sechs Monaten erstellt wurden. Die Incidents sind nach Wochentag getrennt, enthalten jedoch nicht das Jahr. Die Standardergebnisse für Donnerstag würden beispielsweise das Jahr enthalten, z. B. `Donnerstag/2023: 16`.

    var incidentGroup = new GlideAggregate('incident');
    incidentGroup.addEncodedQuery("sys_created_onRELATIVEGT@month@ago@6");
    incidentGroup.addTrend('sys_created_on', 'dayofweek');
    incidentGroup.addAggregate('COUNT');
    incidentGroup.setIntervalYearIncluded(false);
    incidentGroup.query();
    while (incidentGroup.next()) {
        gs.info(incidentGroup.getValue('timeref') + ': ' + incidentGroup.getAggregate('COUNT'))};

Ausgabe:

    Sunday: 1
    Monday: 15
    Tuesday: 1
    Wednesday: 7
    Thursday: 16
    Saturday: 1