--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # GlideAggregate - グローバル # GlideAggregate - グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：67分 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=australia&pubname=australia-platform-administration&ft:locale=en-US) 値 (集計値) との間の換算レートが変化する可能性があるため、結果がユーザーの期待と異なる場合があります。 この API を使用して動的属性を作成するには、dynamic_schema_writer ロールが必要です。この API を使用して動的データを読み取るには、dynamic_schema_reader ロールが必要です。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 注: オンプレミスシステムを使用する場合、このクラスを正しく機能させるには、データベースサーバーのタイムゾーンを GMT/UTC に設定する必要があります。 ## GlideAggregate - addAggregate(文字列集計, 文字列名) {#ariaid-title2} 集計をデータベースクエリに追加します。 {#r_GlideAggregate-addAggregate_String_String__id_zgs_fl2_4nb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 集計 | 文字列 | 使用するアグリゲートの名前。 有効な値： * AVG:式の平均値。 * COUNT:null 以外の値の数。 * GROUP_CONCAT:グループのすべての非 null 値を昇順で連結し、カンマ (',') で結合して、結果を文字列として返します。 * GROUP_CONCAT_DISTINCT:グループのすべての非 null 値を昇順で連結し、重複を削除してカンマ (',') で結合し、結果を文字列として返します。 * MAX:最大値。 * MIN:最小値。 * STDDEV:母集団の標準偏差。 * SUM:すべての値の合計。 | | name | 文字列 | フィールド名はオプションです。集計結果をグループ化するフィールドの名前、または動的属性ストア内の属性へのパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-addAggregate_String_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 デフォルト：Null | [表 : 1. パラメーター] {#r_GlideAggregate-addAggregate_String_String__id_zgs_fl2_4nb} {#r_GlideAggregate-addAggregate_String_String__table_kzm_kck_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 2. 返される内容] {#r_GlideAggregate-addAggregate_String_String__table_kzm_kck_ws} 次の例は、インシデント \[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 次の例は、動的属性ストアの属性を使用してこのメソッドを呼び出す方法を示しています。 var ga_Inc = new GlideAggregate('incident'); ga_Inc.groupBy('inc_dynamic_schema->make'); ga_Inc.addAggregate('AVG', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('MIN', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('MAX', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('SUM', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('COUNT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('STDDEV', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cost'); ga_Inc.query(); while (ga_Inc.next()) { gs.info(gr_Inc.getValue('inc_dynamic_schema->make')); gs.info('AVG: ' + ga_Inc.getAggregate('AVG', 'inc_dynamic_schema->cost')); gs.info('MAX: ' + ga_Inc.getAggregate('MAX', 'inc_dynamic_schema->cost')); gs.info('MIN: ' + ga_Inc.getAggregate('MIN', 'inc_dynamic_schema->cost')); gs.info('SUM: ' + ga_Inc.getAggregate('SUM', 'inc_dynamic_schema->cost')); gs.info('COUNT: ' + ga_Inc.getAggregate('COUNT', 'inc_dynamic_schema->cost')); gs.info('STDDEV: ' + ga_Inc.getAggregate('STDDEV', 'inc_dynamic_schema->cost')); gs.info('GROUP_CONCAT: ' + ga_Inc.getAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cost')); gs.info('GROUP_CONCAT_DISTINCT: ' + ga_Inc.getAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cost')); gs.info('COUNT(DISTINCT: ' + ga_Inc.getAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cost')); gs.info(' '); } 出力： *** 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: ### スコープ対応 {#r_GlideAggregate-addAggregate_String_String__section_emz_mjr_mcb} スコープ対象のアプリケーションで addAggregate() メソッドを使用するには、対応するスコープ対象のメソッド [addAggregate()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateAddAggregate_String_String "集計をデータベースクエリに追加します。") を使用します。 ## GlideAggregate - addBizCalendarTrend(文字列 fieldName, 文字列 bizCalendarSysId) {#ariaid-title3} ビジネスカレンダーによる傾向をアグリゲートクエリに追加します。このメソッドを使用すると、指定されたビジネスカレンダーのタイムスパンに基づいて、対応する GlideRecord とグループレコードの日付と時刻のフィールドを選択できます。 注: このメソッドは、SQL クエリで JOIN 演算子を使用しません。 {#GlideAgg-addBizCalendarTrend_S_S__table_opp_y5l_lyb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | レコードを含めるグループまたはカレンダーのタイムスパンを決定するために使用する、関連する GlideRecord の日付と時刻のフィールド。 | | bizCalendarSysID | 文字列 | 使用するカレンダーレコードのSys_id。これは、目的のタイムスパンを含むカレンダーです。 | [表 : 3. パラメーター] {#GlideAgg-addBizCalendarTrend_S_S__table_opp_y5l_lyb} {#GlideAgg-addBizCalendarTrend_S_S__table_ppp_y5l_lyb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 4. 返される内容] {#GlideAgg-addBizCalendarTrend_S_S__table_ppp_y5l_lyb} 次のコード例は、「月」ビジネスカレンダーのタイムスパン別にグループ化されたインシデントレコードの数を示しています。 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')); } 出力: 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(文字列クエリ) {#ariaid-title4} このアグリゲートに設定されている可能性がある他のクエリに、エンコードされたクエリを追加します。 {#r_GlideAggregate-addEncodedQuery_String__table_vbj_r1k_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | query | 文字列 | アグリゲートに追加するエンコードされたクエリ文字列。 | [表 : 5. パラメーター] {#r_GlideAggregate-addEncodedQuery_String__table_vbj_r1k_ws} {#r_GlideAggregate-addEncodedQuery_String__table_wbj_r1k_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 6. 返される内容] {#r_GlideAggregate-addEncodedQuery_String__table_wbj_r1k_ws} 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); } ### スコープ対応 {#r_GlideAggregate-addEncodedQuery_String__section_t1m_sjr_mcb} スコープ対象のアプリケーションで addEncodedQuery() メソッドを使用するには、対応するスコープ対象のメソッド [addEncodedQuery()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateAddEncodedQuery_String "このアグリゲートに設定されている可能性がある他のクエリに、エンコードされたクエリを追加します。") を使用します。 ## GlideAggregate - addHaving(文字列名, 文字列演算子, 文字列値) {#ariaid-title5} select category, count(\*) from incident group by category HAVING count(\*) \> 5 など、アグリゲートに「having」要素を追加します。 {#r_GlideAggregate-addHaving_String_String_String__table_asq_nbk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | name | 文字列 | フィルターを適用するアグリゲート。たとえば、COUNT です。 | | オペレーター | 文字列 | 演算子記号。たとえば、\<、\>、=、!= などです。 | | value | 文字列 | クエリ対象の値。たとえば、「5」です。 | [表 : 7. パラメーター] {#r_GlideAggregate-addHaving_String_String_String__table_asq_nbk_ws} {#r_GlideAggregate-addHaving_String_String_String__table_bsq_nbk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 8. 返される内容] {#r_GlideAggregate-addHaving_String_String_String__table_bsq_nbk_ws} 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')); } 出力: 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, String operator, String value) {#ariaid-title6} select category, count(\*) from incident group by category HAVING count(\*) \> 5 など、アグリゲートに「having」要素を追加します。このメソッドの実装により、テーブル内の特定のフィールド、または動作する動的属性を指定できます。 {#GlideAgg-addHaving_S_S_S_S__table_asq_nbk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | aggName | 文字列 | フィルターを適用するアグリゲート。 たとえば、COUNT です。 | | fieldName | 文字列 | 動的属性ストア内の属性へのフィールド名またはパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#GlideAgg-addHaving_S_S_S_S__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | | オペレーター | 文字列 | 演算子記号。 たとえば、\<、\>、=、!= などです。 | | value | 文字列 | クエリ対象の値。 たとえば、「5」です。 | [表 : 9. パラメーター] {#GlideAgg-addHaving_S_S_S_S__table_asq_nbk_ws} {#GlideAgg-addHaving_S_S_S_S__table_bsq_nbk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 10. 返される内容] {#GlideAgg-addHaving_S_S_S_S__table_bsq_nbk_ws} 次のコード例は、 addHaving() メソッド呼び出しのフィールド名を使用して cmdb テーブル内の重複するシリアル番号を特定する方法を示しています。 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)); 出力: 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 次の例は重複を識別する方法を示していますが、 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->attr"; gs.print(getDupes(tableName, dpField)); 出力: 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(文字列 fieldName, 文字列 timeInterval, 数値 numUnits) {#ariaid-title7} フィールドの傾向を追加します。傾向を使用して、一定期間のパターンを示します。 注: dayofweek結果を年別にグループ化するかどうかを制御するには、[GlideAggregate:setIntervalYearIncluded(ブール、b)](https://servicenow-prod.fluidtopics.net/Trvd9P7TvM~3rU09ZsmVJA#GlideAgg-setIntervalYearIncluded_B "曜日の傾向の結果を年別にグループ化するかどうかを設定します。これらの傾向は、dayofweek時間間隔の addTrend() メソッドを使用して作成されます。") を使用します。 {#r_GlideAggregate-addTrend_String_String__table_tlk_cdk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 傾向が発生するフィールドの名前。 | | 時間間隔 | 文字列 | 傾向の時間間隔。 有効な値： * date * 曜日 * 時間 * 分 * 四半期 * value * 週 * 年 {#r_GlideAggregate-addTrend_String_String__ul_rm5_xqq_gnb} | | 単位数 | 番号 | オプション。timeInterval = 分の場合にのみ有効です。傾向に含める分数。 デフォルト値：1 | [表 : 11. パラメーター] {#r_GlideAggregate-addTrend_String_String__table_tlk_cdk_ws} {#r_GlideAggregate-addTrend_String_String__table_ulk_cdk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 12. 返される内容] {#r_GlideAggregate-addTrend_String_String__table_ulk_cdk_ws} 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')); } 出力: 9/2018: 3 10/2018: 8 11/2018: 14 ### スコープ対応 {#r_GlideAggregate-addTrend_String_String__section_c5j_trd_3z} スコープ対象のアプリケーションで addTrend() メソッドを使用するには、対応するスコープ対象のメソッド [addTrend()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggAddTrend_S_S "指定されたフィールドの傾向を追加します。傾向を使用して、一定期間のパターンを示します。") を使用します。 ## GlideAggregate - getAggregate(文字列集計, 文字列名) {#ariaid-title8} 現在のレコードから集計値を取得します。 {#r_GlideAggregate-getAggregate_String_String__table_udy_sdk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 集計 | 文字列 | アグリゲートのタイプ。 有効な値： * AVG:式の平均値。 * COUNT:null 以外の値の数。 * GROUP_CONCAT:グループのすべての非 null 値を昇順で連結し、カンマ (',') で結合して、結果を文字列として返します。 * GROUP_CONCAT_DISTINCT:グループのすべての非 null 値を昇順で連結し、重複を削除してカンマ (',') で結合し、結果を文字列として返します。 * MAX:最大値。 * MIN:最小値。 * STDDEV:母集団の標準偏差。 * SUM:すべての値の合計。 | | name | 文字列 | 集計元のフィールドの名前、または動的スキーマ内の属性へのパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-getAggregate_String_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 13. パラメーター] {#r_GlideAggregate-getAggregate_String_String__table_udy_sdk_ws} {#r_GlideAggregate-getAggregate_String_String__table_vdy_sdk_ws__entry__2} | タイプ | 説明 | |-|-| | 文字列 | アグリゲーションの値。 集計される値が FX 通貨値の場合、戻り値は次の形式になります ``、 例:USD。134.980000です。 注: 指定されたフィールドに混合通貨タイプの FX 通貨値が含まれている場合、メソッドは値を集計できず、セミコロン (;) を返します。 | [表 : 14. 返される内容] {#r_GlideAggregate-getAggregate_String_String__table_vdy_sdk_ws} この例では、COUNT 集計を取得する方法を示します。 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; } この例は、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 次の例は、動的属性ストアの属性を使用してこのメソッドを呼び出す方法を示しています。 var ga_Inc = new GlideAggregate('incident'); ga_Inc.groupBy('inc_dynamic_schema->make'); ga_Inc.addAggregate('AVG', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('MIN', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('MAX', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('SUM', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('COUNT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('STDDEV', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cost'); ga_Inc.addAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cost'); ga_Inc.query(); while (ga_Inc.next()) { gs.info(gr_Inc.getValue('inc_dynamic_schema->make')); gs.info('AVG: ' + ga_Inc.getAggregate('AVG', 'inc_dynamic_schema->cost')); gs.info('MAX: ' + ga_Inc.getAggregate('MAX', 'inc_dynamic_schema->cost')); gs.info('MIN: ' + ga_Inc.getAggregate('MIN', 'inc_dynamic_schema->cost')); gs.info('SUM: ' + ga_Inc.getAggregate('SUM', 'inc_dynamic_schema->cost')); gs.info('COUNT: ' + ga_Inc.getAggregate('COUNT', 'inc_dynamic_schema->cost')); gs.info('STDDEV: ' + ga_Inc.getAggregate('STDDEV', 'inc_dynamic_schema->cost')); gs.info('GROUP_CONCAT: ' + ga_Inc.getAggregate('GROUP_CONCAT', 'inc_dynamic_schema->cost')); gs.info('GROUP_CONCAT_DISTINCT: ' + ga_Inc.getAggregate('GROUP_CONCAT_DISTINCT', 'inc_dynamic_schema->cost')); gs.info('COUNT(DISTINCT: ' + ga_Inc.getAggregate('COUNT(DISTINCT', 'inc_dynamic_schema->cost')); gs.info(' '); } 出力： *** 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: ### スコープ対応 {#r_GlideAggregate-getAggregate_String_String__section_pvv_fkr_mcb} スコープ対象のアプリケーションで getAggregate() メソッドを使用するには、対応するスコープ対象のメソッド [getAggregate()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateGetAggregate_String_String "現在のレコードから集計値を返します。") を使用します。 ## GlideAggregate:getDynamicAttributeValue(文字列 fullPath) {#ariaid-title9} 指定されたパスにある動的属性の値を返します。 {#GA-getDynamicAttributeValue_S__table_oh3_x1x_1bc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fullPath | 文字列 | 目的の動的属性を見つけるために使用するパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#GA-getDynamicAttributeValue_S__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 15. パラメーター] {#GA-getDynamicAttributeValue_S__table_oh3_x1x_1bc} {#GA-getDynamicAttributeValue_S__table_ph3_x1x_1bc__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 指定されたパスにある動的属性の値。 fullPathパラメーターに無効なデータが含まれている場合、または指定された属性値がサポートされているデータタイプの 1 つでない場合は、null を返します。 | [表 : 16. 返される内容] {#GA-getDynamicAttributeValue_S__table_ph3_x1x_1bc} 次のコード例は、このメソッドを呼び出す方法を示しています。 var ga_Tab = new GlideAggregate('u_mytable'); ga_Tab.groupBy('u_dyn_attr_store->color'); ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->number'); ga_Tab.query(); while(ga_Tab.next()) { gs.info( "color: " + ga_Tab.getDynamicAttributeValue('u_dyn_attr_store->color') + " avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->number')); } 出力： *** Script: color: blue avg: 5.0000 *** Script: color: red avg: 8.0000 *** Script: color: yellow avg: 7.0000 ## GlideAggregate - getDynamicAttributeValue(String dynamicAttributeField, String attrPath) {#ariaid-title10} 現在のテーブルの指定されたフィールドにある動的属性の値と指定された属性パスを返します。 {#GA-getDynamicAttributeValue_S_S__table_n1f_fbx_1bc__entry__3}{#GA-getDynamicAttributeValue_S_S__DynS-dynamicAttributeField-entry} | 名前 | タイプ | 説明 | |-|-|-| | 動的属性フィールド | 文字列 | 動的属性を含むテーブル内のフィールドの名前。 | | 属性パス | 文字列 | 関連する動的スキーマ属性を見つけるために使用する属性パス。 形式:「 `attr_name」` `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] テーブルの属性フィールドにあります。 | [表 : 17. パラメーター] {#GA-getDynamicAttributeValue_S_S__table_n1f_fbx_1bc} {#GA-getDynamicAttributeValue_S_S__table_o1f_fbx_1bc__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 指定されたパスにある動的属性の値。 dynamicAttributeField パラメーターまたは attrPath パラメーターのいずれかが無効な場合は、null を返します。 | [表 : 18. 返される内容] {#GA-getDynamicAttributeValue_S_S__table_o1f_fbx_1bc} 次のコード例は、このメソッドを呼び出す方法を示しています。 var ga_Tab = new GlideAggregate('u_mytable'); ga_Tab.groupBy('u_dyn_attr_store->color'); ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->number'); ga_Tab.query(); while(ga_Tab.next()) { gs.info( "color: " + ga_Tab.getDynamicAttributeValue('u_dyn_attr_store', 'color') + " avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->number')); } 出力： *** Script: color: blue avg: 5.0000 *** Script: color: red avg: 8.0000 *** Script: color: yellow avg: 7.0000 ## GlideAggregate:getDynamicAttributeDisplayValue(文字列 fullPath) {#ariaid-title11} 指定されたパスにある動的属性の表示値を返します。 {#GA-getDynAttributeDisplayValue_S__table_nht_nbx_1bc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fullPath | 文字列 | 目的の動的属性を見つけるために使用するパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#GA-getDynAttributeDisplayValue_S__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 19. パラメーター] {#GA-getDynAttributeDisplayValue_S__table_nht_nbx_1bc} {#GA-getDynAttributeDisplayValue_S__table_oht_nbx_1bc__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定されたパスにある動的属性の表示値。 fullPathパラメーターが無効な場合は、null を返します。 | [表 : 20. 返される内容] {#GA-getDynAttributeDisplayValue_S__table_oht_nbx_1bc} 次のコード例は、このメソッドを呼び出す方法を示しています。 var ga_Tab = new GlideAggregate('u_mytable'); ga_Tab.groupBy('u_dyn_attr_store->color'); ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->number'); ga_Tab.query(); while(ga_Tab.next()) { gs.info( "color: " + ga_Tab.getDynamicAttributeDisplayValue('u_dyn_attr_store->color') + " avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->number')); } 出力： *** Script: color: blue avg: 5.0000 *** Script: color: red avg: 8.0000 *** Script: color: yellow avg: 7.0000 ## GlideAggregate - getDynamicAttributeDisplayValue(String dynamicAttributeField, String attrPath) {#ariaid-title12} 指定されたテーブルフィールドと属性パスにある動的属性の表示値を返します。 {#GA-getDynAttributeDisplayValue_S_S__table_vm3_wbx_1bc__entry__3}{#GA-getDynAttributeDisplayValue_S_S__DynS-dynamicAttributeField-entry} | 名前 | タイプ | 説明 | |-|-|-| | 動的属性フィールド | 文字列 | 動的属性を含むテーブル内のフィールドの名前。 | | 属性パス | 文字列 | 関連する動的スキーマ属性を見つけるために使用する属性パス。 形式:「 `attr_name」` `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] テーブルの属性フィールドにあります。 | [表 : 21. パラメーター] {#GA-getDynAttributeDisplayValue_S_S__table_vm3_wbx_1bc} {#GA-getDynAttributeDisplayValue_S_S__table_wm3_wbx_1bc__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定されたパスにある動的属性の表示値。 dynamicAttributeField パラメーターまたは attrPath パラメーターのいずれかが無効な場合は、null を返します。 | [表 : 22. 返される内容] {#GA-getDynAttributeDisplayValue_S_S__table_wm3_wbx_1bc} 次のコード例は、このメソッドを呼び出す方法を示しています。 var ga_Tab = new GlideAggregate('u_mytable'); ga_Tab.groupBy('u_dyn_attr_store->color'); ga_Tab.addAggregate('AVG', 'u_dyn_attr_store->number'); ga_Tab.query(); while(ga_Tab.next()) { gs.info( "color: " + ga_Tab.getDynamicAttributeDisplayValue('u_dyn_attr_store', 'color') + " avg: " + ga_Tab.getAggregate('AVG', 'u_dyn_attr_store->number')); } 出力： *** Script: color: blue avg: 5.0000 *** Script: color: red avg: 8.0000 *** Script: color: yellow avg: 7.0000 ## GlideAggregate:getQuery() {#ariaid-title13} 現在の集計を返すために必要なクエリを取得します。 {#r_GlideAggregate-getQuery__table_bnl_l2k_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 23. パラメーター] {#r_GlideAggregate-getQuery__table_bnl_l2k_ws} {#r_GlideAggregate-getQuery__table_cnl_l2k_ws__entry__2} | タイプ | 説明 | |-|-| | 文字列 | クエリー。 | [表 : 24. 返される内容] {#r_GlideAggregate-getQuery__table_cnl_l2k_ws} 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() {#ariaid-title14} GlideAggregate オブジェクトの行数を取得します。 {#GlideAgg-getRowCount__table_vy2_535_jq__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 25. パラメーター] {#GlideAgg-getRowCount__table_vy2_535_jq} {#GlideAgg-getRowCount__table_qpt_3f5_jq__entry__2} | タイプ | 説明 | |-|-| | 番号 | GlideAggregate オブジェクトの行数。 | [表 : 26. 返される内容] {#GlideAgg-getRowCount__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 ### スコープ対応 {#GlideAgg-getRowCount__section_cm1_zsn_nyb} スコープ対象のアプリケーションで getRowCount() メソッドを使用するには、対応するスコープ対象のメソッドである [スコープ付き GlideAggregate - getRowCount()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateGetRowCount "GlideAggregate オブジェクトの行数を取得します。") を使用します。 ## GlideAggregate - getTotal(文字列集計、文字列名) {#ariaid-title15} 集計を合計してレコード数を返します。 {#r_GlideAggregate-getTotal_String_String__table_kl5_v2k_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 集計 | 文字列 | 使用するアグリゲートの名前。 有効な値： * AVG:式の平均値。 * COUNT:null 以外の値の数。 * GROUP_CONCAT:グループのすべての非 null 値を昇順で連結し、カンマ (',') で結合して、結果を文字列として返します。 * GROUP_CONCAT_DISTINCT:グループのすべての非 null 値を昇順で連結し、重複を削除してカンマ (',') で結合し、結果を文字列として返します。 * MAX:最大値。 * MIN:最小値。 * STDDEV:母集団の標準偏差。 * SUM:すべての値の合計。 | | name | 文字列 | アグリゲートするフィールドの名前。 | [表 : 27. パラメーター] {#r_GlideAggregate-getTotal_String_String__table_kl5_v2k_ws} {#r_GlideAggregate-getTotal_String_String__table_ll5_v2k_ws__entry__2} | タイプ | 説明 | |-|-| | 番号 | レコードの数。 | [表 : 28. 返される内容] {#r_GlideAggregate-getTotal_String_String__table_ll5_v2k_ws} 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')); 出力: Incidents opened on year - 2015 - 1 Incidents opened on year - 2018 - 5 Incidents opened on year - 2020 - 10 Total Aggregate Value >> 16 ## GlideAggregate:getValue(文字列名) {#ariaid-title16} フィールドまたは動的属性の値を返します。 {#r_GlideAggregate-getValue_String__table_odk_kfk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | name | 文字列 | 動的属性ストア内の属性へのフィールド名またはパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-getValue_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 29. パラメーター] {#r_GlideAggregate-getValue_String__table_odk_kfk_ws} {#r_GlideAggregate-getValue_String__table_qpt_3f5_jq__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定されたフィールドの値。無効な場合 (結果セットの一部ではない) は null を返します。 | [表 : 30. 返される内容] {#r_GlideAggregate-getValue_String__table_qpt_3f5_jq} 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')); } 出力: 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 ### スコープ対応 {#r_GlideAggregate-getValue_String__section_nlm_3kr_mcb} スコープ対象のアプリケーションで getValue() メソッドを使用するには、対応するスコープ対象のメソッド [getValue()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateGetValue_String "指定されたフィールドの値を返します。") を使用します。 ## GlideAggregate:groupBy(文字列名) {#ariaid-title17} 集計をグループ化するときに使用する、フィールドの名前または動的属性ストア内の属性を指定します。 複数のグループフィールドを設定するために、複数回呼び出される場合があります。 {#r_GlideAggregate-groupBy_String__table_itp_2gk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | name | 文字列 | 動的属性ストア内の属性へのフィールド名またはパス。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-groupBy_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 31. パラメーター] {#r_GlideAggregate-groupBy_String__table_itp_2gk_ws} {#r_GlideAggregate-groupBy_String__table_ktp_2gk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 32. 返される内容] {#r_GlideAggregate-groupBy_String__table_ktp_2gk_ws} 次の例は、このメソッドを呼び出す方法を示しています。 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); } 次の例は、動的属性ストアの属性を使用してこのメソッドを呼び出す方法を示しています。 var ga_AppTab = new GlideAggregate('application_table'); ga_AppTab.addGroupBy('dyn_att_field->attr'); ga_AppTab.addAggregate('AVG', 'dyn_att_field->attr1'); ga_AppTab.addHaving('SUM', 'dyn_att_field->attr2', '>=', 420); ga.query(); ### スコープ対応 {#r_GlideAggregate-groupBy_String__section_dff_pkr_mcb} スコープ対象のアプリケーションで groupBy() メソッドを使用するには、対応するスコープ対象のメソッド [groupBy()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateGroupBy_String "集計のグループ化に使用するフィールドの名前を指定します。") を使用します。 ## GlideAggregate:orderBy(文字列名) {#ariaid-title18} 指定されたフィールド、動的属性パス、または glidefunction の値を使用して集計を順序付けします。このフィールドはグループ別リストにも追加されます。 {#r_GlideAggregate-orderBy_String__table_ft1_wgk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | name | 文字列 | フィールド名、動的属性ストア内の属性へのパス、または集計の順序付けに使用する glidefunction。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-orderBy_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 glidefunction 形式:`glidefunction:length(short_description)。`glidefunctions の詳細については、「 [glidefunction 操作](https://www.servicenow.com/docs/access?context=platform-support-functions&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 | [表 : 33. パラメーター] {#r_GlideAggregate-orderBy_String__table_ft1_wgk_ws} {#r_GlideAggregate-orderBy_String__table_gt1_wgk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 34. 返される内容] {#r_GlideAggregate-orderBy_String__table_gt1_wgk_ws} 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); } ### スコープ対応 {#r_GlideAggregate-orderBy_String__section_zml_vkr_mcb} スコープ対象のアプリケーションで orderBy() メソッドを使用するには、対応するスコープ対象のメソッド [orderBy()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateOrderBy_String "指定されたフィールドの値を使用して集計を並べ替えます。このフィールドはグループ別リストにも追加されます。") を使用します。 ## GlideAggregate - orderByAggregate(String agg, String fieldName) {#ariaid-title19} 指定されたアグリゲートとフィールドまたは動的属性に基づいて集計を順序付けします。 {#r_GlideAggregate-orderByAggregate_String_String__table_ycv_lhk_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 集計 | 文字列 | アグリゲーションのタイプ 有効な値： * AVG:式の平均値。 * COUNT:null 以外の値の数。 * GROUP_CONCAT:グループのすべての非 null 値を昇順で連結し、カンマ (',') で結合して、結果を文字列として返します。 * GROUP_CONCAT_DISTINCT:グループのすべての非 null 値を昇順で連結し、重複を削除してカンマ (',') で結合し、結果を文字列として返します。 * MAX:最大値。 * MIN:最小値。 * STDDEV:母集団の標準偏差。 * SUM:すべての値の合計。 | | fieldName | 文字列 | アグリゲートする動的属性ストア内の属性のフィールドまたはパスの名前。 属性パスの形式: `dyn_att_field->attr_name` * `dyn_att_field`:テーブルの動的属性ストアフィールドの名前。 * `attr_name`:動的属性の名前。 テーブル:動的属性 \[dynamic_attribute\] {#r_GlideAggregate-orderByAggregate_String_String__ul_rsc_lvy_1hc}「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 「[Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」も参照してください。 | [表 : 35. パラメーター] {#r_GlideAggregate-orderByAggregate_String_String__table_ycv_lhk_ws} {#r_GlideAggregate-orderByAggregate_String_String__table_zcv_lhk_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 36. 返される内容] {#r_GlideAggregate-orderByAggregate_String_String__table_zcv_lhk_ws} 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); } ### スコープ対応 {#r_GlideAggregate-orderByAggregate_String_String__section_src_tkr_mcb} スコープ対象のアプリケーションで orderByAggregate() メソッドを使用するには、対応するスコープ対象のメソッド [orderByAggregate()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateOrderByAggregate_String_String "指定されたアグリゲートとフィールドに基づいて集計を順序付けします。") を使用します。 ## GlideAggregate - query() {#ariaid-title20} クエリを発行し、結果を取得します。 {#r_GlideAggregate-query__table_rxs_c3k_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 37. パラメーター] {#r_GlideAggregate-query__table_rxs_c3k_ws} {#r_GlideAggregate-query__table_sxs_c3k_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 38. 返される内容] {#r_GlideAggregate-query__table_sxs_c3k_ws} 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); ### スコープ対応 {#r_GlideAggregate-query__section_m2z_ykr_mcb} スコープ対象のアプリケーションで query() メソッドを使用するには、対応するスコープ対象のメソッド [query()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateQuery "クエリを発行し、結果を取得します。") を使用します。 ## GlideAggregate - setAggregateWindow(Number firstRow, Number lastRow) {#ariaid-title21} アグリゲートクエリに含めるテーブルの行数を制限します。 {#GlideAgg-setAggregateWindow_N_N__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 最初の行 | 番号 | アグリゲートクエリに含める最初の行の 0 ベースのインデックス (両端を含む)。 | | lastRow | 番号 | 集計クエリに含める最後の行のゼロベースのインデックス (排他的)。 | [表 : 39. パラメーター] {#GlideAgg-setAggregateWindow_N_N__table_orv_jcm_gtb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 40. 返される内容] {#GlideAgg-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 ### スコープ対応 {#GlideAgg-setAggregateWindow_N_N__section_m2z_ykr_mcb} スコープ対象のアプリケーションで setAggregateWindow() メソッドを使用するには、対応するスコープ対象のメソッド [setAggregateWindow()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#ScopedGlAgg-setAggregateWindow_N_N "アグリゲートクエリに含めるテーブルの行数を制限します。") を使用します。 ## GlideAggregate - setAggregateWorkflow(ブールワークフロー) {#ariaid-title22} 集計クエリのビジネスルールの実行をアクティブまたは非アクティブにします。 セッションレベルのワークフロー設定 (`gs.getSession().setWorkflow()`) は、このメソッドを上書きします。セッションワークフローを非アクティブ化すると、このメソッドの設定に関係なく、クエリビジネスルールは実行されません。 警告: ビジネスルール、スクリプトエンジン、および監査の実行を無効にすると、 ServiceNow® インスタンスとその動作に大きな影響を与える可能性があります。本番環境に展開する前に、この変更を十分にテストしてください。 {#GA-setAggregateWorkflow_B__table_vy2_525_jq__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | ワークフロー | ブーリアン | 現在の GlideAggregate クエリに対してビジネスルールがアクティブかどうかを示すフラグ。 有効な値： * true:現在のクエリのビジネスルールを有効にします。 * false:現在のクエリのビジネスルールを非アクティブ化します。 デフォルト値：false | [表 : 41. パラメーター] {#GA-setAggregateWorkflow_B__table_vy2_525_jq} {#GA-setAggregateWorkflow_B__table_cdx_3tb_2r__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 42. 返される内容] {#GA-setAggregateWorkflow_B__table_cdx_3tb_2r} 次の例は、集計クエリのビジネスルールを有効にする方法を示しています。 var incidentGA = new GlideAggregate('incident'); incidentGA.setAggregateWorkflow(true); // activate business rules for this aggregate incidentGA.addAggregate('COUNT', 'sys_mod_count'); incidentGA.query(); glide.businessrule.callstack プロパティがシステムプロパティ \[sys_properties\] テーブルにあり、true に設定されている場合、出力にはビジネスルール実行ログが含まれます。パフォーマンスへの影響を避けるために、不要な場合はこのプロパティを false に設定します。 BUSINESS RULE - About to execute business rule 'incident query' on incident: BUSINESS RULE - Finished executing business rule 'incident query' on incident: ## GlideAggregate:setGroup(ブール b) {#ariaid-title23} 結果をグループ化するかどうかを設定します。 {#r_GlideAggregate-setGroup_Boolean__table_g3r_m3k_ws__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | b | ブーリアン | 結果をグループ化するかどうかを示すフラグ。 有効な値： * true:結果をグループ化します。 * false:結果をグループ化しません。 {#r_GlideAggregate-setGroup_Boolean__ul_uhp_mr4_nnb} | [表 : 43. パラメーター] {#r_GlideAggregate-setGroup_Boolean__table_g3r_m3k_ws} {#r_GlideAggregate-setGroup_Boolean__table_h3r_m3k_ws__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 44. 返される内容] {#r_GlideAggregate-setGroup_Boolean__table_h3r_m3k_ws} var ga = new GlideAggregate('incident'); ga.addAggregate('COUNT', 'category'); ga.setGroup(true); ### スコープ対応 {#r_GlideAggregate-setGroup_Boolean__section_ryd_blr_mcb} スコープ対象のアプリケーションで setGroup() メソッドを使用するには、対応するスコープ対象のメソッド [setGroup()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#r_ScopedGlideAggregateSetGroup_Boolean "返される結果をグループ化するかどうかを設定します。") を使用します。 ## GlideAggregate:setIntervalYearIncluded(ブール、b) {#ariaid-title24} 曜日の傾向の結果を年別にグループ化するかどうかを設定します。これらの傾向は、dayofweek時間間隔の addTrend() メソッドを使用して作成されます。 依存関係:[GlideAggregate - addTrend('\', 'dayofweek')。](https://servicenow-prod.fluidtopics.net/Trvd9P7TvM~3rU09ZsmVJA#r_GlideAggregate-addAggregate_String_String "集計をデータベースクエリに追加します。") {#GlideAgg-setIntervalYearIncluded_B__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | b | ブーリアン | 曜日の時間間隔で傾向に年を含めるかどうかを示すフラグ。 有効な値： * true:曜日の結果を年別にグループ化します。 * false:時間間隔の結果から年を除外します。 {#GlideAgg-setIntervalYearIncluded_B__ul_uz2_dph_gzb} デフォルト：true | [表 : 45. パラメーター] {#GlideAgg-setIntervalYearIncluded_B__table_orv_jcm_gtb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 46. 返される内容] {#GlideAgg-setIntervalYearIncluded_B__table_orv_jcm_gtb} 次の例は、過去 6 か月間に作成されたインシデントをカウントする方法を示しています。インシデントは曜日ごとに分けられますが、年は含まれません。たとえば、木曜日のデフォルトの結果には年が含まれます ( `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 ### スコープ対応 {#GlideAgg-setIntervalYearIncluded_B__section_m2z_ykr_mcb} スコープ対象のアプリケーションで setIntervalYearIncluded() メソッドを使用するには、対応するスコープ対象のメソッド [setIntervalYearIncluded()](https://servicenow-prod.fluidtopics.net/YH3MF48VxvVzg8O89GnOiw#ScopedGlAgg-setIntervalYearInclu_B "曜日の傾向の結果を年別にグループ化するかどうかを設定します。これらの傾向は、dayofweek時間間隔の addTrend() メソッドを使用して作成されます。") を使用します。