---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Transformer - スコープ指定、グローバル

# Transformer - スコープ指定、グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

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

このクラスは、メトリックベース アプリケーションの一部です。

## Transformer - Transformer( GlideRecord sourceRecords) {#ariaid-title2}

Transformer オブジェクトを作成します。
{#TFMR-transformer_GR__table_w4x_4qr_mbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sourceRecords | GlideRecord | 測定基準が評価されるレコードが入ります。1 つまたは複数のレコードを指定できます。 |
[表 : 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);

## Transformer - execute(GlideDateTime start, GlideDateTime end) {#ariaid-title3}

変換を実行します。
execute() を呼び出す前に、metric() および groupBy() メソッドを使用します。execute() メソッドは、Transformer の各オブジェクトに対して 1 回だけ呼び出すことができます。

変換の一環で実行されるアクションによって メトリックベース データベースのデータが変更されることはありません。
{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| start | GlideDateTime | 評価対象の期間の最初。 |
| end | GlideDateTime | 評価対象の期間の最後。 |
[表 : 2. パラメーター]

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

| タイプ | 説明 |
|-|-|
| TransformResult | 変換されたデータ。 |
[表 : 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 | 変換特性の指定に使用できる TransformPart オブジェクト。 |
[表 : 5. 返される内容]

{#TFMR-groupBy_S__table_crg_q5r_mbb}  

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

## Transformer - metric(文字列 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 | 変換の特性を指定するために使用できる TransformPart オブジェクト。 |
[表 : 7. 返される内容]

{#TFRM-metric_S__table_h3m_yvr_mbb}  

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