---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideAggregate - 범위 지정됨

# GlideAggregate - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 30분

GlideAggregate API를 사용하면 데이터베이스 집계 쿼리를 만들 수 있습니다.

GlideAggregate 클래스는 GlideRecord 클래스의 확장이며 데이터베이스 집계(AVG, COUNT, GROUP_CONCAT, GROUP_CONCAT_DISTINCT, MAX, MIN, STDDEV, SUM) 쿼리를 제공합니다. 이 기능은 사용자 지정 보고서를 만들거나 계산된 필드를 계산할 때 유용할 수 있습니다.

통화 또는 가격 필드에서 GlideAggregate 메서드를 사용하는 경우 기준 통화 값으로 작업하게 됩니다. 표시할 사용자의 세션 통화로 집계 값을 변환해야 합니다. 통화 또는 가격 값(표시된 값)과 기준 [통화](https://www.servicenow.com/docs/access?context=currency&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 값(집계 값) 간의 환산율이 변경될 수 있기 때문에 결과가 사용자가 예상한 것과 다를 수 있습니다.  
주:  
온프레미스 시스템을 사용하는 경우 이 클래스가 제대로 작동하려면 데이터베이스 서버 시간대를 GMT/UTC로 설정해야 합니다.

## 범위 지정된 GlideAggregate - GlideAggregate(String tableName) {#ariaid-title2}

지정된 테이블에 GlideAggregate 객체를 작성합니다.
{#r_ScopedGlideAggregateGlideAggregate_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 테이블의 이름입니다. |
[표 1. 매개변수]

{#r_ScopedGlideAggregateGlideAggregate_String__table_vy2_525_jq}  

    var count = new GlideAggregate('incident');

## 범위 지정된 GlideAggregate - addAggregate(문자열 집계, 문자열 이름) {#ariaid-title3}

데이터베이스 쿼리에 집계를 추가합니다.
{#r_ScopedGlideAggregateAddAggregate_String_String__id_zgs_fl2_4nb__entry__3}{#r_ScopedGlideAggregateAddAggregate_String_String__agg-GlideAgg-row}

| 이름 | 유형 | 설명 |
|-|-|-|
| 집계 | 문자열 | 사용할 집계의 이름입니다. 유효한 값은 다음과 같습니다. * AVG: 표현식의 평균 값입니다. * COUNT: null이 아닌 값의 개수. * GROUP_CONCAT: 그룹의 null이 아닌 모든 값을 오름차순으로 연결하고 쉼표(',')로 결합한 다음 결과를 문자열로 반환합니다. * GROUP_CONCAT_DISTINCT: 그룹의 null이 아닌 모든 값을 오름차순으로 연결하고, 중복을 제거하고, 쉼표(',')로 결합하고, 결과를 문자열로 반환합니다. * MAX: 가장 큰 값 또는 최대값. * MIN: 최소값. * STDDEV: 모집단 표준 편차. * SUM: 모든 값의 합계입니다. |
| 이름 | 문자열 | 옵션입니다. 집계 결과를 그룹화할 필드의 이름입니다. 기본값: Null |
[표 2. 매개변수]

{#r_ScopedGlideAggregateAddAggregate_String_String__id_zgs_fl2_4nb} {#r_ScopedGlideAggregateAddAggregate_String_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#r_ScopedGlideAggregateAddAggregate_String_String__table_qpt_3f5_jq1}  
다음 예는 인시던트 \[incident\] 테이블에서 GlideAggregate 함수를 사용하는 방법을 보여줍니다.

    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(' ');
    }

출력.

    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

## 범위 지정된 GlideAggregate - addEncodedQuery(문자열 쿼리) {#ariaid-title4}

이 집계에 대해 설정되었을 수 있는 다른 쿼리에 인코딩된 쿼리를 추가합니다.
{#r_ScopedGlideAggregateAddEncodedQuery_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 쿼리 | 문자열 | 집계에 추가할 인코딩된 쿼리입니다. |
[표 4. 매개변수]

{#r_ScopedGlideAggregateAddEncodedQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddEncodedQuery_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#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);

## 범위 지정된 GlideAggregate - addQuery(문자열 이름, 문자열 연산자, 문자열 값) {#ariaid-title5}

집계에 쿼리를 추가합니다.
{#r_ScopedGlideAggregateAddQuery_String_String_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 추가할 쿼리입니다. |
| 운영자 | 문자열 | 쿼리에 대한 연산자입니다. |
| 값 | 문자열 | 쿼리에 포함할 값의 목록입니다. |
[표 6. 매개변수]

{#r_ScopedGlideAggregateAddQuery_String_String_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddQuery_String_String_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| GlideQueryCondition | 쿼리 조건입니다. |
[표 7. 반환]

{#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);
    }

출력:

    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

## 범위 지정된 GlideAggregate - addNotNullQuery(String fieldName) {#ariaid-title6}

집계에 null이 아닌 쿼리를 추가합니다.
{#r_ScopedGlideAggregateAddNotNullQuery_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필드 이름 | 문자열 | 필드의 이름입니다. |
[표 8. 매개변수]

{#r_ScopedGlideAggregateAddNotNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddNotNullQuery_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| GlideQueryCondition | 범위가 지정된 쿼리 조건입니다. |
[표 9. 반환]

{#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
      }

## 범위 지정된 GlideAggregate - addNullQuery(String fieldName) {#ariaid-title7}

집계에 null 쿼리를 추가합니다.
{#r_ScopedGlideAggregateAddNullQuery_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| fieldName | 문자열 | 필드의 이름입니다. |
[표 10. 매개변수]

{#r_ScopedGlideAggregateAddNullQuery_String__table_vy2_525_jq} {#r_ScopedGlideAggregateAddNullQuery_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| GlideQueryCondition | 범위가 지정된 쿼리 조건입니다. |
[표 11. 반환]

{#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
      }

## 범위 지정 GlideAggregate - addTrend(String fieldName, String timeInterval, Number numUnits) {#ariaid-title8}

지정된 필드에 대한 추세를 추가합니다. 추세를 사용하여 일정 기간 동안의 패턴을 표시합니다.
주:  
결과를 연도별로 그룹화 dayofweek 할지 여부를 제어하려면 을 사용합니다 [범위 지정된 GlideAggregate - setIntervalYearIncluded(부울 b)](https://servicenow-prod.fluidtopics.net/yFmUVNHmJasWThEBKTdGiw#ScopedGlAgg-setIntervalYearInclu_B "요일 추세에 대해 결과를 연도별로 그룹화할지 여부를 설정합니다. 이러한 추세는 시간 간격과 dayofweek 함께 addTrend() 메서드를 사용하여 생성됩니다.").
{#r_ScopedGlideAggAddTrend_S_S__table_tlk_cdk_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| fieldName | 문자열 | 추세가 발생해야 하는 필드의 이름입니다. |
| timeInterval (시간 간격) | 문자열 | 추세의 시간 간격입니다. 유효한 값은 다음과 같습니다. * 날짜 * dayofweek * 시간 * 분 * 분기 * 값 * 주 * 년 {#r_ScopedGlideAggAddTrend_S_S__ul_rm5_xqq_gnb} |
| numUnits (숫자 단위) | 번호 | 옵션입니다. = 분인 경우에만 timeInterval 유효합니다. 추세에 포함할 시간(분)입니다. 기본값: 1 |
[표 12. 매개변수]

{#r_ScopedGlideAggAddTrend_S_S__table_tlk_cdk_ws} {#r_ScopedGlideAggAddTrend_S_S__table_frl_fqd_3z__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 13. 반환]

{#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')]);
    }

출력:

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

## 범위 지정된 GlideAggregate - getAggregate(문자열 집계, 문자열 이름) {#ariaid-title9}

현재 기록에서 집계 값을 반환합니다.
{#r_ScopedGlideAggregateGetAggregate_String_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 집계 | 문자열 | 집계의 유형입니다. 유효한 값은 다음과 같습니다. * AVG: 표현식의 평균 값입니다. * COUNT: null이 아닌 값의 개수. * GROUP_CONCAT: 그룹의 null이 아닌 모든 값을 오름차순으로 연결하고 쉼표(',')로 결합한 다음 결과를 문자열로 반환합니다. * GROUP_CONCAT_DISTINCT: 그룹의 null이 아닌 모든 값을 오름차순으로 연결하고, 중복을 제거하고, 쉼표(',')로 결합하고, 결과를 문자열로 반환합니다. * MAX: 가장 큰 값 또는 최대값. * MIN: 최소값. * STDDEV: 모집단 표준 편차. * SUM: 모든 값의 합계입니다. |
| 이름 | 문자열 | 집계를 수행할 필드의 이름입니다. |
[표 14. 매개변수]

{#r_ScopedGlideAggregateGetAggregate_String_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGetAggregate_String_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 집계의 값입니다. 집계되는 값이 FX 통화 값인 경우 반환되는 값은 \<currency_code 형식입니다 `. currency_value>` 예: USD; 134.980000입니다. 주: 지정된 필드에 혼합 통화 유형의 FX 통화 값이 포함되어 있는 경우 메서드는 값을 집계할 수 없으며 세미콜론(;)을 반환합니다. |
[표 15. 반환]

{#r_ScopedGlideAggregateGetAggregate_String_String__table_qpt_3f5_jq}  
인시던트 테이블의 기록 수를 반환하는 집계를 표시합니다.

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

출력: 인시던트 수: 63.  
FX 통화 필드의 집계를 표시합니다.

    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'));
    }

출력:

    *** 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

## 범위 지정된 GlideAggregate - getAggregateEncodedQuery() {#ariaid-title10}

현재 집계를 반환하는 데 필요한 쿼리를 가져옵니다.
{#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 16. 매개변수]

{#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateGetAggregateEncodedQuery__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 집계를 가져오기 위해 인코딩된 쿼리입니다. |
[표 17. 반환]

{#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());
    }

출력:

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

## 범위 지정된 GlideAggregate - getEncodedQuery() {#ariaid-title11}

인코딩된 쿼리를 검색합니다.
{#r_ScopedGlideAggregateGetEncodedQuery__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 18. 매개변수]

{#r_ScopedGlideAggregateGetEncodedQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateGetEncodedQuery__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 인코딩된 쿼리입니다. |
[표 19. 반환]

{#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());

출력:

    ORDERBYcategory^GROUPBYcategory

## 범위가 지정된 GlideAggregate - getRowCount() {#ariaid-title12}

GlideAggregate 객체의 행 수를 검색합니다.
{#r_ScopedGlideAggregateGetRowCount__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 20. 매개변수]

{#r_ScopedGlideAggregateGetRowCount__table_vy2_535_jq} {#r_ScopedGlideAggregateGetRowCount__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | GlideAggregate 객체의 행 수입니다. |
[표 21. 반환]

{#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);
      }

출력:

    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

## 범위가 지정된 GlideAggregate - getTableName() {#ariaid-title13}

이 GlideAggregate 객체와 연결된 테이블 이름을 조회합니다.
{#r_ScopedGlideAggregateGetTableName__table_vc2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 22. 매개변수]

{#r_ScopedGlideAggregateGetTableName__table_vc2_525_jq} {#r_ScopedGlideAggregateGetTableName__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 테이블 이름입니다. |
[표 23. 반환]

{#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());

## 범위 지정된 GlideAggregate - getValue(문자열 이름) {#ariaid-title14}

지정된 필드의 값을 반환합니다.
{#r_ScopedGlideAggregateGetValue_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 반환하려는 현재 테이블 내의 필드 이름입니다. |
[표 24. 매개변수]

{#r_ScopedGlideAggregateGetValue_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGetValue_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 필드의 값입니다. 잘못된 경우(결과 집합의 일부가 아님) null을 반환합니다. |
[표 25. 반환]

{#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");  
    }

출력:

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

## 범위 지정된 GlideAggregate - groupBy(문자열 이름) {#ariaid-title15}

집계를 그룹화하는 데 사용할 필드의 이름을 제공합니다.
여러 그룹 필드를 설정하기 위해 여러 번 호출될 수 있습니다.
{#r_ScopedGlideAggregateGroupBy_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 필드의 이름입니다. |
[표 26. 매개변수]

{#r_ScopedGlideAggregateGroupBy_String__table_vy2_525_jq} {#r_ScopedGlideAggregateGroupBy_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 27. 반환]

{#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);
    }

출력:

    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

## 범위가 지정된 GlideAggregate - hasNext() {#ariaid-title16}

GlideAggregate 객체에 기록이 더 있는지 확인합니다.
{#r_ScopedGlideAggregateHasNext__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 28. 매개변수]

{#r_ScopedGlideAggregateHasNext__table_vy2_535_jq} {#r_ScopedGlideAggregateHasNext__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 쿼리 세트에 더 많은 결과가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 쿼리 세트에 더 많은 결과가 있습니다. * false: 쿼리 집합에 더 이상 결과가 없습니다. {#r_ScopedGlideAggregateHasNext__ul_bkh_hhc_dtb} |
[표 29. 반환]

{#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);
    }

출력:

    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

## 범위가 지정된 GlideAggregate - next() {#ariaid-title17}

GlideAggregate의 다음 기록으로 이동합니다.
{#r_ScopedGlideAggregateNext__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 30. 매개변수]

{#r_ScopedGlideAggregateNext__table_vy2_535_jq} {#r_ScopedGlideAggregateNext__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 쿼리 세트에 더 많은 결과가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 쿼리 세트에 더 많은 결과가 있습니다. * false: 쿼리 집합에 더 이상 결과가 없습니다. {#r_ScopedGlideAggregateNext__ul_bkh_hhc_dtb} |
[표 31. 반환]

{#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);
    }

## 범위 지정된 GlideAggregate - orderBy(문자열 이름) {#ariaid-title18}

지정된 필드의 값을 사용하여 집계를 정렬합니다. 필드는 그룹 기준 목록에도 추가됩니다.
{#r_ScopedGlideAggregateOrderBy_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 집계를 정렬할 필드의 이름입니다. 또는 `glidefunction:length(short_description)와 같은 glidefunction을` 제공하여 집계를 정렬할 수 있습니다. Glide 기능에 대한 자세한 내용은 [Glidefunction 작업을](https://www.servicenow.com/docs/access?context=platform-support-functions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 참조하십시오. |
[표 32. 매개변수]

{#r_ScopedGlideAggregateOrderBy_String__table_vy2_525_jq} {#r_ScopedGlideAggregateOrderBy_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 33. 반환]

{#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);
    }

출력:

    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

## 범위 지정된 GlideAggregate - orderByAggregate(String agg, String fieldName) {#ariaid-title19}

지정된 집계 및 필드를 기준으로 집계를 정렬합니다.
{#r_ScopedGlideAggregateOrderByAggregate_String_String__table_ikq_hwt_vr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 집계 | 문자열 | 집계 유형입니다. |
| fieldName | 문자열 | 집계할 필드의 이름입니다. |
[표 34. 매개변수]

{#r_ScopedGlideAggregateOrderByAggregate_String_String__table_ikq_hwt_vr} {#r_ScopedGlideAggregateOrderByAggregate_String_String__table_jkq_hwt_vr__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 35. 반환]

{#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'));
    }

출력:

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

## 범위 지정된 GlideAggregate - orderByDesc(문자열 이름) {#ariaid-title20}

지정된 필드를 기준으로 집계를 내림차순으로 정렬합니다. 필드가 그룹 기준 목록에도 추가됩니다.
{#r_ScopedGlideAggregateOrderByDesc_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 필드의 이름입니다. |
[표 36. 매개변수]

{#r_ScopedGlideAggregateOrderByDesc_String__table_vy2_525_jq} {#r_ScopedGlideAggregateOrderByDesc_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 37. 반환]

{#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);
    }

출력:

    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

## 범위가 지정된 GlideAggregate - query() {#ariaid-title21}

쿼리를 실행하고 결과를 가져옵니다.
{#r_ScopedGlideAggregateQuery__table_vy2_535_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 38. 매개변수]

{#r_ScopedGlideAggregateQuery__table_vy2_535_jq} {#r_ScopedGlideAggregateQuery__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 39. 반환]

{#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);

## 범위 지정된 GlideAggregate - setAggregateWindow(Number firstRow, Number lastRow) {#ariaid-title22}

집계 쿼리에 포함할 테이블의 행 수를 제한합니다.
{#ScopedGlAgg-setAggregateWindow_N_N__section_tjk_kfm_gtb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 첫 번째 행 | 번호 | 집계 쿼리에 포함할 첫 번째 행의 인덱스(0부터 시작)입니다. |
| lastRow (마지막 행) | 번호 | 집계 쿼리에 포함할 마지막 행의 인덱스(0부터 시작)입니다(제외). |
[표 40. 매개변수]

{#ScopedGlAgg-setAggregateWindow_N_N__table_orv_jcm_gtb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 41. 반환]

{#ScopedGlAgg-setAggregateWindow_N_N__table_orv_jcm_gtb}  
인시던트 \[incident\] 테이블의 처음 10개 기록에 대한 각 범주의 카운트를 인쇄합니다.

    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]);
    }

출력:

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

## 범위 지정된 GlideAggregate - setGroup(부울 b) {#ariaid-title23}

반환 결과를 그룹화할지 여부를 설정합니다.
{#r_ScopedGlideAggregateSetGroup_Boolean__table_w24_dxt_vr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| b | 부울 | 결과를 그룹화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 결과를 그룹화합니다. * false: 결과를 그룹화하지 않습니다. {#r_ScopedGlideAggregateSetGroup_Boolean__ul_ylw_phc_dtb} |
[표 42. 매개변수]

{#r_ScopedGlideAggregateSetGroup_Boolean__table_w24_dxt_vr} {#r_ScopedGlideAggregateSetGroup_Boolean__table_x24_dxt_vr__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 43. 반환]

{#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'));
      }

출력:

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

## 범위 지정된 GlideAggregate - setIntervalYearIncluded(부울 b) {#ariaid-title24}

요일 추세에 대해 결과를 연도별로 그룹화할지 여부를 설정합니다. 이러한 추세는 시간 간격과 dayofweek 함께 addTrend() 메서드를 사용하여 생성됩니다.
종속성: [범위 지정 GlideAggregate - addTrend("\<fieldName\>", "dayofweek").](https://servicenow-prod.fluidtopics.net/yFmUVNHmJasWThEBKTdGiw#r_ScopedGlideAggAddTrend_S_S "지정된 필드에 대한 추세를 추가합니다. 추세를 사용하여 일정 기간 동안의 패턴을 표시합니다.")
{#ScopedGlAgg-setIntervalYearInclu_B__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| b | 부울 | 요일 시간 간격이 있는 추세에 연도를 포함할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 연도별로 요일 결과를 그룹화합니다. * false: 시간 간격 결과에서 연도를 제외합니다. {#ScopedGlAgg-setIntervalYearInclu_B__ul_uz2_dph_gzb} 기본값: true |
[표 44. 매개변수]

{#ScopedGlAgg-setIntervalYearInclu_B__table_orv_jcm_gtb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 45. 반환]

{#ScopedGlAgg-setIntervalYearInclu_B__table_orv_jcm_gtb}  
다음 예에서는 지난 6개월 동안 생성된 인시던트를 계산하는 방법을 보여 줍니다. 인시던트는 요일로 구분되지만 연도는 포함되지 않습니다. 예를 들어 목요일의 기본 결과에는 연도가 포함됩니다(예: `Thursday/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'))};

출력:

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