GlideAggregate : Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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- 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)

    Erstellt ein GlideAggregate-Objekt in der angegebenen Tabelle.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle. 
    var count = new GlideAggregate('incident');

    Scoped GlideAggregate – addAggregate(String agg, String name)

    Fügt einer Datenbankabfrage ein Aggregat hinzu.

    Tabelle : 2. Parameter
    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 : 3. Rückgaben
    Typ Beschreibung
    Keine

    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)

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

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Eine verschlüsselte Abfrage, die der Zusammenfassung hinzugefügt werden soll.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Keine 
    //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)

    Fügt der Zusammenfassung eine Abfrage hinzu.

    Tabelle : 6. Parameter
    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 : 7. Rückgaben
    Typ Beschreibung
    GlideQueryCondition Abfragebedingung. 
    //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)

    Fügt der Zusammenfassung eine nicht leere Abfrage hinzu.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    fieldname Zeichenfolge Name des Felds.
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Bereichsbezogene Abfragebedingung. 
    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)

    Fügt der Zusammenfassung eine Nullabfrage hinzu.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    GlideQueryCondition Die bereichsbezogene Abfragebedingung. 
    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)

    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).
    Tabelle : 12. Parameter
    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
    AnzahlEinheiten Nummer Optional. Nur gültig, wenn timeInterval = Minuteist. Anzahl der Minuten, die in den Trend aufgenommen werden sollen.

    Standard: 1
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    void 
    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)

    Gibt den Wert einer Zusammenfassung aus dem aktuellen Datensatz zurück.

    Tabelle : 14. Parameter
    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 : 15. Rückgaben
    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.

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

    Ruft die erforderliche Abfrage ab, um die aktuelle Zusammenfassung zurückzugeben.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Codierte Abfrage zum Abrufen des Aggregats. 
    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()

    Ruft die verschlüsselte Abfrage ab.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 19. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Codierte Abfrage. 
    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()

    Ruft die Anzahl der Zeilen im GlideAggregate-Objekt ab.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 21. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der Zeilen im GlideAggregate-Objekt. 
    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()

    Ruft den Tabellennamen ab, der diesem GlideAggregate-Objekt zugeordnet ist.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Tabellenname. 
    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)

    Gibt den Wert des angegebenen Felds zurück.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds in der aktuellen Tabelle, das zurückgegeben werden soll.
    Tabelle : 25. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert des angegebenen Felds. Gibt null zurück, wenn ungültig (nicht Teil des Ergebnissatzes). 
    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)

    Gibt den Namen eines Feldes an, das zur Gruppierung der Zusammenfassungen verwendet werden soll.

    Kann mehrfach aufgerufen werden, um mehrere Gruppenfelder festzulegen.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds.
    Tabelle : 27. Ergebnisse
    Typ Beschreibung
    Keine 
    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()

    Bestimmt, ob weitere Datensätze im GlideAggregate-Objekt vorhanden sind.

    Tabelle : 28. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 29. Ergebnisse
    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.
    		 
    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()

    Wechselt zum nächsten Datensatz im GlideAggregate.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 31. Ergebnisse
    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.
    		 
    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)

    Ordnet die Zusammenfassungen mit dem Wert des angegebenen Feldes an. Das Feld wird auch der Liste „Gruppieren nach“ hinzugefügt.

    Tabelle : 32. Parameter
    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.
    Tabelle : 33. Rückgaben
    Typ Beschreibung
    Keine 
    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)

    Ordnet die Zusammenfassungen basierend auf der angegebenen Zusammenfassung und dem angegebenen Feld an.

    Tabelle : 34. Parameter
    Name Typ Beschreibung
    agg Zeichenfolge Zusammenfassungstyp.
    fieldName Zeichenfolge Name des Feldes, das zusammengefasst werden soll.
    Tabelle : 35. Ergebnisse
    Typ Beschreibung
    void 
    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)

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

    Tabelle : 36. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds.
    Tabelle : 37. Ergebnisse
    Typ Beschreibung
    Keine 
    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()

    Gibt die Abfrage aus und ruft die Ergebnisse ab.

    Tabelle : 38. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 39. Ergebnisse
    Typ Beschreibung
    Keine 
    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)

    Begrenzt die Anzahl der Zeilen aus der Tabelle, die in die Aggregatabfrage aufgenommen werden sollen.

    Tabelle : 40. Parameter
    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 : 41. Rückgaben
    Typ Beschreibung
    Keine

    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)

    Legt fest, ob die zurückgegebenen Ergebnisse gruppiert werden sollen.

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    b Boolean

    Kennzeichnung, die angibt, ob die Ergebnisse gruppiert werden sollen.

    Gültige Werte:
    • wahr: Ergebnisse gruppieren.
    • „falsch“: Ergebnisse nicht gruppieren.
    Tabelle : 43. Rückgaben
    Typ Beschreibung
    void 
    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)

    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('<fieldName> ', 'Wochentag') .

    Tabelle : 44. Parameter
    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.

    Standardwert: wahr
    Tabelle : 45. Rückgaben
    Typ Beschreibung
    Keine

    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