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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 변환기 - 범위 지정, 전역

# 변환기 - 범위 지정, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

변환기 API는 시계열 데이터를 조작하여 평가 및 분석을 위한 데이터를 준비합니다.

범위가 지정된 서버 스크립트 및 전역 서버 스크립트에서 이 API를 호출할 수 있습니다. Transformer 클래스를 사용하는 경우 `sn_clotho` 네임스페이스 식별자를 사용합니다.  
일반적인 사용 사례는 평가할 기간을 결정하고, 메트릭 필드가 있는 테이블에서 기록을 선택하고, 실행할 변환 유형을 정의한 다음, 변환을 실행하는 것입니다.

    // create the start and end time
           var start = new GlideDateTime();
    	start.addSeconds(-1 * 60 * 60); 
    	var end = new GlideDateTime();
    	
    	//mb_demo_drone is a table with metric fields. 
    	var drones = new GlideRecord("mb_demo_drone");
    	drones.addQuery("model", "Kingfisher Phantom");
    	drones.query();

    	//build a transform that returns a simple average
    	var builder = new sn_clotho.Transformer(drones);
    	builder.metric("mb_demo_mt_rem_battery").avg().label("Original");

    	//execute transform and return result for visualization
    	var result = builder.execute(start,end);

이 클래스는 애플리케이션의 일부입니다 MetricBase .

## 변환기 - 변환기(GlideRecord sourceRecords) {#ariaid-title2}

Transformer 객체를 생성합니다.
{#TFMR-transformer_GR__table_w4x_4qr_mbb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 소스 기록 | GlideRecord | 메트릭을 평가할 기록을 포함합니다. 기록이 하나 또는 여러 개일 수 있습니다. |
[표 1. 매개변수]

{#TFMR-transformer_GR__table_w4x_4qr_mbb}  

    //where drones is a GlideRecord created from a table with a metric field
    	var builder = new sn_clotho.Transformer(drones);

## 변환기 - execute(GlideDateTime start, GlideDateTime end) {#ariaid-title3}

변환을 실행합니다.
execute()를 호출하기 전에 metric() 및 groupBy() 메서드를 사용하십시오. execute() 메서드는 각 Transformer 객체에 대해 한 번만 호출할 수 있습니다.

변환의 일부로 수행되는 작업은 데이터베이스의 MetricBase 데이터를 변경하지 않습니다.
{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시작 | GlideDateTime | 평가할 기간의 시작입니다. |
| 끝 | GlideDateTime | 평가할 기간의 종료입니다. |
[표 2. 매개변수]

{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb} {#TFRM-execute_GDT_GDT__table_c2l_4xr_mbb__entry__2}

| 유형 | 설명 |
|-|-|
| 결과 변환 | 변환된 데이터입니다. |
[표 3. 반환]

{#TFRM-execute_GDT_GDT__table_c2l_4xr_mbb}  

    var minutesAgoStart = 60;
    	var end = new GlideDateTime();
    	var start = new GlideDateTime(end);
    	start.addSeconds(-1 * 60 * minutesAgoStart);
    	
    	// query subject records
    	var grDrone = new GlideRecord('mb_demo_drone');
    	grDrone.query();
    	
    	// building transform; get the average transforms of a metric, grouping by model
    	var transformer = new sn_clotho.Transformer(grDrone);
    	transformer.groupBy("fleet").metric("mb_demo_mt_altitude").avg().label('avg - %g:fleet:');

    	// execute and return result for visualization
    	var tfrmResult = transformer.execute(start, end);

## 변환기 - groupBy(문자열 필드) {#ariaid-title4}

데이터를 그룹화하는 데 사용할 필드를 지정합니다.
groupBy() 메서드를 사용하려면 execute() 메서드를 호출하기 전에 must를 호출해야 합니다.
{#TFMR-groupBy_S__table_brg_q5r_mbb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필드 | 문자열 | 변환 결과를 그룹화하는 데 사용할 테이블의 필드입니다. |
[표 4. 매개변수]

{#TFMR-groupBy_S__table_brg_q5r_mbb} {#TFMR-groupBy_S__table_crg_q5r_mbb__entry__2}

| 유형 | 설명 |
|-|-|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
[표 5. 반환]

{#TFMR-groupBy_S__table_crg_q5r_mbb}  

    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.groupBy("fleet");

## 변환기 - metric(String metricName) {#ariaid-title5}

변환에 사용할 메트릭 필드를 지정합니다.
변환에 사용할 여러 메트릭을 지정할 수 있습니다. execute() 메서드가 호출된 후에는 metric() 메서드를 호출할 수 없습니다.
{#TFRM-metric_S__table_g3m_yvr_mbb__entry__3}

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

{#TFRM-metric_S__table_g3m_yvr_mbb} {#TFRM-metric_S__table_h3m_yvr_mbb__entry__2}

| 유형 | 설명 |
|-|-|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
[표 7. 반환]

{#TFRM-metric_S__table_h3m_yvr_mbb}  

    var transformer = new sn_clotho.Transformer(grDrone);
    var trnsfrm = transformer.metric("mb_demo_mt_altitude");