---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DataBuilder - スコープ付き、グローバル

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

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

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 |
| metric | 文字列 | メトリックのフィールド名 |
[表 : 1. パラメーター]

{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b}  

    // 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 オブジェクトに追加します。各データポイントはタイムスタンプと値です。
start パラメーターと保持ポリシーの収集期間を使用して、アレイ内の各値のタイムスタンプを計算します。最初の値には、タイムスタンプとしての開始パラメーターがあります。このメソッドは、MetricBase データベースにデータを保存しません。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 | 同じ DataBuilder オブジェクトです。 |
[表 : 3. 返される内容]

{#SDB-add_GDT_A__table_yy1_c1m_31b}  


    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 | DataBuilder オブジェクト |
[表 : 5. 返される内容]

{#SDB-add_GDT_N__table_s1w_2vl_31b}  

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