GlideAggregate : Global

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

    Um diese API zum Erstellen dynamischer Attribute zu verwenden, benötigen Sie die Rolle „dynamic_schema_writer“. Um dynamische Daten mit dieser API zu lesen, benötigen Sie die Rolle „dynamic_schema_reader“.

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Hinweis:
    Wenn Sie ein On-Premise-System verwenden, muss die Zeitzone des Datenbankservers auf GMT/UTC gesetzt sein, damit diese Klasse ordnungsgemäß funktioniert.

    GlideAggregate – addAggregate(String agg, String name)

    Fügt einer Datenbankabfrage ein Aggregat hinzu.

    Tabelle : 1. 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 für Feldname. Name des Felds oder Pfad zu einem Attribut in einem dynamischen Attributspeicher, nach dem die Ergebnisse der Zusammenfassung gruppiert werden sollen.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    Standard: Null
    Tabelle : 2. 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

    Das folgende Beispiel zeigt, wie diese Methode mithilfe eines Attributs in einem dynamischen Attributspeicher aufgerufen wird.

    var ga_Inc = new GlideAggregate('incident');
ga_Inc.groupBy('inc_dynamic_schema->cars->make');
ga_Inc.addAggregate('AVG', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('MIN', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('MAX', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('SUM', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('COUNT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('STDDEV', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cars->cost');
ga_Inc.query();
while (ga_Inc.next()) {
    gs.info(gr_Inc.getValue('inc_dynamic_schema->cars->make'));
    gs.info('AVG: ' + ga_Inc.getAggregate('AVG', 'inc_dynamic_schema->cars->cost'));
    gs.info('MAX: ' + ga_Inc.getAggregate('MAX', 'inc_dynamic_schema->cars->cost'));
    gs.info('MIN: ' + ga_Inc.getAggregate('MIN', 'inc_dynamic_schema->cars->cost'));
    gs.info('SUM: ' + ga_Inc.getAggregate('SUM', 'inc_dynamic_schema->cars->cost'));
    gs.info('COUNT: ' + ga_Inc.getAggregate('COUNT', 'inc_dynamic_schema->cars->cost'));
    gs.info('STDDEV: ' + ga_Inc.getAggregate('STDDEV', 'inc_dynamic_schema->cars->cost'));
    gs.info('GROUP_CONCAT: ' + ga_Inc.getAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cars->cost'));
    gs.info('GROUP_CONCAT_DISTINCT: ' + ga_Inc.getAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cars->cost'));
    gs.info('COUNT(DISTINCT: ' + ga_Inc.getAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cars->cost'));
    gs.info(' ');
}

    Ausgabe:

    *** Script: BMW
*** Script: AVG: 31852.066666666667
*** Script: MAX: 49182
*** Script: MIN: 16544
*** Script: SUM: 477781
*** Script: COUNT: 15
*** Script: STDDEV: 10376.50218706
*** Script: GROUP_CONCAT: 16544,18427,19083,22144,24126,27018,32353,34934,35691,35698,35799,36814,41257,48711,49182
*** Script: GROUP_CONCAT_DISTINCT: 16544,18427,19083,22144,24126,27018,32353,34934,35691,35698,35799,36814,41257,48711,49182
*** Script: COUNT(DISTINCT: 15
*** Script:  
*** Script: Ford
*** Script: AVG: 31520.090909090909
*** Script: MAX: 47408
*** Script: MIN: 16080
*** Script: SUM: 346721
*** Script: COUNT: 11
*** Script: STDDEV: 11355.75551388
*** Script: GROUP_CONCAT: 16080,16082,16996,27621,31662,33478,35201,36965,38085,47143,47408
*** Script: GROUP_CONCAT_DISTINCT: 16080,16082,16996,27621,31662,33478,35201,36965,38085,47143,47408
*** Script: COUNT(DISTINCT: 11
*** Script:  
*** Script: Honda
*** Script: AVG: 31972.750000000000
*** Script: MAX: 49187
*** Script: MIN: 15208
*** Script: SUM: 511564
*** Script: COUNT: 16
*** Script: STDDEV: 10240.67632207
*** Script: GROUP_CONCAT: 15208,17926,18365,20942,25557,28215,29090,34336,34857,34969,37144,38097,41541,41805,44325,49187
*** Script: GROUP_CONCAT_DISTINCT: 15208,17926,18365,20942,25557,28215,29090,34336,34857,34969,37144,38097,41541,41805,44325,49187
*** Script: COUNT(DISTINCT: 16
*** Script:  
*** Script: Lexus
*** Script: AVG: 29841.250000000000
*** Script: MAX: 48406
*** Script: MIN: 15517
*** Script: SUM: 238730
*** Script: COUNT: 8
*** Script: STDDEV: 12073.56647214
*** Script: GROUP_CONCAT: 15517,16964,22371,23900,32421,36620,42531,48406
*** Script: GROUP_CONCAT_DISTINCT: 15517,16964,22371,23900,32421,36620,42531,48406
*** Script: COUNT(DISTINCT: 8
*** Script:  
*** Script: Tesla
*** Script: AVG: 30790.000000000000
*** Script: MAX: 45032
*** Script: MIN: 16724
*** Script: SUM: 431060
*** Script: COUNT: 14
*** Script: STDDEV: 8510.068136760580
*** Script: GROUP_CONCAT: 16724,17173,21049,24837,28431,30594,31871,32549,32675,33778,36963,37946,41438,45032
*** Script: GROUP_CONCAT_DISTINCT: 16724,17173,21049,24837,28431,30594,31871,32549,32675,33778,36963,37946,41438,45032
*** Script: COUNT(DISTINCT: 14
*** Script:  
*** Script: Toyota
*** Script: AVG: 32115.444444444444
*** Script: MAX: 49418
*** Script: MIN: 15188
*** Script: SUM: 289039
*** Script: COUNT: 9
*** Script: STDDEV: 12120.76776767
*** Script: GROUP_CONCAT: 15188,16453,24596,28529,32863,34697,42790,44505,49418
*** Script: GROUP_CONCAT_DISTINCT: 15188,16453,24596,28529,32863,34697,42790,44505,49418
*** Script: COUNT(DISTINCT: 9
*** Script:

    Bereichsbezogenes Äquivalent

    Um die addAggregate()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addAggregate().

    GlideAggregate – addBizCalendarTrend(Zeichenfolge fieldName, Zeichenfolge bizCalendarSysId)

    Fügt der Zusammenfassungsabfrage Trends nach einem Geschäftskalender hinzu. Mit dieser Methode können Sie ein Datums- und Uhrzeitfeld im entsprechenden GlideRecord auswählen und Datensätze basierend auf einer angegebenen Geschäftskalenderzeitspanne gruppieren.

    Hinweis:
    Bei dieser Methode wird der Join-Operator für die SQL-Abfragen nicht verwendet.
    Tabelle : 3. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Datums- und Uhrzeitfeld im zugeordneten GlideRecord, mit dem bestimmt wird, in welcher Gruppen- oder Kalenderzeitspanne der Datensatz enthalten ist.
    bizCalendarSysId Zeichenfolge Sys_id des zu verwendenden Kalenderdatensatzes. Dies ist der Kalender, der die gewünschten Zeitspannen enthält.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt die Anzahl der Incident-Datensätze, gruppiert nach den Zeitspannen des Geschäftskalenders „Monat“.

    var monthCal = "4d7ddda353f3001076bcddeeff7b12b1"
var ga = new GlideAggregate('incident');
ga.addAggregate('COUNT');
ga.addBizCalendarTrend('opened_at', monthCal);
ga.setGroup(false);
ga.query();
gs.print(ga.getRowCount());
while (ga.next()) {
  gs.info(ga.getValue('bizcalref') + ', ' + ga.getValue('bizcalrefend') + ', ' + ga.getAggregate('COUNT'));
}

    Ausgabe:

    13
2015-08-01 00:00:00, 2015-09-01 00:00:00, 2
2015-11-01 00:00:00, 2015-12-01 00:00:00, 2
2016-08-01 00:00:00, 2016-09-01 00:00:00, 3
2016-12-01 00:00:00, 2017-01-01 00:00:00, 1
2018-08-01 00:00:00, 2018-09-01 00:00:00, 3
2018-09-01 00:00:00, 2018-10-01 00:00:00, 3
2018-10-01 00:00:00, 2018-11-01 00:00:00, 2
2019-07-01 00:00:00, 2019-08-01 00:00:00, 2
2020-06-01 00:00:00, 2020-07-01 00:00:00, 1
2021-01-01 00:00:00, 2021-02-01 00:00:00, 1
2023-04-01 00:00:00, 2023-05-01 00:00:00, 15
2023-05-01 00:00:00, 2023-06-01 00:00:00, 23
2023-07-01 00:00:00, 2023-08-01 00:00:00, 9

    GlideAggregate – addEncodedQuery(String query)

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

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    query Zeichenfolge Codierte Abfragezeichenfolge, die dem Aggregat hinzugefügt werden soll.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Keine 
    var agg = new GlideAggregate('incident');
agg.addAggregate('count','category'); 
agg.orderByAggregate('count', 'category'); 
agg.orderBy('category'); 
agg.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(2)'); 
agg.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(2)'); 
agg.query(); 
while (agg.next()) { 
  var category = agg.category;
  var count = agg.getAggregate('count','category');
  var query = agg.getQuery();  
  var agg2 = new GlideAggregate('incident');   
  agg2.addAggregate('count','category');
  agg2.orderByAggregate('count', 'category');
  agg2.orderBy('category');
  agg2.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(3)');
  agg2.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(3)');
  agg2.addEncodedQuery(query);
  agg2.query();
  var last = "";
  while (agg2.next()) {
     last = agg2.getAggregate('count','category');      
  }
  gs.log(category + ": Last month:" + count + " Previous Month:" + last);
 
}

    Bereichsbezogenes Äquivalent

    Um die addEncodedQuery()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: addEncodedQuery().

    GlideAggregate – addHaving(String name, String operator, String value)

    Fügt der Zusammenfassung ein Element vom Typ „hat“ hinzu, z. B. Kategorie auswählen, Anzahl (*) aus Incident-Gruppe nach Kategorie HAVING count(*) > 5.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Aggregat, nach dem gefiltert werden soll. Beispiel: COUNT.
    operator Zeichenfolge Betreibersymbol. Beispiel: <, >, =, !=.
    Wert Zeichenfolge Wert, der abgefragt werden soll. Beispiel: „5“.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Keine 
    var trend = new GlideAggregate('incident');
trend.addTrend ('opened_at','Month');
trend.addAggregate('COUNT');

//addHaving limits the results returned to those in which the aggregate COUNT is greater than 2
trend.addHaving('COUNT', '>', '2');
trend.setGroup(false);
trend.query();
while(trend.next()) {
  gs.print(('Incidents by month ' + trend.getValue('timeref') + ' where count is more than 2 count is: ' + trend.getAggregate('COUNT'));
}

    Ausgabe:

    Incidents by month 9/2018 where count is more than 2 count is: 3
Incidents by month 10/2018 where count is more than 2 count is: 8
Incidents by month 11/2018 where count is more than 2 count is: 14

    GlideAggregate - addHaving(String aggName, String fieldName, Zeichenfolgenoperator, Zeichenfolgenwert)

    Fügt der Zusammenfassung ein Element „hat“ hinzu, z. B. Kategorie auswählen, Anzahl(*) aus Incident-Gruppe nach Kategorie HAVING count(*) > 5. Mit dieser Implementierung der Methode können Sie ein bestimmtes Feld in einer Tabelle oder einem dynamischen Feld angeben Attribut, auf das reagiert werden soll.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    aggName Zeichenfolge Aggregat, nach dem gefiltert werden soll.

    Beispiel: COUNT.
    fieldName Zeichenfolge Feldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.
    operator Zeichenfolge Betreibersymbol.

    Beispiel: <, >, =, !=.
    Wert Zeichenfolge Wert, der abgefragt werden soll.

    Beispiel: „5“.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie Sie die doppelten Seriennummern in der CMDB-Tabelle mithilfe eines Feldnamens im Methodenaufruf addHaving() identifizieren.

    function getDupes(tableName, dpField) { 
    var ga = new GlideAggregate(tableName);
    ga.addAggregate('COUNT', dpField); // Aggregate to count values in whatever field is passed as dpField
    ga.addHaving('COUNT', dpField, '>', '1'); // Returns only records having more than one active instance of dpField
    ga.query(); 
    var arDupes = new Array(); // Build array to push the results into
    while (ga.next()) { 
      arDupes.push(ga.getValue(dpField)); // Push the value of the dupe field to the array  
    }
    return arDupes;
}
 
var tableName = "cmdb";
var dpField = "serial_number";
 
gs.print(getDupes(tableName, dpField));

    Ausgabe:

    Incidents by month 9/2018 where count is more than 2 count is: 3
Incidents by month 10/2018 where count is more than 2 count is: 8
Incidents by month 11/2018 where count is more than 2 count is: 14

    Das folgende Beispiel zeigt, wie Du Duplikate identifiziert, verwendet jedoch ein dynamisches Attribut anstelle eines Felds im Methodenaufruf addHaving().

    function getDupes(tableName, dpField) { 
    var ga = new GlideAggregate(tablename);
    ga.addAggregate('COUNT', dpField); // Aggregate to count values in whatever dynamic attribute is passed as dpField
    ga.addHaving('COUNT', dpField, '>', '1'); // Returns only records having more than one active instance of dpField
    ga.query(); 
    var arDupes = new Array(); // Build array to push the results into
    while (ga.next()) { 
      arDupes.push(ga.getValue(dpField)); // Push the value of the dupe field to the array  
    }
    return arDupes;
}
 
var tableName = "cmdb";
var dpField = "dyn_att_field->group->attr";
 
gs.print(getDupes(tableName, dpField));

    Ausgabe:

    Incidents by month 9/2018 where count is more than 2 count is: 3
Incidents by month 10/2018 where count is more than 2 count is: 8
Incidents by month 11/2018 where count is more than 2 count is: 14

    GlideAggregate – addTrend(String fieldName, String timeInterval, Number numUnits)

    Fügt einen Trend für ein 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 GlideAggregate – setIntervalYearIncluded(Boolean b).
    Tabelle : 11. 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 : 12. Rückgaben
    Typ Beschreibung
    Keine 
    var trend = new GlideAggregate('incident');  
trend.addTrend ('opened_at','month');  
trend.addAggregate('COUNT');  
trend.setGroup(false);  
trend.query();  
while(trend.next()) {  
   gs.print(trend.getValue('timeref') + ': ' + trend.getAggregate('COUNT'));  
}

    Ausgabe:

    9/2018: 3
10/2018: 8
11/2018: 14

    Bereichsbezogenes Äquivalent

    Um die Methode addTrend() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addTrend().

    GlideAggregate – getAggregate(String agg, String name)

    Ruft den Wert einer Zusammenfassung aus dem aktuellen Datensatz ab.

    Tabelle : 13. 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 oder Pfad zu einem Attribut in einem dynamischen Schema, von dem die Zusammenfassung abgerufen werden soll.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Zeichenfolge 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.

    Dieses Beispiel zeigt, wie Sie die COUNT-Aggregation abrufen.

    function doMyBusinessRule(assigned_to, number) {
  var agg = new GlideAggregate('incident');
  agg.addQuery('assigned_to', assigned_to);
  agg.addQuery('category', number);
  agg.addAggregate("COUNT");
  agg.query();
  var answer = 'false';
  if (agg.next()) {
    answer = agg.getAggregate("COUNT");
    if (answer > 0)
      answer = 'true';
    else
      answer = 'false';
  }
  return answer; 
}

    Dieses Beispiel zeigt die Zusammenfassung eines FX-Währungsfelds.

    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

    Das folgende Beispiel zeigt, wie diese Methode mithilfe eines Attributs in einem dynamischen Attributspeicher aufgerufen wird.

    var ga_Inc = new GlideAggregate('incident');
ga_Inc.groupBy('inc_dynamic_schema->cars->make');
ga_Inc.addAggregate('AVG', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('MIN', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('MAX', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('SUM', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('COUNT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('STDDEV', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cars->cost');
ga_Inc.addAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cars->cost');
ga_Inc.query();
while (ga_Inc.next()) {
    gs.info(gr_Inc.getValue('inc_dynamic_schema->cars->make'));
    gs.info('AVG: ' + ga_Inc.getAggregate('AVG', 'inc_dynamic_schema->cars->cost'));
    gs.info('MAX: ' + ga_Inc.getAggregate('MAX', 'inc_dynamic_schema->cars->cost'));
    gs.info('MIN: ' + ga_Inc.getAggregate('MIN', 'inc_dynamic_schema->cars->cost'));
    gs.info('SUM: ' + ga_Inc.getAggregate('SUM', 'inc_dynamic_schema->cars->cost'));
    gs.info('COUNT: ' + ga_Inc.getAggregate('COUNT', 'inc_dynamic_schema->cars->cost'));
    gs.info('STDDEV: ' + ga_Inc.getAggregate('STDDEV', 'inc_dynamic_schema->cars->cost'));
    gs.info('GROUP_CONCAT: ' + ga_Inc.getAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cars->cost'));
    gs.info('GROUP_CONCAT_DISTINCT: ' + ga_Inc.getAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cars->cost'));
    gs.info('COUNT(DISTINCT: ' + ga_Inc.getAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cars->cost'));
    gs.info(' ');
}

    Ausgabe:

    *** Script: BMW
*** Script: AVG: 31852.066666666667
*** Script: MAX: 49182
*** Script: MIN: 16544
*** Script: SUM: 477781
*** Script: COUNT: 15
*** Script: STDDEV: 10376.50218706
*** Script: GROUP_CONCAT: 16544,18427,19083,22144,24126,27018,32353,34934,35691,35698,35799,36814,41257,48711,49182
*** Script: GROUP_CONCAT_DISTINCT: 16544,18427,19083,22144,24126,27018,32353,34934,35691,35698,35799,36814,41257,48711,49182
*** Script: COUNT(DISTINCT: 15
*** Script:  
*** Script: Ford
*** Script: AVG: 31520.090909090909
*** Script: MAX: 47408
*** Script: MIN: 16080
*** Script: SUM: 346721
*** Script: COUNT: 11
*** Script: STDDEV: 11355.75551388
*** Script: GROUP_CONCAT: 16080,16082,16996,27621,31662,33478,35201,36965,38085,47143,47408
*** Script: GROUP_CONCAT_DISTINCT: 16080,16082,16996,27621,31662,33478,35201,36965,38085,47143,47408
*** Script: COUNT(DISTINCT: 11
*** Script:  
*** Script: Honda
*** Script: AVG: 31972.750000000000
*** Script: MAX: 49187
*** Script: MIN: 15208
*** Script: SUM: 511564
*** Script: COUNT: 16
*** Script: STDDEV: 10240.67632207
*** Script: GROUP_CONCAT: 15208,17926,18365,20942,25557,28215,29090,34336,34857,34969,37144,38097,41541,41805,44325,49187
*** Script: GROUP_CONCAT_DISTINCT: 15208,17926,18365,20942,25557,28215,29090,34336,34857,34969,37144,38097,41541,41805,44325,49187
*** Script: COUNT(DISTINCT: 16
*** Script:  
*** Script: Lexus
*** Script: AVG: 29841.250000000000
*** Script: MAX: 48406
*** Script: MIN: 15517
*** Script: SUM: 238730
*** Script: COUNT: 8
*** Script: STDDEV: 12073.56647214
*** Script: GROUP_CONCAT: 15517,16964,22371,23900,32421,36620,42531,48406
*** Script: GROUP_CONCAT_DISTINCT: 15517,16964,22371,23900,32421,36620,42531,48406
*** Script: COUNT(DISTINCT: 8
*** Script:  
*** Script: Tesla
*** Script: AVG: 30790.000000000000
*** Script: MAX: 45032
*** Script: MIN: 16724
*** Script: SUM: 431060
*** Script: COUNT: 14
*** Script: STDDEV: 8510.068136760580
*** Script: GROUP_CONCAT: 16724,17173,21049,24837,28431,30594,31871,32549,32675,33778,36963,37946,41438,45032
*** Script: GROUP_CONCAT_DISTINCT: 16724,17173,21049,24837,28431,30594,31871,32549,32675,33778,36963,37946,41438,45032
*** Script: COUNT(DISTINCT: 14
*** Script:  
*** Script: Toyota
*** Script: AVG: 32115.444444444444
*** Script: MAX: 49418
*** Script: MIN: 15188
*** Script: SUM: 289039
*** Script: COUNT: 9
*** Script: STDDEV: 12120.76776767
*** Script: GROUP_CONCAT: 15188,16453,24596,28529,32863,34697,42790,44505,49418
*** Script: GROUP_CONCAT_DISTINCT: 15188,16453,24596,28529,32863,34697,42790,44505,49418
*** Script: COUNT(DISTINCT: 9
*** Script:

    Bereichsbezogenes Äquivalent

    Um die getAggregate()-Methode für eine Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getAggregate().

    GlideAggregate – getDynamicAttributeValue(String fullPath)

    Gibt den Wert des dynamischen Attributs zurück, das sich unter einem angegebenen Pfad befindet.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad zum Suchen des gewünschten dynamischen Attributs.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Objekt Wert des dynamischen Attributs, das sich unter dem angegebenen Pfad befindet.

    Wenn der Parameter fullPath ungültige Daten enthält oder der angegebene Attributwert nicht zu den unterstützten Datentypen gehört, wird null zurückgegeben.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var ga_Tab = new GlideAggregate('u_mytable');
ga_Tab.groupBy('u_dyn_attr_store->paint->color');
ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->paint->number');
ga_Tab.query();

while(ga_Tab.next()) {
    gs.info(
        "color: " + ga_Tab.getDynamicAttributeValue('u_dyn_attr_store->paint->color')
        + "  avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->paint->number'));
}
    Ausgabe:
    *** Script: color: blue  avg: 5.0000
*** Script: color: red  avg: 8.0000
*** Script: color: yellow  avg: 7.0000

    GlideAggregate – getDynamicAttributeValue(String dynamicAttributeField, Zeichenfolge groupAttrPath)

    Gibt den Wert des dynamischen Attributs zurück, das sich in einem angegebenen Feld in der aktuellen Tabelle und einem angegebenen Attributpfad befindet.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    dynamischesAttributFeld Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    groupAttrPath Zeichenfolge Attributpfad zum Suchen des zugeordneten dynamischen Schemaattributs.
    Format: "group_name->attr_name"
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group] oder im Feld Gruppe der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    • attr_name: Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „Dynamisches Attribut“ [dynamic_attribute].

    Beispiel: „Auto->Farbe“
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Objekt Wert des dynamischen Attributs, das sich unter dem angegebenen Pfad befindet.

    Wenn einer der Parameter dynamicAttributeField oder groupAttrPath ungültig ist, wird null zurückgegeben.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var ga_Tab = new GlideAggregate('u_mytable');
ga_Tab.groupBy('u_dyn_attr_store->paint->color');
ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->paint->number');
ga_Tab.query();

while(ga_Tab.next()) {
    gs.info(
        "color: " + ga_Tab.getDynamicAttributeValue('u_dyn_attr_store', 'paint->color')
        + "  avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->paint->number'));
}
    Ausgabe:
    *** Script: color: blue  avg: 5.0000
*** Script: color: red  avg: 8.0000
*** Script: color: yellow  avg: 7.0000

    GlideAggregate – getDynamicAttributeDisplayValue(String fullPath)

    Gibt den Anzeigewert des dynamischen Attributs zurück, das sich unter dem angegebenen Pfad befindet.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    fullPath Zeichenfolge Pfad zum Suchen des gewünschten dynamischen Attributs.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anzeigewert des dynamischen Attributs, das sich unter dem angegebenen Pfad befindet.

    Wenn der Parameter fullPath ungültig ist, wird null zurückgegeben.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var ga_Tab = new GlideAggregate('u_mytable');
ga_Tab.groupBy('u_dyn_attr_store->paint->color');
ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->paint->number');
ga_Tab.query();

while(ga_Tab.next()) {
    gs.info(
        "color: " + ga_Tab.getDynamicAttributeDisplayValue('u_dyn_attr_store->paint->color')
        + "  avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->paint->number'));
}
    Ausgabe:
    *** Script: color: blue  avg: 5.0000
*** Script: color: red  avg: 8.0000
*** Script: color: yellow  avg: 7.0000

    GlideAggregate – getDynamicAttributeDisplayValue(String dynamicAttributeField, Zeichenfolge groupAttrPath)

    Gibt den Anzeigewert des dynamischen Attributs zurück, das sich in einem angegebenen Tabellenfeld und Attributpfad befindet.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    dynamischesAttributFeld Zeichenfolge Name des Felds in der Tabelle, das das dynamische Attribut enthält.
    groupAttrPath Zeichenfolge Attributpfad zum Suchen des zugeordneten dynamischen Schemaattributs.
    Format: "group_name->attr_name"
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld Name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group] oder im Feld Gruppe der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    • attr_name: Name des dynamischen Attributs innerhalb der dynamischen Gruppe.

      Tabelle: Im Feld Name der Tabelle „Dynamisches Attribut“ [dynamic_attribute].

    Beispiel: „Auto->Farbe“
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzeigewert des dynamischen Attributs, das sich unter dem angegebenen Pfad befindet.

    Wenn einer der Parameter dynamicAttributeField oder groupAttrPath ungültig ist, wird null zurückgegeben.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var ga_Tab = new GlideAggregate('u_mytable');
ga_Tab.groupBy('u_dyn_attr_store->paint->color');
ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->paint->number');
ga_Tab.query();

while(ga_Tab.next()) {
    gs.info(
        "color: " + ga_Tab.getDynamicAttributeDisplayValue('u_dyn_attr_store', 'paint->color')
        + "  avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->paint->number'));
}
    Ausgabe:
    *** Script: color: blue  avg: 5.0000
*** Script: color: red  avg: 8.0000
*** Script: color: yellow  avg: 7.0000

    GlideAggregate – getQuery()

    Ruft die für die Rückgabe der aktuellen Zusammenfassung erforderliche Abfrage ab.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Abfrage. 
    var agg = new GlideAggregate('incident');
agg.addAggregate('count','category'); 
agg.orderByAggregate('count', 'category'); 
agg.orderBy('category'); 
agg.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(2)'); 
agg.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(2)'); 
agg.query(); 
while (agg.next()) { 
  var category = agg.category;
  var count = agg.getAggregate('count','category');
  var query = agg.getQuery();  
  var agg2 = new GlideAggregate('incident');   
  agg2.addAggregate('count','category');
  agg2.orderByAggregate('count', 'category');
  agg2.orderBy('category');
  agg2.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(3)');
  agg2.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(3)');
  agg2.addEncodedQuery(query);
  agg2.query();
  var last = "";
  while (agg2.next()) {
     last = agg2.getAggregate('count','category');      
  }
  gs.log(category + ": Last month:" + count + " Previous Month:" + last);
 
}

    GlideAggregate – getRowCount()

    Ruft die Anzahl der Zeilen im GlideAggregate-Objekt ab.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. 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

    Bereichsbezogenes Äquivalent

    Um die getRowCount()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Scoped GlideAggregate - getRowCount().

    GlideAggregate – getTotal(String agg, String name)

    Gibt die Anzahl der Datensätze zurück, indem eine Zusammenfassung summiert wird.

    Tabelle : 27. 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 Name des Feldes, das zusammengefasst werden soll.
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der Datensätze. 
    var incidentGA = new GlideAggregate('incident');
incidentGA.addQuery('category', 'software'); 
incidentGA.addAggregate('COUNT');  
incidentGA.addTrend('opened_at','year'); // Counting number of incidents for software category per year
incidentGA.setGroup(false);
incidentGA.query();
while(incidentGA.next()){
  gs.info('Incidents opened on year - '+incidentGA.getValue('timeref')+' - '+incidentGA.getAggregate('COUNT'));
}
gs.info('Total Aggregate Value >> '+ incidentGA.getTotal('COUNT'));

    Ausgabe:

    Incidents opened on year - 2015 - 1
Incidents opened on year - 2018 - 5
Incidents opened on year - 2020 - 10
Total Aggregate Value >> 16

    GlideAggregate – getValue(String name)

    Gibt den Wert eines Felds oder eines dynamischen Attributs zurück.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Feldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].
    Tabelle : 30. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert des angegebenen Felds. Gibt null zurück, wenn ungültig (nicht Teil des Ergebnissatzes). 
    var trend = new GlideAggregate('incident');
trend.addTrend ('opened_at','Month');
trend.addAggregate('COUNT');

//addHaving limits the results returned to those in which the aggregate COUNT is greater than 2
trend.addHaving('COUNT', '>', '2');
trend.setGroup(false);
trend.query();
while(trend.next()) {
  gs.print(('Incidents by month ' + trend.getValue('timeref') + ' where count is more than 2 count is: ' + trend.getAggregate('COUNT'));
}

    Ausgabe:

    Incidents by month 9/2018 where count is more than 2 count is: 3
Incidents by month 10/2018 where count is more than 2 count is: 8
Incidents by month 11/2018 where count is more than 2 count is: 14

    Bereichsbezogenes Äquivalent

    Um die getValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getValue().

    GlideAggregate – groupBy(String name)

    Stellt den Namen eines Felds oder eines Attributs in einem dynamischen Attributspeicher bereit, das beim Gruppieren der Aggregate verwendet werden soll.

    Kann mehrfach aufgerufen werden, um mehrere Gruppenfelder festzulegen.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Feldname oder Pfad zu einem Attribut in einem dynamischen Attributspeicher.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.
    Tabelle : 32. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird.

    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.log(category + " Update counts: MIN = " + min + " MAX = " + max + " AVG = " + avg);
}

    Das folgende Beispiel zeigt, wie diese Methode mithilfe eines Attributs in einem dynamischen Attributspeicher aufgerufen wird.

    var ga_AppTab = new GlideAggregate('application_table');
ga_AppTab.addGroupBy('dyn_att_field->group->attr');
ga_AppTab.addAggregate('AVG', 'dyn_att_field->group->attr1');
ga_AppTab.addHaving('SUM', 'dyn_att_field->group->attr2', '>=', 420);
ga.query();

    Bereichsbezogenes Äquivalent

    Um die groupBy()-Methode zu in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: groupBy().

    GlideAggregate – orderBy(String name)

    Ordnet die Aggregate anhand des Werts des angegebenen Felds, dynamischen Attributpfads oder der GlideFunktion. Das Feld wird auch der Liste „Gruppieren nach“ hinzugefügt.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Feldname, Pfad zu einem Attribut in einem dynamischen Attributspeicher oder GlideFunktion zum Sortieren der Aggregate.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.

    glidefunction-Format: glidefunction:length(short_description). Weitere Informationen zu Glidefunktionen finden Sie unter Glidefunktions-Operationen.
    Tabelle : 34. Rückgaben
    Typ Beschreibung
    Keine 
    var agg = new GlideAggregate('incident');
agg.addAggregate('count','category'); 
agg.orderByAggregate('count', 'category'); 
agg.orderBy('category'); 
agg.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(2)'); 
agg.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(2)'); 
agg.query(); 
while (agg.next()) { 
  var category = agg.category;
  var count = agg.getAggregate('count','category');
  var query = agg.getQuery();  
  var agg2 = new GlideAggregate('incident');   
  agg2.addAggregate('count','category');
  agg2.orderByAggregate('count', 'category');
  agg2.orderBy('category');
  agg2.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(3)');
  agg2.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(3)');
  agg2.addEncodedQuery(query);
  agg2.query();
  var last = "";
  while (agg2.next()) {
     last = agg2.getAggregate('count','category');      
  }
  gs.log(category + ": Last month:" + count + " Previous Month:" + last);
}

    Bereichsbezogenes Äquivalent

    Um die orderBy()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: orderBy().

    GlideAggregate – orderByAggregate(String agg, String fieldName)

    Sortiert die Aggregate basierend auf dem angegebenen Aggregat und Feld oder dynamischen Attribut.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    agg Zeichenfolge Zusammenfassungstyp.
    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.
    fieldName Zeichenfolge Name des Felds oder Pfad zu einem Attribut in einem dynamischen Attributspeicher zum Aggregieren.
    Format des dynamischen Pfads: dyn_att_field->group_name->attribute_name
    • dyn_att_field: Name eines dynamischen Attributspeicherfelds in der Tabelle.
    • group_name: Name der Gruppe, der dieses Attribut zugeordnet ist.

      Tabelle: Im Feld group_name der Tabelle „Dynamische Attributgruppe“ [dynamic_attribute_group]

    • attr_name: Name des dynamischen Attributs.

      Tabelle: Im Attributfeld der Tabelle „Dynamische Attributtabelle“ [dynamic_attribute].

    Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamic Schema.
    Tabelle : 36. Rückgaben
    Typ Beschreibung
    Keine 
    var agg = new GlideAggregate('incident');
agg.addAggregate('count','category'); 
agg.orderByAggregate('count', 'category'); 
agg.orderBy('category'); 
agg.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(2)'); 
agg.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(2)'); 
agg.query(); 
while (agg.next()) { 
  var category = agg.category;
  var count = agg.getAggregate('count','category');
  var query = agg.getQuery();  
  var agg2 = new GlideAggregate('incident');   
  agg2.addAggregate('count','category');
  agg2.orderByAggregate('count', 'category');
  agg2.orderBy('category');
  agg2.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(3)');
  agg2.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(3)');
  agg2.addEncodedQuery(query);
  agg2.query();
  var last = "";
  while (agg2.next()) {
     last = agg2.getAggregate('count','category');      
  }
  gs.log(category + ": Last month:" + count + " Previous Month:" + last);
 
}

    Bereichsbezogenes Äquivalent

    Um die orderByAggregate()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: orderByAggregate().

    GlideAggregate – query()

    Gibt die Abfrage aus und ruft die Ergebnisse ab.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    Keine 
    var agg = new GlideAggregate('incident');
agg.addAggregate('count','category'); 
agg.orderByAggregate('count', 'category'); 
agg.orderBy('category'); 
agg.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(2)'); 
agg.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(2)'); 
agg.query(); 
while (agg.next()) { 
  var category = agg.category;
  var count = agg.getAggregate('count','category');
  var query = agg.getQuery();  
  var agg2 = new GlideAggregate('incident');   
  agg2.addAggregate('count','category');
  agg2.orderByAggregate('count', 'category');
  agg2.orderBy('category');
  agg2.addQuery('opened_at', '>=', 'javascript:gs.monthsAgoStart(3)');
  agg2.addQuery('opened_at', '<=', 'javascript:gs.monthsAgoEnd(3)');
  agg2.addEncodedQuery(query);
  agg2.query();
  var last = "";
  while (agg2.next()) {
     last = agg2.getAggregate('count','category');      
  }
  gs.log(category + ": Last month:" + count + " Previous Month:" + last);

    Bereichsbezogenes Äquivalent

    Um die query()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: query().

    GlideAggregate - setAggregateWindow(Number firstRow, Nummer lastRow)

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

    Tabelle : 39. 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 : 40. 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

    Bereichsbezogenes Äquivalent

    Um die Methode setAggregateWindow() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setAggregateWindow().

    GlideAggregate – setGroup(Boolean b)

    Legt fest, ob die Ergebnisse gruppiert werden sollen.

    Tabelle : 41. 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 : 42. Rückgaben
    Typ Beschreibung
    Keine 
    var ga = new GlideAggregate('incident');
ga.addAggregate('COUNT', 'category');
 
ga.setGroup(true);

    Bereichsbezogenes Äquivalent

    Um die setGroup()-Methode in einer Bereichsanwendung zu verwenden, vernwenden Sie die entsprechende Bereichsmethode: setGroup().

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

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

    Bereichsbezogenes Äquivalent

    Um die Methode setIntervalYearIncluded() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setIntervalYearIncluded().