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


---

# DataBuilder - スコープ対象、グローバル

# DataBuilder - スコープ対象、グローバル {#ariaid-title1}

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

DataBuilder API は、メトリクスの一連のデータポイントを作成するメソッドを提供します。sn_clothoを使用します。Client.put() メソッドを使用して値を保存します。

このクラスは、スコープ対象およびグローバルサーバースクリプトで呼び出すことができます。DataBuilder クラスを使用する場合は、`sn_clotho` 名前空間識別子を使用します。

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

## DataBuilder - DataBuilder(オブジェクト glideRecord, 文字列 subject, 文字列 metric) {#ariaid-title2}

DataBuilder クラスのインスタンスを作成します。
{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| glideRecord | オブジェクト | ドメインを取得する GlideRecord。 |
| 件名 | 文字列 | この系列に関連付けられた GlideRecord のsys_id。 |
| メトリクス | 文字列 | メトリックのフィールド名 |
[表 : 1. パラメーター]

{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b}  
次の例では、現在の時刻または特定の時間範囲を表す `now_GR` パラメータと、追跡対象のメトリクスの名前である文字列パラメータ`「cpu_percentage」`を使用して、`sn_clotho` 名前空間から `DataBuilder` の新しいインスタンスを初期化します。

    // Where cpu_percentage is the name of the metric
            var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');

## DataBuilder - add(GlideDateTime start, Array value) {#ariaid-title3}

一連のデータポイントを DataBuilder オブジェクトに追加します。各データポイントはタイムスタンプと値です。
開始パラメーターと保持ポリシーの収集期間を使用して、アレイ内の各値のタイムスタンプを計算します。最初の値には、タイムスタンプとして開始パラメーターがあります。このメソッドでは、メトリックベースデータベースにデータは保存されません。sn_clothoを使用します。Client.put() メソッドを使用して値を保存します。
{#SDB-add_GDT_A__table_xy1_c1m_31b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| start | GlideDateTime | 最初のデータポイントのタイムスタンプ。それ以降のタイムスタンプは、保持ポリシーの収集期間を使用して計算されます。 |
| value | アレイ | 数値の配列。 |
[表 : 2. パラメーター]

{#SDB-add_GDT_A__table_xy1_c1m_31b} {#SDB-add_GDT_A__table_yy1_c1m_31b__entry__2}

| タイプ | 説明 |
|-|-|
| データビルダー | 同じ DataBuilder オブジェクトです。 |
[表 : 3. 返される内容]

{#SDB-add_GDT_A__table_yy1_c1m_31b}  
次の例では、最初に、特定のタイムスタンプでの CPU 使用率に関連するさまざまなデータ ポイントを表す 7、0.5、273 の 3 つの数値を含む配列 (ポイント) を初期化します。次に、コードは新しいsn_clothoを初期化します `。``now_GR` を使用する DataBuilder オブジェクト (GlideRecord オブジェクト) は、このデータが格納されているターゲットデータベースレコードを表します。 `「cpu_percentage」` は、CPU 使用率を追跡するために使用されるメトリクス名です。

オブジェクトを現在の日付と時刻に設定する GlideDateTime を使用して、新しい時間変数が作成されます。最後に、コードは `dataBuilder.add(time, points)` を使用して、データビルダーオブジェクトに複数のデータポイントを格納します。


    var points = [7,0.5,273];
    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    // this creates a GlideDateTime object set to the current date and time
    var time = new GlideDateTime();
    dataBuilder.add(time, points);

## DataBuilder - add(GlideDateTime start, 数値) {#ariaid-title4}

DataBuilder オブジェクトにデータポイントを追加します。各データポイントはタイムスタンプと値です。このメソッドでは、データポイントはメトリクスに保存されません。sn_clothoを使用します。Client.put() メソッドを使用して値を保存します。
{#SDB-add_GDT_N__table_r1w_2vl_31b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| start | GlideDateTime | データポイントのタイムスタンプ。 |
| value | 数値 | データポイントの値。 |
[表 : 4. パラメーター]

{#SDB-add_GDT_N__table_r1w_2vl_31b} {#SDB-add_GDT_N__table_s1w_2vl_31b__entry__2}

| タイプ | 説明 |
|-|-|
| データビルダー | DataBuilder オブジェクト |
[表 : 5. 返される内容]

{#SDB-add_GDT_N__table_s1w_2vl_31b}  
次の例では、まず、`パラメーター now_GR` (ターゲットレコード) と `'cpu_percentage'` (追跡するメトリクス) を使用して`、sn_clotho`名前空間から `DataBuilder` の新しいインスタンスを初期化します。`GlideDateTime` は、時間を現在の日時に初期化します。最後に、 `dataBuilder.add()` は、現在のタイムスタンプで値 `0.6` (CPU 使用率が 60% の値を表す) を格納します。

    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    // this creates a GlideDateTime object set to the current date and time
    var time = new GlideDateTime();
    dataBuilder.add(time, 0.6);