---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Client : champ d'application, global

# Client : champ d'application, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'API client fournit des méthodes permettant d'ajouter des données à la MetricBase base de données, d'exécuter des transformations sur la MetricBase base de données et de recevoir les résultats de ces transformations.

Vous pouvez utiliser la classe Client dans les scripts serveur inclus dans le périmètre et dans les scripts serveur globaux. Cette classe fait partie de l'application et doit s'exécuter MetricBase dans l'espace de noms `sn_clotho` .

## Client : Client() {#ariaid-title2}

Créez une instance de la classe client pour accéder à la MetricBase base de données.
{#ClientS-Client__table_pzg_hvz_31b__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#ClientS-Client__table_pzg_hvz_31b}  

    var client = new sn_clotho.Client();

## Client : accumuler (now_GR GlideRecord, mesure de chaîne) {#ariaid-title3}

Accumule les valeurs de mesure à l'horodatage spécifié et enregistre le résultat dans la base de données plutôt que d'écraser la valeur.
Utiliser cette méthode méthode pour gérer les mesures qui peuvent être additionnées pour une accumulation, telles que les kilowattheures (kWhs) d'électricité. Accumuler effectue un appel pour chaque mesure à l'horodatage fourni. Par exemple, les kilowatts collectés pour un radiateur, une bouilloire électrique et une machine à laver entraîneraient l'accumulation de trois appels.
{#ClientS-accumulate_GR_N__table_zsz_5jd_1db__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | GlideRecord | Nom de la série GlideRecord à partir de laquelle obtenir la valeur cumulée. Voir aussi : [getSeries()](https://servicenow-prod.fluidtopics.net/8VHuzFkUeiom~vIrTmDTsA#ClientS-getSeries_O_S_O "Obtenir toutes les séries à partir d’une dimension spécifique.") |
| default_value | Numéro | Facultatif. Valeur par défaut pour l'accumulation à un horodatage donné. Utilisé uniquement lors du premier appel pour accumuler si une valeur n'est pas disponible pour un horodatage donné. Un cas d'utilisation pourrait être l'accumulation d'une mesure de watts pour un total_power. Vous souhaitez accumuler des watts pour un routeur connecté à une prise sans wattmètre pour le mesurer. Si vous connaissez la valeur de consommation et qu'elle est constante), vous pouvez utiliser la valeur constante comme valeur par défaut pour accumuler total_power. Par exemple, vous utiliserez 20 si le routeur est constamment branché et consomme 20 watts. La valeur d'horodatage peut être fournie à l'aide de l'API [DataBuilder](https://servicenow-prod.fluidtopics.net/U8ckIxCPKEhpgKA8MI4o6Q#DataBuilderScopedAPI "L’API DataBuilder fournit des méthodes pour créer une série de points de données pour une mesure. Utilisez le sn_clotho. Client.put() pour enregistrer les valeurs.") . Par défaut : 0 |
[Tableau 2. Paramètres]

{#ClientS-accumulate_GR_N__table_zsz_5jd_1db} {#ClientS-accumulate_GR_N__table_atz_5jd_1db__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 3. Renvoie]

{#ClientS-accumulate_GR_N__table_atz_5jd_1db}  
L'exemple suivant montre comment accumuler la valeur de mesure `total_power` dans un enregistrement appelé `building_a`.

    var time = new GlideDateTime();

    // total_power is the name of a metric within building_a which stores accumulated values

    var dataBuilder1 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder1.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder1, 0);

    var dataBuilder2 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder2.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder2, 0);

    var dataBuilder3 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder3.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder3, 0);

    // As a result of these operations client will save value of
    // 3.5+12+4.3+0(default value) at the timestamp 'time'

## Client : deleteMetric(String tableName, String metricName) {#ariaid-title4}

Supprimer une mesure spécifiée d'une table spécifiée dans la MetricBase base de données
Remarque :  
Cette méthode supprime les données de la MetricBase base de données. Il n'y a pas de mécanisme de récupération.
{#ClientS-deleteMetric_S_S__table_zsz_5jd_1db__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table dont la mesure spécifiée doit être supprimée. |
| metricName | Chaîne | Nom de la mesure. |
[Tableau 4. Paramètres]

{#ClientS-deleteMetric_S_S__table_zsz_5jd_1db} {#ClientS-deleteMetric_S_S__table_atz_5jd_1db__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 5. Renvoie]

{#ClientS-deleteMetric_S_S__table_atz_5jd_1db}  
L'exemple suivant montre comment supprimer une mesure d'une table.

    var client = new sn_clotho.Client();

    // delete metric (Speed) from the Drones table
    client.deleteMetric("mb_demo_drone", "mb_demo_mt_speed");

## Client : deleteSeries(GlideRecord now_GR, mesure de chaîne) {#ariaid-title5}

Supprimez les données de la MetricBase base de données associées à la mesure spécifiée dans le GlideRecord spécifié. Utilisez cette méthode pour supprimer les données de test.
Remarque :  
Cette méthode supprime les données de la MetricBase base de données. Il n'y a pas de mécanisme de récupération.
{#ClientS-deleteSeries_GR_S__table_zsz_5jd_1db__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | GlideRecord | Les enregistrements dont les données de séries chronologiques pour la mesure spécifiée doivent être supprimées. |
| mesure | Chaîne | Nom de la mesure. |
[Tableau 6. Paramètres]

{#ClientS-deleteSeries_GR_S__table_zsz_5jd_1db} {#ClientS-deleteSeries_GR_S__table_atz_5jd_1db__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 7. Renvoie]

{#ClientS-deleteSeries_GR_S__table_atz_5jd_1db}  

    var client = new sn_clotho.Client();
    //query drones of a specific model
    var drones = new GlideRecord("mb_demo_drone");
    drones.addQuery("model", "Kingfisher Phantom");
    drones.query();

    client.deleteSeries(drones, 'mb_demo_mt_speed');

## Client : getSeries(GlideRecord now_GR, String metricName, GlideDateTime lastUpdateBefore) {#ariaid-title6}

Obtenir toutes les séries à partir d'une dimension spécifique.
{#ClientS-getSeries_O_S_O__table_zsz_5jd_1db__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | [GlideRecord](https://servicenow-prod.fluidtopics.net/2WySz5FCvQHHbdfx6_dFUg#c_GlideRecordScopedAPI "L’API GlideRecord incluse dans le périmètre d’application est utilisée pour les opérations de base de données.") | Enregistrement à partir duquel obtenir la série. |
| mesure | Chaîne | Nom de la mesure. |
| lastUpdateBefore | [GlideDateTime](https://servicenow-prod.fluidtopics.net/JgJ6~NAVmsxzolCUQ1ybvw#c_GlideDateTimeScoped "La classe GlideDateTime incluse dans le champ d’application fournit des méthodes permettant d’effectuer des opérations sur les objets GlideDateTime.") | Facultatif. Date dans le futur représentant la fin de la période à évaluer. |
[Tableau 8. Paramètres]

{#ClientS-getSeries_O_S_O__table_zsz_5jd_1db} {#ClientS-getSeries_O_S_O__table_atz_5jd_1db__entry__2}

| Type | Description |
|-|-|
| Tableau | Liste de sys_ids de chaîne représentant la série contenant des données pour la mesure spécifiée. Si le lastUpdateBefore paramètre est fourni, il renvoie les séries dont aucune donnée n'est plus récente que la date lastUpdateBefore (non inclus). |
[Tableau 9. Renvoie]

{#ClientS-getSeries_O_S_O__table_atz_5jd_1db}  
L'exemple suivant montre comment obtenir la liste complète des valeurs de vitesse répertoriées dans le tableau Drones \[mb_demo_drone\].

    var client = new sn_clotho.Client();

    // query subject records
    var grDrone = new GlideRecord('mb_demo_drone');
    grDrone.query();

    var series = client.getSeries(grDrone,'mb_demo_mt_speed');

## Client : put(Object metricData) {#ariaid-title7}

Enregistre les données de mesure dans la MetricBase base de données.
{#ClientS-put_DB__table_vxt_wvz_31b__entry__3}

| Nom | Type | Description |
|-|-|-|
| Données métriques | Objet | L'un des éléments suivants : * [Objet DataBuilder](https://servicenow-prod.fluidtopics.net/U8ckIxCPKEhpgKA8MI4o6Q#DataBuilderScopedAPI "L’API DataBuilder fournit des méthodes pour créer une série de points de données pour une mesure. Utilisez le sn_clotho. Client.put() pour enregistrer les valeurs.") contenant des données de mesures. * Tableau d'objets DataBuilder contenant des données de mesures. {#ClientS-put_DB__ul_ldw_bbh_yjb} |
[Tableau 10. Paramètres]

{#ClientS-put_DB__table_vxt_wvz_31b} {#ClientS-put_DB__table_wxt_wvz_31b__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 11. Renvoie]

{#ClientS-put_DB__table_wxt_wvz_31b}  

    var time = new GlideDateTime();
    ​
    // two different GlideRecord instances and metrics
    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    dataBuilder.add(time, 0.6);
    ​
    var dataBuilder2 = new sn_clotho.DataBuilder(gr2, 'disk_free_percentage');
    dataBuilder2.add(time, 0.2);
    ​
    new sn_clotho.Client().put([dataBuilder,dataBuilder2]);