변환기 - 범위 지정, 전역

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

Transformer 클래스는 범위가 지정된 서버 스크립트 및 전역 서버 스크립트에서 사용할 수 있습니다. 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 일부입니다.

변환기 - execute(GlideDateTime start, GlideDateTime end)

변환을 실행합니다.

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

변환의 일부로 수행된 작업은 데이터베이스의 데이터를 MetricBase 변경하지 않습니다.

표 1. 매개변수

이름	유형	설명
시작	GlideDateTime	평가할 기간의 시작 부분.
끝	GlideDateTime	평가할 기간의 종료 날짜입니다.

표 2. 반환

유형	설명
변환 결과	변환된 데이터입니다.

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(문자열 필드)

데이터를 그룹화하는 데 사용할 필드를 지정합니다.

groupBy() 메서드를 사용하려면 execute() 메서드 앞에 호출해야 합니다.

표 3. 매개변수

이름	유형	설명
필드	문자열	변환 결과를 그룹화하는 데 사용할 테이블의 필드입니다.

표 4. 반환

유형	설명
변환부품	변환 특성을 지정하는 데 사용할 수 있는 TransformPart 개체입니다.

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

변환기 - metric(String, metricName)

변환에 사용할 메트릭 필드를 지정합니다.

변환에 사용할 여러 메트릭을 지정할 수 있습니다. execute() 메서드를 호출한 후에는 metric() 메서드를 호출할 수 없습니다.

표 5. 매개변수

이름	유형	설명
metricName	문자열	메트릭 필드의 이름입니다.

표 6. 반환

유형	설명
변환부품	변환 특성을 지정하는 데 사용할 수 있는 TransformPart 개체입니다.

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

변환기 - 변환기( GlideRecord sourceRecords)

Transformer 개체를 만듭니다.

표 7. 매개변수

이름	유형	설명
소스 기록	GlideRecord	메트릭을 평가할 레코드를 포함합니다. 하나 또는 여러 개의 기록이 될 수 있습니다.

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