---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Umwandler: Umfang, Global

# Umwandler: Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Umwandler Die API bearbeitet Zeitreihendaten, um die Daten für die Auswertung und Analyse vorzubereiten.

Sie können diese API in bereichsbezogenen und globalen Serverskripts aufrufen. Bei Verwendung von Umwandler Klasse, verwenden Sie `sn_Clotho `Namespace-Bezeichner.  
Der allgemeine Anwendungsfall besteht darin, den auszuwertenden Zeitraum zu bestimmen, die Datensätze aus der Tabelle mit dem Metrikfeld auszuwählen, den Typ der auszuführenden Transformation zu definieren und dann die Transformation auszuführen.

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

Diese Klasse ist Teil von MetricBaseAnwendung.

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

Erstellen Sie ein Transformatorobjekt.
{#TFMR-transformer_GR__table_w4x_4qr_mbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Quelldatensätze | GlideRecord | Enthält die Datensätze, für die Metriken ausgewertet werden sollen. Kann ein oder mehrere Datensätze sein. |
[Tabelle : 1. Parameter]

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

## Umwandler -- execute(GlideDateTime Start, GlideDateTime End) {#ariaid-title3}

Führen Sie die Transformation aus.
Verwenden Sie Metrik() Und Groupby() Methoden vor dem Aufruf Ausführen () . Die Ausführen () Die Methode kann für jedes Transformatorobjekt nur einmal aufgerufen werden.

Aktionen, die als Teil der Transformation ausgeführt werden, ändern die Daten in nicht MetricBaseDatenbank.
{#TFRM-execute_GDT_GDT__table_b2l_4xr_mbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| start | GlideDateTime | Der Beginn des auszuwertenden Zeitraums. |
| end | GlideDateTime | Das Ende des auszuwertenden Zeitraums. |
[Tabelle : 2. Parameter]

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

| Typ | Beschreibung |
|-|-|
| TransformationsResult | Die transformierten Daten. |
[Tabelle : 3. Rückgaben]

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

## Umwandler -- groupBy(Zeichenfolgenfeld) {#ariaid-title4}

Gibt das Feld an, das zum Gruppieren der Daten verwendet werden soll.
Wenn Sie verwenden möchten Groupby() -Methode, müssen Sie sie aufrufen, bevor Sie aufrufen Ausführen () Methode.
{#TFMR-groupBy_S__table_brg_q5r_mbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Das Feld in der Tabelle, das zum Gruppieren der Transformationsergebnisse verwendet werden soll. |
[Tabelle : 4. Parameter]

{#TFMR-groupBy_S__table_brg_q5r_mbb} {#TFMR-groupBy_S__table_crg_q5r_mbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Teil umwandeln | Ein TransformPart-Objekt, mit dem Sie die Transformationsmerkmale angeben können. |
[Tabelle : 5. Rückgaben]

{#TFMR-groupBy_S__table_crg_q5r_mbb}  

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

## Umwandler -- metric(String metricName) {#ariaid-title5}

Geben Sie das Metrikfeld an, das in der Transformation verwendet werden soll.
Sie können mehrere Metriken angeben, die in der Transformation verwendet werden sollen. Die Metrik() Methode kann nicht nach aufgerufen werden Ausführen () Methode wird aufgerufen.
{#TFRM-metric_S__table_g3m_yvr_mbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| metricName | Zeichenfolge | Name des Metrikfelds. |
[Tabelle : 6. Parameter]

{#TFRM-metric_S__table_g3m_yvr_mbb} {#TFRM-metric_S__table_h3m_yvr_mbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Teil umwandeln | Ein TransformPart-Objekt, das zum Angeben der Transformationsmerkmale verwendet werden kann. |
[Tabelle : 7. Rückgaben]

{#TFRM-metric_S__table_h3m_yvr_mbb}  

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


