---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DataBuilder - com escopo, global

# DataBuilder - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API DataBuilder fornece métodos para criar uma série de pontos de dados para uma métrica. Use o método sn_clotho.Client.put() para salvar os valores.

Você pode chamar esta classe em scripts de servidor com escopo e globais. Ao usar a classe DataBuilder, use o identificador de namespace `sn_clotho`.

Esta classe faz parte da aplicação MetricBase.

## DataBuilder - DataBuilder (objeto glideRecord, assunto de cadeia de caracteres, métrica de cadeia de caracteres) {#ariaid-title2}

Cria uma instância da classe DataBuilder.
{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| glideRecord | Objeto | GlideRecord do qual o domínio será obtido. |
| assunto | Cadeia de caracteres | O sys_id do GlideRecord associado a esta série. |
| métrica | Cadeia de caracteres | O nome do campo da métrica. |
[Tabela 1. Parâmetros]

{#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(início de GlideDateTime, valor de matriz) {#ariaid-title3}

Adiciona uma série de pontos de dados ao objeto DataBuilder. Cada ponto de dados é um carimbo de data/hora e um valor.
Usa o parâmetro de início e o período de coleta da política de retenção para calcular o carimbo de data/hora de cada valor na matriz. O primeiro valor tem o parâmetro de início como carimbo de data/hora. Este método não salva os dados no banco de dados MetricBase. Use o método sn_clotho.Client.put() para salvar os valores.
{#SDB-add_GDT_A__table_xy1_c1m_31b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| iniciar | GlideDateTime | O carimbo de data/hora do primeiro ponto de dados. Os carimbos de data/hora subsequentes são calculados usando o período de coleta da política de retenção. |
| valor | Matriz | Uma matriz de números. |
[Tabela 2. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Construtor de dados | O mesmo objeto DataBuilder. |
[Tabela 3. Retorna]

{#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(Início de GlideDateTime, Valor numérico) {#ariaid-title4}

Adiciona um ponto de dados ao objeto DataBuilder. Cada ponto de dados é um carimbo de data/hora e um valor. Este método não salva o ponto de dados na métrica. Use o método sn_clotho.Client.put() para salvar os valores.
{#SDB-add_GDT_N__table_r1w_2vl_31b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| iniciar | GlideDateTime | O carimbo de data/hora do ponto de dados. |
| valor | Número | O valor do ponto de dados. |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Construtor de dados | O objeto DataBuilder. |
[Tabela 5. Retorna]

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